sla
Source Files (2)
Download AllREADME
Macro Pad com ESP32 CYD 2.8" (touch)
Transforma sua placa CYD numa "Stream Deck" caseira: uma grade de 20 botões na tela touch, onde cada toque manda um comando pro PC via cabo USB, e um script Python no PC executa a ação (abrir programa, abrir site, pesquisar, mutar o Discord etc).
Não existe "IA" fazendo mágica aqui — é uma solução bem mais simples e
confiável: o ESP32 manda um texto curto (ex: CMD:DISCORD) pela porta
serial (o mesmo cabo USB), e um script Python que fica rodando no seu PC
decide o que fazer com aquele comando. Isso evita precisar de nenhuma IA
para a placa "adivinhar" o que fazer, e você tem controle total do que
cada botão faz.
Estrutura dos arquivos
esp32_macropad/
├── firmware/
│ ├── firmware.ino -> código que vai para o ESP32
│ └── User_Setup.h -> configuração da biblioteca TFT_eSPI (pinagem da tela)
├── pc_listener/
│ ├── pc_listener.py -> script que roda no PC
│ └── requirements.txt -> dependências do Python
└── README.md
1. Preparar o Arduino IDE
- Instale o Arduino IDE (versão 2.x).
- Em Arquivo > Preferências, adicione esta URL em "URLs Adicionais para Gerenciadores de Placas":
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json - Em Ferramentas > Placa > Gerenciador de Placas, procure
esp32e instale o pacote da Espressif. - Em Ferramentas > Gerenciador de Bibliotecas, instale:
TFT_eSPI(por Bodmer)XPT2046_Touchscreen(por Paul Stoffregen)
2. Configurar a biblioteca TFT_eSPI (só uma vez)
A TFT_eSPI precisa saber a pinagem da SUA tela em tempo de compilação.
- Ache a pasta da biblioteca, normalmente em:
Documentos/Arduino/libraries/TFT_eSPI/ - Substitua o arquivo
User_Setup.hde lá pelo arquivofirmware/User_Setup.hdeste projeto (ou copie o conteúdo dele para dentro do original).
3. Gravar o firmware no ESP32
- Abra
firmware/firmware.inono Arduino IDE. - Em Ferramentas > Placa, escolha
ESP32 Dev Module. - Conecte a placa no PC pelo cabo USB (nas placas CYD "2 USB", use a porta marcada como USB/serial de gravação, não a que é só alimentação/OTG).
- Selecione a porta COM correspondente em Ferramentas > Porta.
- Clique em Carregar (Upload).
Se a imagem aparecer de cabeça para baixo ou girada, troque o valor de
tft.setRotation(1) para 0, 2 ou 3 no código.
Se os toques caírem no lugar errado, ajuste os valores TS_MINX, TS_MAXX,
TS_MINY, TS_MAXY no topo do arquivo (calibração do touch resistivo).
4. Configurar o script do PC
- Instale o Python 3 (marque a opção "Add Python to PATH" na instalação, no Windows).
- Abra um terminal dentro da pasta
pc_listener/e rode:pip install -r requirements.txt - Abra
pc_listener.pynum editor de texto e edite o dicionárioACTIONSno topo do arquivo — é ali que você coloca o caminho de cada programa que quer abrir, os links de sites, o texto de pesquisa, etc. Cada botão da grade tem umid(ex:"PRIME","DISCORD","BTN4"...) que precisa ser exatamente igual aoidcorrespondente nofirmware.ino. - Para mutar o Discord: dentro do próprio Discord vá em
Configurações > Voz e Vídeo > Atalhos do Teclado e cadastre um atalho
global de "Mutar" (ex:
Ctrl+Shift+M). Coloque esse mesmo atalho no botãoMUTE_DISCORDdoACTIONS. - Rode o script:
Deixe essa janela aberta em segundo plano. (Opcional: crie um atalho dele na pasta Inicializar do Windows para ele já abrir sozinho ao ligar o PC.)python pc_listener.py
5. Adicionando/editando os outros 15 botões
Para cada botão livre (BTN4 até BTN20):
- No
firmware.ino, dentro do arrayapps[], troque olabel(o texto mostrado na tela) e acolorse quiser. - No
pc_listener.py, dentro do dicionárioACTIONS, adicione a entrada com o mesmoide o caminho/ação desejada, por exemplo:"BTN6": {"type": "open", "value": r"C:\Program Files\Steam\steam.exe"}, "BTN7": {"type": "url", "value": "https://www.youtube.com"}, "BTN8": {"type": "search", "value": "receita de bolo de cenoura"},
Depois de editar o firmware.ino, grave de novo na placa. O pc_listener.py
não precisa gravar nada — é só salvar o arquivo e rodar de novo.
Observações
- A biblioteca
keyboard(usada para o atalho de mutar) às vezes precisa que o script rode como Administrador no Windows para funcionar em todos os apps. - Os ícones desenhados na tela (Prime Video e Discord) são representações
simples com as cores das marcas — não são os logotipos oficiais, para
evitar qualquer problema de direitos de imagem. Se quiser logos reais,
dá pra usar imagens
.bmp/.jpgna tela via TFT_eSPI, mas isso exige outra etapa (conversão de imagem para o formato do display) que não entrou neste primeiro código para manter simples.