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.