物聯網平臺提供的設備模擬器，可模擬真實設備與物聯網平臺建立連接。您可使用模擬數據，測試物聯網平臺與設備端之間的通信功能，并定位問題。本文介紹設備模擬接入物聯網平臺并進行通信的具體操作。
功能說明
通過設備模擬器，可調試設備通信功能。具體功能如下：
功能項 | 說明 |
上行指令調試 | 設備上報消息到物聯網平臺，包含：
|
下行指令調試 | 物聯網平臺下發指令到設備，包含：
|
設備模擬器啟動后，會自動訂閱基礎通信Topic和物模型Topic。詳細說明，請參見使用消息通信Topic。
使用限制
MQTT型企業版實例下設備不支持使用設備模擬器。
屬性上報和事件上報支持策略推送功能。
多次設置策略推送時，僅保留并執行最后一次的策略推送。
連續推送的最小時間間隔為1秒。
連續推送時間段最多為3小時。
數據格式為透傳或自定義的設備不支持啟動設備模擬器。
真實設備在線或設備被禁用時，不支持啟動設備模擬器。
離開設備模擬器頁面后，設備模擬器會自動下線。
若尊享型實例下自定義了MQTT接入的證書和域名，該實例下不支持設備模擬器服務。自定義證書詳細內容，請參見為尊享型實例自定義MQTT接入證書。
操作步驟
登錄物聯網平臺控制臺。
在實例概覽頁簽的全部環境下，找到對應的實例，單擊實例卡片。
在左側導航欄，選擇。
選擇本次模擬的設備，單擊啟動設備模擬器。
在MQTT連接參數窗口，選擇MQTT協議版本，然后單擊確認。
MQTT協議說明，請參見MQTT協議規范。
選擇功能類型，推送調試指令，如下表所示。
上行指令調試
自定義Topic
消息上報：使用設備模擬器發送自定義Topic消息到物聯網平臺云端。
選擇。
選擇消息上報的自定義Topic，輸入Payload數據。
設置QoS為0或1。
MQTT協議為5.0時，可設置是否為保留消息和消息過期時長（秒）。
說明QoS 0的消息過期時長（秒）最長為86400秒，QoS 1的消息過期時長（秒）最長為604800秒。消息過期時長（秒）不設置時，默認使用對應QoS消息的最長時長。
單擊消息上報。
消息訂閱：設備訂閱自定義Topic，用于接收物聯網平臺下發的消息。
選擇。
選擇消息訂閱的自定義Topic。
MQTT協議為5.0時，可設置：
Qos：0或1。
No Local（是否接收自身發布的消息）：true（不接收）或false（接收）。
Retain Handling（指定訂閱時是否向設備發送保留消息）：
0：只要客戶端訂閱成功，服務端就發送保留消息。
1：客戶端訂閱成功且該訂閱之前不存在，服務端才發送保留消息。
2：即使客戶端訂閱成功，服務端也不會發送保留消息。
單擊訂閱消息。
屬性上報
使用設備模擬器上報模擬屬性值到物聯網平臺云端。
選擇。
選擇物模型的模塊。
在屬性對應的輸入框中，選擇或輸入符合屬性數據類型和取值范圍的值。 數值類型的屬性支持設置隨機數，
random(a,b)代表整數a和整數b范圍之間的隨機數。推送指令。
發送指令：立即推送數據。
策略推送： 設置推送策略。
重要關閉設備模擬器后，策略推送將不再執行。
定時推送：在設置好的時間推送數據，僅推送一次。
連續推送：在設置好的時間段內，按照固定時間間隔，推送數據。時間間隔單位為秒。
事件上報
使用設備模擬器上報模擬事件到物聯網平臺云端。
選擇。
在調試功能中選擇物模型模塊。
選擇要上報的事件，輸入JSON格式的事件上報數據，如
{"Power": "on"}。推送指令。
發送指令：立即推送數據。
策略推送： 設置推送策略。
重要關閉設備模擬器后，策略推送不再執行。
定時推送：在設置好的時間推送數據，僅推送一次。
連續推送：在設置好的時間段內，按照固定時間間隔，推送數據。時間間隔單位為秒。
下行指令調試
自定義Topic
從物聯網平臺云端下發自定義Topic消息到設備模擬器。
選擇。
選擇自定義Topic，輸入Payload數據。
設置QoS為0或1。
MQTT協議為5.0時，可設置是否為保留消息和消息過期時長（秒）。
說明QoS 0的消息過期時長（秒）最長為86400秒，QoS 1的消息過期時長（秒）最長為604800秒。消息過期時長（秒）不設置時，默認使用對應QoS消息的最長時長。
單擊發送指令。
屬性調試
從物聯網平臺云端下發設置屬性值的指令給設備模擬器或從設備模擬器獲取指定屬性的值。
選擇。
在屬性輸入框輸入值，單擊調試，選擇設置。數值類型的屬性支持設置隨機數，
random(a,b)代表整數a和整數b范圍之間的隨機數。重要設置設備屬性成功，只表示物聯平臺云端下發屬性設置請求成功，不保證設備端執行了該請求。所以設備端SDK成功響應云端設置設備屬性值的請求后，需上報對應屬性值，設備屬性值才能真正設置成功。
在屬性輸入框右側，單擊調試，選擇獲取。
輸入框中將顯示獲取到的屬性值。如果設備模擬器上沒有該屬性的數據，則數據為空。
服務調用
選擇。
在調試功能中選擇物模型模塊及對應服務。
在輸入框中，輸入調用服務的入參，單擊發送指令。
輸入的服務入參數據，需為標準的JSON格式，例如
{"Switch":0}。
執行結果
推送數據后，可在頁面右側設備端日志區域查看策略推送開啟狀態、日志時間、日志內容等信息。
屬性上報示例如下。
單擊查看云端日志，將跳轉到云端運行日志頁簽，可查詢相關云端日志。
更多信息，請參見云端運行日志。
