Cliente Hub SDK

Incluya los archivos de encabezado (.h) y los archivos de objetos compartidos (.so) en su aplicación.

Debe incluir los archivos de encabezado públicos (.h) y los archivos de objetos compartidos (.so) en su aplicación. En el caso de los archivos.so, puede colocarlos en una carpeta lib. El diseño final será similar al siguiente:

├── 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 cliente Hub SDK en tu aplicación principal.

1. En tu aplicación principal, primero debes inicializar el cliente del SDK de Hub antes de que pueda usarse para procesar las solicitudes. Simplemente puede crear el cliente con unclientId.

2. Una vez que tenga el cliente, puede conectarlo al SDK de dispositivos de integraciones administradas.

   A continuación, se muestra un ejemplo de cómo crear el cliente del SDK de Hub y cómo conectarlo.

   #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_clientIddebe ser el mismo que especificó en la configuración guiada por el usuario o start-device-discoveryen el flujo de create-managed-thingaprovisionamiento de la configuración simple.

Para publicar y suscribirse, siga estos pasos.

1. Una vez establecida la conexión, ya puedes suscribirte a las tareas entrantes desde el SDK de Hub para integraciones gestionadas. Las tareas entrantes pueden ser tareas de control o tareas de aprovisionamiento. También debes definir tu propia función de devolución de llamadas en función de las tareas recibidas y tu propio contexto personalizado para tus propios fines de seguimiento.

         // 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. Una vez establecida la conexión, ahora puedes publicar las solicitudes de tu aplicación en el SDK de Hub para integraciones gestionadas. Puedes definir tu propio tipo de mensaje de tarea, con diferentes cargas útiles para distintos fines empresariales. Las solicitudes pueden incluir tanto solicitudes de control como solicitudes de aprovisionamiento, de forma similar al flujo de suscripción. Por último, puedes asignarte una dirección rspPayload para obtener la respuesta del SDK de Hub de integraciones gestionadas de forma sincronizada.

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

Cree la suya propia CMakeLists.txt y cree su aplicación a partir de ahí. El resultado final podría ser un archivo binario ejecutable, como MyFirstApplication