Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Ce guide pratique vous montre comment utiliser les propriétés d’appareil définies dans un modèle d’appareil dans votre application Azure IoT Central.
Les propriétés représentent des valeurs de point dans le temps. Par exemple, un appareil peut utiliser une propriété pour signaler 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 cloud dans une application Azure IoT Central. Les valeurs de propriété cloud ne sont jamais communiquées avec un appareil et ne sont pas abordées dans cet article.
Pour en savoir plus sur les conventions de propriétés IoT Plug and Play, consultez IoT Plug-and-Play conventions.
Pour en savoir plus sur les données de propriété qu’un appareil échange avec IoT Central, consultez les charges utiles de télémétrie, de propriété et de commande.
Pour savoir comment gérer les propriétés à l’aide de 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 SDK d’appareil, consultez Communiquer avec un hub IoT à l’aide du protocole MQTT.
Définir vos paramètres
Les propriétés sont des champs de données qui représentent l’état de votre appareil. Utilisez des propriétés pour représenter l’état durable de l’appareil, tel que l’état activé/désactivé 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. Vous déclarez des propriétés comme étant en lecture seule ou modifiables.
La capture d’écran suivante montre une définition de propriété dans une application Azure IoT Central.
Le tableau suivant présente les paramètres de configuration d’une fonctionnalité de propriété.
| Champ | Descriptif |
|---|---|
| Nom complet | 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 Name . |
| Type de fonctionnalité | Propriété. |
| Type sémantique | Type sémantique de la propriété, tel que la température, l’état ou l’événement. Le choix du type sémantique détermine quels champs suivants sont disponibles. |
| Schema | 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 ensuite envoyer des mises à jour de propriété à l’appareil. |
| Niveau de gravité | Disponible uniquement pour le type sémantique d’événement. Les niveaux de gravité sont les erreurs, les informations, ou les avertissements. |
| Valeurs d’état | Disponible uniquement pour le type sémantique d’état. Définissez les valeurs d’état possibles, chacune ayant le nom d’affichage, le nom, le type d’énumération et la valeur. |
| Unité | Unité de la valeur de propriété, telle que 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é. |
| Descriptif | 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 les conventions > IoT Plug-and-Play en lecture seule.
Les champs facultatifs, tels que le nom d’affichage et la description, vous permettent d’ajouter plus de détails à l’interface et aux fonctionnalités.
Lorsque vous créez une propriété, vous pouvez spécifier des types de schémas complexes tels que Object et Enum.
Lorsque vous sélectionnez le schéma complexe, tel que l’objet, vous devez définir le schéma d’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 les mises à jour des 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 des 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 Tutoriel : Configurer vos appareils à partir d’un service back-end.
Un appareil envoie des mises à jour de propriétés sous forme de charge utile JSON. Pour plus d’informations, consultez Télémétrie, propriété et charges utiles de commande.
Vous pouvez utiliser le Kit de développement logiciel (SDK) d’appareil Azure IoT pour envoyer une mise à jour de propriété à votre application Azure IoT Central.
Pour obtenir des exemples d’implémentations dans plusieurs langages, consultez Tutoriel : Créer et connecter une application cliente à votre application Azure IoT Central.
La vue suivante 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 l’appareil.
Pour obtenir des exemples d’implémentations dans plusieurs langues, consultez 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 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 propriété signalée, elle met à jour la vue de propriété 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 pas affecté à un modèle d’appareil.
Pour afficher les propriétés existantes sur un appareil non attribué, 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 vue :
Étapes suivantes
Maintenant que vous savez comment utiliser des propriétés dans votre application Azure IoT Central, consultez :