Como ligar dispositivos ao Home Assistant através de MQTT

Este guia usa o monitor de corrente trifásica WiFi PowerUC MCW02-E para explicar como criar um utilizador MQTT dedicado, configurar o MCW02-E, adicionar a integração MQTT ao Home Assistant e confirmar a descoberta automática do dispositivo.

1. Criar um utilizador MQTT no Home Assistant

Crie uma conta MQTT separada para o MCW02-E. Uma conta dedicada facilita a gestão do acesso e evita usar uma conta de administrador do Home Assistant no sensor.

1. Abra Definições no Home Assistant.
2. Aceda a Pessoas → Utilizadores e selecione Adicionar utilizador.
3. Introduza um nome, como esp32mqtt.
4. Ative Permitir início de sessão.
5. Defina o nome de utilizador e a palavra-passe. Use as mesmas credenciais mais tarde na página MQTT do MCW02-E.
6. Deixe Administrador desativado, a menos que exista um motivo específico para o ativar.
7. Clique em Guardar.

2. Configurar o servidor MQTT no MCW02-E

Abra a interface Web do MCW02-E introduzindo o respetivo endereço IP num navegador. Na secção MQTT, introduza o endereço do broker MQTT, e não o nome do serviço interno do Home Assistant.

1. Introduza o endereço do servidor MQTT e a porta 1883.
2. Introduza um tópico base único, como PowerUC/MCW02-E.
3. Introduza o nome de utilizador e a palavra-passe MQTT criados no passo 1.
4. Clique em Guardar.

3. Adicionar a integração MQTT ao Home Assistant

O Home Assistant tem de estar ligado ao mesmo broker MQTT usado pelo MCW02-E. Se a integração MQTT já estiver configurada, verifique o endereço do broker, a porta, o nome de utilizador e a palavra-passe antes de continuar.

1. Abra Definições → Dispositivos e serviços.
2. Clique em Adicionar integração.
3. Pesquise MQTT.
4. Selecione MQTT na lista de integrações.
5. Introduza o endereço do broker MQTT, a porta 1883 e as credenciais MQTT.
6. Envie o formulário e aguarde até a integração estabelecer ligação.

No complemento Mosquitto do Home Assistant, o endereço do broker apresentado dentro do Home Assistant pode ser core-mosquitto. Este endereço é diferente do que um dispositivo ESP32 externo normalmente usa. O MCW02-E deve usar o endereço IP do anfitrião do broker acessível na rede local.

4. Permitir que o Home Assistant descubra o MCW02-E

Depois de se ligar ao MQTT, o MCW02-E publica mensagens de configuração para a descoberta MQTT do Home Assistant. O Home Assistant pode então criar automaticamente o dispositivo e as respetivas entidades.

1. Volte a Definições → Dispositivos e serviços.
2. Aguarde a notificação do dispositivo MQTT descoberto ou abra a integração MQTT.
3. Selecione o dispositivo MCW02-E descoberto.
4. Defina a área do dispositivo, se necessário, e selecione Ignorar e terminar ou Terminar.
5. Abra a página do dispositivo e confirme que o fabricante é a PowerUC e que o modelo é o MCW02-E.

Verificação e resolução de problemas

• Página Web do MCW02-E: o estado MQTT deve apresentar Ligado: Sim.
• Home Assistant: o dispositivo deve aparecer na integração MQTT.
• Entidades: a tensão, a corrente, a potência estimada, a frequência, a temperatura, o RSSI e a RAM livre devem apresentar valores.
• Se nenhum dispositivo aparecer, verifique o IP do broker, a porta 1883, as credenciais MQTT, a rede WiFi e se a descoberta MQTT está ativada.
• Use um tópico base único para cada MCW02-E, para evitar que os dispositivos substituam o estado uns dos outros.

Exemplos de tópicos:

Depois de o dispositivo ser descoberto, adicione as entidades a um painel do Home Assistant para monitorizar os três canais de corrente e a potência estimada em tempo real.