全部產品
Search
文件中心

IoT Platform:線上調試

更新時間:Oct 17, 2025

裝置端開發完成後,您可以使用物聯網平台的線上調試功能,從物聯網平台控制台下髮指令到裝置端進行物模型功能測試。本文介紹物模型功能調試的操作步驟。

前提條件

  • 裝置所屬產品,已定義物模型功能。具體內容,請參見添加物模型

  • 裝置已接入物聯網平台並啟用線上。裝置端開發並接入物聯網平台的方法,請參見裝置接入Link SDK

    說明

    您也可通過物聯網平台的裝置模擬器或MQTT.fx工具類比裝置線上後,使用線上調試功能調試線上裝置的功能。具體操作,請參見裝置模擬器使用MQTT.fx接入物聯網平台

    類比裝置線上後會產生裝置Topic,相關訊息Topic訂閱和使用說明,請參見產生裝置Topic

使用限制

僅支援使用MQTT協議串連的裝置進行物模型功能調試。

功能調試

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

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

  3. 在左側導覽列,選擇監控營運 > 線上調試

  4. 線上調試頁面,選擇本次調試的裝置。

  5. 選擇屬性調試服務調用,進行調試。

屬性調試

  1. 屬性調試頁簽,選擇物模型的模組

  2. 執行以下操作,進行調試。

    重要

    設定設定期望值的屬性必須具有讀寫權限。

    功能

    操作

    說明

    擷取

    在屬性輸入框右側,單擊調試,選擇擷取

    屬性輸入框中將顯示擷取到的最新屬性資料。如果裝置上沒有該屬性的資料,則輸入框為空白。

    設定

    在屬性輸入框輸入值,單擊右側調試,選擇設定

    從雲端下發設定屬性值的指令給裝置。線上裝置收到指令後,根據裝置端的物模型開發功能,處理屬性值,例如將最新屬性值上報給雲端。

    設定期望值

    在屬性輸入框輸入值,單擊右側調試,選擇設定期望值

    從雲端下發設定期望屬性值的指令給裝置。

    如果下髮指令時:

    • 裝置線上,裝置立即收到指令,更新該屬性值,並將新屬性值上報雲端。

    • 裝置不線上,待裝置重新上線時,主動擷取期望屬性值資訊,然後更新屬性值並上報。

    您也可單擊頁面下方的擷取設定設定期望值,進行批量屬性調試。

服務調用

  1. 服務調用頁簽,從調試功能下拉式清單的選項中,選擇模組及對應待調試的服務。

  2. 在輸入框中,輸入調用服務的入參,單擊發送指令

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

查看調試日誌

推送指令後,可在頁面右側即時日誌下查看動作記錄;在裝置詳情頁面的物模型資料頁簽,查看調試結果。

重要

線上調試時,物聯網平台使用RRPC同步方式下行推送指令。因此對於類比線上的裝置(例如使用MQTT.fx工具接入的裝置),即使沒有訂閱任何裝置Topic,也可以收到相關日誌。您可在監控營運Log Service頁面,查看詳細日誌。

如下圖所示:

  • 屬性調試:輸入屬性值,單擊設定

    屬性設定

  • 服務調用:選擇對應服務,輸入服務的入參,單擊發送指令

    調用服務