本文中含有需要您注意的重要提示信息,忽略該信息可能對您的業務造成影響,請務必仔細閱讀。
產品是設備的集合,通常是一組具有相同功能定義的設備集合。例如,產品指同一個型號的產品,設備就是該型號下的某個設備。使用物聯網平臺接入設備前,您需在物聯網平臺控制臺創建產品。本文介紹創建產品的具體操作。
前提條件
開通物聯網平臺服務。
說明免費開通后,您可先試用物聯網平臺服務,試用流程,請參見阿里云免費試用的物聯網平臺產品。物聯網平臺服務的計費標準,請參見計費概述。
若使用企業版實例,需先購買所需的實例。具體操作,請參見購買企業版實例。
實例的詳細說明,請參見實例概述。
操作步驟
登錄物聯網平臺控制臺。
在控制臺左上方,選擇物聯網平臺所在地域。
在實例概覽頁簽的全部環境下,找到對應的實例,單擊實例卡片。
在左側導航欄,選擇 ,單擊創建產品。
您可單擊新建產品頁簽或從設備中心新建產品頁簽,選擇不同方式創建產品。
重要MQTT型實例僅支持新建產品,不支持從設備中心新建產品。
新建產品
參數
描述
產品名稱
為產品命名。產品名稱在賬號內具有唯一性。例如,可以填寫為產品型號。支持中文、英文字母、日文、數字、下劃線(_)、短劃線(-)、at(@)和英文圓括號(()),長度限制4~30個字符,一個中文或日文占2個字符。
所屬品類
相當于產品模板。
標準品類:物聯網平臺已為標準品類預定義了功能模板。
例如,
品類已預定義煙機電源開關、煙機工作狀態、煙機風量檔位等電表標準功能。選擇該品類,創建的產品具有預定義的功能。您可以在該產品的產品詳情頁功能定義頁簽下,編輯、修改、新增功能。單擊所屬品類右側幫助按鈕,可了解標準品類更多信息,或申請新品類。
自定義品類:產品創建成功后,需根據實際需要,自定義物模型。
說明MQTT型實例下,此處配置僅用于標識產品所屬品類。
選擇標準品類不會關聯預定義了物模型功能。
選擇自定義品類,無需自定義物模型功能。
節點類型
產品下設備的類型。
直連設備:具有IP地址,可直接連接物聯網平臺,且不能掛載子設備,但可作為子設備掛載到網關下的設備。
網關子設備:不直接連接物聯網平臺,而是通過網關設備接入物聯網平臺的設備。網關與子設備說明,請參見網關與子設備。
網關設備:可以掛載子設備的直連設備。網關具有子設備管理模塊,可以維持子設備的拓撲關系,將與子設備的拓撲關系同步到云端。
說明MQTT型實例下僅支持選擇直連設備。
接入網關協議
節點類型選擇為網關子設備的參數。表示該產品下的設備作為子設備與網關的通訊協議類型。
自定義:表示子設備和網關之間是其它標準或私有協議。
Modbus:表示子設備和網關之間的通訊協議是Modbus。
OPC UA:表示子設備和網關之間的通訊協議是OPC UA。
ZigBee:表示子設備和網關之間的通訊協議是ZigBee。
BLE:表示子設備和網關之間的通訊協議是BLE。
連網方式
直連設備和網關設備的連網方式。
Wi-Fi
蜂窩(2G/3G/4G/5G)
以太網
LoRaWAN
僅尊享型高可用版的企業版實例,支持該連網方式。MQTT型實例和新版和舊版公共實例不支持該連網方式。
說明首次選擇LoRaWAN時,需要單擊下方提示中的立即授權,前往RAM控制臺授權IoT使用AliyunIOTAccessingLinkWANRole角色訪問LinkWAN服務。
其他
入網憑證
當連網方式選擇為LoRaWAN時,需提供入網憑證名稱。
若無憑證,請單擊創建憑證,進入對應頁面:
公共實例下,在物聯網絡管理平臺的入網開通。
頁面,添加專用憑證,并為憑證授權用戶。具體操作,請參見企業版實例下,在該實例的
頁面,單擊添加入網憑證,添加專用憑證。參數配置說明與物聯網絡管理平臺相同。
使用憑證創建的產品,將作為一個節點分組,自動同步到物聯網絡管理平臺的節點分組列表中。
數據格式
設備上下行的數據格式。
說明MQTT型實例下不顯示該參數。
ICA標準數據格式(Alink JSON):是物聯網平臺為開發者提供的設備與云端的數據交換協議,采用JSON格式。
透傳/自定義:如果您希望使用自定義的串口數據格式,可以選擇為透傳/自定義。
您需在控制臺提交數據解析腳本,將上行的自定義格式的數據轉換為Alink JSON格式;將下行的Alink JSON格式數據解析為設備自定義格式,設備才能與云端進行通信。
說明使用LoRaWAN接入網關的產品僅支持透傳/自定義。
校驗類型
設備上報物模型數據時,物聯網平臺將按設置的數據校驗方式,根據物模型定義進行數據校驗。
說明MQTT型實例下不顯示該參數。
若產品的數據格式為透傳/自定義,該產品下設備與物聯網平臺進行物模型數據通信時,物聯網平臺會先調用數據解析腳本,將上報的透傳或自定義格式數據轉換為Alink JSON格式,然后進行數據校驗。
認證方式
設備接入物聯網平臺的安全認證方式。產品創建成功后,認證方式不可變更。可選:
說明MQTT型實例下不顯示該參數。
設備密鑰:使用物聯網平臺為設備生成的DeviceSecret進行設備認證簽名計算。
使用DeviceSecret簽名計算,請參見MQTT-TLS連接通信。
ID2:ID2認證提供設備與物聯網平臺的雙向身份認證能力,通過建立輕量化的安全鏈路(iTLS)來保障數據的安全性。
重要目前,僅華東2(上海)地域的企業版實例和舊版公共實例下,支持使用ID2證書認證。
選擇使用ID2認證,需購買ID2服務。請參見IoT設備身份認證(ID2)用戶手冊。
連網方式選擇為LoRaWAN的產品不支持ID2認證方式。
產品描述
可輸入文字,用來描述產品信息。字數限制為100。
從設備中心新建產品
通過AIoT設備中心中認證設備AliThingsCode快速創建對應產品。
說明從AIoT設備中心新建產品,需完成AIoT硬件合作伙伴入駐認證。
物聯網平臺已為從設備中心新建的產品預定義了功能模板。您可以在該產品的產品詳情頁功能定義頁簽下,編輯、修改、新增功能。
參數
描述
產品名稱
為產品命名。產品名稱在賬號內具有唯一性。例如,可以填寫為產品型號。支持中文、英文字母、日文、數字、下劃線(_)、短劃線(-)、at(@)和英文圓括號,長度限制4~30個字符,一個中文或日文占2個字符。
AliThingsCode
認證設備的AliThingsCode。
您可前往AIoT設備中心查找認證設備,獲取該設備的AliThingsCode。
執行結果
產品創建成功后,跳轉到
頁面。您可根據頁面提示,進行后續的添加設備、功能定義和設備開發。后續操作
定義產品功能
在產品頁面的產品列表,單擊產品對應操作列的查看。
在產品詳情頁面,單擊對應功能頁簽,定義相關功能。
說明MQTT型實例下僅支持展示產品信息和服務端訂閱頁簽。
產品信息
查看產品信息。您可以單擊產品信息右側的編輯,在產品編輯信息對話框,修改產品名稱或產品描述。
查看產品標簽。默認無標簽,您可以添加標簽標識產品。具體操作,請參見編輯產品標簽。
Topic類列表
查看物聯網平臺系統預定義的基礎通信Topic類、物模型通信Topic類和自定義Topic類。詳細說明,請參見Topic類列表。
您也可以添加自定義Topic類。具體操作,請參見自定義Topic類。
功能定義
定義物模型屬性、服務和事件,用于物模型通信。具體內容,請參見:
消息解析
產品數據格式為透傳/自定義時,需提交數據解析腳本。具體內容,請參見:
服務端訂閱
若需訂閱產品下設備上報數據,要創建訂閱。具體內容,請參見配置AMQP服務端訂閱。
文件上傳配置
若需設備將文件上傳至您自己的OSS空間存儲,要完成Bucket授權和配置。具體內容,請參見上傳文件配置。
設備開發
根據界面提示進行設備注冊、功能接入、連接驗證、設備量產,完成設備開發,接入物聯網平臺。詳細信息,請參見設備端開發。
設備注冊
單個創建設備:如下圖所示。
設備接入
物聯網平臺提供多種開發語言的Link SDK供您選擇。具體內容,請參見設備接入概述。
連接驗證
查看并驗證設備接入物聯網平臺的狀態。設備在線后,您可以使用物聯網平臺的消息通信功能,進行設備消息的收發。具體內容,請參見:
設備量產
批量添加設備,然后進行燒錄量產。具體內容,請參見:
(可選)發布產品
在對應產品詳情頁面中,單擊右上角發布,發布產品。
發布前需確認:產品各項信息已設置完成、設備開發調試工作已完成、產品已具備上線發布條件。
產品發布后,產品狀態變為已發布。
產品發布成功后,不支持修改和刪除操作。