> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unicontrol.me/llms.txt
> Use this file to discover all available pages before exploring further.

# MQTT

> Integre dispositivos IoT usando o protocolo MQTT via broker EMQX

# 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

<Steps>
  <Step title="Adicione a integração MQTT">
    Va em **Configurações → Integrações → Adicionar → MQTT**.
  </Step>

  <Step title="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
  </Step>

  <Step title="Dispositivos se conectam">
    Dispositivos que publicam no formato MQTT Discovery serão descobertos automaticamente.
  </Step>
</Steps>

## Componentes Suportados

| Componente      | Descrição                                  |
| --------------- | ------------------------------------------ |
| `binary_sensor` | Sensores binarios (on/off)                 |
| `sensor`        | Sensores de valores (temperatura, umidade) |
| `switch`        | Interruptores (liga/desliga)               |
| `light`         | Luminarias (brilho, cor)                   |
| `cover`         | Cortinas e persianas (posição)             |
| `select`        | Seletores de opção                         |
| `button`        | Botões de ação                             |
| `media_player`  | Reprodutores de mídia                      |
| `update`        | Atualizaçõ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
```

<Info>
  O broker EMQX está disponível em `localhost:1883` para desenvolvimento local. O dashboard do EMQX pode ser acessado em `localhost:18083`.
</Info>

<Tip>
  Se seu dispositivo não suporta MQTT Discovery, você pode pública manualmente os payloads de configuração para registra-lo.
</Tip>