Back to Explorer

sla

Project Information

Author

artrabelo

Board

ESP32-WROOM-DA Module

SDK Version

3.3.6

Platform

ESP32

Created

Updated

Description

esp

Tags
This project has no successful builds and cannot be flashed.

README

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 (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 (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:
    "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.