디바이스 등록 상태 이벤트 - AWS IoT Wireless

디바이스 등록 상태 이벤트

디바이스 등록 상태 이벤트는 Sidewalk 디바이스가 프로비저닝되거나 등록된 경우와 같이 디바이스 등록 상태가 변경될 때 이벤트 알림을 게시합니다. 이 이벤트는 프로비저닝될 때부터 등록될 때까지 디바이스가 거치는 다양한 상태에 대한 정보를 제공합니다.

디바이스 등록 상태 이벤트의 작동 방식

Amazon Sidewalk 및 AWS IoT 무선로 Sidewalk 디바이스를 온보딩하면 AWS IoT 무선에서 create 작업을 수행하고 Sidewalk 디바이스를 AWS 계정에 추가합니다. 그러면 디바이스가 프로비저닝됨 상태가 되고 eventTypeprovisioned가 됩니다. 디바이스 온보딩에 대한 자세한 내용은 Amazon Sidewalk용 AWS IoT Core 시작하기 섹션을 참조하세요.

디바이스가 provisioned이 된 후 Amazon Sidewalk는 Sidewalk 디바이스를 AWS IoT 무선에 등록하는 register 작업을 수행합니다. 암호화 및 세션 키가 AWS IoT로 설정되는 등록 프로세스가 시작됩니다. 디바이스가 등록되면 eventTyperegistered가 되고 디바이스를 사용할 수 있습니다.

디바이스가 등록(registered)된 후 Sidewalk에서 디바이스를 등록 취소(deregister)하도록 요청을 보낼 수 있습니다. 그런 다음 AWS IoT 무선가 요청을 이행하고 디바이스 상태를 provisioned로 되돌립니다. 디바이스 상태에 대한 자세한 내용은 DeviceState를 참조하세요.

디바이스 등록 상태 이벤트에 대한 알림 사용

디바이스 등록 상태 예약 주제의 구독자가 메시지를 수신하려면 AWS Management Console에서 또는 API 또는 CLI를 사용하여 해당 주제에 대한 이벤트 알림을 사용하도록 설정해야 합니다. AWS 계정에 있는 모든 Sidewalk 리소스 또는 일부 리소스에 대해 이러한 이벤트를 활성화 할 수 있습니다. 이러한 이벤트를 활성화하는 방법에 대한 자세한 내용은 무선 리소스에 이벤트 사용 섹션을 참조하세요.

디바이스 등록 상태 이벤트에 대한 MQTT 주제의 형식

디바이스 등록 상태 이벤트를 알리기 위해 달러($) 기호로 시작하는 MQTT 예약 주제를 구독할 수 있습니다. 자세한 내용은 AWS IoT 개발자 안내서의 MQTT 주제를 참조하세요.

Sidewalk 디바이스 등록 상태 이벤트용으로 예약된 MQTT 주제는 다음 형식을 사용합니다.

  • 리소스 수준 주제:

    $aws/iotwireless/events/{eventName}/{eventType}/sidewalk/wireless_devices

  • 식별자 주제:

    $aws/iotwireless/events/{eventName}/{eventType}/sidewalk/{resourceType}/{resourceID}/{id}

위치:

{eventName}

{eventName}은 device_registation_state이어야 합니다.

{eventType}

{eventType}은 provisioned 또는 registered일 수 있습니다.

{resourceType}

{resourceType}은 sidewalk_accounts 또는 wireless_devices일 수 있습니다.

{resourceID}

{resourceID}는 {resourceType}이 sidewalk_accounts인 경우 amazon_id, {resourceType}이 wireless_devices인 경우 wireless_device_id입니다.

+ 와일드카드 문자를 사용하여 동시에 여러 주제를 구독할 수도 있습니다. + 와일드카드 문자는 해당 문자를 포함하는 수준의 모든 문자열과 일치합니다. 예를 들어, 가능한 모든 이벤트 유형(provisionedregistered)과 특정 Amazon ID에 등록된 모든 디바이스에 대해 알림을 받으려는 경우 다음 주제 필터를 사용할 수 있습니다.

$aws/iotwireless/events/device_registration_state/+/sidewalk/sidewalk_accounts/amazon_id/+

참고

예약된 주제를 구독하기 위해 와일드카드 문자 #을 사용할 수 없습니다. 주제 필터에 대한 자세한 내용은 AWS IoT 개발자 안내서의 MQTT 주제 필터를 참조하세요.

디바이스 등록 상태 이벤트에 대한 메시지 페이로드

디바이스 등록 상태 이벤트에 대한 알림을 사용하도록 설정하면 이벤트 알림이 JSON 페이로드와 함께 MQTT를 통해 게시됩니다. 이러한 이벤트에는 아래와 같은 페이로드 예제가 포함됩니다.

{ "eventId": "string", "eventType": "provisioned|registered", "WirelessDeviceId": "string", "timestamp": "timestamp", // Event-specific fields "operation": "create|deregister|register", "Sidewalk": { "AmazonId": "string", "SidewalkManufacturingSn": "string" } }

페이로드에는 다음과 같은 속성이 포함됩니다.

eventId

고유한 이벤트 ID(문자열)입니다.

eventType

발생한 이벤트의 유형입니다. 가능한 값은 provisioned 또는 registered입니다.

wirelessDeviceId

무선 디바이스의 식별자입니다.

timestamp

이벤트가 발생한 시점의 UNIX 타임스탬프입니다.

작업을 통해 처리 속도를 높일 수 있습니다

이벤트를 트리거한 작업입니다. 유효한 값은 create, register, deregister입니다.

sidewalk

Sidewalk Amazon ID 또는 이벤트 알림을 받을 SidewalkManufacturingSn입니다.