Skip to main content

​
MQTT

O MQTT e o protocolo padrão de comunicação IoT no Portal. Dispositivos que publicam e assinam tópicos MQTT podem ser integrados automaticamente.

​
Como Funciona

O Portal utiliza um broker EMQX para gerenciar todas as comunicações MQTT. Dispositivos compatveis com MQTT Discovery (formato Home Assistant) são descobertos automaticamente.

​
Configurar

1

Adicione a integração MQTT

Va em Configurações → Integrações → Adicionar → MQTT.
2

Configure o broker

Insira as credenciais do broker MQTT:
  • Host — Endereco do broker EMQX
  • Porta — 1883 (padrão) ou 8883 (SSL)
  • Usuário/Senha — Credenciais de acesso
3

Dispositivos se conectam

Dispositivos que publicam no formato MQTT Discovery serão descobertos automaticamente.

​
Componentes Suportados

ComponenteDescrição
binary_sensorSensores binarios (on/off)
sensorSensores de valores (temperatura, umidade)
switchInterruptores (liga/desliga)
lightLuminarias (brilho, cor)
coverCortinas e persianas (posição)
selectSeletores de opção
buttonBotões de ação
media_playerReprodutores de mídia
updateAtualizações de firmware

​
MQTT Discovery

O Portal implementa o protocolo de MQTT Discovery compatível com Home Assistant. Dispositivos que publicam payloads de configuração no formato padrão são registrados automaticamente.

​
Tópico de Descoberta

homeassistant/{componente}/{node_id}/{object_id}/config
O broker EMQX está disponível em localhost:1883 para desenvolvimento local. O dashboard do EMQX pode ser acessado em localhost:18083.
Se seu dispositivo não suporta MQTT Discovery, você pode pública manualmente os payloads de configuração para registra-lo.