> 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-fr/kilo-iot-server/devices/mioty-devices.md).
# Appareils MIOTY
Mettez en service un point de terminaison MIOTY dans Kilo IoT — EUI du point de terminaison, adresse courte, clé de session réseau et compteurs.
Un endpoint MIOTY enregistré sur le serveur Kilo IoT devient un jumeau numérique comme n’importe quel autre appareil — une représentation numérique persistante de son identité, de sa configuration, de son historique de télémétrie et de son état. Ce qui est spécifique à MIOTY, c’est l’ensemble des paramètres qui décrivent comment l’endpoint atteint vos stations de base, ainsi que le matériel de sécurité qui permet au centre de service de lui faire confiance.
Cette page couvre les champs spécifiques à MIOTY sur le formulaire de l’appareil. Le flux d’enregistrement environnant — nommer l’appareil, l’onglet Metrics, l’onglet Logs, l’enregistrement — correspond au flux commun documenté dans [Enregistrement des appareils](/kilo-docs-fr/kilo-iot-server/devices/registering-devices.md).
## Prérequis
* **Un connecteur Mioty.** Sans lui, les champs MIOTY ne sont pas disponibles et le formulaire affiche **« Créez d’abord un connecteur Mioty »**. Voir [Connecteur MIOTY](/kilo-docs-fr/kilo-iot-server/connectors/mioty-connector.md).
* **Au moins une station de base en ligne.** Les endpoints se rattachent via des stations de base. Voir [Stations de base MIOTY](/kilo-docs-fr/kilo-iot-server/gateways/mioty-base-stations.md).
* **Identifiants de l’endpoint fournis par le fabricant** — l’EUI du point terminal et la clé de session réseau, normalement sur l’étiquette de l’unité ou dans un fichier de provisionnement fourni.
## Sélection du connecteur
Sur le formulaire de l’appareil, sélectionnez le connecteur Mioty comme type de connecteur. Le formulaire présente alors les sections de paramètres MIOTY décrites ci-dessous.
## Base
* **EUI du point terminal** — l’identifiant unique de l’endpoint, exactement 16 caractères hexadécimaux. C’est l’adresse sous laquelle le réseau connaît l’unité. Une valeur qui ne comporte pas 16 caractères hexadécimaux est rejetée.
## Réseau
Ces champs décrivent comment l’endpoint émet ses télégrammes sur l’air.
* **Adresse courte** — l’identifiant compact que l’endpoint utilise sur le lien radio, saisi en hexadécimal. Les valeurs valides vont de **0001** sur **FFFF**; zéro n’est pas une adresse courte valide et sera rejeté. Attribuez les adresses courtes de manière réfléchie sur un site plutôt qu’au hasard — un schéma lié à une zone ou à une ligne rend un déploiement à grande échelle beaucoup plus facile à comprendre par la suite.
* **Décalage de porteuse** — facultatif. Décale la porteuse de l’endpoint à l’intérieur de la bande. Réglez-le lorsque les données de mise en service du fabricant ou le plan de fréquences de votre site l’exigent ; sinon, laissez-le tel quel.
* **EUI du type** — en lecture seule. Il est renseigné à partir du plan directeur que vous sélectionnez ou créez pour l’appareil, et identifie le type de charge utile de l’endpoint. Vous ne le saisissez pas manuellement. Voir [Plans directeurs MIOTY](/kilo-docs-fr/kilo-iot-server/devices/mioty-blueprints.md).
## Communication
* **BiDi** — communication bidirectionnelle. Activez-la pour les endpoints qui doivent à la fois recevoir et émettre.
* **PreAtt** — pré-attachement. Activez-la lorsque l’endpoint est provisionné pour se rattacher avant sa première liaison montante.
Ces deux réglages font partie de la configuration de l’unité et sont définis par le fabricant. Faites correspondre le formulaire au matériel plutôt que de choisir selon vos préférences ici.
## MIOTY avancé
Ces paramètres ajustent le comportement radio de l’endpoint et existent pour les déploiements qui en ont besoin. Réglez-les pour qu’ils correspondent à la configuration propre de l’endpoint :
* **Double canal**
* **Répétition DL** — répétition de liaison descendante
* **Décalage de porteuse large**
* **Longue distance entre blocs**
Si votre fiche de mise en service ne mentionne pas un paramètre, l’endpoint ne l’utilise pas — laissez-le à sa valeur par défaut. Ce sont des leviers pour les environnements RF difficiles, pas des réglages à expérimenter sur une flotte en production.
## Compteurs
* **Dernier paquet** — la position du compteur de paquets.
* **Attachement** — le compteur d’attachement.
Les deux sont **0** pour un nouvel appareil. Elles existent afin qu’un enregistrement d’appareil puisse être aligné avec un endpoint qui a déjà un historique — par exemple lorsque vous migrez une unité qui fonctionnait ailleurs. Pour une unité sortie d’usine, laissez-les à zéro.
L’alignement des compteurs aligne le *enregistrement*. Cela ne déplace pas l’endpoint sur votre réseau. Un endpoint MIOTY se rattache à un seul réseau à la fois, et une unité qui fonctionnait sur un autre centre de service y est toujours rattachée — elle n’apparaîtra pas sous vos stations de base parce que vous avez créé un enregistrement d’appareil pour elle. Réinitialisez l’endpoint pour qu’il se rattache à nouveau, en suivant la procédure du fabricant pour votre modèle. Une fois qu’une station de base l’a pris en charge, l’onglet de l’appareil **Connexion** passe à *Réseau atteint — en attente de données*. Voir [Diagnostic de l’appareil](/kilo-docs-fr/kilo-iot-server/devices/device-diagnostics.md) pour savoir comment ce cycle de vie se présente sur la plateforme.
## Sécurité
* **Clé de session réseau** — requise. Exactement 32 caractères hexadécimaux. C’est la clé qui sécurise la liaison de l’endpoint au réseau ; sans clé valide, l’appareil ne peut pas être enregistré.
* **Clé d’application** — facultative. Fournissez-la lorsque la charge utile de l’endpoint est chiffrée au niveau applicatif.
### Ajouter au coffre
Les identifiants de l’endpoint finissent parfois hors de portée — sur une étiquette d’une unité désormais scellée dans un boîtier sur un râtelier de tuyauterie. Cliquez **Ajouter au coffre** sur le formulaire de l’appareil pour stocker la paire EUI du point terminal et clé de session réseau dans Key Vault, où elle peut être récupérée indépendamment du matériel et de l’étiquette.
Faites-le lors de la mise en service, tant que les identifiants sont encore sous vos yeux. Récupérer une unité dont vous n’avez plus la clé de session réseau en dossier signifie ouvrir le boîtier — et certains fabricants ne redonnent la clé que via une connexion filaire, quand ils la redonnent. Voir [Coffre de clés](/kilo-docs-fr/kilo-iot-server/reports/key-vault.md).
## Validation — ce qui empêche l’enregistrement
Le formulaire ne sera pas enregistré tant que ces conditions ne sont pas remplies :
| Champ | Exigence | Ce que vous voyez en cas d’échec |
| ------------------------- | --------------------------------------------- | -------------------------------------------------------------------- |
| **EUI du point terminal** | Exactement 16 caractères hexadécimaux | Le champ indique que l’EUI doit comporter 16 caractères hexadécimaux |
| **Adresse courte** | Hexadécimal, dans la plage **0001**–**FFFF** | Le champ est rejeté ; zéro n’est pas valide |
| **Clé de session réseau** | Exactement 32 caractères hexadécimaux, requis | L’appareil ne peut pas être enregistré |
L’enregistrement d’un identifiant qui existe déjà dans votre organisation renvoie **« Une station de base avec cet EUI existe déjà »**.
## Décodage de la télémétrie
La télémétrie d’un endpoint MIOTY est **pas décodée tant qu’un plan directeur n’a pas été sélectionné pour lui**. Jusqu’à ce moment, l’appareil est enregistré et rattaché, mais ses charges utiles ne sont pas transformées en mesures nommées — ce qui signifie qu’aucune donnée exploitable n’atteint les tableaux de bord, les règles ou l’historique.
La configuration du plan directeur se trouve sur le même formulaire d’appareil. Vous pouvez choisir un plan directeur existant dans le catalogue ou en créer un nouveau à partir de JSON, et le choix est copié sur l’appareil sous forme de cliché indépendant. C’est ce modèle de cliché qui rend possible la modification sûre des modèles du catalogue sur une flotte de production. Voir [Plans directeurs MIOTY](/kilo-docs-fr/kilo-iot-server/devices/mioty-blueprints.md).
## Et ensuite
* **Lier un plan directeur** afin que les charges utiles de l’endpoint soient décodées en champs nommés. Voir [Plans directeurs MIOTY](/kilo-docs-fr/kilo-iot-server/devices/mioty-blueprints.md).
* **Mapper les métriques** pour normaliser les champs décodés entre fabricants. Voir [Métriques](/kilo-docs-fr/kilo-iot-server/devices/metric-templates.md).
* **Terminez le flux d’enregistrement commun** — informations de l’appareil, Metrics, Logs. Voir [Enregistrement des appareils](/kilo-docs-fr/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-fr/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.
