IoT Platform：裝置模擬器

功能說明

使用限制

• 屬性上報和事件上報支援策略推送功能。

  • 多次設定策略推送時，僅保留並執行最後一次的策略推送。

  • 連續推送的最小時間間隔為1秒。

  • 連續推送時間段最多為3小時。

• 資料格式為透傳或自訂的裝置不支援啟動裝置模擬器。

• 真實裝置線上或裝置被禁用時，不支援啟動裝置模擬器。

• 離開裝置模擬器頁面後，裝置模擬器會自動下線。

• 若尊享型執行個體下自訂了MQTT接入的認證和網域名稱，該執行個體下不支援裝置模擬器服務。自訂認證詳細內容，請參見為尊享型執行個體自訂MQTT接入認證。

操作步驟

1. 登入物聯網平台控制台。

2. 在執行個體概覽頁簽的全部環境下，找到對應的執行個體，單擊執行個體卡片。

3. 在左側導覽列，選擇裝置管理 > 裝置模擬器。

4. 選擇本次類比的裝置，單擊啟動裝置模擬器。

5. 在MQTT串連參數視窗，選擇MQTT協議版本，然後單擊確認。

   MQTT協議說明，請參見MQTT協議規範。

   

6. 選擇功能類型，推送調試指令，如下表所示。

   上行指令調試

   自訂Topic

   • 訊息上報：使用裝置模擬器發送自訂Topic訊息到物聯網平台雲端。

     1. 選擇上行指令調試 > 自訂Topic。

     2. 選擇訊息上報的自訂Topic，輸入Payload資料。

     3. 設定QoS為0或1。

     4. MQTT協議為5.0時，可設定是否為保留訊息和訊息到期時間長度（秒）。

        說明

        QoS 0的訊息到期時間長度（秒）最長為86400秒，QoS 1的訊息到期時間長度（秒）最長為604800秒。訊息到期時間長度（秒）不設定時，預設使用對應QoS訊息的最長時間長度。

     5. 單擊訊息上報。

   • 訊息訂閱：裝置訂閱自訂Topic，用於接收物聯網平台下發的訊息。

     1. 選擇上行指令調試 > 自訂Topic。

     2. 選擇訊息訂閱的自訂Topic。

     3. MQTT協議為5.0時，可設定：

        • Qos：0或1。

        • No Local（是否接收自身發布的訊息）：true（不接收）或false（接收）。

        • Retain Handling（指定訂閱時是否向裝置發送保留訊息）：

          • 0：只要客訂閱成功，服務端就發送保留訊息。

          • 1：客訂閱成功且該訂閱之前不存在，服務端才發送保留訊息。

          • 2：即使客訂閱成功，服務端也不會發送保留訊息。

     4. 單擊訂閱訊息。

   屬性上報

   使用裝置模擬器上報類比屬性值到物聯網平台雲端。

   1. 選擇上行指令調試 > 屬性上報。

   2. 選擇物模型的模組。

   3. 在屬性對應的輸入框中，選擇或輸入符合屬性資料類型和取值範圍的值。 數實值型別的屬性支援設定隨機數，random(a,b)代表整數a和整數b範圍之間的隨機數。

   4. 推送指令。

      • 發送指令：立即推送資料。

      • 策略推送： 設定推送策略。

        重要

        關閉裝置模擬器後，策略推送不再執行。

        • 定時推送：在設定好的時間推送資料，僅推送一次。

        • 連續推送：在設定好的時間段內，按照固定時間間隔，推送資料。時間間隔單位為秒。

   事件上報

   使用裝置模擬器上報類比事件到物聯網平台雲端。

   1. 選擇上行指令調試 > 事件上報。

   2. 在調試功能中選擇物模型模組。

   3. 選擇要上報的事件，輸入JSON格式的事件上報資料，如{"Power": "on"}。

   4. 推送指令。

      • 發送指令：立即推送資料。

      • 策略推送： 設定推送策略。

        重要

        關閉裝置模擬器後，策略推送不再執行。

        • 定時推送：在設定好的時間推送資料，僅推送一次。

        • 連續推送：在設定好的時間段內，按照固定時間間隔，推送資料。時間間隔單位為秒。

   下行指令調試

   自訂Topic

   從物聯網平台雲端下發自訂Topic訊息到裝置模擬器。

   1. 選擇下行指令調試 > 自訂Topic。

   2. 選擇自訂Topic，輸入Payload資料。

   3. 設定QoS為0或1。

   4. MQTT協議為5.0時，可設定是否為保留訊息和訊息到期時間長度（秒）。

      說明

      QoS 0的訊息到期時間長度（秒）最長為86400秒，QoS 1的訊息到期時間長度（秒）最長為604800秒。訊息到期時間長度（秒）不設定時，預設使用對應QoS訊息的最長時間長度。

   5. 單擊發送指令。

   屬性調試

   從物聯網平台雲端下發設定屬性值的指令給裝置模擬器或從裝置模擬器擷取指定屬性的值。

   1. 選擇下行指令調試 > 屬性調試。

   2. 在屬性輸入框輸入值，單擊調試，選擇設定。數實值型別的屬性支援設定隨機數，random(a,b)代表整數a和整數b範圍之間的隨機數。

      重要

      設定裝置屬性成功，只表示物聯平台雲端下發屬性佈建要求成功，不保證裝置端執行了該請求。所以裝置端SDK成功響應雲端設定裝置屬性值的請求後，需上報對應屬性值，裝置屬性值才能真正設定成功。

   3. 在屬性輸入框右側，單擊調試，選擇擷取。

      輸入框中將顯示擷取到的屬性值。如果裝置模擬器上沒有該屬性的資料，則資料為空白。

   服務調用

   1. 選擇下行指令調試 > 服務調用。

   2. 在調試功能中選擇物模型模組及對應服務。

   3. 在輸入框中，輸入調用服務的入參，單擊發送指令。

      輸入的服務入參資料，需為標準的JSON格式，例如{"Switch":0}。