Pular para o conteúdo principal

Conectar o Seeed Studio IoT Button ao ESPHome

Neste tutorial, mostraremos como conectar o Seeed Studio IoT Button ao Home Assistant usando o ESPHome. Você aprenderá como configurar o botão para detectar diferentes padrões de pressão (clique simples, clique duplo e pressão longa) e acionar diferentes ações na sua casa inteligente.

nota

Se você seguir este Wiki para conectar o IoT Button ao ESPHome, esteja ciente da limitação potencial:

Acordar manualmente e atraso de reconexão: Sempre que quiser usar o botão, você precisa despertá-lo manualmente pressionando-o. Após acordar, o dispositivo precisará se reconectar à rede, o que pode levar um curto período antes que o botão possa ser usado novamente.

Se você escolher o IoT Button V2, haverá um recurso adicional de detecção de energia no ESPHome em relação à geração anterior.

Materiais Necessários​

Seeed Studio IoT Button
Adquira Agora 🖱️

O Seeed Studio IoT Button é um botão inteligente versátil com chip ESP32-C6 integrado. É um dispositivo completo e independente que pode ser integrado ao Home Assistant para controlar vários dispositivos e acionar automações. Com seu chip ESP32-C6, oferece baixo consumo de energia e conectividade confiável sem exigir placas de desenvolvimento adicionais.

Instalar o ESPHome no Home Assistant​

Etapa 1. Clique em Settings --> Add-on --> ADD-ON STORE.

Etapa 2. Pesquise por ESPHome.

Etapa 3. Clique em INSTALL e depois clique em START.

Etapa 4. Instalação bem-sucedida

Adicionando o IoT Button ao ESPHome​

Etapa 5. Clique em +NEW DEVICE

Etapa 6. Clique em NEXT e dê ao seu dispositivo um nome de sua escolha. Recomendamos usar "seeedstudio-iot-button" ou algo semelhante.

Etapa 7. Selecione o tipo do seu dispositivo

Para o IoT Button com seu ESP32-C6 integrado, selecione "ESP32" como o tipo de dispositivo. Iremos modificar a configuração depois para especificar a variante correta do ESP32.

Etapa 8. Dispositivo adicionado com sucesso, por fim clique em SKIP.

Configurando o IoT Button​

Usando o Web Flasher (Método Recomendado)​

A maneira mais fácil de começar com o IoT Button é usar a ferramenta Web Flasher para instalar o firmware ESPHome pré-compilado diretamente do seu navegador.

Etapa 1: Visite o site Seeed Studio IoT Button Firmware Flasher.

Etapa 2: Conecte o seu IoT Button ao computador usando um cabo USB.

Etapa 3: Clique no botão "Install" na página do Web Flasher.

Etapa 4: Selecione a porta USB correta na janela pop-up.

Etapa 5: O navegador fará automaticamente o download e gravará o firmware no seu dispositivo.

Etapa 6: Após a conclusão da gravação, o IoT Button criará sua própria rede WiFi. Conecte-se à rede WiFi chamada "seeedstudio-iot-button" a partir do seu computador ou smartphone.

Etapa 7: Uma vez conectado, seu dispositivo deve abrir automaticamente uma página de configuração. Se não abrir, abra um navegador e acesse http://192.168.4.1.

Etapa 8: Na página de configuração:

  • Insira o nome (SSID) e a senha da sua rede WiFi doméstica
  • Certifique-se de que esta é a mesma rede à qual o seu Home Assistant está conectado
  • Clique em "Save" para aplicar as configurações

Etapa 9: O IoT Button será reiniciado e se conectará à sua rede WiFi doméstica.

Etapa 10: No Home Assistant, vá para Settings > Devices & Services. Você deverá ver uma notificação de que um novo dispositivo ESPHome foi detectado. Clique em "Configure" para adicionar o dispositivo ao Home Assistant.

Etapa 11: Siga as instruções para concluir a configuração. O IoT Button agora aparecerá no painel do Home Assistant com três interruptores virtuais correspondentes às diferentes ações do botão.

Método Alternativo: Usando o painel do ESPHome​

Se você preferir usar o painel do ESPHome para ter mais controle sobre a configuração, siga as etapas abaixo.

Adicionando a configuração do ESPHome​

Etapa 1. O card correspondente ao dispositivo aparecerá na página do ESPHome, então clique em EDIT.

Etapa 2. Substitua toda a configuração pelo seguinte código:

Devido às frequentes atualizações de código, clique no botão abaixo para acessar o programa Yaml.

IoT Button V1 Yaml 🖱️IoT Button V2 Yaml 🖱️
nota

Certifique-se de substituir "Your_WiFi_SSID" e "Your_WiFi_Password" pelas credenciais reais da sua rede WiFi. A configuração de WiFi deve corresponder à rede onde o seu servidor Home Assistant está em execução para garantir a conectividade adequada.

Entendendo a Configuração​

Vamos analisar as partes principais desta configuração:

  1. Configuração do ESP32:

    • Especifica a variante ESP32-C6 e o tipo de placa para o chip integrado do IoT Button
    • Define o tamanho da flash em 4MB
    • Usa o framework ESP-IDF, que é necessário para o ESP32-C6

  2. Configuração do Botão:

    • Conecta ao GPIO9, onde o botão físico está ligado internamente
    • Inverted: True significa que o pino é mantido em nível alto quando não pressionado e vai para nível baixo quando pressionado
    • Configura três padrões de pressão diferentes:
      • Clique curto simples (pressionar e soltar rapidamente)
      • Clique duplo (duas pressões rápidas)
      • Pressão longa (manter pressionado por 1–2,5 segundos)

  3. Interruptores Virtuais:

    • Cria três interruptores template que aparecerão no Home Assistant
    • Cada interruptor corresponde a um padrão de pressão diferente do botão
    • Esses interruptores podem ser usados em automações para controlar outros dispositivos

Etapa 3. Após concluir a configuração, clique em INSTALL no canto superior direito e selecione Plug into this computer.

Etapa 4. Aguarde a conclusão do processo de compilação. Depois clique em Download project, selecione Factory format para baixar o arquivo do projeto e então clique em Open ESPHome Web.

Etapa 5. Conecte o IoT Button ao computador via USB. Clique em CONNECT e selecione a porta serial correta.

Etapa 6. Clique em INSTALL para gravar o firmware no seu IoT Button.

Passo 7. Se tudo correr bem, você verá uma mensagem de instalação bem-sucedida.

Adicionando o IoT Button ao Home Assistant​

Passo 16. Volte para o Home Assistant. Clique em Settings e depois selecione Devices & services.

Passo 17. Você deverá ver uma notificação sobre um novo dispositivo descoberto. Clique em CONFIGURE.

Passo 18. Siga as instruções para adicionar o IoT Button ao Home Assistant. Você pode selecionar a qual área o dispositivo pertence e clicar em FINISH.

Passo 19. O IoT Button e seus três interruptores virtuais agora aparecerão no painel do seu Home Assistant.

Criando Automações com o IoT Button​

Agora que seu IoT Button está configurado, você pode criar automações para controlar dispositivos na sua casa inteligente. Vamos criar uma automação simples que liga uma luz quando você pressiona o botão.

Passo 20. No Home Assistant, vá em Settings > Automations & scenes.

Passo 21. Clique em CREATE AUTOMATION.

Passo 22. Configure sua automação:

  1. Name: Dê à sua automação um nome descritivo, como "IoT Button Single Press - Turn On Light"
  2. Trigger: Selecione "State" como o tipo de gatilho
    • Entity: Selecione "Switch 1" (para clique simples)
    • From: "off"
    • To: "on"
  3. Action: Escolha o dispositivo que você quer controlar
    • Por exemplo, selecione uma luz e configure para ligar

Passo 23. Clique em SAVE para criar a automação.

Uso Avançado: Controlando Diferentes Dispositivos com Diferentes Padrões de Pressão​

Um dos recursos poderosos da configuração do IoT Button é a capacidade de detectar diferentes padrões de pressão. Aqui estão algumas ideias para usar cada padrão:

  1. Pressão Única (Switch 1):

    • Ligar/desligar as luzes no cômodo atual
    • Alternar um dispositivo usado com frequência

  2. Duplo Clique (Switch 2):

    • Ativar uma cena (por exemplo, "Noite de Filme" que diminui as luzes e liga a TV)
    • Controlar um grupo de dispositivos simultaneamente

  3. Pressão Longa (Switch 3):

    • Ativar recursos de segurança (acionar/desativar alarme)
    • Disparar rotinas de emergência
    • Desligar vários dispositivos de uma só vez

Para configurar essas automações avançadas, crie automações adicionais seguindo os passos acima, mas selecione o switch apropriado (Switch 1, 2 ou 3) como gatilho e configure as ações desejadas.

Solução de Problemas​

Se você encontrar problemas com o seu IoT Button, aqui estão algumas etapas comuns de solução de problemas:

  1. O botão não está conectando ao WiFi:

    • Verifique suas credenciais de WiFi na configuração do ESPHome
    • Certifique-se de que sua rede WiFi é 2,4GHz (o ESP32-C6 suporta 2,4GHz e 5GHz, mas 2,4GHz normalmente tem melhor alcance)

  2. O botão não aparece no Home Assistant:

    • Verifique se o botão e o Home Assistant estão na mesma rede
    • Reinicie o add-on ESPHome e o Home Assistant

  3. Os cliques do botão não são detectados:

    • Verifique a configuração do pino GPIO (GPIO9 para o IoT Button padrão)
    • Verifique os logs no ESPHome para ver se os cliques do botão estão sendo detectados

  4. As automações não estão disparando:

    • Verifique se a automação está habilitada
    • Verifique se as condições de gatilho correspondem exatamente (mudanças de estado de "off" para "on")

Solução de Problemas​

P1: Por que meu dispositivo continua caindo e não consegue se conectar à internet após substituir a bateria? Posso confirmar que a bateria está carregada​

Depois que a bateria é removida, devido à estratégia de proteção do chip da bateria 18650, é necessário ser levemente ativada por um cabo de alimentação USB carregado para funcionar corretamente.

Recursos​

Suporte Técnico & Discussão de Produtos​

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...