IoT 디바이스 명령 및 이벤트 관리

디바이스 명령은 물리적 디바이스를 원격으로 관리하여 중요한 보안, 소프트웨어 및 하드웨어 업데이트를 수행하는 것 외에도 디바이스를 완벽하게 제어할 수 있는 기능을 제공합니다. 대규모 디바이스 플릿을 사용하면 디바이스가 언제 명령을 수행하는지 알면 전체 디바이스 구현을 감독할 수 있습니다. 디바이스 명령 또는 자동 업데이트는 디바이스 상태 변경을 트리거하여 새 디바이스 이벤트를 생성합니다. 이 디바이스 이벤트는 고객 관리형 대상으로 자동으로 전송되는 알림을 트리거합니다.

디바이스 명령

명령 요청은 디바이스로 전송되는 명령입니다. 명령 요청에는 전구 켜기와 같이 수행할 작업을 지정하는 페이로드가 포함됩니다. 디바이스 명령을 전송하기 위해 관리형 통합을 통해 최종 사용자를 대신하여 SendManagedThingCommand API가 호출되고 명령 요청이 디바이스로 전송됩니다.

에 대한 응답은 SendManagedThingCommand이며 가능한 경우 이를 사용하여 명령 전송 및 관련 명령 응답 워크플로를 traceId 추적할 traceId 수 있습니다.

SendManagedThingCommand API 작업에 대한 자세한 내용은 SendManagedThingCommand를 참조하세요.

UpdateState 작업

조명이 켜지는 시간과 같은 디바이스 상태를 업데이트하려면 SendManagedThingCommand API를 호출할 때 UpdateState 작업을 사용합니다. 에서 업데이트하려는 데이터 모델 속성과 새 값을 제공합니다parameters. 아래 예제는 전구OnTime의를 로 업데이트하는 SendManagedThingCommand API 요청을 보여줍니다5.

{
  "Endpoints": [
    {
      "endpointId": "1",
      "capabilities": [
        {
          "id": "matter.OnOff",
          "name": "On/Off",
          "version": "1",
          "actions": [
            {
              "name": "UpdateState",
              "parameters": {
                "OnTime": 5
              }
            }
          ]
        }
      ]
    }
  ]
}

ReadState 작업

모든 데이터 모델 속성의 현재 값을 포함하여 디바이스의 최신 상태를 가져오려면 SendManagedThingCommand API를 호출할 때 ReadState 작업을 사용합니다. 에서는 다음 옵션을 사용할 propertiesToRead수 있습니다.

• 조명이 켜져 있는지 또는 꺼져 있는지 OnOff 확인하는 등 최신 값을 얻기 위해 특정 데이터 모델 속성을 제공합니다.

• 와일드카드 연산자(*)를 사용하여 기능에 대한 모든 디바이스 상태 속성을 읽습니다.

아래 예제에서는 ReadState 작업을 사용하는 SendManagedThingCommand API 요청에 대한 두 시나리오를 모두 보여줍니다.

{
  "Endpoints": [
    {
      "endpointId": "1",
      "capabilities": [
        {
          "id": "aws.OnOff",
          "name": "On/Off",
          "version": "1",
          "actions": [
            {
              "name": "ReadState",
              "parameters": {
                "propertiesToRead": [ "OnOff" ]
              }
            }
          ]
        }
      ]
    }
  ]
}

{
  "Endpoints": [
    {
      "endpointId": "1",
      "capabilities": [
        {
          "id": "aws.OnOff",
          "name": "On/Off",
          "version": "1",
          "actions": [
            {
              "name": "ReadState",
              "parameters": {
                "propertiesToRead": [ "*" ]
              }
            }
          ]
        }
      ]
    }
  ]}

디바이스 이벤트

디바이스 이벤트에는 디바이스의 현재 상태가 포함됩니다. 이는 디바이스가 상태를 변경했거나 상태가 변경되지 않은 경우에도 상태를 보고하고 있음을 의미할 수 있습니다. 여기에는 데이터 모델에 정의된 속성 보고서 및 이벤트가 포함됩니다. 휴지통 주기가 완료되었거나 온도 조절기가 최종 사용자가 설정한 목표 온도에 도달한 이벤트일 수 있습니다.

디바이스 이벤트 알림

최종 사용자는 특정 디바이스 이벤트에 대한 업데이트를 위해 생성한 특정 고객 관리 대상을 구독할 수 있습니다. 고객 관리형 대상을 생성하려면 CreateDestination API를 호출합니다. 디바이스에서 디바이스 이벤트를 관리형 통합에 보고하면 고객 관리형 대상이 있는 경우 알림을 받습니다.