物聯(lián)網(wǎng)云平臺(tái)主流平臺(tái)如阿里云IoT、OneNET、ThingsBoard、JetLinks等，設(shè)備批量導(dǎo)入通用操作流程邏輯大體一致，均采用下載模板→填寫設(shè)備信息→上傳導(dǎo)入→查看導(dǎo)入結(jié)果流程。

而如聚英云、有人云等輕量化物聯(lián)網(wǎng)平臺(tái)，簡化了設(shè)備接入云平臺(tái)的方式，可直接采用輸入設(shè)備ID、掃描設(shè)備唯一二維碼的方式，傻瓜式操作。

一、前置準(zhǔn)備

1. 先建好產(chǎn)品：批量設(shè)備必須歸屬同一個(gè)產(chǎn)品，產(chǎn)品下已經(jīng)定義好物模型/點(diǎn)位、通信協(xié)議(MQTT/Modbus等)。

2. 收集設(shè)備原始信息：設(shè)備SN、MAC、設(shè)備名稱、鑒權(quán)秘鑰、別名、分組、位置等。

3. 文件格式：絕大多數(shù)平臺(tái)只接受 CSV，少數(shù)支持xlsx;不要修改模板表頭，從第二行開始填數(shù)據(jù)。

二、標(biāo)準(zhǔn)操作步驟

1. 登錄平臺(tái)控制臺(tái)，進(jìn)入【設(shè)備管理】【設(shè)備列表】。

2. 點(diǎn)擊 批量添加 / 批量導(dǎo)入 / Import 按鈕。

3. 下載官方模板文件，不要自己新建表格，表頭字段平臺(tái)強(qiáng)校驗(yàn)。

4. 打開模板填寫設(shè)備信息

設(shè)備名稱/DeviceName：產(chǎn)品內(nèi)唯一，字母數(shù)字、`-_@.:`，432字符，不能中文特殊符號(hào);

SN/MAC： 設(shè)備硬件序列號(hào);

鑒權(quán)信息：DeviceSecret / AccessToken / MQTT賬號(hào)密碼(預(yù)導(dǎo)入存量設(shè)備需要填);

別名、分組、經(jīng)緯度：選填;

> 注意：不要留中文逗號(hào)，日期、編號(hào)不要帶多余空格;不要合并單元格。

5. 保存CSV，編碼選 UTF8(Windows Excel保存CSV容易亂碼，建議用WPS或記事本另選編碼)。

6. 在彈窗上傳文件，確認(rèn)所屬產(chǎn)品，執(zhí)行導(dǎo)入。

7. 查看導(dǎo)入結(jié)果：

- 全部成功：直接回到設(shè)備列表查看，導(dǎo)出設(shè)備列表獲取全部秘鑰用于燒錄設(shè)備。

- 部分失敗：下載錯(cuò)誤明細(xì)列表，看哪一行哪個(gè)字段非法，修正后重新導(dǎo)入，不要整表重復(fù)上傳避免重復(fù)創(chuàng)建設(shè)備。

三、各平臺(tái)差異要點(diǎn)

1. 阿里云IoT

- 入口：設(shè)備管理 → 設(shè)備 → 批量添加;兩種模式：自動(dòng)生成DeviceName / CSV上傳自定義名稱。

- 上限：普通實(shí)例單次最多1000臺(tái);尊享實(shí)例支持上萬臺(tái)。

- 存量設(shè)備遷移：模板可填入自定義DeviceSecret，實(shí)現(xiàn)預(yù)注冊(cè)自有秘鑰設(shè)備。

2. 中國移動(dòng)OneNET

- 入口：設(shè)備接入與管理 → 設(shè)備管理 → 添加設(shè)備 → 批量添加，下載模板。

- 支持查看導(dǎo)入批次記錄;不同協(xié)議模板字段不一樣(MQTT、Modbus模板不同)。

3. ThingsBoard(開源私有化)

- 入口：EntitiesDevices → Import按鈕。

- 需要手動(dòng)做列映射：把CSV每一列映射到平臺(tái)字段(name、accessToken、自定義屬性)。

- 勾選`更新屬性`：遇到重名設(shè)備會(huì)更新，不勾選則重名直接報(bào)錯(cuò)終止導(dǎo)入。

4. 聚英云(國內(nèi)輕量化化IoT)

- 支持單臺(tái)填寫fUNID(設(shè)備唯一ID)添加。

- 支持設(shè)備二維碼掃描，一鍵接入云平臺(tái)。

四、常見踩坑與注意事項(xiàng)

1. 設(shè)備名稱重復(fù)：同一個(gè)產(chǎn)品下DeviceName不能重復(fù)，導(dǎo)入報(bào)錯(cuò)最常見原因。

2. CSV亂碼：Windows直接另存CSV會(huì)GBK，平臺(tái)識(shí)別亂碼;記事本打開csv，另存為，編碼選UTF8。

3. 模板表頭改動(dòng)：刪除、修改表頭字段會(huì)直接解析失敗，必須原樣保留表頭。

4. 秘鑰保管：批量導(dǎo)入成功后導(dǎo)出設(shè)備清單妥善保存秘鑰，用于設(shè)備固件配置聯(lián)網(wǎng)，丟失無法找回。

5. 數(shù)量上限：注意平臺(tái)單次導(dǎo)入條數(shù)限制，超量拆分多個(gè)文件分批導(dǎo)入。

6. 子設(shè)備網(wǎng)關(guān)場景：網(wǎng)關(guān)下子設(shè)備批量導(dǎo)入，部分平臺(tái)需要先創(chuàng)建網(wǎng)關(guān)，再導(dǎo)入子設(shè)備列表。