Utilisation des propriétés dans une solution Azure IoT Central
Ce guide pratique explique comment utiliser les propriétés de l’appareil qui sont définies dans un modèle d’appareil dans votre application Azure IoT Central.
Les propriétés représentent des valeurs à un moment donné. Par exemple, un appareil peut utiliser une propriété pour indiquer la température cible qu’il tente d’atteindre. Par défaut, les propriétés de l’appareil sont en lecture seule dans IoT Central. Les propriétés accessibles en écriture vous permettent de synchroniser l’état entre votre appareil et votre application Azure IoT Central.
Vous pouvez également définir des propriétés de cloud dans une application Azure IoT Central. Les valeurs de propriétés de cloud ne sont jamais échangées avec un appareil et ne sont pas concernées par cet article.
Pour en savoir plus sur les conventions de propriétés IoT Plug-and-Play, consultez la rubrique Conventions IoT Plug-and-Play.
Pour en savoir plus sur les données de propriété qu’un appareil échange avec IoT Central, consultez Charges utiles de télémétrie, de propriétés et de commandes.
Pour savoir comment gérer les propriétés en utilisant l’API REST IoT Central, consultez Comment utiliser l’API REST IoT Central pour contrôler les appareils.
Pour savoir comment implémenter des propriétés dans un appareil sans utiliser les kits de développement logiciel (SDK) d’appareil, consultez la rubrique Communiquer avec un hub IoT à l’aide du protocole MQTT.
Définir vos propriétés
Les propriétés sont des champs de données qui représentent l’état de votre appareil. Utilisez les propriétés pour représenter l’état durable de l’appareil, par exemple l’état marche/arrêt d’un appareil. Les propriétés peuvent également représenter des propriétés d’appareil de base, telles que la version logicielle de l’appareil. Les propriétés sont déclarées en lecture seule ou accessibles en écriture.
La capture d’écran suivante montre une définition de propriété dans l’application Azure IoT Central.
Le tableau suivant décrit les paramètres de configuration d’une fonctionnalité de données de propriété.
| Champ | Description |
|---|---|
| Nom d’affichage | Nom complet de la valeur de propriété utilisée sur les vignettes de tableau de bord et les formulaires d'appareil. |
| Nom | Nom de la propriété. Azure IoT Central génère une valeur pour ce champ à partir du nom d’affichage, mais vous pouvez choisir votre propre valeur si nécessaire. Ce champ doit être alphanumérique. Le code de l’appareil utilise cette valeur Nom. |
| Type de fonctionnalité | Propriété. |
| Type sémantique | Type sémantique de la propriété, telles que la température, l’état ou l’événement. Le choix du type sémantique détermine lequel des champs suivants est disponible. |
| schéma | Type de données de propriété, tel que double, chaîne ou vecteur. Le type sémantique détermine les choix disponibles. Le schéma n’est pas disponible pour les types sémantiques d’événement et d’état. |
| Accessible en écriture | Si la propriété n’est pas accessible en écriture, l’appareil peut signaler des valeurs de propriété à Azure IoT Central. Si la propriété est accessible en écriture, l’appareil peut signaler des valeurs de propriété à Azure IoT Central. Azure IoT Central peut alors envoyer des mises à jour de propriétés à l’appareil. |
| severity | Disponible uniquement pour le type sémantique d’événement. Les gravités sont Erreur, Information ou Avertissement. |
| Valeurs d’état | Disponible uniquement pour le type sémantique d’état. Définissez les valeurs d’état possibles, chacune ayant un nom d’affichage, un nom, un type d’énumération et une valeur. |
| Unité | Unité de la valeur de propriété, par exemple, mph, % ou °C. |
| Unité d'affichage | Unité d'affichage à utiliser sur les vignettes de tableau de bord et les formulaires d'appareil. |
| Commentaire | Commentaires sur la fonctionnalité de propriété. |
| Description | Description de la fonctionnalité de propriété. |
Pour en savoir plus sur le langage DTDL (Digital Twin Definition Language) utilisé par Azure IoT Central pour définir des propriétés dans un modèle d’appareil, consultez la rubrique Conventions IoT Plug-and-Play > Propriétés en lecture seule.
Des champs facultatifs, tels que le nom d’affichage et la description, vous permettent d’ajouter des détails à l’interface et aux fonctionnalités.
Lorsque vous créez une propriété, vous pouvez spécifier des types de schéma complexes tels que Objet et Enum.
Lorsque vous sélectionnez le Schéma complexe, par exemple Objet, vous devez également définir le schéma de l’objet.
Implémenter des propriétés en lecture seule
Par défaut, les propriétés sont en lecture seule. Les propriétés en lecture seule permettent à un appareil de signaler des mises à jour de valeurs de propriété à votre application Azure IoT Central. Votre application Azure IoT Central ne peut pas définir la valeur d’une propriété en lecture seule.
Azure IoT Central utilise les jumeaux d’appareil pour synchroniser les valeurs de propriété entre l’appareil et l’application Azure IoT Central. Les valeurs de propriété d’appareil utilisent les propriétés signalées du jumeau d’appareil. Pour plus d’informations, consultez la documentation relative aux jumeaux d’appareil.
Un appareil envoie des mises à jour de propriété en tant que charge utile JSON. Pour en savoir plus, consultez la rubrique Charges utiles de télémétrie, de propriétés et de commandes.
Vous pouvez utiliser l’Azure IoT device SDK pour envoyer une mise à jour de propriété à votre application Azure IoT Central.
Pour obtenir des exemples d’implémentations dans plusieurs langages, consultez la rubrique Créer et connecter une application cliente à votre application Azure IoT Central.
L’affichage suivant dans l’application Azure IoT Central affiche les propriétés en lecture seule de l’appareil :
Implémenter des propriétés accessibles en écriture
Un opérateur IoT Central définit des propriétés accessibles en écriture sur un formulaire. Azure IoT Central envoie la propriété à l’appareil. Azure IoT Central attend un accusé de réception de la part de l’appareil.
Pour obtenir des exemples d’implémentations dans plusieurs langages, consultez la rubrique Créer et connecter une application cliente à votre application Azure IoT Central.
Le message de réponse doit inclure les champs ac et av. Le champ ad est facultatif. Pour plus d’informations, consultez la rubrique Conventions IoT Plug-and-Play > Propriétés accessibles en écriture.
Lorsque l’opérateur définit une propriété accessible en écriture dans l’interface utilisateur d’Azure IoT Central, l’application utilise une propriété souhaitée de jumeau d’appareil pour envoyer la valeur à l’appareil. L’appareil répond alors en utilisant une propriété signalée du jumeau d’appareil. Quand Azure IoT Central reçoit la valeur de la propriété rapportée, il met à jour l’affichage des propriétés avec l’état Accepté.
Lorsque vous entrez la valeur et sélectionnez Enregistrer, l’état initial est En attente. Lorsque l’appareil accepte la modification, l’état passe à Accepté.
Utiliser des propriétés sur des appareils non attribués
Vous pouvez afficher et mettre à jour les propriétés accessibles en écriture sur un appareil qui n’est affecté à aucun modèle d’appareil.
Pour afficher les propriétés existantes sur un appareil non affecté, accédez à l’appareil dans la section Appareils, sélectionnez Gérer l’appareil, puis Propriétés de l’appareil :
Vous pouvez mettre à jour les propriétés accessibles en écriture dans cette affichage :
Étapes suivantes
Maintenant que vous avez appris à utiliser les propriétés dans votre application Azure IoT Central, consultez :