Cliente Hub SDK

Inclua os arquivos de cabeçalho (.h) e os arquivos de objetos compartilhados (.so) em seu aplicativo.

Você deve incluir os arquivos de cabeçalho públicos (.h) e os arquivos de objetos compartilhados (.so) em seu aplicativo. Para os arquivos.so, você pode colocá-los em uma pasta lib. O layout final será semelhante a este:

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

Crie um cliente Hub SDK em seu aplicativo principal.

1. Em seu aplicativo principal, você deve primeiro inicializar o cliente Hub SDK antes que ele possa ser usado para processar solicitações. Você pode simplesmente construir o cliente com umclientId.

2. Depois de ter o cliente, você pode conectá-lo ao Device SDK de integrações gerenciadas.

   Veja a seguir um exemplo de como criar o cliente Hub SDK e como se conectar.

   #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 ser a mesma especificada start-device-discoveryna configuração guiada pelo usuário ou create-managed-thingno fluxo de provisionamento de configuração simples.

Publique e assine seguindo as etapas a seguir.

1. Depois que a conexão for estabelecida, agora você poderá assinar as tarefas recebidas do SDK do Hub de integrações gerenciadas. As tarefas recebidas podem ser tarefas de controle ou tarefas de provisionamento. Você também precisa definir sua própria função de retorno de chamada nas tarefas recebidas e seu próprio contexto personalizado para seus próprios propósitos de rastreamento.

         // 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. Depois que a conexão for estabelecida, agora você poderá publicar solicitações do seu aplicativo no SDK do Hub de integrações gerenciadas. Você pode definir seu próprio tipo de mensagem de tarefa, com cargas diferentes para diferentes fins comerciais. As solicitações podem incluir solicitações de controle e solicitações de provisão, de forma semelhante ao fluxo de assinatura. Por fim, você pode atribuir um endereço para obter rspPayload a resposta do SDK do Hub de integrações gerenciadas 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);
     

Crie o seu próprio CMakeLists.txt e crie seu aplicativo a partir daí. A saída final pode ser um binário executável, como MyFirstApplication