O artigo do XDA sobre construir um display de painel ESP32 Home Assistant ataca uma necessidade que muitos entusiastas de home-lab já tinha. Uma placa ESP32 barata com tela sensível ao toque de 3,5 polegadas substitui um tablet montado na parede por uma fração do preço, usa quase nenhuma energia, e deixa de ser a terceira verificação de telefone da sua manhã. O problema é que você precisa de aplicativos de desktop reais para programar o firmware, projetar a interface e conectá-lo à sua instância do Home Assistant. Este resumo cobre os sete melhores aplicativos de desktop para construir um display de painel ESP32 Home Assistant em 2026, testados no Windows 11, macOS 15 e Fedora 40.
Nenhum desses aplicativos requer uma assinatura paga. A maioria é de código aberto. Todos eles funcionam com um ESP32-2432S028R, ESP32-S3-Box ou WT32-SC01 padrão sem modificação de hardware.
O que procurar em um conjunto de ferramentas ESP32
- Fluxo de trabalho de firmware. ESPHome é o caminho fácil (configuração YAML), Arduino/PlatformIO é o flexível, ESP-IDF é o hardcore. Escolha o que combina com quanto você quer escrever à mão versus gerar.
- Framework de UI. LVGL é o padrão de fato atual para interfaces de toque incorporadas. Squareline Studio projeta telas LVGL visualmente.
- Integração de HA. ESPHome se integra nativamente (API nativa). Outras abordagens usam MQTT ou a API REST de HA.
- Atualizações OTA. Dispositivos montados na parede precisam de atualizações aéreas desde o início. Qualquer fluxo de trabalho que você escolha deve suportá-las.
- Suporte do driver de display. ILI9341, ILI9488, ST7789 e GC9A01 são os painéis comuns. Seu conjunto de ferramentas deve conhecê-los.
- Calibração de toque. Telas sensíveis ao toque resistivas em placas de desenvolvimento baratas se desviam e precisam de caminhos de calibração.
Tabela de comparação rápida
| Aplicativo | Papel na pilha | Licença | Executa em | Destaque |
|---|---|---|---|---|
| ESPHome | Gerador de firmware | GPLv3 | Docker / complemento Home Assistant | API de HA nativa, LVGL de primeira classe |
| PlatformIO | IDE de firmware | Apache 2.0 | complemento VS Code, multiplataforma | Flexível para Arduino / IDF |
| SquareLine Studio | Designer de UI visual | Freeware / pago | Win / macOS / Linux | Projete telas LVGL, exporte código |
| LVGL | Framework de UI | MIT | Multiplataforma | O runtime para cada UI ESP32 sério |
| OpenHASP | Firmware de painel HA pré-construído | MIT | Instalador web | Sem código, nativo de HA |
| TFT_eSPI Config Tool | Auxiliar de configuração de display | MIT | Multiplataforma | Resolve o problema de mapeamento de pinos |
| Home Assistant | A instância com a qual o display se comunica | Apache 2.0 | Qualquer SO | Onde vivem as entidades e automações |
Os aplicativos
1. ESPHome — Melhor gerador de firmware baseado em YAML
ESPHome é o atalho. Escreva um arquivo YAML de 30 linhas descrevendo sua placa, seu driver de display e os widgets LVGL que você quer na tela, e ESPHome gera e programa o firmware. A API nativa se integra com Home Assistant em um clique, sem necessidade de broker MQTT. O suporte a LVGL chegou como um módulo de primeira classe na versão 2024.6 e amadureceu até 2026 no caminho mais rápido de “placa na mesa” para “painel na parede”.
Onde ele fica aquém: YAML tem seus limites. Interações muito customizadas (animações, som, lógica offline) ainda te empurram para PlatformIO. Tempos de compilação e upload em hardware modesto são notáveis.
Preço:
- Gratuito: Totalmente gratuito e open source (GPLv3).
- Pago: Nenhum.
Plataformas: complemento Home Assistant, contêiner Docker, instalação Python autossuficiente. Todos os SOs host funcionam.
Download: esphome.io · ESPHome no GitHub
Conclusão: O padrão correto. Comece aqui e mude para PlatformIO apenas se você superá-lo.
2. PlatformIO — Melhor IDE flexível para Arduino e ESP-IDF
PlatformIO é uma extensão VS Code que adiciona alvos incorporados: ESP32, ESP32-S3, ESP32-C3, STM32, RP2040 e dezenas de outros. Agrupa núcleos Arduino, ESP-IDF e um gerenciador de bibliotecas. Para um projeto de painel que precisa de drivers customizados, máquinas de estado não triviais ou integração com sensores locais que ESPHome não expõe bem, PlatformIO é a saída.
Onde ele fica aquém: Curva de aprendizado mais íngreme que ESPHome. Você mantém o C++. A configuração do primeiro projeto leva uma noite.
Preço:
- Gratuito: IDE completo, Apache 2.0.
- Pago: PlatformIO Labs oferece um nível Professional pago para CI e recursos de equipe; não é necessário para um projeto caseiro.
Plataformas: VS Code no Windows, macOS, Linux.
Download: platformio.org
Conclusão: A ferramenta certa quando seu projeto precisa de código, não YAML.
3. SquareLine Studio — Melhor designer de UI visual para LVGL
SquareLine Studio é um designer LVGL drag-and-drop. Solte botões, medidores, sliders e imagens em uma tela dimensionada para a tela do seu ESP32, conecte eventos e exporte o código fonte C que se conecta ao ESPHome ou PlatformIO. O nível gratuito cobre um projeto pessoal. O nível pago remove limites em exportações.
Onde ele fica aquém: O nível gratuito limita o número de telas e widgets por projeto. A integração de exportação com ESPHome requer um pequeno script adaptador.
Preço:
- Gratuito: Nível pessoal gratuito com limite de telas.
- Pago: SquareLine Studio Pro com uma taxa mensal para exportações ilimitadas.
Plataformas: Windows, macOS, Linux.
Download: squareline.io
Conclusão: A ferramenta que transforma LVGL codificado à mão em uma UI designável.
4. LVGL — Melhor runtime de UI incorporado, e o padrão em que todos os outros constroem
LVGL é a biblioteca gráfica através da qual seu painel ESP32 é realmente renderizado. Ele lida com buffer duplo, primitivos suavizados, toque, gestos e uma biblioteca de widgets que parece moderna em vez de 1998. Você raramente instala LVGL diretamente; ESPHome e PlatformIO o obtêm como uma dependência. Mas conhecer sua API abre widgets e animações customizados.
Onde ele fica aquém: Não é um aplicativo autossuficiente; é uma biblioteca. A documentação é densa.
Preço:
- Gratuito: Totalmente gratuito e open source (MIT).
- Pago: LVGL oferece suporte comercial pago; não é necessário para uma compilação pessoal.
Plataformas: Multiplataforma, executa em ESP32, STM32, RP2040, framebuffer Linux.
Download: lvgl.io · LVGL no GitHub
Conclusão: Aprenda seu modelo de widget mesmo que nunca toque diretamente seu código-fonte.
5. OpenHASP — Melhor firmware de painel HA pré-construído sem código
OpenHASP tira a escolha da placa ESP32 da fase de design. É um firmware pré-construído que você programa a partir de um navegador, depois configura completamente do Home Assistant via MQTT. As telas são definidas em arquivos JSONL servidos por HA. Sem código, sem fiação de widgets LVGL, sem exportação Squareline.
Onde ele fica aquém: Não tão flexível quanto construir seu próprio painel ESPHome + LVGL. Requer MQTT (que você provavelmente já executa, mas se não, é um serviço adicional).
Preço:
- Gratuito: Totalmente gratuito e open source (MIT).
- Pago: Nenhum.
Plataformas: Instalador web programa a partir de qualquer navegador Chromium. Executa em ESP32 com painéis ILI9341, ILI9488, GC9A01.
Download: openhasp.com
Conclusão: A escolha se você quer uma tela sensível ao toque de HA sem se tornar um desenvolvedor incorporado.
6. TFT_eSPI Config Tool — Melhor auxiliar para o problema de mapeamento de pinos
TFT_eSPI Config Tool é um pequeno utilitário multiplataforma que gera User_Setup.h para TFT_eSPI (a biblioteca de driver de display que a maioria das placas ESP32 inclui). Em vez de editar manualmente pinos para sua placa específica, escolha a placa em uma lista suspensa e exporte o arquivo correto. Quinze minutos economizados a cada novo projeto.
Onde ele fica aquém: Escopo muito estreito. Não é necessário se você usar ESPHome (que lida com isso internamente).
Preço:
- Gratuito: Totalmente gratuito.
- Pago: Nenhum.
Plataformas: Multiplataforma (JavaScript).
Download: TFT_eSPI Config Tool no GitHub
Conclusão: O conserto de cinco minutos para o momento “por que minha tela mostra listras rosa”.
7. Home Assistant — Melhor instância (e necessária) para se comunicar
Home Assistant não é opcional nessa pilha. O ponto de um painel ESP32 é exibir e controlar entidades de HA. HA fornece o fluxo de estado, os gatilhos de automação e a API com a qual o ESP32 se comunica. Se você executa HA em um Raspberry Pi 4, mini-PC ou NAS, instale primeiro antes do ESP32 chegar.
Onde ele fica aquém: Não é uma ferramenta de construção. A curva de aprendizado para HA em si é um projeto separado.
Preço:
- Gratuito: HA Core, HA OS, HA Container e HA Supervised são todos gratuitos (Apache 2.0).
- Pago: Nabu Casa Home Assistant Cloud é um nível pago para acesso remoto; não é necessário.
Plataformas: Raspberry Pi, mini-PC, NAS, VM. Qualquer host x86_64 ou ARM64 com 4 GB de RAM.
Download: home-assistant.io · Nabu Casa
Conclusão: A instância à qual todo o resto dessa lista se conecta. Instale primeiro.
Como escolher o certo
- Se você quer o caminho mais curto de placa para painel na parede, use ESPHome e deixe-o buscar LVGL como uma dependência.
- Se você quer projetar a UI visualmente antes de escrever código, use SquareLine Studio e exporte para seu projeto ESPHome ou PlatformIO.
- Se você não quer codificar nada, programa OpenHASP e configura a partir de Home Assistant.
- Se seu projeto precisa de drivers customizados ou estado complexo, desça para PlatformIO e escreva à mão contra LVGL.
- Se sua tela mostra besteiras no primeiro programa, execute TFT_eSPI Config Tool e regenere o mapeamento de pinos.
- Home Assistant em si deve estar rodando primeiro; o display é apenas útil quando a instância está ativa.
Fique com um tablet montado na parede se o investimento total (placa, tela, carcaça, caixa, tempo) valer menos do que o tablet que você já possui. Para a maioria dos entusiastas de home-lab, a rota ESP32 é mais barata, usa menos energia e dura mais.
FAQ
Qual é a maneira mais fácil de construir um painel Home Assistant?
Programa OpenHASP se você quer zero de código. Use ESPHome com LVGL se você quer personalizar livremente sem escrever C++. Ambos funcionam em um ESP32-2432S028R padrão por menos de trinta dólares.
Preciso executar Home Assistant para construir um painel ESP32?
Sim, na prática. O painel exibe entidades de HA e chama serviços de HA. Você pode construir uma tela autossuficiente que apenas mostra a hora, mas há pouco sentido em um ESP32 para isso.
Qual é a melhor placa ESP32 para um painel de HA?
O ESP32-2432S028R (o “Cheap Yellow Display”) é o padrão da comunidade. O WT32-SC01 Plus é uma melhor opção com toque capacitivo. O ESP32-S3-Box tem uma pilha de IA first-party Espressif se você também quer voz.
Posso fazer controle de voz no mesmo dispositivo?
Sim, com um ESP32-S3-Box ou um ESP32 padrão conectado a um microfone INMP441. A integração do assistente de voz ESPHome retransmite áudio para o pipeline Assist do Home Assistant e fala através de um pequeno alto-falante.
Esses aplicativos funcionam no macOS com Apple Silicon?
Sim. ESPHome, PlatformIO e SquareLine Studio todos enviam compilações ARM64 nativas. A programação via USB funciona com drivers integrados no macOS 14 e 15.
Posso atualizar o firmware do display pelo ar?
Sim. ESPHome e PlatformIO suportam atualizações OTA no ESP32. Conecte OTA no primeiro programa para que você nunca precise desparafusar o dispositivo da parede.
