Cadastrar dispositivo
Crie um device no painel IoT e obtenha o Access Token MQTT.
O que é um dispositivo
No CurtoLab, um dispositivo é qualquer coisa que envia ou recebe telemetria: ESP32, Raspberry Pi, gateway industrial, sensor com bateria, app móvel, etc. Cada device tem credenciais MQTT/HTTP próprias e pertence a um perfil (que define como os dados são validados e processados).
Passo a passo
1. Acesse Dispositivos
No painel IoT (clique "Abrir painel IoT" no dashboard), use o menu lateral: Entidades → Dispositivos.
2. Adicione novo
Botão + no canto superior direito → "Adicionar novo dispositivo".
Campos:
| Campo | Obrigatório | Dica |
|---|---|---|
| Nome | Sim | Use um padrão consistente: <tipo>-<local>-<id>, ex. esp32-sala-01. |
| Etiqueta | Não | Texto livre pra display em widgets ("Sala da Reunião"). |
| Perfil | Sim | default serve pro começo. Depois você pode criar perfis customizados por tipo de sensor. |
| É gateway? | Não | Marque se for um device que retransmite dados de outros (ex. gateway Modbus, LoRaWAN). Configurações específicas no painel IoT, em Entidades → Gateways. |
| Cliente | Não | Atribua a um dos seus clientes. Sem isso, o device fica visível só pra você (o tenant admin). |
3. Copie o Access Token
Depois de criar, clique no device → aba Detalhes → seção "Credenciais" → botão "Copiar Access Token".
Esse token é a senha MQTT do device. Trate como segredo — quem tiver ele consegue publicar como esse device.
Tipos de credencial
Por default o device usa Access Token (mais simples). TB também aceita:
- Basic MQTT — username + password (ex. integração com sistemas legados)
- X.509 — certificado mTLS (mais seguro, usado em deploys industriais)
- LWM2M — pra devices NB-IoT/LTE-M
Pra trocar: device → Detalhes → "Editar credenciais" → escolha o tipo.
Atribuindo a um cliente
Se você revende a infra (ex. operador IoT pra terceiros), atribua devices a sub-clientes:
- Cadastre o cliente em Clientes → +
- No device → menu "⋮" → "Atribuir a cliente"
- Escolha o cliente. Agora só ele e você (admin) veem esse device.
Mais em Clientes (multi-tenancy).
Próximos passos
- Conectar via MQTT — enviar telemetria
- Exemplo ESP32 + Arduino — código pronto
- Regras de alarme — monitoramento