Como integrar dispositivos SONOFF OpenEdge ao Home Assistant via MQTT

Introdução

A SONOFF está apresentando o OpenEdge, uma arquitetura que prioriza o uso local para dispositivos inteligentes de última geração, projetada para oferecer mais controle local, maior interoperabilidade e mais flexibilidade para conectar seus dispositivos em diferentes plataformas e ecossistemas.

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

Para quem usa o Home Assistant, isso significa mais opções para integrar os 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 for mais adequada às suas necessidades.

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

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

A arquitetura básica é assim:

Dispositivo SONOFF com OpenEdge → Broker MQTT → Home Assistant

Perguntas frequentes sobre a integração MQTT com o Home Assistant

 

1. Como o MQTT conecta dispositivos SONOFF ao Home Assistant?

Os dispositivos SONOFF não se conectam diretamente ao Home Assistant. Em vez disso, eles se comunicam com o Home Assistant por meio de um Broker MQTT.

┌───────────────┐
│ Dispositivo SONOFF │
└───────┬───────┘
        │ MQTT
        ▼
┌───────────────┐
│ Broker MQTT │
└───────┬───────┘
        │ MQTT
        ▼
┌────────────────┐
│ Home Assistant │
└───────┬────────┘
        │ MQTT Discovery
        ▼
┌─────────────────┐
│ Dispositivo / Entidade │
└─────────────────┘

Portanto, o processo de integração pode ser dividido em quatro etapas:

① Dispositivo SONOFF → Broker MQTT

• Certifique-se de que o dispositivo SONOFF consiga se conectar ao Broker MQTT.

② Home Assistant → Broker MQTT

• Certifique-se de que o Home Assistant consiga se conectar ao Broker MQTT.

③ MQTT Discovery

• Certifique-se de que o Home Assistant consiga detectar o dispositivo SONOFF por meio do MQTT Discovery.

④ Entidade

• Certifique-se de que o Home Assistant crie as entidades corretamente e consiga controlar o dispositivo e ler seu status.

Observação: Quando um dispositivo SONOFF exibe “MQTT Connected”, isso significa apenas que o dispositivo se conectou com sucesso ao Broker MQTT. Isso não significa que o Home Assistant se conectou com sucesso ou detectou o dispositivo.

 

2. Etapa 1: Conectar o dispositivo SONOFF ao Broker MQTT

P1: “MQTT Connected” significa que meu dispositivo SONOFF se conectou com sucesso ao Home Assistant?

Não. “MQTT Connected” significa apenas que o dispositivo SONOFF se conectou com sucesso ao Broker MQTT.

Em geral, o dispositivo SONOFF não consegue determinar se o Home Assistant está online, se o Home Assistant está conectado ao broker ou se o dispositivo já foi descoberto.

O caminho completo de comunicação é:

Dispositivo SONOFF
     ↓
Broker MQTT        ✓
     ↓
Home Assistant     ?
     ↓
Descoberta MQTT     ?
     ↓
Entidade             ?

Se o dispositivo mostrar MQTT Connected , mas não aparecer no Home Assistant, continue com as etapas 2 e 3.

Q2: O que devo verificar se meu dispositivo SONOFF não consegue se conectar ao broker MQTT?

Verifique os itens a seguir em ordem:

1. Endereço do broker MQTT

• Verifique se o endereço do broker configurado no dispositivo SONOFF está correto.
  Por exemplo: 192.168.1.100

2. Porta MQTT

• As portas MQTT comumente usadas incluem: 

• Verifique se a porta configurada no dispositivo SONOFF corresponde à porta em que o broker MQTT está realmente escutando.

3. Nome de usuário e senha do MQTT

Se a autenticação estiver ativada no broker, verifique:

• Nome de usuário
• Senha
• Se a conta está desativada
• Se alguma permissão ACL restringe a conta

Se o nome de usuário ou a senha estiver incorreto, talvez o dispositivo SONOFF não consiga estabelecer uma conexão MQTT.

4. Conexão de rede

• Verifique se o dispositivo SONOFF consegue acessar o broker MQTT. Por exemplo:

Dispositivo SONOFF
192.168.1.50
     ↓
Broker MQTT
192.168.1.100:1883

Se você alterar as configurações, reinicie o Home Assistant ou recarregue a integração MQTT antes de verificar novamente.

3. Etapa 2: Conectar o Home Assistant ao broker MQTT

Q3: Meu dispositivo SONOFF mostra “MQTT Connected”, mas não aparece no Home Assistant. O que devo verificar?

Primeiro, verifique se o próprio Home Assistant se conectou com sucesso ao broker MQTT.

O dispositivo SONOFF e o Home Assistant são clientes MQTT independentes:

              Broker MQTT
             /           \
            /             \
   Dispositivo SONOFF           HA
        |                   |
    Conectado           Conectado?

Uma conexão bem-sucedida do dispositivo SONOFF não significa que o Home Assistant também esteja conectado ao broker MQTT.

Q4: Como posso verificar se o Home Assistant está conectado ao broker MQTT?

No Home Assistant, acesse: Configurações → Dispositivos e serviços → MQTT → Reconfigurar

Verifique se a configuração do broker MQTT está correta, incluindo:

• Endereço IP do broker
• Nome de usuário
• Senha

A interface web do Home Assistant geralmente usa a porta 8123. Ela é diferente da porta MQTT. Uma porta MQTT comumente usada é 1883.

Q5: O dispositivo SONOFF OpenEdge e o Home Assistant podem usar brokers MQTT diferentes?

Normalmente, a descoberta automática não funciona corretamente se eles usarem brokers MQTT diferentes. Por exemplo:

Dispositivo SONOFF
     ↓
Broker A

Home Assistant
     ↓
Broker B

Como os dois sistemas estão conectados a Brokers diferentes, o Home Assistant não consegue receber as mensagens MQTT publicadas pelo dispositivo SONOFF.

A configuração normal é:

Dispositivo SONOFF ─┐
         ↓
       Broker
         ↑
         │
Home Assistant

 

4. Etapa 3: descoberta MQTT

P6: O dispositivo OpenEdge e o Home Assistant estão conectados ao Broker MQTT, mas o dispositivo ainda não aparece no Home Assistant. O que devo fazer?

Neste ponto, verifique a Descoberta MQTT.

O dispositivo precisa fornecer informações sobre o dispositivo e as entidades ao Home Assistant por meio da descoberta MQTT.

• No Home Assistant, acesse: Configurações → Dispositivos e serviços → MQTT → Configurar → Configurar opções de MQTT
• Verifique se a Ativar descoberta está habilitada.
• Além disso, verifique se o Prefixo de descoberta está definido como o valor padrão: homeassistant

Se a descoberta estiver desativada, simplesmente ativá-la e salvar as configurações não fará com que o Home Assistant procure novamente os dispositivos MQTT já conectados.

Reinicie o Home Assistant ou clique em “Recarregar” na integração MQTT para que o Home Assistant possa se inscrever novamente no tópico de descoberta e identificar os dispositivos.

 

5. Problemas com o Prefixo de descoberta

P8: O que é o Prefixo de descoberta?

O Prefixo de descoberta é o prefixo do tópico usado pela descoberta MQTT do Home Assistant.

O Home Assistant usa o seguinte valor por padrão: homeassistant

P9: Alterar o Prefixo de descoberta do Home Assistant afetará a integração dos dispositivos OpenEdge?

Sim. Por exemplo, se o dispositivo usar o prefixo padrão: homeassistant

No entanto, se o Prefixo de descoberta do Home Assistant tiver sido alterado para: myhome

O Home Assistant escutará os tópicos de descoberta em: myhome/...

O caminho de comunicação seria assim:

Dispositivo
homeassistant/...
       ↓
    Broker
       ↓
Home Assistant
escuta myhome/...

Como os dois prefixos não correspondem, o Home Assistant não consegue descobrir o dispositivo corretamente.

Recomendação

• Mantenha o Prefixo de descoberta do Home Assistant definido como: homeassistant
• Não altere.
• Se o prefixo foi alterado anteriormente e isso fez com que o dispositivo ficasse indisponível, alterá-lo de volta para o valor padrão não removerá automaticamente as entidades antigas nem fará o dispositivo ser descoberto novamente.
• Nesse caso, reinicie o Home Assistant ou recarregue a integração MQTT. Se as entidades descobertas anteriormente ainda aparecerem como “Indisponível”, talvez seja necessário excluir as entidades antigas e redescobrir o dispositivo.

 

6. Problemas em ambientes de rede especiais

P11: Por que o MQTT funciona na minha rede local, mas para de funcionar quando mudo para uma rede externa?

Se o Broker MQTT estiver implantado apenas na sua rede local residencial:

Dispositivo SONOFF
     ↓
192.168.1.100:1883
     ↓
Rede local residencial

Quando o dispositivo sair dessa rede e estiver em outra rede local:

Dispositivo SONOFF
    x
192.168.1.100

Não será mais possível acessar o Broker pelo endereço IP da rede local.

Para acessar entre redes diferentes, considere:

• Broker MQTT com IP público

Observação de segurança: não é recomendado expor diretamente à Internet pública uma porta MQTT sem criptografia, como 1883.

 

7. Problemas comuns em ambientes Docker

P12: O Home Assistant está sendo executado no Docker. Por que não consegue se conectar ao Broker MQTT quando uso localhost:1883?

Se o Home Assistant e o Broker MQTT estiverem sendo executados em contêineres Docker diferentes, localhost geralmente se refere ao contêiner do Home Assistant, e não ao contêiner em que o Broker MQTT está sendo executado.

Por exemplo:

┌─────────────────────┐
│ Host Docker         │
│                     │
│ ┌───────────────┐   │
│ │ Home Assistant│   │
│ │ localhost     │   │
│ └───────────────┘   │
│                     │
│ ┌───────────────┐   │
│ │ Mosquitto     │   │
│ │ Porta 1883     │   │
│ └───────────────┘   │
│                     │
└─────────────────────┘

Portanto, informar localhost:1883 no Home Assistant não necessariamente conecta ao Mosquitto.

Configuração recomendada

Se você não conhece bem a configuração de redes Docker, recomendamos informar o endereço IP da rede local do host que executa o Broker MQTT. Por exemplo:

Broker MQTT:
192.168.1.100

Porta:
1883

Substitua 192.168.1.100 pelo endereço IP real do host que executa o Broker MQTT.

Se o Home Assistant e o Mosquitto estiverem conectados à mesma rede Docker, você também poderá usar o nome do contêiner Mosquitto, por exemplo: mosquitto:1883

Observação: Um nome de contêiner como mosquitto só pode ser usado dentro da rede Docker correspondente. Em geral, os dispositivos SONOFF devem usar o endereço IP ou o nome de domínio do host que executa o Broker MQTT, em vez do nome do contêiner Docker.

Depois de fazer alterações, reinicie o contêiner do Home Assistant ou recarregue a integração MQTT para aplicar a nova configuração.