> ## 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.

# Estados

> Entenda como o Portal rastreia o estado dos seus dispositivos em tempo real

# Estados

O Portal rastreia o **estado atual** de todas as entidades em tempo real via conexão WebSocket e MQTT.

## O que e um Estado

Um estado e o valor atual de uma entidade em um determinado momento. Exemplos:

| Entidade              | Estado | Atributos                            |
| --------------------- | ------ | ------------------------------------ |
| `light.sala`          | `on`   | brightness: 80, color\_temp: 350     |
| `sensor.temperatura`  | `24.5` | unit: °C, device\_class: temperature |
| `cover.cortina`       | `open` | position: 75                         |
| `binary_sensor.porta` | `off`  | device\_class: door                  |

## Atributos

Além do estado principal, cada entidade pode ter **atributos** adicionais:

* `friendly_name` — Nome amigável para exibição
* `unit_of_measurement` — Unidade de medida (°C, %, W)
* `device_class` — Classe do dispositivo (temperature, humidity, motion)
* Atributos específicos da plataforma (brightness, position, fan\_mode, etc.)

## Atualização em Tempo Real

Os estados são atualizados automaticamente via:

* **MQTT** — Dispositivos publicam alterações no broker
* **Workers** — Workers de integração fazem polling periódico
* **Webhooks** — Dispositivos enviam eventos diretamente

<Info>
  O painel de **Atividade** mostra o histórico de mudanças de estado. Acesse pelo menu lateral para acompanhar o que aconteceu nos seus dispositivos.
</Info>