Control del hub

Siga las instrucciones del generador de códigos para Data Model para generar el código C de bajo nivel.

Siga las instrucciones de Integrar el SDK para dispositivos finales para:

1. Configure el entorno de compilación

   Compila el código en Amazon Linux 2023/x86_64 como host de desarrollo. Instale las dependencias de compilación necesarias:

   dnf install make gcc gcc-c++ cmake

2. Desarrolle funciones de devolución de llamadas de hardware

   Antes de implementar las funciones de devolución de llamada del hardware, comprenda cómo funciona la API. En este ejemplo, se utilizan el On/Off clúster y el OnOff atributo para controlar la función de un dispositivo. Para obtener más información sobre la API, consulteFunción C de bajo nivel APIs.

   struct DeviceState
   {
     struct iotmiDev_Agent *agent;
     struct iotmiDev_Endpoint *endpointLight;
     /* This simulates the HW state of OnOff */
     bool hwState;   
   };
   
   /* This implementation for OnOff getter just reads
      the state from the DeviceState */
   iotmiDev_DMStatus exampleGetOnOff(bool *value, void *user)
   {
      struct DeviceState *state = (struct DeviceState *)(user);
     *value = state->hwState;
     return iotmiDev_DMStatusOk;
   }

3. Configure los puntos finales y conecte las funciones de devolución de llamada del hardware

   Tras implementar las funciones, cree puntos finales y registre las devoluciones de llamada. Complete estas tareas:

   1. Cree un agente de dispositivo

   2. Rellene los puntos de la función de devolución de llamada para cada estructura de clúster que desee admitir

   3. Configure los puntos finales y registre los clústeres compatibles

   struct DeviceState
   {
       struct iotmiDev_Agent * agent;
       struct iotmiDev_Endpoint *endpoint1;
   
       /* OnOff cluster states*/
       bool hwState;
   };
   
   
   /* This implementation for OnOff getter just reads
      the state from the DeviceState */
   iotmiDev_DMStatus exampleGetOnOff( bool * value, void * user )
   {
       struct DeviceState * state = ( struct DeviceState * ) ( user );
       *value = state->hwState;
       printf( "%s(): state->hwState: %d\n", __func__, state->hwState );
       return iotmiDev_DMStatusOk;
   }
   
   iotmiDev_DMStatus exampleGetOnTime( uint16_t * value, void * user )
   {
       *value = 0;
       printf( "%s(): OnTime is %u\n", __func__, *value );
       return iotmiDev_DMStatusOk;
   }
   
   iotmiDev_DMStatus exampleGetStartUpOnOff( iotmiDev_OnOff_StartUpOnOffEnum * value, void * user )
   {
       *value = iotmiDev_OnOff_StartUpOnOffEnum_Off;
       printf( "%s(): StartUpOnOff is %d\n", __func__, *value );
       return iotmiDev_DMStatusOk;
   }
   
   void setupOnOff( struct DeviceState *state )
   {
       struct iotmiDev_clusterOnOff clusterOnOff = {
           .getOnOff = exampleGetOnOff,
           .getOnTime = exampleGetOnTime,
           .getStartUpOnOff = exampleGetStartUpOnOff,
       };
       iotmiDev_OnOffRegisterCluster( state->endpoint1,
                                       &clusterOnOff,
                                       ( void * ) state);
   }
   
   
   /* Here is the sample setting up an endpoint 1 with OnOff
      cluster. Note all error handling code is omitted. */
   void setupAgent(struct DeviceState *state)
   {
       struct iotmiDev_Agent_Config config = {
           .thingId = IOTMI_DEVICE_MANAGED_THING_ID,
           .clientId = IOTMI_DEVICE_CLIENT_ID,
       };
       iotmiDev_Agent_InitDefaultConfig(&config);
   
       /* Create a device agent before calling other SDK APIs */
       state->agent = iotmiDev_Agent_new(&config);
       
       /* Create endpoint#1 */
       state->endpoint1 = iotmiDev_Agent_addEndpoint( state->agent,
                                                       1,
                                                       "Data Model Handler Test Device",
                                                       (const char*[]){ "Camera" },
                                                       1 );
       setupOnOff(state);
   }
   

Mueva los archivos generados por el código a la example carpeta:

cp codegen/out/* example/dm

Para crear hub control, ejecute los siguientes comandos:

cd <hub-control-root-folder>

mkdir build

cd build

cmake -DBUILD_EXAMPLE_WITH_MQTT_PROXY=ON -DIOTMI_USE_MANAGED_INTEGRATIONS_DEVICE_LOG=ON ..

cmake -build .

Ejecute los ejemplos con el MQTTProxy componente del hub y con los MQTTProxy componentes HubOnboarding y ejecutándose.

./examples/iotmi_device_sample_camera/iotmi_device_sample_camera