Client Hub SDK

Includete i file di intestazione (.h) e i file di oggetti condivisi (.so) nell'applicazione.

È necessario includere i file di intestazione pubblici (.h) e i file di oggetti condivisi (.so) nell'applicazione. Per i file.so, potete metterli in una cartella lib. Il layout finale sarà simile al seguente:

├── 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

Crea un client Hub SDK nell'applicazione principale.

1. Nell'applicazione principale, è necessario inizializzare il client Hub SDK prima che possa essere utilizzato per elaborare le richieste. Puoi semplicemente creare il client con un. clientId

2. Dopo aver ottenuto il client, puoi collegarlo al Device SDK delle integrazioni gestite.

   Di seguito è riportato un esempio di creazione del client Hub SDK e di come connettersi.

   #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();

   Nota

   your_own_clientIddeve essere uguale a quello specificato nella configurazione guidata dall'utente o start-device-discoverynel flusso di provisioning di Simple Setup. create-managed-thing

Pubblica e sottoscrivi effettuando le seguenti operazioni.

1. Dopo aver stabilito la connessione, ora puoi iscriverti alle attività in entrata dall'Hub SDK per le integrazioni gestite. Le attività in entrata possono essere attività di controllo o attività di fornitura. È inoltre necessario definire la propria funzione di callback in base alle attività ricevute e il proprio contesto personalizzato per i propri scopi di tracciamento.

         // 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. Dopo aver stabilito la connessione, ora puoi pubblicare le richieste dall'applicazione all'SDK Hub per le integrazioni gestite. È possibile definire il proprio tipo di messaggio di attività, con payload diversi per scopi aziendali diversi. Le richieste possono includere sia richieste di controllo che richieste di fornitura, in modo simile al flusso di iscrizione. Infine, puoi assegnare un indirizzo per rspPayload ricevere la risposta dall'Hub SDK delle integrazioni gestite in modo sincronizzato.

   // 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);
     

Creane uno tuo CMakeLists.txt e crea la tua applicazione partendo da lì. L'output finale potrebbe essere un file binario eseguibile come MyFirstApplication