教學課程：使用 AWS IoT 裝置 SDK 將裝置連接至 AWS IoT Core

1. 開始練習之前，請試著從裝置上的 AWS IoT Core 教學課程入門 教學課程執行此命令，確保所有項目都準備好進行練習。

   cd ~/aws-iot-device-sdk-python-v2/samples
   python3 pubsub.py --topic topic_1 --ca_file ~/certs/Amazon-root-CA-1.pem --cert ~/certs/device.pem.crt --key ~/certs/private.pem.key --endpoint your-iot-endpoint
   

   您應該會看到與在教學課程入門中看到的相同輸出。

2. 在此練習中，請變更這些命令列參數。

   動作	命令列參數	Effect
   add	--message ""	僅限配置 pubsub.py 加以聆聽
   add	--count 2	收到兩則訊息後結束程式
   change	--topic device/+/details	定義要訂閱的主題篩選條件

   對初始命令列進行這些變更會產生此命令列。在裝置的終端機視窗中輸入此命令。

   python3 pubsub.py --message "" --count 2 --topic device/+/details --ca_file ~/certs/Amazon-root-CA-1.pem --cert ~/certs/device.pem.crt --key ~/certs/private.pem.key --endpoint your-iot-endpoint
   

   程式應該會顯示如下所示的內容：

   Connecting to a3qexamplesffp-ats.iot.us-west-2.amazonaws.com with client ID 'test-24d7cdcc-cc01-458c-8488-2d05849691e1'...
   Connected!
   Subscribing to topic 'device/+/details'...
   Subscribed with QoS.AT_LEAST_ONCE
   Waiting for all messages to be received...
   

   若您在終端機上看到類似的內容，表示您的裝置已準備就緒，且會收聽主題名稱開頭為 device，結尾為 /detail 的訊息。所以，讓我們來進行測試。

3. 以下為您的裝置可能會收到的幾個訊息。

   主題名稱	訊息承載
   device/temp/details	{ "desiredTemp": 20, "currentTemp": 15 }
   device/light/details	{ "desiredLight": 100, "currentLight": 50 }

4. 在 AWS IoT 主控台中使用 MQTT 測試用戶端，將上一個步驟中說明的訊息傳送至您的裝置。

   1. 在 AWS IoT 主控台中開啟 MQTT 測試用戶端。

   2. 於 Subscribe to a topic (訂閱主題) 的 Subscription topic (訂閱主題) 欄位中，輸入主題篩選條件：device/+/details，再選擇 Subscribe to topic (訂閱主題)。

   3. 在 MQTT 測試用戶端的 Subscriptions (訂閱) 欄中，選擇 device/+/details。

   4. 若為上表中的每個主題，請於 MQTT 測試用戶端中執行下列動作：

      1. 於 Publish (發佈) 中，輸入來自表格中 Topic name (主題名稱) 欄的值。

      2. 在主題名稱下方的訊息承載欄位中，輸入來自表格中 Message payload (訊息承載) 欄的值。

      3. 觀看 pubsub.py 正在執行的終端機視窗，並在 MQTT 測試用戶端中，選擇 Publish to topic (發佈至主題)。

      您應該看到該訊息是由終端機視窗中的 pubsub.py 所收到。

如要評估訊息主題

1. 將 pubsub.py 複製至 pubsub2.py。

2. 以您最愛的文字編輯器或 IDE 中開啟 pubsub2.py 檔案。

3. 在 pubsub2.py 中，尋找 on_message_received 函數。

4. 在 on_message_received 中，請在以 print("Received message 開頭的行之後及以 global received_count 開頭的行之前插入下列程式碼。

       topic_parsed = False
       if "/" in topic:
           parsed_topic = topic.split("/")
           if len(parsed_topic) == 3:
               # this topic has the correct format
               if (parsed_topic[0] == 'device') and (parsed_topic[2] == 'details'):
                   # this is a topic we care about, so check the 2nd element
                   if (parsed_topic[1] == 'temp'):
                       print("Received temperature request: {}".format(payload))
                       topic_parsed = True
                   if (parsed_topic[1] == 'light'):
                       print("Received light request: {}".format(payload))
                       topic_parsed = True
       if not topic_parsed:
           print("Unrecognized message topic.")
   

5. 儲存您的變更，並使用此命令列執行修改後的程式。

   python3 pubsub2.py --message "" --count 2 --topic device/+/details --ca_file ~/certs/Amazon-root-CA-1.pem --cert ~/certs/device.pem.crt --key ~/certs/private.pem.key --endpoint your-iot-endpoint
   

6. 在 AWS IoT 主控台中，開啟 MQTT 測試用戶端。

7. 於 Subscribe to a topic (訂閱主題) 的 Subscription topic (訂閱主題) 欄位中，輸入主題篩選條件：device/+/details，再選擇 Subscribe to topic (訂閱主題)。

8. 在 MQTT 測試用戶端的 Subscriptions (訂閱) 欄中，選擇 device/+/details。

9. 若為此表格中的每個主題，請在 MQTT 測試用戶端中執行下列動作：

   主題名稱	訊息承載
   device/temp/details	{ "desiredTemp": 20, "currentTemp": 15 }
   device/light/details	{ "desiredLight": 100, "currentLight": 50 }

   1. 於 Publish (發佈) 中，輸入來自表格中 Topic name (主題名稱) 欄的值。

   2. 在主題名稱下方的訊息承載欄位中，輸入來自表格中 Message payload (訊息承載) 欄的值。

   3. 觀看 pubsub.py 正在執行的終端機視窗，並在 MQTT 測試用戶端中，選擇 Publish to topic (發佈至主題)。

   您應該看到該訊息是由終端機視窗中的 pubsub.py 所收到。

如要準備 MQTT 測試用戶端監控本練習的訊息

1. 於 Subscribe to a topic (訂閱主題) 的 Subscription topic (訂閱主題) 欄位中，輸入主題篩選條件：device/data，再選擇 Subscribe to topic (訂閱主題)。

2. 在 MQTT 測試用戶端的 Subscriptions (訂閱) 欄中，選擇 device/data。

3. 讓 MQTT 測試用戶端視窗保持開啟狀態，以等待來自您裝置的訊息。

如要使用 pubsub.py 範例應用程式傳送 JSON 文件

1. 在您的裝置上，將 pubsub.py 複製至 pubsub3.py。

2. Edit (編輯) pubsub3.py，變更其格式化所發佈訊息的方式。

   1. 在文字編輯器中開啟 pubsub3.py。

   2. 找出這行程式碼：

      message = "{} [{}]".format(message_string, publish_count)

   3. 將其變更為：

      message = "{}".format(message_string)

   4. 找出這行程式碼：

      message_json = json.dumps(message)

   5. 將其變更為：

      message = "{}".json.dumps(json.loads(message))

   6. 儲存您的變更。

3. 在您的裝置上，執行此命令以傳送訊息兩次。

   python3 pubsub3.py  --ca_file ~/certs/Amazon-root-CA-1.pem  --cert ~/certs/device.pem.crt  --key ~/certs/private.pem.key  --topic device/data  --count 2 --message '{"timestamp":1601048303,"sensorId":28,"sensorData":[{"sensorName":"Wind speed","sensorValue":34.2211224}]}'  --endpoint your-iot-endpoint
   

4. 於 MQTT 測試用戶端中，檢查是否已解譯並格式化訊息承載中的 JSON 文件，例如：