Product Guides

Como integrar dispositivos SONOFF OpenEdge com o Home Assistant através de MQTT

How to Integrate SONOFF OpenEdge Devices with Home Assistant via MQTT


Introdução

A SONOFF apresenta o OpenEdge, uma arquitetura que privilegia o funcionamento local para dispositivos inteligentes de nova geração, concebida para lhe proporcionar maior controlo local, maior interoperabilidade e formas mais flexíveis de ligar os seus dispositivos a diferentes plataformas e ecossistemas.

Com o OpenEdge, os dispositivos SONOFF compatíveis podem comunicar localmente através de interfaces abertas, incluindo HTTP, MQTT e WebSocket.

Para os utilizadores do Home Assistant, isto significa mais opções para integrar os seus dispositivos: pode ligá-los localmente através de MQTT quando preferir um controlo local e uma integração flexível com o ecossistema, mantendo a conectividade à nuvem disponível quando esta se adequar melhor às suas necessidades.

Neste guia, aprenderá a integrar dispositivos SONOFF compatíveis com OpenEdge no Home Assistant através de MQTT, seguindo uma configuração detalhada passo a passo.




Como funciona a integração MQTT com o Home Assistant

Antes de começar a configurar o MQTT, é útil compreender como funciona a ligação.

A arquitetura básica é a seguinte:

Dispositivo SONOFF compatível com OpenEdge → Broker MQTT → Home Assistant

O dispositivo SONOFF não se liga diretamente ao Home Assistant. Em vez disso, tanto o dispositivo como o Home Assistant ligam-se ao mesmo broker MQTT, que funciona como centro de mensagens entre ambos.
  • Dispositivo SONOFF compatível com OpenEdge — liga-se ao broker como cliente MQTT, publica estados e dados do dispositivo e recebe comandos de controlo.
  • Broker MQTT — recebe e distribui mensagens MQTT entre clientes ligados. Nas configurações do Home Assistant, o Mosquitto é uma escolha comum.
  • Home Assistant — liga-se ao mesmo broker através da integração MQTT, recebe atualizações do dispositivo, envia comandos e gere o dispositivo no Home Assistant.
Os dispositivos SONOFF compatíveis com OpenEdge e MQTT suportam nativamente a deteção MQTT. Assim que o dispositivo se liga ao broker, publica as informações de deteção necessárias, permitindo que o Home Assistant crie automaticamente o dispositivo e as entidades suportadas, sem ser necessário configurar manualmente tópicos MQTT ou escrever YAML.




Configurar dispositivos OpenEdge com o Home Assistant através de MQTT

Agora vamos configurar a integração MQTT. Este guia utiliza o SONOFF MINI-1GSP como exemplo, mas o mesmo fluxo de trabalho básico pode ser utilizado com outros dispositivos OpenEdge compatíveis com MQTT. 

O que precisa

Antes de começar, certifique-se de que tem:
  • Um dispositivo SONOFF compatível com OpenEdge e com suporte para MQTT.
  • O Home Assistant está instalado e em execução.
  • Está instalado e em execução um broker MQTT .
  • A integração MQTT foi adicionada e ligada ao broker no Home Assistant. 

Instalar e configurar um broker MQTT

Se ainda não tiver um broker MQTT, uma opção comum para o Home Assistant é a aplicação oficial de broker MQTT Mosquitto.
Para o instalar no Home Assistant: 
  • Abra o Home Assistant.
  • Aceda a Definições → Aplicações (anteriormente designadas por suplementos) → Instalar aplicação.
  • Pesquise por broker Mosquitto e clique em INSTALAR.
  • Depois de instalado, inicie a aplicação de broker Mosquitto.
  • Recomenda-se ativar Iniciar no arranque e Watchdog, para que o broker seja iniciado automaticamente com o Home Assistant e possa ser reiniciado se parar inesperadamente.
  • Se necessário, crie um utilizador dedicado do Home Assistant para dispositivos MQTT em Definições → Pessoas → Utilizadores.

Para obter mais informações sobre como escolher e configurar um broker MQTT, consulte o guia oficial do Home Assistant para configurar um broker

Adicionar a integração MQTT no Home Assistant

  1. No Home Assistant, aceda a Definições → Dispositivos e serviços → Adicionar integração.
  2. Pesquise por MQTT e conclua a configuração.
  3. Aceda a Definições → Dispositivos e serviços → MQTT para confirmar que a integração está ligada ao seu broker.

Passo 1: Ligar o dispositivo

No MINI-1GSP, o dispositivo entra automaticamente no modo de emparelhamento na primeira ligação. Quando o LED apresentar dois flashes curtos seguidos de um flash longo, o hotspot AP está pronto para a configuração. 

Passo 2: Aceder à Consola Web OpenEdge

Existem duas formas de aceder à Consola Web.

Método 1: Aceder através do hotspot AP — recomendado para a configuração inicial

  • Abra as definições de Wi-Fi no seu computador, tablet ou dispositivo móvel.
  • Ligue-se ao hotspot do dispositivo: SONOFF_1GSP_xxxx.

  • Abra um navegador Web e aceda a: http://192.168.33.1
  • A página de início de sessão da Consola Web será aberta. Na primeira vez que lhe aceder, crie uma palavra-passe de início de sessão com pelo menos 8 caracteres.
    Inicie sessão para entrar na Consola Web OpenEdge.

Na consola Web, pode gerir funções locais, incluindo o controlo de LIGAR/DESLIGAR, dados históricos de energia, temporizadores, emparelhamento Matter, definições de rede, configuração de AP/Wi-Fi, atualizações OTA e a secção Sobre o OpenEdge.

Em Definições de conectividade, pode configurar a conectividade Cloud , o MQTT para o Home Assistant, as opções TLS e as ligações WebSocket de saída para plataformas de terceiros.  

Método 2: Aceder através da LAN

Se o dispositivo já estiver ligado à sua rede local, pode aceder diretamente à consola Web sem se ligar ao hotspot AP.  
Para o MINI-1GSP, abra um navegador num dispositivo que consiga aceder à mesma LAN e introduza uma das seguintes opções no navegador:

  • MINI-1GSP.local
  • o endereço IP local do dispositivo.

Passo 3: Ligar o dispositivo à sua rede Wi-Fi

Ligue o dispositivo a uma rede Wi-Fi que consiga alcançar tanto o Home Assistant como o seu broker MQTT, para que possam comunicar através da rede local.

  • Aceda a Definições de rede → Definições de Wi-Fi.
  • Selecione a rede Wi-Fi à qual pode aceder a partir do Home Assistant e do broker MQTT.
  • Introduza a palavra-passe do Wi-Fi.
  • Clique em Guardar.
  • Aguarde até que o dispositivo estabeleça ligação.

Quando o dispositivo se liga à sua rede local, o router atribui-lhe normalmente um endereço IP local através de DHCP. Este endereço é apresentado nas definições de Wi-Fi e pode ser utilizado posteriormente para aceder à consola Web através da LAN, conforme descrito no Método 2 acima.

Nota: Tempo limite do hotspot AP

O MINI-1GSP sai automaticamente do modo de emparelhamento após cerca de 10 minutos. Quando o modo de emparelhamento termina, o hotspot AP utilizado para a configuração inicial deixa de estar disponível.

Se o hotspot AP desaparecer antes de concluir a configuração:

  1. Se o dispositivo já estiver ligado à sua rede local, continue a configuração através do método de acesso pela LAN descrito acima.
  2. Se precisar de utilizar novamente o hotspot AP, prima continuamente o botão do dispositivo durante 5 segundos para voltar a entrar no modo de emparelhamento.
  3. Ligue-se novamente a SONOFF_1GSP_xxxx, abra http://192.168.33.1 e continue a configuração.

Sugestão: Premir continuamente o botão do dispositivo durante 10 segundos efetua uma reposição de fábrica.

Passo 4: Ativar o MQTT e configurar os parâmetros

  • Aceda a Definições de conectividade → MQTT.
  • Ativar MQTT.
  • Configure os parâmetros MQTT conforme apresentado abaixo
  • Quando concluir as definições, clique em Guardar.

Exemplo de configuração MQTT da consola Web do dispositivo:

Definição

O que introduzir

Servidor

Endereço e porta do broker MQTT, por exemplo 192.168.1.242:1883

Nome de utilizador

Nome de utilizador do broker MQTT

Palavra-passe

Palavra-passe do broker MQTT

Tipo de ligação

Selecione a opção TLS correspondente ao seu broker

Notificações do estado RPC através de MQTT

Ative ou desative conforme necessário


Sugestões:
  • O campo Servidor deve apontar para o seu broker MQTT. Se o Mosquitto Broker estiver a ser executado no mesmo anfitrião que o Home Assistant, este é normalmente o endereço IP do anfitrião do Home Assistant com a porta MQTT 1883, por exemplo: 192.168.1.242:1883. 
  • Se estiver a utilizar o Mosquitto Broker oficial do Home Assistant e não tiver criado credenciais MQTT separadas (nome de utilizador e palavra-passe), pode utilizar um nome de utilizador e uma palavra-passe do Home Assistant existentes.
  • Se o Mosquitto já estiver configurado com um nome de utilizador e uma palavra-passe, introduza o mesmo nome de utilizador e a mesma palavra-passe nas definições de MQTT da Consola Web do dispositivo.

Passo 5: Verificar e controlar o dispositivo no Home Assistant

  • Depois de guardar as definições de MQTT, volte a ligar o seu computador, tablet ou dispositivo móvel à rede local que consegue aceder ao Home Assistant e ao broker MQTT.
  • Abra o Home Assistant e aceda a Definições → Dispositivos e serviços → MQTT  

O dispositivo já deverá aparecer na lista de dispositivos MQTT. Os dispositivos SONOFF compatíveis com o OpenEdge e com suporte para MQTT publicam nativamente informações de descoberta MQTT do Home Assistant, permitindo que o Home Assistant adicione automaticamente o dispositivo e crie as entidades compatíveis, sem configuração manual de tópicos MQTT ou YAML.

  • Abra a página do dispositivo para consultar os controlos e as entidades disponíveis. No exemplo do MINI-1GSP, incluem funções como:
    • Controlo do relé
    • Corrente
    • Tensão
    • Potência
    • Frequência
    • Dados de energia

Pode então adicionar estas entidades ao painel do Home Assistant ou utilizá-las em automatizações e cenas.



Dispositivos compatíveis com o OpenEdge

O MINI-1GSP é o primeiro produto SONOFF compatível com o OpenEdge.
Em breve estarão disponíveis mais dispositivos compatíveis com o OpenEdge, incluindo:

  • MINI-1GP
  • MINI-1GS
  • MINI-1GS10

O OpenEdge também será gradualmente expandido para mais categorias de produtos SONOFF, incluindo:

  • Interruptores inteligentes — controlo local e integração mais flexíveis através de interfaces abertas.
  • Produtos de gestão de energia — processamento local de dados e monitorização de energia mais transparente.
  • Outros dispositivos inteligentes — ligação a mais plataformas e ecossistemas através das capacidades de integração aberta do OpenEdge.

Para consultar os dispositivos compatíveis mais recentes e as funcionalidades disponíveis após a integração com o Home Assistant, consulte a [Lista de suporte de funcionalidades do Home Assistant para dispositivos SONOFF OpenEdge].  



Conclusão

O SONOFF OpenEdge torna a integração com o Home Assistant mais simples, mais local e mais flexível. Através da Consola Web integrada e da API Local padronizada do OpenEdge sobre MQTT, os dispositivos SONOFF compatíveis podem ser configurados diretamente a partir de um navegador e integrados localmente com o Home Assistant — proporcionando uma configuração simples, um controlo local responsivo e uma automatização mais flexível, sem depender da nuvem para o processo de integração.



A ler a seguir

home assistant zigbee dongle
SONOFF OpenEdge Devices: Home Assistant Feature Support

Deixe um comentário

Todos os comentários são moderados antes de serem publicados.

Este site está protegido pela Política de privacidade da hCaptcha e da hCaptcha e aplicam-se os Termos de serviço das mesmas.