Un modèle Thing Specification Language (TSL) est un modèle de données défini pour un produit dans la Plateforme IoT. Il décrit les fonctionnalités d'un produit. Cette rubrique présente les concepts et les limites d'un modèle TSL.
Fonctionnalités
Un modèle TSL numérise une entité physique dans le cloud, telle qu'un capteur, un dispositif embarqué, un bâtiment ou une usine. Il inclut les propriétés, les services et les événements d'une entité. Il décrit ce qu'est l'entité, ce qu'elle peut faire et quelles informations elle peut fournir. Vous pouvez définir les fonctionnalités TSL d'un produit selon les dimensions des propriétés, des services et des événements.
Type de fonctionnalité | Description |
Propriété | Une propriété est une fonctionnalité TSL qui décrit l'état ou les informations d'un appareil en cours d'exécution. Par exemple, une propriété peut correspondre aux informations de température collectées par un dispositif de surveillance environnementale, à l'état marche/arrêt d'une lampe intelligente ou à la vitesse du vent d'un ventilateur électrique. Les propriétés se divisent en propriétés en lecture/écriture et en propriétés en lecture seule. Vous pouvez spécifier et lire les valeurs des propriétés en lecture/écriture. Pour les propriétés en lecture seule, vous ne pouvez que lire les valeurs. |
Service | Un service est une commande ou une méthode fournie par un appareil pour une invocation externe. Vous pouvez configurer les paramètres d'entrée et de sortie d'un service à invoquer. Le service lit les valeurs des paramètres d'entrée et renvoie les résultats dans les paramètres de sortie. Contrairement aux propriétés, les services s'invoquent via une commande pour mettre en œuvre une logique métier complexe. Par exemple, vous pouvez invoquer un service pour exécuter une tâche spécifique. Vous pouvez invoquer un service de manière synchrone ou asynchrone. |
Événement | Un événement contient les informations qu'un appareil signale à la Plateforme IoT pour notification et traitement lors de son exécution, y compris les alertes et les pannes. Un événement peut contenir plusieurs paramètres de sortie. Par exemple, un événement peut être une notification indiquant la fin d'une tâche, la température et l'heure de la panne en cas de défaillance de l'appareil, ou l'état de l'appareil lorsqu'une alerte est déclenchée. Vous pouvez vous abonner aux événements ou les distribuer. |
La Plateforme IoT vous permet de définir plusieurs ensembles de fonctionnalités pour un produit, notamment des propriétés, des services et des événements. Un module TSL représente un ensemble de fonctionnalités. Les différents modules TSL sont indépendants.
Les modules TSL vous permettent de résoudre des problèmes complexes de modélisation d'appareils dans des scénarios industriels. Vous pouvez développer des appareils aux fonctionnalités différentes en utilisant le même produit.
Par exemple, les propriétés du produit « radiateur soufflant » incluent Power Switch, Gear (high, medium, and low) et Indoor Temperature. Vous pouvez ajouter les deux premières propriétés dans un module et les trois propriétés dans un autre module. Ensuite, développez des appareils basés sur des modules TSL. De cette manière, différents appareils au sein du même produit présentent des fonctionnalités distinctes.
La Plateforme IoT fournit le module par défaut. Vous pouvez ajouter des modules personnalisés en fonction de vos besoins métier. La somme du nombre de modules par défaut et du nombre de modules personnalisés pour chaque produit ne peut pas dépasser 20.
Les fonctionnalités définies avant le 1er janvier 2021 sont catégorisées dans le module par défaut.
Description
La Plateforme IoT fournit le langage TSL pour décrire les modules et les fonctionnalités des produits.
Vous pouvez définir des propriétés, des services ou des événements dans un module TSL en fonction de votre scénario métier.
Chaque fichier TSL est au format JSON. Pour afficher ou exporter un modèle TSL au format JSON dans la console de la Plateforme IoT, procédez comme suit : sur la page Product Details, cliquez sur Define Feature. Dans l'onglet Define Feature, cliquez sur TSL Model. Pour plus d'informations sur les champs TSL, consultez Descriptions des champs TSL.
Vous pouvez ajouter un ou plusieurs modèles TSL dans la Plateforme IoT. Lorsque vous importez plusieurs modèles TSL simultanément, vous pouvez créer des fichiers TSL personnalisés. Pour plus d'informations, consultez Limites.
Limites
Pour obtenir des informations sur les limites des fonctionnalités TSL, consultez Limites. Le tableau suivant décrit les limites applicables lors de l'importation de fichiers TSL.
Opération | Limite |
Importer un seul fichier TSL | L'extension du fichier est Les caractères valides n'incluent pas les sauts de ligne ni les caractères d'alignement. |
Importer plusieurs fichiers TSL |
|