4種批量添加設備方案(按上手速度排序)

> 適用：阿里云IoT、OneNET、華為IoTDA、ThingsBoard、聚英云等;聚英云本身支持掃碼接入，簡單快捷

? 方案1：控制臺CSV批量導入(中小批量，幾十~1萬，最常用)

1. 先建好產品(物模型)，所有待導入設備必須歸屬同一個產品

2. 設備列表頁找到【批量添加/批量注冊】，下載平臺官方CSV模板(不要自己新建表頭，平臺強校驗)

3. 填入SN/MAC、設備名稱DeviceName、備注、分組等;

- 兩種模式：①自定義設備名(填SN/MAC);②自動生成，只填數量，平臺自動生成設備密鑰

4. 保存CSV，上傳提交;任務跑完后導出批次清單，保存設備密鑰/證書，用于燒錄到硬件

> 限制：單文件一般上限10000臺;設備名稱在產品內必須唯一，不能中文、特殊符號

? 方案2：API批量接口(大批量，上萬臺，自動化，推薦項目量產)

平臺都提供批量注冊OpenAPI：

- 阿里云：`BatchImportDevice`

- OneNET：批量創建設備、批量綁定網關子設備

- 華為IoTDA：批量注冊任務接口

- ThingsBoard：REST API / Python腳本讀取CSV循環調用創建設備接口

簡易流程

1. 導出硬件SN清單(Excel)

2. Python腳本讀取CSV，循環調用平臺批量API，一次性創建設備

3. 返回結果寫入新CSV，保存設備密鑰，直接用于燒錄固件

> 優勢：可集成產線，產線掃碼采集SN，自動注冊;支持數萬級設備;適合反復批量導入場景

? 方案3：網關自注冊(Modbus/RS485傳感器、子設備，工業場景首選，聚英485HUB/DAM模塊非常適合)

適合：485總線下一堆傳感器、RTU子設備(大棚、水泵、電表、動環)

1. 先把網關本身注冊到云平臺

2. 網關上線后，自動掃描485總線子設備，網關主動上報子設備SN到平臺，平臺自動創建子設備并綁定到網關拓撲(網關代理子設備鑒權)

> 優點：不用提前在平臺逐個錄入子設備，現場部署上電自動發現;適合大量Modbus儀表、DAM繼電器模塊、485傳感器集群，聚英云場景優先用這個方案

? 方案4：設備預注冊+設備上線自動激活(量產燒錄)

1. 平臺批量生成一批設備密鑰，燒錄進固件(一機一密)

2. 設備現場上電聯網，主動上報鑒權信息，平臺自動激活

> 適合出廠預燒錄，現場不用任何平臺操作，上電自動上線

?? 實操避坑要點(非常關鍵)

1. 字符限制：DeviceName僅支持字母、數字、`-_@.:`，4~32字符，禁止中文、空格，同產品內唯一

2. CSV編碼：保存為 UTF-8，不要用Excel默認ANSI，否則導入亂碼報錯

3. 重復校驗：導入前清理重復SN，重復行會整行失敗甚至中斷任務

4. 聚英云特殊說明：Web端沒有CSV批量導入;少量設備掃碼添加;大量485子設備，推薦聚英網關+子設備自動上報;上萬臺可調用聚英開放API批量注冊

5. 配額：提前確認平臺設備數量配額，避免導入一半超限

?? 選型快速判斷

- 幾十~幾百臺，一次性部署：CSV控制臺導入

- 上萬臺、產線量產、需要反復導入：API腳本批量注冊

- 485/Modbus傳感器集群(DAM、儀表、溫濕度)：網關自動發現子設備

- 設備出廠燒密，現場直接上電：預注冊+上線自動激活