Product Guides

Como integrar dispositivos SONOFF OpenEdge ao Home Assistant via MQTT

How to Integrate SONOFF OpenEdge Devices with Home Assistant via MQTT


Introdução

A SONOFF está apresentando o OpenEdge, uma arquitetura que prioriza o uso local para dispositivos inteligentes de próxima geração, criada para oferecer maior controle local, interoperabilidade mais ampla e mais flexibilidade para conectar seus dispositivos a diferentes plataformas e ecossistemas.

Com o OpenEdge, os dispositivos SONOFF compatíveis podem se comunicar localmente por meio de interfaces abertas, incluindo HTTP, MQTT e WebSocket.

Para usuários do Home Assistant, isso significa ter mais opções para integrar seus dispositivos: você pode conectá-los localmente via MQTT quando preferir controle local e integração flexível com o ecossistema, enquanto a conectividade com a nuvem continua disponível quando atender melhor às suas necessidades.

Neste guia, você aprenderá a integrar dispositivos SONOFF compatíveis com OpenEdge ao Home Assistant via MQTT por meio de uma configuração detalhada passo a passo.




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

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

A arquitetura básica é a seguinte:

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

O dispositivo SONOFF não se conecta diretamente ao Home Assistant. Em vez disso, o dispositivo e o Home Assistant se conectam ao mesmo broker MQTT, que funciona como o hub de mensagens entre eles.
  • Dispositivo SONOFF compatível com OpenEdge — conecta-se ao broker como um cliente MQTT, publica estados e dados do dispositivo e recebe comandos de controle.
  • Broker MQTT — recebe e distribui mensagens MQTT entre os clientes conectados. Em configurações do Home Assistant, o Mosquitto é uma escolha comum.
  • Home Assistant — conecta-se ao mesmo broker por meio da integração MQTT, recebe atualizações do dispositivo, envia comandos e gerencia o dispositivo no Home Assistant.
Os dispositivos SONOFF compatíveis com OpenEdge e MQTT oferecem suporte nativo à descoberta de MQTT. Assim que o dispositivo se conecta ao broker, ele publica as informações necessárias para a descoberta, permitindo que o Home Assistant crie automaticamente o dispositivo compatível e suas entidades, sem a necessidade de configurar manualmente os tópicos MQTT ou escrever YAML.




Configure dispositivos OpenEdge com o Home Assistant via MQTT

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

O que você vai precisar

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

Instalar e configurar um broker MQTT

Se você ainda não tiver um broker MQTT, uma opção comum para o Home Assistant é o aplicativo de broker MQTT Mosquitto oficial.
Para instalá-lo no Home Assistant: 
  • Abra o Home Assistant.
  • Acesse Configurações → Aplicativos (anteriormente conhecidos como complementos) → Instalar aplicativo.
  • Pesquise por broker Mosquitto e clique em INSTALAR.
  • Depois de instalado, inicie o aplicativo de broker Mosquitto.
  • Recomenda-se ativar Iniciar na inicialização e Watchdog, para que o broker seja iniciado automaticamente com o Home Assistant e possa ser reiniciado caso pare inesperadamente.
  • Se necessário, crie um usuário dedicado do Home Assistant para dispositivos MQTT em Configurações → Pessoas → Usuários.

Para obter mais detalhes sobre como escolher e configurar um broker MQTT, consulte o guia oficial de configuração de um broker do Home Assistant. 

Adicionar a integração MQTT no Home Assistant

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

Etapa 1: Ligar o dispositivo

No MINI-1GSP, o dispositivo entra automaticamente no modo de pareamento na primeira inicialização. Quando o LED emitir dois flashes curtos seguidos de um flash longo, o ponto de acesso estará pronto para a configuração. 

Etapa 2: Acessar o Console Web OpenEdge

Há duas maneiras de acessar o Console Web.

Método 1: Acesso pelo ponto de acesso — recomendado para a primeira configuração

  • Abra as configurações de Wi-Fi no seu computador, tablet ou dispositivo móvel.
  • Conecte-se ao ponto de acesso do dispositivo: SONOFF_1GSP_xxxx.

  • Abra um navegador da web e acesse: http://192.168.33.1
  • A página de login do Console Web será aberta. Na primeira vez que você acessá-la, crie uma senha de login com pelo menos 8 caracteres.
    Faça login para acessar o Console Web OpenEdge.

No console web, você pode gerenciar funções locais, incluindo controle de LIGAR/DESLIGAR, dados históricos de energia, temporizadores, emparelhamento do Matter, configurações de rede, configuração de AP/Wi-Fi, atualizações OTA e Sobre o OpenEdge.

Em Configurações de conectividade, você pode configurar a conectividade com a nuvem , o MQTT para o Home Assistant, as opções de TLS e as conexões WebSocket de saída para plataformas de terceiros.  

Método 2: acesso via LAN

Se o dispositivo já estiver conectado à sua rede local, você poderá acessar o console web diretamente, sem se conectar ao hotspot AP.  
Para o MINI-1GSP, abra um navegador em um dispositivo que consiga acessar a mesma LAN e digite uma das opções a seguir no navegador:

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

Etapa 3: conecte o dispositivo à sua rede Wi-Fi

Conecte o dispositivo a uma rede Wi-Fi que alcance tanto o Home Assistant quanto o seu broker MQTT, para que eles possam se comunicar pela rede local.

  • Acesse Configurações de rede → Configurações de Wi-Fi.
  • Selecione a rede Wi-Fi à qual você pode acessar pelo Home Assistant e pelo broker MQTT.
  • Insira a senha do Wi-Fi.
  • Clique em Salvar.
  • Aguarde o dispositivo se conectar.

Assim que o dispositivo se conectar à sua rede local, o roteador normalmente atribuirá a ele um endereço IP local via DHCP. Esse endereço é exibido nas configurações de Wi-Fi e pode ser usado posteriormente para acessar o console web pela LAN, conforme descrito no Método 2 acima.

Observação: 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 usado na configuração inicial deixa de estar disponível.

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

  1. Se o dispositivo já estiver conectado à sua rede local, continue a configuração pelo método de acesso via LAN descrito acima.
  2. Se precisar usar o hotspot AP novamente, pressione e segure o botão do dispositivo por 5 segundos para entrar novamente no modo de emparelhamento.
  3. Reconecte-se a SONOFF_1GSP_xxxx, abra http://192.168.33.1 e continue a configuração.

Dica: pressionar e segurar o botão do dispositivo por 10 segundos realiza uma restauração de fábrica.

Etapa 4: ative o MQTT e configure os parâmetros

  • Acesse Configurações de conectividade → MQTT.
  • Ativar MQTT.
  • Configure os parâmetros do MQTT conforme mostrado abaixo
  • Quando terminar de configurar, clique em Salvar.

Exemplo de configuração do MQTT no console web do dispositivo:

Configuração

O que inserir

Servidor

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

Nome de usuário

Nome de usuário do broker MQTT

Senha

Senha do broker MQTT

Tipo de conexão

Selecione a opção de TLS correspondente ao seu broker

Notificações de status do RPC via MQTT

Ative ou desative conforme necessário


Dicas:
  • O campo Servidor deve apontar para o seu broker MQTT. Se o Mosquitto Broker estiver sendo executado no mesmo host que o Home Assistant, normalmente esse será o endereço IP do host do Home Assistant com a porta MQTT 1883, por exemplo: 192.168.1.242:1883. 
  • Se você estiver usando o Mosquitto Broker oficial do Home Assistant e ainda não tiver criado credenciais MQTT separadas (nome de usuário e senha), poderá usar um nome de usuário e uma senha existentes do Home Assistant.
  • Se o Mosquitto já estiver configurado com um nome de usuário e uma senha, insira o mesmo nome de usuário e a mesma senha nas configurações de MQTT do Console Web do dispositivo.

Etapa 5: verifique e controle o dispositivo no Home Assistant

  • Depois de salvar as configurações do MQTT, reconecte seu computador, tablet ou dispositivo móvel à rede local que pode acessar o Home Assistant e o broker MQTT.
  • Abra o Home Assistant e acesse Configurações → Dispositivos e serviços → MQTT  

O dispositivo já deve aparecer na lista de dispositivos MQTT. Os dispositivos SONOFF compatíveis com OpenEdge e com suporte a MQTT publicam nativamente informações do MQTT Discovery 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 ver os controles e as entidades disponíveis. No exemplo do MINI-1GSP, eles incluem funções como:
    • Controle do relé
    • Corrente
    • Tensão
    • Potência
    • Frequência
    • Dados de energia

Depois, você poderá adicionar essas entidades ao painel do Home Assistant ou usá-las em automações e cenas.



Dispositivos compatíveis com OpenEdge

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

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

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

  • Interruptores inteligentes — permitindo controle local e integração mais flexíveis por meio de interfaces abertas.
  • Produtos de gerenciamento de energia — oferecendo processamento local de dados e monitoramento de energia mais transparente.
  • Outros dispositivos inteligentes — conectando-se a mais plataformas e ecossistemas por meio dos recursos de integração aberta do OpenEdge.

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



Conclusão

O SONOFF OpenEdge torna a integração com o Home Assistant mais simples, local e flexível. Por meio do Console Web integrado e da API Local padronizada do OpenEdge via MQTT, os dispositivos SONOFF compatíveis podem ser configurados diretamente pelo navegador e integrados localmente ao Home Assistant — proporcionando uma configuração simples, controle local responsivo e automações mais flexíveis, sem depender da nuvem para o caminho de integração.



Continuar lendo

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

Deixar comentário

Os comentários precisam ser aprovados antes da publicação.

Este site é protegido por hCaptcha e a Política de privacidade e os Termos de serviço do hCaptcha se aplicam.