ESPHome é uma ferramenta poderosa para criar firmwares personalizados para dispositivos ESP8266 e ESP32, facilitando a integração com sistemas como o Home Assistant. Nesta oficina, aprenderemos como configurar e utilizar o ESPHome para criar e gerenciar dispositivos IoT.
Instale o ESPHome usando o pip
:
pip install esphome
Verifique se a instalação foi bem-sucedida:
esphome --version
Saída esperada:
Version: 2025.2.2
Baixe e instale o Python e, em seguida, instale o ESPHome com o comando acima.
Para criar um novo projeto ESPHome, siga os passos abaixo:
- Execute o assistente para criar um novo firmware:
esphome wizard meu_projeto.yaml
-
Siga as instruções interativas para:
- Definir o nome do dispositivo
- Escolher o modelo do microcontrolador (ESP32, ESP8266, etc.)
- Selecionar a placa utilizada
- Configurar a rede Wi-Fi
- Definir uma senha de acesso
-
Para compilar e instalar o firmware:
esphome run meu_projeto.yaml
Esse comando compilará o código e o instalará no dispositivo conectado via USB.
Para garantir compatibilidade, é recomendável especificar a versão do ESPHome no arquivo de configuração YAML:
esphome:
name: meu_dispositivo
platform: ESP32
board: nodemcu-32s
version: "2025.2.2"
- Documentação oficial do ESPHome
- Componentes suportados pelo ESPHome
- Lista de placas ESP32 suportadas
- Se for utilizar conexão via Wi-Fi, assegure-se de estar na mesma rede que seu dispositivo ESP.
- Utilize um nome de dispositivo com apenas letras minúsculas, números e hífens para evitar erros.
- Se encontrar problemas ao compilar, tente atualizar as dependências com:
pip install --upgrade esphome platformio
Esta oficina ira apresentou um guia básico para instalação e uso do ESPHome. A partir daqui, você pode explorar sensores, atuadores e outras funcionalidades para criar dispositivos IoT personalizados!