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

# Dispositivos e Entidades

> Entenda a diferenca entre dispositivos, entidades e estados no Portal

# Dispositivos e Entidades

O Portal organiza seus equipamentos IoT em três níveis: **dispositivos**, **entidades** e **estados**.

## Hierarquia

```
Integracao (ex: Tuya)
  └── Dispositivo (ex: Lampada da Sala)
        ├── Entidade: light.tuya.sala_principal (luz)
        ├── Entidade: sensor.tuya.sala_temperatura (sensor)
        └── Entidade: switch.tuya.sala_led (interruptor)
```

### Dispositivo

Um **dispositivo** representa um equipamento físico (lâmpada, sensor, ar condicionado). Ele pertence a uma integração e pode ter multiplas entidades.

### Entidade

Uma **entidade** e uma funcionalidade específica de um dispositivo. Por exemplo, uma lâmpada pode ter uma entidade de luz (para ligar/desligar) e uma entidade de sensor (para temperatura de cor).

### Estado

Cada entidade possui um **estado** atual (ligado, desligado, 25°C, aberto, etc.) e **atributos** adicionais (brilho, modo, friendly\_name).

## Acessando Dispositivos

Para visualizar todos os seus dispositivos:

1. Va em **Configurações → Integrações**
2. Selecione uma integração
3. Clique em uma entrada de configuração para ver seus dispositivos

Ou acesse **Configurações → Dispositivos** para ver a lista completa.

<Info>
  Dispositivos são descobertos automaticamente quando você configura uma integração. Não e necessário cadastra-los manualmente.
</Info>