Client du SDK Hub

Incluez les fichiers d'en-tête (.h) et les fichiers d'objets partagés (.so) dans votre application.

Vous devez inclure les fichiers d'en-tête publics (.h) et les fichiers d'objets partagés (.so) dans votre application. Pour les fichiers .so, vous pouvez les placer dans un dossier lib. La mise en page finale sera similaire à celle-ci :

├── include
│   ├── iotmi_device_sdk_client
│   │   └── iotmi_device_sdk_client_common_types.h
│   ├── iotmi_device_sdk_client.h
│   └── iotshd_status.h
├── lib
│   ├── libiotmi_devicesdk_client_module.so
│   └── libiotmi_log_c.so

Créez un client Hub SDK dans votre application principale.

1. Dans votre application principale, vous devez d'abord initialiser le client du SDK Hub avant de pouvoir l'utiliser pour traiter les demandes. Vous pouvez simplement créer le client avec unclientId.

2. Une fois que vous avez le client, vous pouvez le connecter au SDK Device pour les intégrations gérées.

   Voici un exemple de création du client du SDK Hub et de la procédure de connexion.

   #include <cstdlib>
   #include <string>
   #include "iotshd_status.h"
   #include "iotmi_device_sdk_client.h"
   
   auto client = std::make_unique<DeviceSDKClient>(your_own_clientId);
   iotmi_statusCode_t status = client->connect();

   Note

   your_own_clientIddoit être identique à celui que vous spécifiez start-device-discoverydans la configuration guidée par l'utilisateur ou create-managed-thingdans le flux de provisionnement de configuration simple.

Publiez et abonnez-vous en suivant les étapes ci-dessous.

1. Une fois la connexion établie, vous pouvez désormais vous abonner aux tâches entrantes à partir du SDK du hub d'intégrations gérées. Les tâches entrantes peuvent être des tâches de contrôle ou des tâches de provisionnement. Vous devez également définir votre propre fonction de rappel lors de la réception des tâches et votre propre contexte personnalisé à des fins de suivi.

         // subscribe to provisioning tasks
         iotmi_statusCode_t status = client->iotmi_provision_subscribe_to_tasks(
         example_subscriber_callback, custom_context);
         
         // subscribe to control tasks
         iotmi_statusCode_t status = client->iotmi_control_subscribe_to_tasks(
         example_subscriber_callback, custom_context);

2. Une fois la connexion établie, vous pouvez désormais publier les demandes de votre application vers le SDK du Hub d'intégrations gérées. Vous pouvez définir votre propre type de message de tâche, avec différentes charges utiles pour différents objectifs commerciaux. Les demandes peuvent inclure à la fois des demandes de contrôle et des demandes de fourniture, comme dans le cas du flux d'abonnement. Enfin, vous pouvez attribuer une adresse pour rspPayload obtenir la réponse du SDK du Hub d'intégrations gérées de manière synchronisée.

   // publish control request
     iotmi_client_request_t api_payload = {
               .messageType = C2MIMessageType::C2MI_CONTROL_EVENT,
               .reqPayload = (uint8_t *)"define_your_req_payload",
               .rspPayload = (uint8_t *)calloc(1000, sizeof(uint8_t))
     };
   
     status = client->iotmi_control_publish_request(&api_payload); 
     
     // publish provision request 
     iotmi_client_request_t api_payload = {
               .messageType = C2MIMessageType::C2MI_DEVICE_ONBOARDED,
               .reqPayload = (uint8_t *)"define_your_req_payload",
               .rspPayload = (uint8_t *)calloc(1000, sizeof(uint8_t))
     };
     status = client->iotmi_provision_publish_request(&api_payload);
     

Créez le vôtre CMakeLists.txt et créez votre application à partir de là. La sortie finale peut être un fichier binaire exécutable tel que MyFirstApplication