README.md
Markdown · 113 lines
# 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
1. Instale o [Arduino IDE](https://www.arduino.cc/en/software) (versão 2.x).
2. 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`
3. Em **Ferramentas > Placa > Gerenciador de Placas**, procure `esp32` e instale o pacote da Espressif.
4. 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.
1. Ache a pasta da biblioteca, normalmente em:
`Documentos/Arduino/libraries/TFT_eSPI/`
2. Substitua o arquivo `User_Setup.h` de lá pelo arquivo `firmware/User_Setup.h`
deste projeto (ou copie o conteúdo dele para dentro do original).
## 3. Gravar o firmware no ESP32
1. Abra `firmware/firmware.ino` no Arduino IDE.
2. Em **Ferramentas > Placa**, escolha `ESP32 Dev Module`.
3. 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).
4. Selecione a porta COM correspondente em **Ferramentas > Porta**.
5. 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
1. Instale o [Python 3](https://www.python.org/downloads/) (marque a opção
"Add Python to PATH" na instalação, no Windows).
2. Abra um terminal dentro da pasta `pc_listener/` e rode:
```
pip install -r requirements.txt
```
3. Abra `pc_listener.py` num editor de texto e edite o dicionário `ACTIONS`
no 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 um `id` (ex: `"PRIME"`, `"DISCORD"`, `"BTN4"`...) que precisa
ser exatamente igual ao `id` correspondente no `firmware.ino`.
4. 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ão `MUTE_DISCORD` do `ACTIONS`.
5. Rode o script:
```
python pc_listener.py
```
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.)
## 5. Adicionando/editando os outros 15 botões
Para cada botão livre (`BTN4` até `BTN20`):
- No `firmware.ino`, dentro do array `apps[]`, troque o `label` (o texto
mostrado na tela) e a `color` se quiser.
- No `pc_listener.py`, dentro do dicionário `ACTIONS`, adicione a entrada
com o mesmo `id` e o caminho/ação desejada, por exemplo:
```python
"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`/`.jpg` na 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.