> For the complete documentation index, see [llms.txt](https://docs.kiloiot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kiloiot.io/kilo-docs-pt/kilo-iot-server/devices/mioty-devices.md).
# Dispositivos MIOTY
Comissione um endpoint MIOTY no Kilo IoT — End Point EUI, endereço curto, chave de sessão de rede e contadores.
Um endpoint MIOTY registado no Kilo IoT Server torna-se um Digital Twin, tal como qualquer outro dispositivo — uma representação digital persistente da sua identidade, configuração, histórico de telemetria e estado. O que é específico do MIOTY é o conjunto de parâmetros que descrevem como o endpoint chega às suas estações base, e o material de segurança que permite ao centro de serviços confiar nele.
Esta página cobre os campos específicos do MIOTY no formulário do dispositivo. O fluxo de registo em torno disto — dar nome ao dispositivo, o separador Métricas, o separador Registos, guardar — é o fluxo partilhado documentado em [Registar Dispositivos](/kilo-docs-pt/kilo-iot-server/devices/registering-devices.md).
## Pré-requisitos
* **Um conetor Mioty.** Sem ele, os campos MIOTY ficam indisponíveis e o formulário apresenta **"Crie primeiro um conetor Mioty"**. Ver [Conetor MIOTY](/kilo-docs-pt/kilo-iot-server/connectors/mioty-connector.md).
* **Pelo menos uma estação base online.** Os endpoints ligam-se através de estações base. Ver [Estações base MIOTY](/kilo-docs-pt/kilo-iot-server/gateways/mioty-base-stations.md).
* **Credenciais do endpoint do fabricante** — o End Point EUI e a Network Session Key, normalmente na etiqueta da unidade ou num ficheiro de provisionamento fornecido.
## Selecionar o conetor
No formulário do dispositivo, selecione o conetor Mioty como tipo de conetor. O formulário apresenta então as secções de parâmetros MIOTY descritas abaixo.
## Básico
* **End Point EUI** — o identificador único do endpoint, exatamente 16 caracteres hexadecimais. Este é o endereço pelo qual a rede conhece a unidade. Um valor que não tenha 16 caracteres hexadecimais é rejeitado.
## Rede
Estes campos descrevem como o endpoint transmite os seus telegramas pelo ar.
* **Endereço Curto** — o identificador compacto que o endpoint usa no enlace rádio, introduzido em hexadecimal. Os valores válidos vão de **0001** para **FFFF**; zero não é um endereço curto válido e será rejeitado. Atribua endereços curtos deliberadamente em todo o local, em vez de ao acaso — um esquema ligado a zona ou linha torna uma implementação em grande escala muito mais fácil de compreender mais tarde.
* **Desvio da portadora** — opcional. Desloca a portadora do endpoint dentro da banda. Defina-o quando os dados de comissionamento do fabricante ou o plano de frequências do seu local o exigirem; caso contrário, deixe-o inalterado.
* **Type EUI** — apenas leitura. É preenchido a partir do blueprint que selecionar ou criar para o dispositivo e identifica o tipo de payload do endpoint. Não o introduz manualmente. Ver [Blueprints MIOTY](/kilo-docs-pt/kilo-iot-server/devices/mioty-blueprints.md).
## Comunicação
* **BiDi** — comunicação bidirecional. Ative-a para endpoints que tenham de receber bem como transmitir.
* **PreAtt** — pré-anexação. Ative-a quando o endpoint for provisionado para se anexar antes do seu primeiro uplink.
Ambas as definições são propriedades de como a unidade está configurada e especificadas pelo fabricante. Ajuste o formulário ao hardware em vez de escolher preferências aqui.
## MIOTY avançado
Estes parâmetros ajustam o comportamento rádio do endpoint e existem para implementações que deles precisam. Defina-os para corresponder à configuração do próprio endpoint:
* **Canal duplo**
* **Repetição DL** — repetição de downlink
* **Desvio amplo da portadora**
* **Longa distância entre blocos**
Se a sua ficha de comissionamento não mencionar um parâmetro, o endpoint não o está a utilizar — deixe-o no valor predefinido. Estes são ajustes para ambientes RF difíceis, não definições para experimentar numa frota em funcionamento.
## Contadores
* **Último pacote** — a posição do contador de pacotes.
* **Anexar** — o contador de anexação.
Ambos são **0** para um novo dispositivo. Existem para que um registo de dispositivo possa ser alinhado com um endpoint que já tem histórico — por exemplo, quando está a migrar uma unidade que já estava a funcionar noutro local. Para uma unidade nova, deixe-os em zero.
Alinhar os contadores sincroniza o *registo*. Isso não move o endpoint para a sua rede. Um endpoint MIOTY liga-se a uma rede de cada vez, e uma unidade que estava a funcionar noutro centro de serviços continua ligada lá — não aparecerá sob as suas estações base só porque criou um registo de dispositivo para ela. Reinicie o endpoint para que se volte a anexar, seguindo o procedimento do fabricante para o seu modelo. Assim que uma estação base o detetar, o **Ligação** separador passa para *Rede alcançada — à espera de dados*. Ver [Diagnóstico do dispositivo](/kilo-docs-pt/kilo-iot-server/devices/device-diagnostics.md) para ver como esse ciclo de vida aparece na plataforma.
## Segurança
* **Chave de sessão de rede** — obrigatório. Exatamente 32 caracteres hexadecimais. Esta é a chave que protege a ligação do endpoint à rede; sem uma válida o dispositivo não pode ser guardado.
* **Chave da aplicação** — opcional. Forneça-a quando o payload do endpoint estiver encriptado pela aplicação.
### Adicionar ao Cofre
As credenciais do endpoint acabam por vezes fora do alcance — numa etiqueta numa unidade que agora está selada dentro de um invólucro num suporte de tubagem. Clique **Adicionar ao Cofre** no formulário do dispositivo para guardar o par End Point EUI e Chave de sessão de rede no Key Vault, onde podem ser recuperados independentemente do hardware e do autocolante.
Faça-o durante o comissionamento, enquanto as credenciais ainda estão à sua frente. Recuperar uma unidade cuja Chave de sessão de rede já não tem arquivada significa abrir o invólucro — e alguns fabricantes só devolvem a chave através de uma ligação por cabo, se é que a devolvem. Ver [Cofre de Chaves](/kilo-docs-pt/kilo-iot-server/reports/key-vault.md).
## Validação — o que impede um guardar
O formulário não será guardado até que estes se verifiquem:
| Campo | Requisito | O que vê se falhar |
| --------------------------- | -------------------------------------------------- | -------------------------------------------------------------- |
| **End Point EUI** | Exatamente 16 caracteres hexadecimais | O campo indica que o EUI tem de ter 16 caracteres hexadecimais |
| **Endereço Curto** | Hexadecimal, no intervalo **0001**–**FFFF** | O campo é rejeitado; zero não é válido |
| **Chave de sessão de rede** | Exatamente 32 caracteres hexadecimais, obrigatório | O dispositivo não pode ser guardado |
Registar um identificador que já existe na sua organização devolve **"Já existe uma estação base com este EUI"**.
## Decodificação da telemetria
A telemetria de um endpoint MIOTY é **não é decodificada até ser selecionado um blueprint para ele**. Até lá, o dispositivo está registado e anexado, mas os seus payloads não são convertidos em medições nomeadas — o que significa que nada utilizável chega a dashboards, regras ou histórico.
A Configuração de Blueprint vive no mesmo formulário do dispositivo. Pode escolher um blueprint existente do catálogo ou criar um novo a partir de JSON, e a escolha é copiada para o dispositivo como a sua própria captura independente. Esse modelo de captura é o que torna seguro alterar modelos do catálogo numa frota em produção. Ver [Blueprints MIOTY](/kilo-docs-pt/kilo-iot-server/devices/mioty-blueprints.md).
## O que vem a seguir
* **Associar um modelo** para que os payloads do endpoint sejam decodificados em campos nomeados. Ver [Blueprints MIOTY](/kilo-docs-pt/kilo-iot-server/devices/mioty-blueprints.md).
* **Mapear métricas** para normalizar campos decodificados entre fabricantes. Ver [Métricas](/kilo-docs-pt/kilo-iot-server/devices/metric-templates.md).
* **Conclua o fluxo de registo partilhado** — informações do dispositivo, Métricas, Registos. Ver [Registar Dispositivos](/kilo-docs-pt/kilo-iot-server/devices/registering-devices.md).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.kiloiot.io/kilo-docs-pt/kilo-iot-server/devices/mioty-devices.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
