IoT Platform:Créer un produit et un appareil

Prérequis

Une instance Enterprise Edition est requise. Pour plus d'informations, consultez la rubrique Créer une instance Enterprise Edition.

Contexte

• Un produit représente un ensemble d'appareils partageant les mêmes fonctionnalités. Vous pouvez gérer les appareils par produit, par exemple pour définir un modèle TSL ou personnaliser des topics.

• Chaque appareil physique doit posséder une identité sur IoT Platform. Vous devez provisionner l'appareil physique avec le certificat d'appareil (ProductKey, DeviceName et DeviceSecret) émis par IoT Platform. Ce certificat authentifie l'appareil lors de sa connexion à la plateforme. Pour plus d'informations, consultez la rubrique Obtenir un certificat d'appareil.

Cette rubrique explique comment créer un produit, définir un modèle TSL, ajouter un appareil et obtenir un certificat d'appareil pour un thermostat domestique dans IoT Platform.

Procédure

1. Dans la console IoT Platform, sous l'onglet Overview, cliquez sur l'instance IoT Test Environment.

2. Dans le volet de navigation de gauche, sélectionnez Device Management > Products, puis cliquez sur Create Product.

3. Sur la page Create Product, configurez les paramètres, puis cliquez sur OK.

   Dans cet exemple, définissez le paramètre Product Name sur Home Thermostat. Conservez les valeurs par défaut pour les autres paramètres. Par exemple, Node Type est défini sur Directly Connected Device, Connection Method sur Wi-Fi, Data Format sur ICA Standard Data Format (Alink JSON), Data Validation Level sur Relaxed et Authentication Method sur DeviceSecret.

4. Sur la page Create Product, cliquez sur Go to Define Thing Specification Language (TSL) model.

   La définition d'un modèle TSL pour le produit permet d'abstraire un produit physique en un modèle de données composé de propriétés, de services et d'événements. Ce modèle simplifie la gestion des appareils et les interactions de données dans IoT Platform.

5. Sous l'onglet Define Features, cliquez sur Edit Draft et suivez les étapes ci-dessous pour définir les propriétés de température et d'humidité du produit Home Thermostat.

   1. Sous Default Module, cliquez sur Add Custom Feature pour configurer les propriétés de température et d'humidité.

      Pour la propriété de température, définissez Feature Type sur Property, Feature Name sur Temperature, Identifier sur temperature, Data Type sur double, Value Range sur -20–60, Step sur 0,1, Unit sur Celsius/°C et Access Mode sur Read/Write. Pour la propriété d'humidité, définissez Feature Name sur Humidity, Identifier sur humidity, Data Type sur int32, Value Range sur 0–100, Step sur 1, Unit sur Percentage/% et Access Mode sur Read/Write.

   2. Cliquez sur Publish dans le coin inférieur gauche de la page Edit Draft sous Function Definition. La boîte de dialogue Publish TSL model? s'affiche.

   3. Cochez la case I have confirmed the differences between the current and online versions.

   4. Cliquez sur OK pour publier le modèle TSL.

6. Sur la page Product Details, cliquez sur l'onglet Devices.

7. Sous l'onglet Devices, cliquez sur Add Device. Dans la boîte de dialogue qui s'affiche, saisissez un nom d'appareil, par exemple Device1, puis cliquez sur OK.

   Une fois l'appareil créé, la boîte de dialogue Added s'affiche. Cliquez sur Copy Device Certificate.

   Vous pouvez également cliquer sur View pour ouvrir la page Device Details. Sur cette page, cliquez sur View à côté de DeviceSecret.

   Un certificat d'appareil contient la ProductKey, le DeviceName et le DeviceSecret. L'appareil utilise ces informations d'identification pour communiquer avec IoT Platform.

   Important

   Le certificat d'appareil est requis pour connecter votre appareil à IoT Platform. Copiez les informations du certificat et conservez-les en toute sécurité.

   Parameter	Description
   ProductKey	La ProductKey du produit auquel appartient l'appareil. La ProductKey est l'identifiant global unique (GUID) émis par IoT Platform pour le produit.
   DeviceName	Le DeviceName de l'appareil, qui constitue l'identifiant unique de l'appareil au sein du produit. La combinaison du DeviceName et de la ProductKey sert d'identifiant d'appareil. IoT Platform authentifie l'appareil et communique avec celui-ci sur la base de cet identifiant.
   DeviceSecret	Le DeviceSecret de l'appareil, émis par IoT Platform pour l'authentification et le chiffrement des appareils. Le DeviceSecret doit être utilisé conjointement avec le DeviceName.

Étapes suivantes

Connecter un appareil et charger des données