Introdução
A SONOFF está apresentando o OpenEdge, uma arquitetura que prioriza o uso local para dispositivos inteligentes de próxima geração, desenvolvida para oferecer maior controle local, maior interoperabilidade e maneiras mais flexíveis de 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 os usuários do Home Assistant, isso significa 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.
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
- 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 opção 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.
Configure dispositivos OpenEdge com o Home Assistant via MQTT
Agora vamos configurar a integração MQTT. Este guia usa o SONOFF MINI-1GSP como exemplo, mas o mesmo fluxo básico pode ser usado para outros dispositivos OpenEdge compatíveis com suporte a MQTT.
O que você precisará
- 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.
Instale e configure um broker MQTT
- Abra o Home Assistant.
- Acesse Configurações → Aplicativos (anteriormente conhecidos como complementos) → Instalar aplicativo.
- Pesquise por broker Mosquitto e clique em INSTALAR.
- Após a instalação, inicie o aplicativo de broker Mosquitto.
- Recomenda-se habilitar Iniciar na inicialização 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 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.
Adicione a integração MQTT ao Home Assistant
- No Home Assistant, acesse Configurações → Dispositivos e serviços → Adicionar integração.
- Pesquise por MQTT e conclua a configuração.
- Acesse Configurações → Dispositivos e serviços → MQTT para confirmar que a integração está conectada ao seu broker.
Etapa 1: Ligue o dispositivo
No MINI-1GSP, o dispositivo entra automaticamente no modo de pareamento ao ser ligado pela primeira vez. Quando o LED emitir dois flashes curtos seguidos de um flash longo, o ponto de acesso Wi-Fi estará pronto para a configuração.
Etapa 2: Acesse o Console Web do OpenEdge
Há duas maneiras de acessar o Console Web.
Método 1: Acesso pelo ponto de acesso Wi-Fi — 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 da Web Console será aberta. Na primeira vez que acessá-la, crie uma senha de login com pelo menos 8 caracteres.
Web Console do OpenEdge.
Na Web Console, você pode gerenciar funções locais, incluindo controle de LIGADO/DESLIGADO, dados históricos de energia, temporizadores, pareamento 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 a Web Console diretamente, sem se conectar ao hotspot AP.
Para o MINI-1GSP, abra um navegador em um dispositivo que possa 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 possa alcançar tanto o Home Assistant quanto o 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.
- Digite a senha do Wi-Fi.
- Clique em Salvar.
- Aguarde até que o dispositivo se conecte.
Depois que o dispositivo se conecta à sua rede local, o roteador normalmente atribui 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 a Web Console via LAN, conforme descrito no Método 2 acima.
Observação: tempo limite do hotspot AP
O MINI-1GSP sai automaticamente do modo de pareamento após cerca de 10 minutos. Quando o modo de pareamento 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:
- Se o dispositivo já estiver conectado à sua rede local, continue a configuração pelo método de acesso via LAN descrito acima.
- Se precisar usar o hotspot AP novamente, mantenha o botão do dispositivo pressionado por 5 segundos para entrar novamente no modo de pareamento.
- 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 executa 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 de MQTT conforme mostrado abaixo
- Quando as configurações estiverem concluídas, clique em Salvar.
Exemplo de configuração de MQTT do Console Web do dispositivo:
|
Configuração |
O que inserir |
|
Servidor |
Endereço e porta do broker MQTT, por exemplo: |
|
Nome de usuário |
Nome de usuário do broker MQTT |
|
Senha |
Senha do broker MQTT |
|
Tipo de conexão |
Selecione a opção TLS correspondente ao seu broker |
|
Notificações de status de RPC via MQTT |
Ative ou desative conforme necessário |
- 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 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 de 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á deverá aparecer na lista de dispositivos MQTT. Os dispositivos SONOFF compatíveis com o OpenEdge e com suporte a 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 a necessidade de configurar manualmente tópicos MQTT ou YAML.
-
Abra a página do dispositivo para visualizar os controles e as entidades disponíveis. No exemplo do MINI-1GSP, elas incluem funções como:
- Controle do relé
- Corrente
- Tensão
- Potência
- Frequência
- Dados de energia
Em seguida, você poderá adicionar essas entidades ao painel do Home Assistant ou usá-las em automações e cenas.
Dispositivos compatíveis com o OpenEdge
Os seguintes produtos SONOFF são compatíveis atualmente com o OpenEdge:
Em breve, estarão disponíveis mais dispositivos compatíveis com o OpenEdge, incluindo:
- MINI-1GS
- MINI-1GS10
- ……
O OpenEdge também será gradualmente expandido para mais categorias de produtos SONOFF, incluindo:
- Interruptores inteligentes — permitindo um controle local mais flexível e integração por meio de interfaces abertas.
- Produtos de gerenciamento de energia — proporcionando 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 ver os dispositivos compatíveis mais recentes e os recursos disponíveis após a integração com o Home Assistant, consulte 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, mais local e mais 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.
Perguntas frequentes
P: O OpenEdge depende da nuvem?
Não necessariamente. O OpenEdge foi desenvolvido com uma arquitetura que prioriza o uso local, permitindo que dispositivos compatíveis sejam configurados, controlados e integrados por meio do Console Web local e da API Local padronizada pela rede local.
A conectividade com a nuvem não é necessária para esses recursos locais, mas continua disponível como um aprimoramento opcional para recursos e serviços que se beneficiam do acesso à nuvem.
P: Os dispositivos SONOFF OpenEdge podem funcionar com o Home Assistant quando a internet não está disponível?
Sim. Para a configuração do MQTT com o Home Assistant descrita neste guia, o dispositivo SONOFF, o broker MQTT e o Home Assistant devem permanecer acessíveis pela rede local.
Desde que a LAN e o broker MQTT permaneçam disponíveis, o dispositivo poderá continuar se comunicando localmente com o Home Assistant sem uma conexão ativa com a internet.
P: Preciso do aplicativo eWeLink ou de uma conta eWeLink para configurar o MQTT com o Home Assistant?
Não. Para a integração MQTT local descrita neste guia, você pode acessar diretamente o Console Web do OpenEdge pelo navegador, sem usar o aplicativo eWeLink ou uma conta eWeLink.
Para a configuração inicial, você pode acessar o Console Web pelo ponto de acesso Wi-Fi do dispositivo. Depois que o dispositivo se conectar à sua rede local, você também poderá acessá-lo pela LAN usando o nome de host local ou o endereço IP.
No Console Web, você pode configurar diretamente a rede do dispositivo e a conexão MQTT. A conectividade com a nuvem eWeLink continua disponível separadamente, caso você opte por utilizá-la.
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.