產品是設備的集合,通常指一組具有相同功能的設備。創建產品完成后,需在產品下添加設備,獲取設備證書。您可在物聯網平臺上,同時創建一個或多個設備。本文介紹同時創建多個設備的操作。
前提條件
已完成創建產品。具體操作,請參見創建產品。
批量添加設備:標準型、尊享型和公共實例
登錄物聯網平臺控制臺。
在實例概覽頁簽的全部環境下,找到對應的實例,單擊實例卡片。
在左側導航欄,選擇 。
在設備頁面,單擊批量添加。
選擇產品。新創建的設備會繼承該產品的功能和特性。
重要若該產品關聯了其他平臺,請確保您的阿里云賬號下有足夠的激活碼用于創建設備。
選擇設備的添加方式。
自動生成:無需為設備指定DeviceName。填寫設備數量后,系統會為每個設備自動生成由字母、數字隨機組合成的DeviceName。
批量上傳:需要為所有設備指定名稱。單擊下載.csv模板下載表格模板,在模板中填寫DeviceName、Nickname,然后將填好的表格上傳至物聯網平臺控制臺。
重要第一行不能修改,請從A2單元格開始輸入。
DeviceName支持英文字母、數字、短劃線(-)、下劃線(_)、at(@)、英文句號(.)和英文冒號(:),長度限制為4~32個字符。DeviceName在產品維度下具有唯一性,不可重復。
Nickname為備注名稱,可不填,支持中文、英文字母、日文、數字和下劃線(_),長度限制為4~64個字符,一個中文或日文占2個字符。
一個文件中最多可包含1萬條記錄,文件大小不超過2 MB。
單擊確認,完成批量創建設備。
若批量上傳的設備名稱列表中有不合法的名稱,會出現錯誤提示。請單擊下載不合法列表,查看不合法的設備名稱,并根據設備名稱規范,修改設備名稱,再重新上傳文件。
創建設備成功后,單擊下載設備證書,下載本批次設備的設備證書,用于在產線上統一燒錄。
說明如果創建產品時,選擇認證方式為X.509證書,批量創建設備成功后,返回的X.509證書下載URL(CertUrl)有效期為180日,請及時下載。
下載包中,包含成功生成的X.509證書和密鑰,以及證書生成失敗的設備列表.txt文件。如果沒有失敗的設備,則沒有.txt文件。
設備證書由設備的ProductKey、DeviceName和DeviceSecret組成,是設備與物聯網平臺進行通信的重要身份認證,建議您妥善保管。
參數
說明
ProductKey
設備所屬產品的ProductKey,即物聯網平臺為產品頒發的全局唯一標識符。
DeviceName
設備在產品內的唯一標識符。DeviceName與設備所屬產品的ProductKey組合,作為設備標識,用來與物聯網平臺進行連接認證和通信。
DeviceSecret
物聯網平臺為設備頒發的設備密鑰,用于認證加密。需與DeviceName成對使用。
批量添加設備:MQTT型實例
登錄物聯網平臺控制臺。
在實例概覽頁面,找到MQTT型實例,單擊實例進入實例詳情頁面。
在左側導航欄,選擇 。
在設備頁面,單擊批量添加。
在批量添加設備對話框,選擇產品,單擊下載.csv模板下載表格模板。
在模板中填寫SN、MQTT Username和MQTT Password,然后保存文件。
重要MQTT Username和MQTT Password必填,SN可不填。
MQTT Username支持英文字母、數字、短劃線(-)、下劃線(_)、at(@)、英文句號(.)和英文冒號(:),長度限制為4~32個字符。MQTT Username在產品維度下不可重復。
MQTT Password 支持英文字母、數字、短劃線(-)、下劃線(_)、at(@)、英文句號(.)和英文冒號(:),長度限制為1~32個字符。
一個文件中最多可包含1萬條設備記錄。請不要導入重復的設備。
回到批量添加設備對話框,單擊上傳文件,將填好的表格上傳至物聯網平臺控制臺,單擊確認。
若批量上傳的設備列表中有不合法的輸入信息,將出現錯誤提示。請單擊下載不合法列表,查看不合法的輸入信息,并進行修正,再重新上傳文件。
設備身份導入成功后,物聯網平臺以上傳的MQTT Username值作為設備名稱創建對應設備,設備列表顯示已創建的設備信息。
執行結果
創建設備成功后,可在設備頁面的批次管理頁簽下,單擊對應產品的:
詳情:查看該批次設備的添加數量和設備列表(包含設備證書和狀態等信息)。
若該批次設備中包含創建失敗的設備,設備列表中會顯示失敗原因,對應的錯誤碼說明如下。
錯誤碼
含義
說明
460
duplicated deviceName
設備名稱重復。
invalid deviceName
設備名稱無效。
6251
device exist
設備已存在。
6760
insufficient activation code
激活碼不足。
64003
device creation is failed
并發執行創建設備操作。
6293
device has been distributed
設備已分發。
下載量產成功CSV:下載該批次設備的證書。
后續操作
查看設備信息,請參見查看設備信息。
創建設備完成后,設備狀態顯示為未激活。您需開發設備端SDK,將設備接入物聯網平臺,使其激活,請參見下載設備端SDK。
設備接入物聯網平臺實踐案例,請參見:
相關API
BatchRegisterDevice:批次申請指定數量設備。
MQTT型企業版實例下,不支持使用BatchRegisterDevice接口,可調用BatchImportDevice接口批量注冊設備。