Pular para o conteúdo principal

Conectando o XIAO ESP32-C5 ao Home Assistant

Este tutorial da wiki irá demonstrar como conectar o Seeed Studio XIAO ESP32-C5 ao Home Assistant, bem como como controlar dispositivos ou transmitir dados após conectar módulos Grove ao XIAO ESP32-C5. Então, vamos começar!

Introdução ao Home Assistant​

Home Assistant é uma poderosa plataforma de automação residencial de código aberto que permite controlar e monitorar seus dispositivos de casa inteligente a partir de uma interface única e unificada. Ele atua como o hub central da sua casa inteligente, permitindo automatizar rotinas, monitorar sensores e criar um ambiente doméstico mais inteligente.

Saiba Mais 🖱️

Integração com ESPHome​

ESPHome é uma ferramenta de criação de firmware de código aberto especificamente projetada para dispositivos ESP8266 / ESP32. Ela permite criar firmwares personalizados usando simples arquivos de configuração YAML, que podem então ser gravados no seu dispositivo.


Saiba Mais 🖱️

Método 1: Usando ESPHome​

Este exemplo irá se conectar ao Home Assistant via ESPHome.

Preparação de Hardware​

Você precisa preparar os itens listados na tabela.

Seeed Studio XIAO ESP32-C5Seeed Studio Grove Base para XIAOGrove - LED Vermelho
Adquira Agora 🖱️
Adquira Agora🖱️
Confira Mais 🖱️

Instalar o Firmware​

Se você ainda não configurou o Home Assistant, pode clicar neste link e seguir o tutorial oficial do Home Assistant para concluir a configuração. Home Assistant Installation

Passo 1. Instalar ESPHome

Se você já instalou o ESPHome, pode pular esta etapa.

  • Vá para Settings -> Add-ons
  • ADD-ON STORE -> Search ESPHome
  • Inicie o ESPHome
dica

Certifique-se de que a versão do ESPHome que você instalou seja maior ou igual a 25.11.5; caso contrário, talvez ele não ofereça suporte ao XIAO ESP32-C5.

Passo 2. Adicionar novo dispositivo

Vá para o ESPHome e clique no botão Add New Device no canto inferior direito.


Adicione um novo dispositivo e dê o nome XIAO ESP32-C5.



Passo 3. Instalar o firmware

Configuração de Arquivo YAML de Referência
dica

Você precisa modificar os parâmetros para corresponder aos do seu dispositivo, como a chave da API, SSID, senha e assim por diante. Além disso, o XIAO ESP32-C5 suporta WiFi dual-band (2,4 GHz e 5 GHz), o que significa que você pode conectá-lo ao roteador de 5 GHz da sua casa.

esphome:
  name: xiao-esp32-c5
  friendly_name: XIAO ESP32-C5

esp32:
  board: esp32-c5-devkitc-1
  variant: esp32c5
  framework:
    type: esp-idf

# Enable logging
logger:

# Enable Home Assistant API
api:
  encryption:
    key: 

ota:
  - platform: esphome
    password: 

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

  # Enable fallback hotspot (captive portal) in case wifi connection fails
  ap:
    ssid: "Xiao-Esp32-C5 Fallback Hotspot"
    password: 

captive_portal:
  # Example configuration entry
output:
  - platform: gpio
    pin: GPIO1
    id: led_gpio_output
    inverted: false

switch:
  - platform: output
    name: "LED Switch"
    output: led_gpio_output
    id: dev_board_led

Clique em INSTALL para instalar o código no dispositivo e você verá a seguinte imagem.

dica

Se o seu Host do Home Assistant (Raspberry PI/Green/Yellow etc.) estiver longe de você, recomendamos usar este método. Você pode instalar com o computador que tiver em mãos.

Primeiro, você precisa clicar em Manual download para baixar o firmware compilado.

Abra este site onde iremos enviar o firmware para o XIAO ESP32-C5.
ESPHome dashboard_install


Volte para o ESPHome para baixar o firmware.


Selecione o formato Factory.

Use um cabo USB para conectar o dispositivo ao seu computador e clique em CONNECT.
ESPHome dashboard_install


Selecione usbmodemxxx (no Windows é COMxxx) e clique em connect.

Clique em INSTALL e selecione o firmware que você acabou de baixar.

Etapa 4. Adicionar Dispositivo

  • Navegue até Settings → Devices & services

  • ESPHome Device -> Add.

  • Se você optou por adicionar uma chave secreta, você precisa inseri-la, ela pode ser encontrada no arquivo YAML que você criou.

  • A tela a seguir será exibida após uma adição bem-sucedida.

Exibir no Dashboard​

Etapa 1. Abra Overview -> Clique em Edit no canto superior direito

Etapa 2. Crie uma seção e nomeie-a LED Control -> Adicione o Card

Etapa 3. Adicionar por entidade -> Pesquise XIAO ESP32-C5 -> Continue

Etapa 4. Selecione Add to dashboard na janela pop-up -> Clique em Done no canto superior direito para concluir a adição.

  • Os efeitos são os seguintes:

Método 2: Seeed Home Assistant Discovery​

  • Seeed HA Discovery é uma solução completa para conectar facilmente dispositivos ESP32/nRF52840 ao Home Assistant, fornecida pela Seeed Studio.
  • Com apenas algumas linhas de código na Arduino IDE ou PlatformIO para suas placas de desenvolvimento da série XIAO, você pode se conectar ao Home Assistant via WiFi ou BLE.
  • Aqui usaremos um exemplo de leitura de um sensor de temperatura e umidade de estufa para mostrar como usar o Seeed Home Assistant Discovery para conectar o XIAO ESP32-C5 ao Home Assistant.

Preparação de Hardware​

Seeed Studio XIAO ESP32-C5Seeed Studio Grove Base for XIAOGrove - Temperature & Humidity Sensor (DHT11)
Adquira Agora 🖱️
Adquira Agora🖱️
Saiba Mais 🖱️

Instalar HACS Instagram​

Antes de adicionar a integração Seeed Home Assistant Discovery, você precisa instalar o HACS primeiro.

Etapas de Instalação:

  1. Settings -> Devices & services -> Add integration -> Pesquise HACS
  1. Selecione todas as opções -> Submit

  1. Clique no hiperlink e copie o código de ativação contido nele.

  2. Insira o código de ativação mencionado anteriormente

  3. Volte ao HomeAssistant -> Developer tools -> Reboot system

  1. A barra de navegação à esquerda exibirá HACS

Instalar Integração​

  • Instalação com um clique via HACS (Recomendado)

  1. Abra HACS -> Integrations:

  2. Clique no ícone ⋮ no canto superior direito -> Custom repositories

  3. Insira https://github.com/limengdu/Seeed-Homeassistant-Discovery, selecione a categoria Integration

  4. Clique em Add, depois pesquise por Seeed HA Discovery e instale

  5. Reinicie o Home Assistant

Instalar Biblioteca Arduino​

Instalar a Biblioteca de Dependência WiFi​

  • Para Arduino IDE
  1. Baixe a pasta arduino/SeeedHADiscovery
Download the Library

  1. Copie para C:\Users\yourname\Documents\Arduino\libraries\

  2. ArduinoJson (por Benoit Blanchon)

  1. WebSockets (por Markus Sattler)
  • Para PlatformIO
lib_deps =
    bblanchon/ArduinoJson@^7.0.0
    links2004/WebSockets@^2.4.0

Instalar a Biblioteca de Dependência BLE​

  • Para Arduino IDE

  1. Baixe a pasta arduino/SeeedHADiscoveryBLE

  2. Copie para C:\Users\yourname\Documents\Arduino\libraries\

Baixar a Biblioteca

  1. NimBLE-Arduino
  • Para PlatformIO
lib_deps =
    h2zero/NimBLE-Arduino@^1.4.0

Escrever Programa Arduino​

Escolha a versão correspondente de acordo com suas necessidades reais.

#include <SeeedHADiscovery.h>

const char* WIFI_SSID = "Your WiFi Name";
const char* WIFI_PASSWORD = "Your WiFi Password";

SeeedHADiscovery ha;
SeeedHASensor* tempSensor;
SeeedHASensor* humiditySensor;

void setup() {
    Serial.begin(115200);
    ha.setDeviceInfo("Living Room Sensor", "ESP32-C5", "1.0.0");
    ha.enableDebug(true);

    if (!ha.begin(WIFI_SSID, WIFI_PASSWORD)) {
        Serial.println("WiFi connection failed!");
        while (1) delay(1000);
    }

    tempSensor = ha.addSensor("temperature", "Temperature", "temperature", "°C");
    tempSensor->setPrecision(1);

    humiditySensor = ha.addSensor("humidity", "Humidity", "humidity", "%");
    humiditySensor->setPrecision(0);
}

void loop() {
    ha.handle();

    static unsigned long lastUpdate = 0;
    if (millis() - lastUpdate > 5000) {
        lastUpdate = millis();
        tempSensor->setValue(25.5);
        humiditySensor->setValue(55);
    }
}

Depois de enviar o código, abra o monitor serial. Assim que a conexão WiFi for bem-sucedida, o endereço IP correspondente será impresso.

dica

XIAO ESP-C5 suporta WiFi de banda dupla (2,4 GHz & 5 GHz).
Se você achar a configuração manual de rede muito trabalhosa, também pode usar a página de gravação de firmware que lançamos: Web Firmware Flasher

Adicionar Dispositivo no Home Assistant​

Ele será descoberto automaticamente! Ou adicione manualmente:

  1. Vá para Settings -> Devices & Services

  2. Clique em Add Integration

  3. Procure por Seeed HA Discovery

  4. Insira o endereço IP do ESP32

Demonstração de Efeito​


Parabéns! Até agora, você já deve ter dominado dois métodos para conectar o XIAO ESP32-C5 ao Home Assistant. Estamos ansiosos para ver seus projetos incríveis e convidamos você a compartilhá-los conosco!

Suporte Técnico & Discussão de Produto​

Obrigado por escolher nossos produtos! Estamos aqui para fornecer diferentes tipos de suporte para garantir que sua experiência com nossos produtos seja a mais tranquila possível. Oferecemos vários canais de comunicação para atender a diferentes preferências e necessidades.

Loading Comments...