Skip to main content

​
MQTT

O MQTT e o protocolo padrao de comunicacao IoT no Portal. Dispositivos que publicam e assinam topicos MQTT podem ser integrados automaticamente.

​
Como Funciona

O Portal utiliza um broker EMQX para gerenciar todas as comunicacoes MQTT. Dispositivos compatveis com MQTT Discovery (formato Home Assistant) sao descobertos automaticamente.

​
Configurar

1

Adicione a integracao MQTT

Va em Configuracoes → Integracoes → Adicionar → MQTT.
2

Configure o broker

Insira as credenciais do broker MQTT:
  • Host — Endereco do broker EMQX
  • Porta — 1883 (padrao) ou 8883 (SSL)
  • Usuario/Senha — Credenciais de acesso
3

Dispositivos se conectam

Dispositivos que publicam no formato MQTT Discovery serao descobertos automaticamente.

​
Componentes Suportados

ComponenteDescricao
binary_sensorSensores binarios (on/off)
sensorSensores de valores (temperatura, umidade)
switchInterruptores (liga/desliga)
lightLuminarias (brilho, cor)
coverCortinas e persianas (posicao)
selectSeletores de opcao
buttonBotoes de acao
media_playerReprodutores de midia
updateAtualizacoes de firmware

​
MQTT Discovery

O Portal implementa o protocolo de MQTT Discovery compativel com Home Assistant. Dispositivos que publicam payloads de configuracao no formato padrao sao registrados automaticamente.

​
Topico de Descoberta

homeassistant/{componente}/{node_id}/{object_id}/config
O broker EMQX esta disponivel em localhost:1883 para desenvolvimento local. O dashboard do EMQX pode ser acessado em localhost:18083.
Se seu dispositivo nao suporta MQTT Discovery, voce pode publica manualmente os payloads de configuracao para registra-lo.