허브 제어

데이터 모델용 코드 생성기의 지침에 따라 하위 수준 C 코드를 생성합니다.

엔드 디바이스 SDK 통합의 지침에 따라 다음을 수행합니다.

1. 빌드 환경 설정

   Amazon Linux 2023/x86_64에서 개발 호스트로 코드를 빌드합니다. 필요한 빌드 종속성을 설치합니다.

   dnf install make gcc gcc-c++ cmake

2. 하드웨어 콜백 함수 개발

   하드웨어 콜백 함수를 구현하기 전에 API의 작동 방식을 이해합니다. 이 예제에서는 On/Off 클러스터 및 OnOff 속성을 사용하여 디바이스 함수를 제어합니다. API 세부 정보는 섹션을 참조하세요하위 수준 C-Function 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. 엔드포인트 및 후크 하드웨어 콜백 함수 설정

   함수를 구현한 후 엔드포인트를 생성하고 콜백을 등록합니다. 다음 작업을 완료합니다.

   1. 디바이스 에이전트 생성

   2. 지원하려는 각 클러스터 구조체의 콜백 함수 포인트 채우기

   3. 엔드포인트 설정 및 지원되는 클러스터 등록

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

코드 생성 파일을 example 폴더로 이동합니다.

cp codegen/out/* example/dm

허브 제어를 빌드하려면 다음 명령을 실행합니다.

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 .

HubOnboarding 및 MQTTProxy 구성 요소가 실행 중인 상태에서 허브의 MQTTProxy 구성 요소를 사용하여 예제를 실행합니다.

./examples/iotmi_device_sample_camera/iotmi_device_sample_camera