全部產品
Search
文件中心

IoT Platform:建立產品

更新時間:Jun 30, 2024

產品是裝置的集合,通常是一組具有相同功能定義的裝置集合。例如,產品指同一個型號的產品,裝置就是該型號下的某個裝置。使用物聯網平台接入裝置前,您需在物聯網平台控制台建立產品。本文介紹建立產品的具體操作。

前提條件

操作步驟

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

  2. 在控制台左上方,選擇物聯網平台所在地區。

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

  4. 在左側導覽列,選擇裝置管理 > 產品,單擊建立產品

  5. 按照頁面提示填寫資訊,然後單擊確認

    參數

    描述

    產品名稱

    為產品命名。產品名稱在帳號內具有唯一性。例如,可以填寫為產品型號。支援中文、英文字母、日文、數字、底線(_)、短劃線(-)、at(@)和英文圓括弧(()),長度限制4~30個字元,一個中文或日文佔2個字元。

    節點類型

    產品下裝置的類型。

    • 直連裝置:直連物聯網平台,且不能掛載子裝置,但能作為子裝置掛載到網關下的裝置。

    • 網關子裝置:不直接連接物聯網平台,而是通過網關裝置接入物聯網平台的裝置。網關與子裝置說明,請參見網關與子裝置

    • 網關裝置:可以掛載子裝置的直連裝置。網關具有子裝置管理模組,可以維持子裝置的拓撲關係,將與子裝置的拓撲關係同步到雲端。

    接入網關協議

    節點類型選擇為網關子裝置的參數。表示該產品下的裝置作為子裝置與網關的通訊協議類型。

    • 自訂:表示子裝置和網關之間是其它標準或私人協議。

    • Modbus:表示子裝置和網關之間的通訊協議是Modbus。

    • OPC UA:表示子裝置和網關之間的通訊協議是OPC UA。

    • ZigBee:表示子裝置和網關之間的通訊協議是ZigBee。

    • BLE:表示子裝置和網關之間的通訊協議是BLE。

    連網方式

    直連裝置和網關裝置的連網方式。

    • Wi-Fi

    • 蜂窩(2G/3G/4G/5G

    • 乙太網路

    • 其他

    資料格式

    裝置上下行的資料格式。

    • ICA標準資料格式(Alink JSON):是物聯網平台為開發人員提供的裝置與雲端的資料交換協議,採用JSON格式。

    • 透傳/自訂:如果您希望使用自訂的串口資料格式,可以選擇為透傳/自訂。

      您需在控制台提交資料解析指令碼,將上行的自訂格式的資料轉換為Alink JSON格式;將下行的Alink JSON格式資料解析為裝置自訂格式,裝置才能與雲端進行通訊。

    校正類型

    裝置上報物模型資料時,物聯網平台將按設定的資料校正方式,根據物模型定義進行資料校正。

    若產品的資料格式透傳/自訂,該產品下裝置與物聯網平台進行物模型資料通訊時,物聯網平台會先調用資料解析指令碼,將上報的透傳或自訂格式資料轉換為Alink JSON格式,然後進行資料校正。

    • 弱校正僅校正裝置上報資料中的identifier和dataType欄位,不校正其他欄位,流轉全量資料。

      校正通過的資料展示在物聯網平台控制台對應裝置的裝置詳情物模型資料頁簽。校正不通過的資料則不展示。

      通過流轉資料中的參數checkFailedData,可查看校正不通過的資料。更多資訊,請參見資料格式

    • 免校正不校正裝置上報資料,流轉全量資料。對上報的資料不進行校正,流轉全量資料。

      物模型資料使用說明如下:

      • 物模型屬性上報:屬性資料不展示在物聯網平台控制台對應裝置下裝置詳情頁面的物模型資料 > 運行狀態頁簽中。
      • 物模型服務調用:所有服務都使用非同步呼叫方式。
      • 物模型事件上報:所有事件都使用資訊類型。

    認證方式

    裝置接入物聯網平台的安全認證方式。產品建立成功後,認證方式不可變更。可選:

    • 裝置密鑰:使用物聯網平台為裝置產生的DeviceSecret進行裝置認證簽名計算。

      使用DeviceSecret簽名計算,請參見MQTT-TLS串連通訊

    • ID²:ID²認證提供裝置與物聯網平台的雙向身份認證能力,通過建立輕量化的安全鏈路(iTLS)來保障資料的安全性。

      重要
      • 目前,僅日本(東京)地區的企業版執行個體下,支援使用ID²認證認證。

      • 選擇使用ID²認證,需購買ID²服務。

      • 連網方式選擇為LoRaWAN的產品不支援ID²認證方式。

    產品描述

    可輸入文字,用來描述產品資訊。字數限制為100。

執行結果

產品建立成功後,跳轉到產品管理 > 建立產品頁面。您可根據頁面提示,進行後續的添加裝置功能定義裝置開發

後續操作

定義產品功能

  1. 產品頁面的產品列表,單擊產品對應操作列的查看

  2. 在產品詳情頁面,單擊對應功能頁簽,定義相關功能。

    產品資訊

    • 查看產品資訊。您可以單擊產品資訊右側的編輯,在產品編輯資訊對話方塊,修改產品名稱產品描述

    • 查看產品標籤。預設無標籤,您可以添加標籤標識產品。具體操作,請參見編輯產品標籤

    image.png

    Topic類列表

    查看物聯網平台系統預定義的基礎通訊Topic類、物模型通訊Topic類和自訂Topic類。詳細說明,請參見Topic類列表

    您也可以添加自訂Topic類。具體操作,請參見自訂Topic類

    image.png

    功能定義

    定義物模型屬性、服務和事件,用於物模型通訊。具體內容,請參見:

    訊息解析

    產品資料格式為透傳/自訂時,需提交資料解析指令碼。具體內容,請參見:

    服務端訂閱

    若需訂閱產品下裝置上報資料,要建立訂閱。具體內容,請參見配置AMQP服務端訂閱

裝置開發

根據介面提示進行裝置註冊功能接入串連驗證裝置量產,完成裝置開發,接入物聯網平台。詳細資料,請參見裝置端開發

裝置註冊

單個建立裝置:如下圖所示。

image.png

裝置接入

物聯網平台提供多種開發語言的Link SDK供您選擇。具體內容,請參見裝置接入概述

image.png

串連驗證

查看並驗證裝置接入物聯網平台的狀態。裝置線上後,您可以使用物聯網平台的訊息通訊功能,進行裝置訊息的收發。具體內容,請參見:

image.png

裝置量產

大量新增裝置,然後進行燒錄量產。具體內容,請參見:

image.png

(可選)發布產品

在對應產品詳情頁面中,單擊右上方發布,發布產品。

發布前需確認:產品各項資訊已設定完成、裝置開發調試工作已完成、產品已具備上線發布條件。

產品發布後,產品狀態變為發行

重要

產品發布成功後,不支援修改和刪除操作。

產品管理

其他動作

  • 撤銷發行的產品。在該產品詳情頁面中,單擊右上方撤銷發布,然後單擊確定

  • 刪除未發行的作品。返回產品頁面,在產品列表找到目標產品,單擊產品對應操作列的刪除,然後單擊確定

    警告
    • 刪除產品後,與該產品相關的所有資料都會被清除。如果產品下裝置已接入物聯網平台使用,會導致物聯網平台所有服務不可用、使用者業務中斷。請謹慎操作。

    • 刪除產品前,必須先刪除該產品下的全部裝置,具體內容,請參見刪除裝置

  • 備份產品資料。返回產品頁面,在產品列表上方,單擊備份產品資料,跳轉到資料服務 > 資料接入 > 產品列表頁面,可選擇目標產品開啟資料備份。具體操作,請參見備份產品

    資料備份