> 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-es/kilo-iot-server/devices/mioty-devices.md).
# Dispositivos MIOTY
Pone en servicio un endpoint MIOTY en Kilo IoT — EUI del End Point, dirección corta, clave de sesión de red y contadores.
Un endpoint MIOTY registrado en Kilo IoT Server se convierte en un Gemelo Digital como cualquier otro dispositivo: una representación digital persistente de su identidad, configuración, historial de telemetría y estado. Lo específico de MIOTY es el conjunto de parámetros que describen cómo el endpoint llega a sus estaciones base, y el material de seguridad que permite al centro de servicio confiar en él.
Esta página cubre los campos específicos de MIOTY en el formulario del dispositivo. El flujo de registro circundante — nombrar el dispositivo, la pestaña Metrics, la pestaña Logs, guardar — es el flujo compartido documentado en [Registro de dispositivos](/kilo-docs-es/kilo-iot-server/devices/registering-devices.md).
## Requisitos previos
* **Un conector Mioty.** Sin él, los campos MIOTY no están disponibles y el formulario informa **"Primero cree un conector Mioty"**. Véase [Conector MIOTY](/kilo-docs-es/kilo-iot-server/connectors/mioty-connector.md).
* **Al menos una estación base en línea.** Los endpoints se conectan a través de estaciones base. Véase [estaciones base MIOTY](/kilo-docs-es/kilo-iot-server/gateways/mioty-base-stations.md).
* **Credenciales del endpoint del fabricante** — el EUI del endpoint y la clave de sesión de red, normalmente en la etiqueta de la unidad o en un archivo de aprovisionamiento enviado con el dispositivo.
## Selección del conector
En el formulario del dispositivo, seleccione el conector Mioty como tipo de conector. El formulario muestra entonces las secciones de parámetros MIOTY descritas a continuación.
## Básico
* **EUI del endpoint** — el identificador único del endpoint, exactamente 16 caracteres hexadecimales. Esta es la dirección por la que la red conoce la unidad. Se rechaza un valor que no tenga 16 caracteres hexadecimales.
## Red
Estos campos describen cómo el endpoint emite sus telegramas por el aire.
* **Dirección corta** — el identificador compacto que el endpoint usa en el enlace de radio, introducido en hexadecimal. Los valores válidos van desde **0001** en **FFFF**; cero no es una dirección corta válida y será rechazado. Asigne las direcciones cortas deliberadamente en todo un sitio en lugar de al azar — un esquema vinculado a una zona o línea hace que luego sea mucho más fácil razonar sobre una implantación grande.
* **Desplazamiento de portadora** — opcional. Desplaza la portadora del endpoint dentro de la banda. Configúrelo cuando los datos de puesta en servicio del fabricante o el plan de frecuencias de su sitio lo requieran; de lo contrario, déjelo como está.
* **EUI de tipo** — solo lectura. Se completa a partir del blueprint que seleccione o cree para el dispositivo, e identifica el tipo de carga útil del endpoint. No se introduce manualmente. Véase [Plantillas MIOTY](/kilo-docs-es/kilo-iot-server/devices/mioty-blueprints.md).
## Comunicación
* **BiDi** — comunicación bidireccional. Actívela para los endpoints que deban recibir además de transmitir.
* **PreAtt** — preadjunción. Actívelo cuando el endpoint se aprovisiona para adjuntarse antes de su primer uplink.
Ambas configuraciones son propiedades de cómo se configura y especifica la unidad por el fabricante. Ajuste el formulario al hardware en lugar de elegir preferencias aquí.
## MIOTY avanzado
Estos parámetros ajustan el comportamiento de radio del endpoint y existen para las implementaciones que los necesitan. Configúrelos para que coincidan con la propia configuración del endpoint:
* **Doble canal**
* **Repetición DL** — repetición de enlace descendente
* **Desplazamiento de portadora amplio**
* **Gran distancia entre bloques**
Si su hoja de puesta en servicio no menciona un parámetro, el endpoint no lo está usando — déjelo en su valor predeterminado. Son palancas para entornos de RF difíciles, no ajustes para experimentar en una flota en funcionamiento.
## Contadores
* **Último paquete** — la posición del contador de paquetes.
* **Adjunción** — el contador de adjunción.
Ambos son **0** para un dispositivo nuevo. Existen para que el registro de un dispositivo pueda alinearse con un endpoint que ya tiene historial — por ejemplo, cuando está migrando una unidad que ha estado funcionando en otro lugar. Para una unidad recién salida de la caja, déjelos en cero.
Alinear los contadores alinea el *registro*. No mueve el endpoint a su red. Un endpoint MIOTY se adjunta a una red a la vez, y una unidad que estaba funcionando en otro centro de servicio sigue adjunta allí — no aparecerá bajo sus estaciones base porque creó un registro de dispositivo para ella. Reinicie el endpoint para que se vuelva a adjuntar, siguiendo el procedimiento del fabricante para su modelo. Una vez que una estación base lo detecte, la **Conexión** pestaña del dispositivo pasa a *Se alcanzó la red — esperando datos*. Véase [y lee el estado de recepción — informa de si el dispositivo ha llegado a la red, de si se están recibiendo mensajes y de si se están almacenando los valores que contienen, con el siguiente paso específico para cada caso. Consulta](/kilo-docs-es/kilo-iot-server/devices/device-diagnostics.md) para saber cómo se refleja ese ciclo de vida en la plataforma.
## Seguridad
* **Clave de sesión de red** — requerida. Exactamente 32 caracteres hexadecimales. Esta es la clave que protege el enlace del endpoint con la red; sin una válida, el dispositivo no puede guardarse.
* **Clave de aplicación** — opcional. Proporciónela cuando la carga útil del endpoint esté cifrada por la aplicación.
### Añadir al almacén de claves
Las credenciales del endpoint a veces acaban fuera de alcance — en una etiqueta de una unidad que ahora está sellada dentro de un recinto en un bastidor de tuberías. Haga clic en **Añadir al almacén de claves** en el formulario del dispositivo para almacenar la pareja EUI del endpoint y clave de sesión de red en Key Vault, donde pueden recuperarse de forma independiente del hardware y la etiqueta.
Hágalo durante la puesta en servicio, mientras las credenciales aún están delante de usted. Recuperar una unidad cuya clave de sesión de red ya no tiene archivada significa abrir la carcasa — y algunos fabricantes solo devuelven la clave por una conexión cableada, si es que la devuelven. Véase [Key Vault](/kilo-docs-es/kilo-iot-server/reports/key-vault.md).
## Validación — qué bloquea un guardado
El formulario no se guardará hasta que se cumpla lo siguiente:
| Campo | Requisito | Lo que ve si falla |
| -------------------------- | -------------------------------------------------- | ------------------------------------------------------------------ |
| **EUI del endpoint** | Exactamente 16 caracteres hexadecimales | El campo informa que el EUI debe tener 16 caracteres hexadecimales |
| **Dirección corta** | Hexadecimal, en el rango **0001**–**FFFF** | El campo se rechaza; cero no es válido |
| **Clave de sesión de red** | Exactamente 32 caracteres hexadecimales, requerido | No se puede guardar el dispositivo |
Registrar un identificador que ya existe en su organización devuelve **"Ya existe una estación base con este EUI"**.
## Decodificación de la telemetría
La telemetría de un endpoint MIOTY **no se decodifica hasta que se le selecciona una plantilla**. Hasta entonces el dispositivo está registrado y adjunto, pero sus cargas útiles no se convierten en mediciones con nombre — lo que significa que nada utilizable llega a paneles, reglas ni historial.
La configuración del blueprint vive en el mismo formulario del dispositivo. Puede elegir una plantilla existente del catálogo o crear una nueva a partir de JSON, y la elección se copia al dispositivo como su propia instantánea independiente. Ese modelo de instantánea es lo que hace seguro cambiar plantillas del catálogo en una flota de producción. Véase [Plantillas MIOTY](/kilo-docs-es/kilo-iot-server/devices/mioty-blueprints.md).
## Qué sigue
* **Vincular una plantilla** para que las cargas útiles del endpoint se decodifiquen en campos con nombre. Véase [Plantillas MIOTY](/kilo-docs-es/kilo-iot-server/devices/mioty-blueprints.md).
* **Mapear métricas** para normalizar los campos decodificados entre fabricantes. Véase [Métricas](/kilo-docs-es/kilo-iot-server/devices/metric-templates.md).
* **Complete el flujo de registro compartido** — información del dispositivo, Metrics, Logs. Véase [Registro de dispositivos](/kilo-docs-es/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-es/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.
