자습서: 샘플 앱 및 MQTT 테스트 클라이언트를 사용하여 디바이스 섀도우와 상호 작용

MQTT 테스트 클라이언트 열기

MQTT 테스트 클라이언트의 구성을 잃지 않고 MQTT 주제에서 수신한 메시지를 관찰할 수 있도록 새 창에서 AWS IoT 콘솔의 MQTT 테스트 클라이언트를 엽니다. MQTT 테스트 클라이언트는 콘솔의 다른 페이지로 이동하기 위해 나가면 구독 또는 메시지 로그를 유지하지 않습니다. 자습서의 이 섹션에서는 AWS IoT 사물의 섀도우 문서와 MQTT 테스트 클라이언트를 별도의 창에서 열어 디바이스 섀도우와의 상호 작용을 보다 쉽게 ​​관찰할 수 있습니다.

MQTT 예약 섀도우 주제 구독

MQTT 테스트 클라이언트를 사용하여 디바이스 섀도우의 MQTT 예약 주제 이름을 입력하고 shadow.py 샘플 앱 실행 시 업데이트를 수신하도록 구독할 수 있습니다. 주제를 구독하려면:

1. AWS IoT 콘솔의 MQTT 테스트 클라이언트에서 주제 구독(Subscribe to a topic)을 선택합니다.

2. 주제 필터(Topic filter) 섹션에 $aws/things/thingname/shadow/update/#을 입력합니다. 여기서 thingname은 이전에 생성한 사물 리소스의 이름(예: My_light_bulb)입니다

3. 추가 구성 설정에 대한 기본값을 유지한 후 구독(Subscribe)을 선택합니다.

주제 구독에서 # 와일드카드를 사용하여 여러 MQTT 주제를 동시에 구독하고 디바이스와 섀도우 간에 교환되는 모든 메시지를 단일 창에서 관찰할 수 있습니다. 와일드카드 문자 및 해당 사용에 대한 자세한 내용은 MQTT 주제 단원을 참조하세요.

shadow.py 샘플 프로그램 실행 및 메시지 관찰

Raspberry Pi의 명령줄 창에서 프로그램 연결을 끊었다면 샘플 앱을 다시 실행하고 AWS IoT 콘솔의 MQTT 테스트 클라이언트에서 메시지를 확인합니다.

1. 다음 명령을 실행하여 샘플 프로그램을 다시 시작하세요. your-iot-thing-name 및 your-iot-endpoint를 이전에 생성한 AWS IoT 사물의 이름(예: My_light_bulb) 및 디바이스와 상호 작용할 엔드포인트로 바꿉니다.

   cd ~/aws-iot-device-sdk-python-v2/samples
   python3 shadow.py --ca_file ~/certs/Amazon-root-CA-1.pem --cert ~/certs/device.pem.crt --key ~/certs/private.pem.key --endpoint your-iot-endpoint --thing_name your-iot-thing-name

   shadow.py 샘플 앱이 실행되고 현재 섀도우 상태가 검색됩니다. 섀도우를 삭제했거나 현재 상태를 지운 경우 프로그램은 현재 값을 off로 설정한 다음 desired 값을 입력하라는 메시지를 표시합니다.

   Connecting to a3qEXAMPLEffp-ats.iot.us-west-2.amazonaws.com with client ID 'test-0c8ae2ff-cc87-49d2-a82a-ae7ba1d0ca5a'...
   Connected!
   Subscribing to Delta events...
   Subscribing to Update responses...
   Subscribing to Get responses...
   Requesting current shadow state...
   Launching thread to read user input...
   Finished getting initial shadow state.
   Shadow document lacks 'color' property. Setting defaults...
   Changed local shadow value to 'off'.
   Updating reported shadow value to 'off'...
   Update request published.
   Finished updating reported shadow value to 'off'...
   Enter desired value:

   반면에 프로그램이 실행 중이었고 다시 시작하면 터미널에 최신 색상 값이 보고됩니다. MQTT 테스트 클라이언트에서 $aws/things/thingname/shadow/get 및 $aws/things/thingname/shadow/get/accepted 주제에 대한 업데이트를 볼 수 있습니다.

   보고된 최신 색상이 green이라고 가정합니다. 다음은 $aws/things/thingname/shadow/get/accepted JSON 파일의 내용을 보여줍니다.

   {
   "state": {
     "desired": {
       "welcome": "aws-iot",
       "color": "green"
     },
     "reported": {
       "welcome": "aws-iot",
       "color": "green"
     }
   },
   "metadata": {
     "desired": {
       "welcome": {
         "timestamp": 1620156892
       },
       "color": {
         "timestamp": 1620161643
       }
     },
     "reported": {
       "welcome": {
         "timestamp": 1620156892
       },
       "color": {
         "timestamp": 1620161643
       }
     }
   },
   "version": 10,
   "timestamp": 1620173908
   }            
                 

2. 터미널에 desired 값(예: yellow)을 입력합니다. shadow.py 샘플 앱은 reported 값이 yellow로 변경되었음을 보여주는 다음 메시지를 터미널에 응답으로 표시합니다.

   Enter desired value:
   yellow
   Changed local shadow value to 'yellow'.
   Updating reported shadow value to 'yellow'...
   Update request published.
   Finished updating reported shadow value to 'yellow'.

   AWS IoT 콘솔의 MQTT 테스트 클라이언트(MQTT test client)에서 구독(Subscriptions) 아래에 다음 주제가 메시지를 수신한 것이 표시됩니다.

   • $aws/things/thingname/shadow/update: desired 및 updated 값이 모두 yellow 색상으로 변경되었음을 보여줍니다.

   • $aws/things/thingname/shadow/update/accepted: desired 및 reported 상태의 현재 값과 해당 메타데이터 및 버전 정보를 보여줍니다.

   • $aws/things/thingname/shadow/update/documents: desired 및 reported 상태의 이전 및 현재 값과 해당 메타데이터 및 버전 정보를 보여줍니다.

   $aws/things/thingname/shadow/update/documents 문서에도 다른 두 주제에 포함된 정보가 있으므로 이를 검토하여 상태 정보를 볼 수 있습니다. 이전 상태는 green으로 설정된 보고 값, 해당 메타데이터 및 버전 정보, 보고 값이 yellow로 업데이트된 현재 상태를 보여줍니다.

   {
   "previous": {
     "state": {
       "desired": {
         "welcome": "aws-iot",
         "color": "green"
       },
       "reported": {
         "welcome": "aws-iot",
         "color": "green"
       }
     },
     "metadata": {
       "desired": {
         "welcome": {
           "timestamp": 1617297888
         },
         "color": {
           "timestamp": 1617297898
         }
       },
       "reported": {
         "welcome": {
           "timestamp": 1617297888
         },
         "color": {
           "timestamp": 1617297898
         }
       }
     },
     "version": 10
   },
   "current": {
     "state": {
       "desired": {
         "welcome": "aws-iot",
         "color": "yellow"
       },
       "reported": {
         "welcome": "aws-iot",
         "color": "yellow"
       }
     },
     "metadata": {
       "desired": {
         "welcome": {
           "timestamp": 1617297888
         },
         "color": {
           "timestamp": 1617297904
         }
       },
       "reported": {
         "welcome": {
           "timestamp": 1617297888
         },
         "color": {
           "timestamp": 1617297904
         }
       }
     },
     "version": 11
   },
   "timestamp": 1617297904
   }

3. 이제 다른 desired 값을 입력하면 이러한 주제에서 수신한 reported 값 및 메시지 업데이트에 대한 추가 변경 사항을 볼 수 있습니다. 버전 번호도 1씩 증가합니다. 예를 들어 값 green을 입력하면 이전 상태는 값 yellow를 보고하고 현재 상태는 값 green을 보고합니다.

델타 이벤트를 관찰하기 위해 섀도우 문서 편집

델타 주제의 변경 내용을 관찰하려면 AWS IoT 콘솔의 섀도우 문서를 편집합니다. 예를 들어 desired 값을 red 색상으로 변경할 수 있습니다. 이렇게 하려면 AWS IoT 콘솔에서 편집(Edit)을 선택한 다음 JSON에서 desired 값을 빨간색으로 설정하고 reported 값은 green으로 유지합니다. 변경 사항을 저장하기 전에 터미널에 보고된 델타 메시지가 표시되므로 터미널을 열어 두세요.

{
"desired": {
  "welcome": "aws-iot",
  "color": "red"
},
"reported": {
  "welcome": "aws-iot",
  "color": "green"
}
}

shadow.py 샘플 앱은 이 변경에 응답하고 델타를 나타내는 메시지를 터미널에 표시합니다. MQTT 테스트 클라이언트에서 update 주제는 desired 및 reported 값의 변경 사항을 보여주는 메시지를 수신합니다.

또한 $aws/things/thingname/shadow/update/delta 주제에서 메시지를 수신한 것을 볼 수 있습니다. 메시지를 보려면 구독(Subscriptions) 아래에 나열된 이 주제를 선택하세요.

{
"version": 13,
"timestamp": 1617318480,
"state": {
  "color": "red"
},
"metadata": {
  "color": {
    "timestamp": 1617318480
  }
}
}