> 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-blueprints.md).
# Planos MIOTY
Decodifica cargas útiles MIOTY en Kilo IoT con planos — catálogo del sistema frente a personalizado e instantáneas por dispositivo.
Una plantilla es la especificación del decodificador para un extremo MIOTY: un documento JSON, vinculado a un `typeEui`, que indica al Kilo IoT Server cómo convertir una carga útil sin procesar en campos con nombre. La telemetría de un dispositivo MIOTY no se decodifica hasta que se le selecciona una plantilla; por eso vincular una plantilla es lo que convierte un extremo registrado en un dispositivo que produce datos utilizables.
Las plantillas se organizan como un catálogo: **Fabricante → Modelo de dispositivo → Plantilla**. Un fabricante contiene sus modelos; un modelo contiene sus versiones de plantilla. La Configuración de plantilla en el formulario del dispositivo es donde eliges de ese catálogo o creas una nueva entrada.
## La idea más importante: instantáneas por dispositivo
Cuando seleccionas una plantilla para un dispositivo, esta se **copia en ese dispositivo como una instantánea independiente**.
El dispositivo no es un puntero en vivo al catálogo. Lleva su propia copia del decodificador. Lo que significa:
* **Editar una plantilla del catálogo no cambia los dispositivos ya vinculados a ella.** Siguen funcionando con la copia con la que fueron comisionados.
* **Eliminar una entrada del catálogo no rompe los dispositivos que ya la usan.** Siguen decodificando con su instantánea; la entrada simplemente desaparece del catálogo y ya no puede elegirse para nuevos dispositivos.
* **Dos dispositivos del mismo modelo pueden ejecutar plantillas diferentes.** Un lote piloto con un decodificador corregido y una flota de producción con el probado es un estado normal, no un conflicto.
* **Una nueva versión llega a un dispositivo solo cuando la aplicas explícitamente.** Nada de una edición del catálogo se propaga por sí solo.
Este es el mismo modelo que la plataforma usa para los códecs LoRaWAN, y existe por una razón concreta: en una flota de varios miles de terminales, una edición accidental del decodificador que reescribiera silenciosamente cómo cada unidad interpretaba su carga útil sería una interrupción que descubrirías a través de tus paneles. El límite de la instantánea significa que el trabajo en el catálogo y el comportamiento en producción son asuntos separados. Mejoras una plantilla libremente; la despliegas según tu calendario.
## Catálogos del sistema y personalizados
El catálogo se divide en dos, y nunca se mezclan en una misma lista — cambias entre ellos.
| Catálogo | Quién puede verlo y usarlo | Quién puede cambiarlo |
| ----------------- | -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| **Sistema** | Todos — fabricantes, modelos y plantillas pueden ser usados por cualquier organización | Solo administradores. Crear, editar y eliminar entradas del Sistema requiere un administrador. |
| **Personalizado** | Tu organización | Para que la administres libremente — crea, edita y elimina sin restricciones |
Usar una plantilla del Sistema en un dispositivo crea **solo la instantánea en ese dispositivo**. No se copia nada en tu catálogo Personalizado, y tu catálogo Personalizado se mantiene exactamente como lo construiste.
La división práctica: el Sistema cubre el hardware que la plataforma ya conoce. Personalizado es donde viven tus propios decodificadores, tus variantes específicas del proveedor y tus correcciones de revisiones de firmware.
## Usar una plantilla existente
Este es el camino para el hardware que el catálogo ya cubre.
1. En el formulario del dispositivo, busca **Configuración de plantilla**.
2. Activa **Usar plantilla existente** **ACTIVADO**.
3. Selecciona el catálogo — **Sistema** o **Personalizado**.
4. Selecciona el **Fabricante**.
5. Selecciona el **Modelo de dispositivo**. La lista se reduce a los modelos de ese fabricante.
6. Selecciona el **Versión de la plantilla**.
La especificación del decodificador se muestra en modo de solo lectura para revisarla, y el **EUI de tipo** se rellena automáticamente en el formulario del dispositivo y no es editable — proviene de la plantilla. Guarda el dispositivo y la plantilla se copia como instantánea en él.
Una vez que eso ocurre, el dispositivo se etiqueta como **Instantánea fijada**, para que puedas ver de un vistazo que lo que estás leyendo pertenece a este dispositivo y no a la entrada compartida del catálogo. Si la plantilla del catálogo de la que se copió se ha eliminado desde entonces, la etiqueta dice **Instantánea fijada (plantilla de origen eliminada)** — el dispositivo no se ve afectado y sigue decodificando con su propia copia, pero la etiqueta te indica que ya no hay una entrada del catálogo detrás para compararla.
La **la primera plantilla creada para un modelo se convierte en la predeterminada para los nuevos dispositivos de ese modelo** — así que, una vez que un modelo está configurado correctamente, poner en marcha el resto de la flota es cuestión de seleccionar el modelo.
## Crear una nueva plantilla
Sigue este camino cuando el catálogo no cubra tu hardware o cuando una revisión de firmware se decodifique de forma diferente a la entrada existente.
1. Activa **Usar plantilla existente** **DESACTIVADO**.
2. **Fabricante** — selecciona una existente o haz clic en **+ Añadir nuevo fabricante** y asígnale un nombre.
3. **Nuevo modelo de dispositivo** — introduce el nombre del modelo. Si duplica un modelo existente, el formulario lo marcará — comprueba si en realidad quieres añadir una versión a ese modelo en su lugar.
4. **versión de la plantilla** — introduce una versión, por ejemplo `1.0.0`. La versión debe elegirse deliberadamente, no por accidente; esta cadena es lo que tu equipo usará para distinguir dos decodificadores dentro de un año.
5. **JSON de la plantilla** — pega la especificación del decodificador. Debe ser JSON válido y debe contener un `typeEui` de exactamente 16 caracteres hexadecimales.
6. Cuando la especificación es válida, una ayuda muestra el valor analizado — **"Type EUI: …"** — confirmando a qué quedará vinculado el dispositivo.
7. Haz clic en **Guardar plantilla**. Un aviso emergente confirma *"Plantilla creada"*, y el nuevo modelo, la versión y el Type EUI se completan en el formulario del dispositivo.
### Mensajes de validación
| Mensaje | Qué significa |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **"La especificación de la plantilla debe ser JSON válido"** | El texto pegado no se puede analizar. Busca una coma final, un pegado truncado o comillas tipográficas de un documento. |
| **"typeEui debe tener 16 caracteres hexadecimales"** | La `typeEui` el campo está presente pero no tiene exactamente 16 caracteres hexadecimales. |
| Un mensaje que te dirige a **"Usar plantilla existente"** | La `typeEui` ya está utilizado por un modelo existente. Ese tipo de carga útil ya está en el catálogo — selecciónalo en lugar de crear una entrada en competencia. |
La última merece entenderse en lugar de rodearla. El `typeEui` identifica un tipo de carga útil. Si ya existe, lo correcto es usar el modelo existente — y si necesitas un decodificador diferente para él, añade una versión a ese modelo.
## Vista previa de decodificación
Antes de guardar, usa **Vista previa de decodificación** para ejecutar el decodificador con una carga útil de ejemplo e inspeccionar los campos que produce.
Úsalo. Una plantilla que se analiza como JSON no es lo mismo que una plantilla que decodifica correctamente — los factores de escala, el orden de bytes y los valores con signo son los lugares clásicos en los que un decodificador es sintácticamente perfecto y semánticamente incorrecto. Una carga útil de ejemplo con un valor conocido te lleva un minuto en el banco y te ahorra descubrir el problema como un gráfico de temperatura que parece plausible y está desviado por un factor de diez. Toma una carga útil de la propia documentación del dispositivo o de una unidad que ya hayas comisionado.
## Aplicar una nueva versión
Como los dispositivos funcionan con instantáneas, una nueva versión de la plantilla llega a un dispositivo solo cuando la aplicas:
1. Crea la nueva versión bajo el mismo fabricante y modelo.
2. Abre el dispositivo que quieres mover.
3. En Configuración de plantilla, selecciona la nueva **Versión de la plantilla**.
4. Guarda.
Despliega primero en un dispositivo y confirma sus campos decodificados frente a la carga útil en vivo antes de mover la flota. El modelo de instantáneas es lo que hace posible este despliegue por etapas — el resto de la flota permanece intacto mientras verificas.
## Eliminar entradas del catálogo
Eliminar tu propia plantilla, modelo o fabricante del catálogo Personalizado siempre está permitido.
Si los dispositivos están usando la entrada, obtienes una **advertencia con un recuento** de los dispositivos afectados. Esos dispositivos siguen funcionando — están en sus instantáneas. Lo que cambia es el catálogo: la entrada desaparece y ya no puede elegirse para nuevos dispositivos.
Lee el recuento antes de confirmar. No es un bloqueo, pero te indica cuántos registros de dispositivo llevan ahora un decodificador que ya no tiene una entrada de catálogo detrás — lo cual importa la próxima vez que alguien intente comisionar una unidad coincidente y no encuentre nada que seleccionar.
Eliminar una **Sistema** entrada requiere un administrador.
## Consejos
* **Crea una vez, comisiona muchas.** Para un despliegue de flota, deja bien la plantilla en una unidad con Vista previa de decodificación y luego deja que el valor predeterminado del modelo se encargue del resto.
* **Versiona por firmware, no por fechas.** Cuando un proveedor publica una revisión de firmware que cambia la carga útil, eso es una nueva versión de plantilla. Nómbrala de modo que la relación sea obvia.
* **Prefiere el Sistema cuando encaje.** Si el catálogo del Sistema cubre tu hardware, úsalo — obtienes el decodificador sin encargarte de su mantenimiento, y tu dispositivo sigue obteniendo su propia instantánea.
* **Mapea las métricas después de decodificar.** Una plantilla produce campos con nombre; las plantillas de métricas normalizan esos campos en un vocabulario compartido entre fabricantes. Consulta [Métricas](/kilo-docs-es/kilo-iot-server/devices/metric-templates.md).
## Qué sigue
* **Comisiona el extremo** — el formulario del dispositivo MIOTY sección por sección. Consulta [Dispositivos MIOTY](/kilo-docs-es/kilo-iot-server/devices/mioty-devices.md).
* **Normaliza los campos decodificados** — mapea esos campos al vocabulario de medición de tu despliegue. Consulta [Métricas](/kilo-docs-es/kilo-iot-server/devices/metric-templates.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-blueprints.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.
