IoT Platform:Distribuer des appareils

Scénarios

Vous pouvez distribuer des appareils dans les scénarios suivants :

• Gravure des appareils avant la connexion : Avant de livrer les appareils depuis l'usine, il n'est pas nécessaire de coder en dur différents endpoints en fonction des instances IoT Platform ou des régions dans lesquelles elles se trouvent. Un endpoint globalement unique, ne contenant aucune information régionale, est gravé sur chaque appareil. Une fois sortis d'usine, vous pouvez distribuer les appareils vers différentes régions via la console IoT Platform. Ainsi, les appareils peuvent se connecter à IoT Platform depuis diverses régions du monde.

• Migration professionnelle : Si vous migrez votre activité, vous devrez peut-être modifier la région ou l'instance à laquelle un appareil est connecté. Dans ce cas, vous pouvez distribuer les appareils entre différentes régions, instances ou comptes.

Les politiques de distribution suivantes s'appliquent selon les scénarios :

• Région spécifiée : Les appareils sont distribués vers la région et l'instance spécifiées. Si vous pouvez confirmer la région et l'instance de destination vers lesquelles les appareils doivent être distribués, nous vous recommandons d'utiliser cette politique. Cela vous permet de distribuer les appareils de manière efficace.

• Accès le plus proche : Les appareils peuvent être utilisés dans différentes régions du monde. Lors de la distribution, vous pouvez sélectionner une ou plusieurs régions et choisir une instance pour chacune d'elles. Ensuite, les appareils se connectent à la région la plus proche en fonction de leurs adresses IP. Ainsi, un appareil peut se connecter à la région la plus proche, quel que soit son emplacement physique.

Notes d'utilisation

Éléments distribuables

Vous pouvez distribuer des appareils entre des instances, des régions ou des comptes.

Après la distribution d'un appareil, certaines données relatives à l'appareil et au produit sont également distribuées. Le tableau suivant décrit les éléments distribuables.

Précautions

Procédure

1. Créez un produit et un appareil au sein de ce produit, puis obtenez le certificat de l'appareil dans la console IoT Platform. Le certificat inclut le ProductKey, le DeviceName et le DeviceSecret. Pour plus d'informations, consultez Créer un produit, Créer un appareil et Créer plusieurs appareils à la fois.

2. Utilisez le Link SDK for C V4.x pour configurer l'appareil physique, ou configurez l'appareil selon un protocole de communication afin d'implémenter la fonctionnalité suivante.

   Remarque

   Pour configurer l'appareil, nous vous recommandons d'utiliser Link SDK for C. Pour plus d'informations, consultez Présentation de la distribution des appareils.

   Après avoir distribué l'appareil dans la console IoT Platform, vous pouvez le connecter à IoT Platform en effectuant les opérations suivantes :

   1. Initiez une requête Bootstrap selon l'une des méthodes suivantes, en fonction de votre méthode de développement d'appareil :

      • Connectez l'appareil en utilisant Link SDK for C

        L'appareil appelle la méthode Bootstrap encapsulée dans le SDK et transmet les paramètres ProductKey et DeviceName pour envoyer une requête à l'endpoint globalement unique https://iot-auth-global.aliyuncs.com.

        Pour savoir comment développer la fonctionnalité Bootstrap, consultez Présentation de la distribution des appareils.

      • Connectez l'appareil sans utiliser le SDK

        Envoyez une requête à https://iot-auth-global.aliyuncs.com/auth/bootstrap selon le protocole que vous utilisez. Le tableau suivant décrit les paramètres de la requête.

        |
        |

        Exemple de requête

        POST /auth/bootstrap HTTP/1.1
        Host: iot-auth-global.aliyuncs.com
        Content-Type: application/x-www-form-urlencoded
        Content-Length: 123
        productKey=123&timestamp=123&version=default&clientId=123&resources=mqtt&deviceName=test

        Exemple de réponse

        HTTP/1.1 200 OK
        Server: Tengine
        Date: Wed, 29 Mar 2017 13:08:36 GMT
        Content-Type: application/json;charset=utf-8
        Connection: close
        {
          "code" : 200,
          "data" : {
            "resources" : {
              "mqtt" : {
                "host" : "xxx.iot-as-mqtt.cn-shanghai.aliyuncs.com",
                "port" : 1883
              }
            }
          },
          "message" : "success"
        }

   2. IoT Platform renvoie un endpoint en fonction de la région et de l'instance de destination. Si vous définissez le paramètre Distribution Policy sur Nearest Access, IoT Platform détermine la région et l'instance de destination en fonction de l'adresse IP de l'appareil.

   3. L'appareil se connecte à IoT Platform via MQTT en utilisant le certificat de l'appareil et les informations d'endpoint de l'instance à laquelle il peut se connecter. Le certificat de l'appareil inclut le ProductKey, le DeviceName et le DeviceSecret. Les informations d'endpoint sont renvoyées par le service de distribution.

      • Connectez l'appareil en utilisant Link SDK for C

        Pour connecter l'appareil, nous vous recommandons d'utiliser le SDK V4.x. Pour plus d'informations sur la connexion de l'appareil à IoT Platform, consultez Présentation de la connexion des appareils via MQTT.

      • Connectez l'appareil sans utiliser le SDK

        Utilisez le projet open source Paho MQTT pour C embarqué afin de connecter l'appareil à IoT Platform. Pour plus d'informations, consultez Exemple d'intégration Paho MQTT C (embarqué).

   4. Facultatif. Si vous distribuez l'appareil dans la console IoT Platform, l'appareil reçoit un message MQTT indiquant qu'une opération de distribution est en cours. Ensuite, l'appareil est forcé de passer hors ligne.

      Les topics suivants sont utilisés lorsqu'IoT Platform envoie des requêtes MQTT descendantes et que l'appareil envoie des réponses à IoT Platform :

      Topic de requête : /sys/${productKey}/${deviceName}/thing/bootstrap/notify

      Exemple de requête au format JSON Alink :

      {
          "id": "****",
          "version": "1.0", 
          "method": "thing.bootstrap.notify", 
          "params": {
            "cmd": 0
          }
      }

      Topic de réponse : /sys/${productKey}/${deviceName}/thing/bootstrap/notify_reply

      Exemple de réponse au format JSON Alink :

      {
          "id": "****",
          "code":200,
          "data" : {}
      }

   Important

   À chaque connexion de l'appareil à IoT Platform, nous vous recommandons d'effectuer les trois premières étapes du processus précédent. Cela garantit que l'endpoint stocké sur l'appareil correspond à celui envoyé par IoT Platform. Dans le cas contraire, l'appareil risque de ne pas pouvoir se connecter à IoT Platform.

   Les informations d'endpoint peuvent être stockées sur l'appareil. Si les informations de connexion sont perdues ou si une tentative de connexion échoue, l'appareil peut initier une requête Bootstrap pour obtenir à nouveau les informations d'endpoint.

3. Après avoir configuré un appareil, effectuez l'une des opérations suivantes selon la situation :

   • Avant de pouvoir distribuer un appareil existant pour lequel la fonctionnalité de distribution d'appareils est désactivée, vous devez effectuer une mise à jour OTA pour mettre à jour l'appareil vers la version développée à l'étape précédente. Pour savoir comment mettre à jour l'appareil, consultez Présentation des mises à jour OTA.

     Important

     Si la fonctionnalité de distribution d'appareils d'un appareil existant est désactivée, vous devez effectuer une mise à jour OTA pour activer cette fonctionnalité avant de distribuer l'appareil. Sinon, l'appareil ne pourra pas se connecter à IoT Platform après la distribution.

   • Après avoir créé un appareil, vous devez graver le certificat de l'appareil sur celui-ci. Pour savoir comment graver le certificat de l'appareil, consultez Présentation de l'obtention des certificats d'appareil.

4. Distribuez l'appareil vers une région, une instance et un compte spécifiques dans la console IoT Platform, selon vos besoins professionnels.

   1. Connectez-vous à la console IoT Platform.

   2. Dans la barre de navigation supérieure, sélectionnez China (Shanghai) dans la liste déroulante.

      Remarque

      Cette étape est effectuée pour utiliser la fonctionnalité de distribution d'appareils. Elle ne spécifie pas la région source ou de destination pour la distribution des appareils.

   3. Sur la page Overview, cliquez sur All environment. Dans l'onglet Tous les environnements, localisez l'instance que vous souhaitez gérer et cliquez sur son ID ou son nom.

   4. Dans le volet de navigation de gauche, choisissez Resource Allocation > Device Distribution.

   5. Sur la page Device Distribution, cliquez sur Device Distribution.

   6. Configurez les paramètres.

      Le tableau suivant décrit les paramètres.

      Paramètre	Description
      Méthode de distribution	La méthode utilisée pour distribuer les appareils. Valeurs possibles : This Account : Distribuez les appareils vers une autre instance ou région du compte actuel. Cross-account : Distribuez les appareils vers un autre compte. Remarque Si vous définissez le paramètre Méthode de distribution sur Inter-comptes, vous ne pouvez pas définir le paramètre Politique de distribution sur Accès le plus proche.
      Compte de destination	Le compte de destination vers lequel les appareils sont distribués. Si vous définissez le paramètre Méthode de distribution sur Cross-account, ce paramètre est obligatoire. Vous pouvez spécifier le compte de destination en utilisant le nom du compte ou l'ID du compte. Destination Account Name : Saisissez le nom d'un compte Alibaba Cloud. Destination Account ID : Saisissez l'ID d'un compte Alibaba Cloud. Remarque Pour afficher l'ID du compte Alibaba Cloud, procédez comme suit : Connectez-vous à la console IoT Platform et cliquez sur l'image de profil dans le coin supérieur droit pour accéder à la page Security Settings.
      Code de vérification	Après avoir spécifié le compte de destination, cliquez sur Send Verification Code. IoT Platform envoie un code de vérification au numéro de téléphone associé au compte. Le code de vérification est valide pendant 5 minutes. Contactez le propriétaire du compte de destination pour obtenir le code de vérification.
      Région source	La région depuis laquelle les appareils sont distribués.
      Instance source	L'instance depuis laquelle les appareils sont distribués.
      Politique de distribution	La politique utilisée pour distribuer les appareils. Valeurs possibles : Update Region : Distribuez les appareils vers une région spécifiée. Nearest Access : Distribuez les appareils vers la région la plus proche en fonction de l'adresse IP des appareils. Vous pouvez sélectionner une ou plusieurs régions.
      Région de destination	Si vous définissez le paramètre Politique de distribution sur Update Region, ce paramètre est obligatoire. Sélectionnez la région vers laquelle vous souhaitez distribuer les appareils.
      Instance de destination	Si vous définissez le paramètre Politique de distribution sur Update Region, ce paramètre est obligatoire. L'instance vers laquelle vous souhaitez distribuer les appareils. Si vous définissez le paramètre Méthode de distribution sur This Account, vous devez sélectionner une instance de destination. Si vous définissez le paramètre Méthode de distribution sur Cross-account, vous devez spécifier un ID d'instance. Sinon, une instance publique de la version précédente est utilisée. Important Si l'instance de destination est une nouvelle instance publique ou une instance Enterprise Edition, vous devez spécifier un ID d'instance. Pour plus d'informations, consultez Gérer les endpoints des instances.
      Région	Si vous définissez le paramètre Politique de distribution sur Nearest Access, ce paramètre est obligatoire. Vous pouvez sélectionner une ou plusieurs régions. Si vous souhaitez distribuer les appareils vers la région source, sélectionnez la région source. Si plusieurs instances résident dans la région de destination, vous pouvez sélectionner une instance dans la liste déroulante.
      Appareils	Vous pouvez sélectionner les appareils en utilisant l'une des méthodes suivantes : Select : Sélectionnez un produit dans la liste des produits, puis sélectionnez un ou plusieurs appareils dans la liste des appareils. Les appareils restent sélectionnés même si vous changez de page dans la liste des appareils. Si vous définissez le paramètre Méthode de distribution sur Update Region et que vous ne spécifiez aucun appareil, IoT Platform distribue uniquement les produits. Choose File : Téléchargez un fichier contenant une liste d'appareils. Le fichier doit être au format CSV et peut contenir jusqu'à 1 000 entrées. Vous pouvez cliquer sur Download Template pour obtenir le modèle de fichier.

   7. Cliquez sur OK.

   IoT Platform exécute immédiatement la tâche de distribution.

   • Si vous définissez le paramètre Politique de distribution sur Mettre à jour la région, les données du produit et de l'appareil sont distribuées vers une région spécifiée.

   • Si vous définissez le paramètre Politique de distribution sur Accès le plus proche, les données du produit sont distribuées vers les régions spécifiées. Lorsqu'un appareil se connecte à IoT Platform, IoT Platform distribue dynamiquement les données de l'appareil vers la région la plus proche en fonction de son adresse IP.

   Le tableau suivant décrit les différents états d'une tâche de distribution. L'état est affiché dans l'onglet Liste des lots.

   |
   **État**
   |
   **Description**
   | | --- | --- | |
   Initialisation
   |
   La tâche de distribution est en cours d'initialisation.
   | |
   Distribution en cours
   |
   La tâche de distribution est en cours d'exécution.
   
   
   Si une tâche de distribution reste dans cet état pendant une période prolongée, vous pouvez cliquer sur Réessayer dans la colonne Actions.
   | |
   Distribué
   |
   La tâche de distribution est terminée.
   
   
   Cet état distribué n'indique pas que tous les appareils ont été distribués. Pour vérifier si tous les appareils ont été distribués, cliquez sur **Download Record** dans la colonne Actions et consultez le résultat. Si un appareil spécifique n'existe pas, cela signifie que sa distribution a échoué.
   | |
   Échec
   |
   La tâche de distribution a échoué en raison d'instabilités réseau. Vous pouvez cliquer sur Réessayer dans la colonne Actions. Si le problème persiste, contactez le service client ou soumettez un ticket.
   |

   Une fois la tâche de distribution terminée et qu'un appareil est connecté à IoT Platform, l'appareil se connecte à la région et à l'instance de destination en suivant les opérations décrites à l'étape 2.