Dans IoT Platform, vous pouvez définir un modèle Thing Specification Language (TSL) pour un produit. Un modèle TSL traduit un produit physique en un modèle de données composé de propriétés, de services et d'événements. Ce modèle permet à IoT Platform de gérer les appareils et d'interagir avec eux. Une fois le produit créé, définissez son modèle TSL. Les appareils rattachés au produit héritent automatiquement du modèle TSL.
Prérequis
Vous avez créé un produit. Pour plus d'informations, consultez la rubrique Créer un produit et un appareil.
Contexte
Cette rubrique utilise l'exemple d'un lampadaire pour illustrer la définition de deux propriétés pour un produit : Interrupteur principal et Courant. Une fois le modèle TSL défini, vous pouvez connecter plusieurs lampadaires au produit. Chaque appareil hérite automatiquement du modèle TSL défini. Pour en savoir plus sur les modèles TSL, consultez la rubrique Qu'est-ce qu'un modèle TSL ?.
Procédure
Connectez-vous à la console IoT Platform.
Sous l'onglet Overview, cliquez sur Public Instance.
Dans le volet de navigation de gauche, choisissez . Sur la page Products, localisez le produit de lampadaire que vous avez créé et cliquez sur View dans la colonne Actions.
Sur la page Product Details, cliquez sur l'onglet Define Feature, puis cliquez sur Edit Draft.
-
Sur la page Edit Draft, dans la section Default Module, cliquez sur Add Self-defined Feature pour configurer le modèle TSL, puis cliquez sur OK.
Configurez les propriétés Main Light Switch et Current pour le produit de lampadaire.
Propriété Main Light Switch : définissez Feature Type sur Property, saisissez Main Light Switch pour Feature Name, entrez
LightSwitchpour Identifier, sélectionnezboolpour Data Type (0 pour Off, 1 pour On) et choisissez read/write pour Read/Write Type.Propriété Current : définissez Feature Type sur Property, saisissez Current pour Feature Name, entrez
LightCurrentpour Identifier, sélectionnez float pour Data Type, définissez la plage de valeurs sur 0 to 9, indiquez 0.1 comme pas, sélectionnez Ampere / A comme unité, choisissez read-only pour Read/Write Type et saisissez « Electrical parameters use 4-byte floating-point data. » pour Description.
-
(Facultatif) Cliquez sur TSL Model. Sous l'onglet Full TSL, vous pouvez consulter le modèle TSL complet du produit au format JSON.
Le fichier JSON inclut les tableaux schema, profile et properties. Par exemple, la propriété LightSwitch (Interrupteur principal) utilise le type de données bool et le mode d'accès rw (lecture/écriture). Une valeur de 0 indique Off et une valeur de 1 indique On. Dans le coin inférieur droit, cliquez sur Export Model File pour exporter le modèle TSL vers un fichier local.
-
Publiez le modèle TSL.
ImportantLa publication du modèle TSL est requise pour qu'il prenne effet.
Dans le coin inférieur gauche de la page Edit Draft pour Define Feature, cliquez sur Publish. La boîte de dialogue Publish TSL Model? s'affiche.
-
Cliquez sur Add Publication Note et saisissez un numéro de version ainsi qu'une description de version.
Parameter
Description
Version Number
Définissez le numéro de version du modèle TSL actuel. Vous pourrez ensuite gérer les modèles TSL en fonction des numéros de version.
Le numéro de version accepte les lettres, les chiffres et les points (.). Sa longueur peut varier de 1 à 16 caractères.
Version Description
Décrivez la version actuelle du modèle TSL. Cette description accepte les caractères chinois, les lettres, les caractères japonais, les chiffres et les symboles spéciaux. Elle peut comporter jusqu'à 100 caractères. Un caractère chinois ou japonais compte pour un seul caractère.
-
Si une version a déjà été publiée, comparez le brouillon à la version publiée pour confirmer les modifications.
Cliquez sur Comparison Result pour afficher les modifications dans la boîte de dialogue Comparison Result. Après avoir confirmé les modifications, cliquez sur Confirm and View. Vous revenez à la boîte de dialogue Publish TSL Model et la case à cocher « I have reviewed the comparison between the current version and the online version » est automatiquement sélectionnée.
Si vous n'avez pas besoin de comparer les versions, cochez manuellement la case I have reviewed the comparison between the current version and the online version.
Cliquez sur OK pour publier le modèle TSL.