設(shè)備接入引導(dǎo)
當(dāng)您希望將設(shè)備接入阿里云物聯(lián)網(wǎng)平臺(tái)，實(shí)現(xiàn)設(shè)備集中管理、收集和數(shù)據(jù)分析、遠(yuǎn)程控制、保障設(shè)備數(shù)據(jù)安全等能力時(shí)，請(qǐng)根據(jù)本文的設(shè)備接入流程引導(dǎo)，選擇設(shè)備使用協(xié)議并進(jìn)行云端和設(shè)備端開發(fā)。
前提條件
開通物聯(lián)網(wǎng)平臺(tái)服務(wù)。
免費(fèi)開通后，您可先試用物聯(lián)網(wǎng)平臺(tái)服務(wù)，試用流程，請(qǐng)參見(jiàn)阿里云免費(fèi)試用的物聯(lián)網(wǎng)平臺(tái)產(chǎn)品。物聯(lián)網(wǎng)平臺(tái)服務(wù)的計(jì)費(fèi)標(biāo)準(zhǔn)，請(qǐng)參見(jiàn)計(jì)費(fèi)概述。
接入說(shuō)明
設(shè)備接入物聯(lián)網(wǎng)平臺(tái)，需要完成以下操作：
操作 | 說(shuō)明 |
云端產(chǎn)品開發(fā) | 在物聯(lián)網(wǎng)平臺(tái)控制臺(tái)，依次進(jìn)行創(chuàng)建產(chǎn)品、添加物模型功能、添加自定義Topic、創(chuàng)建設(shè)備、配置業(yè)務(wù)功能（例如：設(shè)備標(biāo)簽、設(shè)備影子、設(shè)備OTA升級(jí)等功能）等操作，定義設(shè)備認(rèn)證方式，完成產(chǎn)品功能開發(fā)和設(shè)備注冊(cè)。 |
設(shè)備端開發(fā) | 設(shè)備端獲取設(shè)備證書，使用SDK接入物聯(lián)網(wǎng)平臺(tái)。設(shè)備端可以使用Link SDK、開放協(xié)議的自研SDK、AT模組、云云對(duì)接SDK的接入方式實(shí)現(xiàn)設(shè)備連接物聯(lián)網(wǎng)平臺(tái)。 |
不同類型設(shè)備接入物聯(lián)網(wǎng)平臺(tái)支持的接入?yún)f(xié)議、SDK和具體流程不同。物聯(lián)網(wǎng)平臺(tái)支持的設(shè)備類型和對(duì)應(yīng)協(xié)議如下表所示，對(duì)應(yīng)SDK和完整接入流程說(shuō)明，請(qǐng)參見(jiàn)下文的接入流程。
設(shè)備類型 | 支持的接入?yún)f(xié)議 |
直連設(shè)備 | MQTT、CoAP、HTTPS |
網(wǎng)關(guān)設(shè)備（直連方式）和非直連子設(shè)備 | MQTT |
LoRa設(shè)備 | MQTT |
中國(guó)移動(dòng)和中國(guó)聯(lián)通的NB-IoT設(shè)備 | MQTT、CoAP |
云網(wǎng)關(guān)設(shè)備 | MQTT、JT/T 808、GB/T 32960、SL 651、中國(guó)電信NB-IoT |
無(wú)法使用物聯(lián)網(wǎng)平臺(tái)支持的協(xié)議直接接入的設(shè)備 | 云云對(duì)接支持的私有協(xié)議 |
網(wǎng)關(guān)設(shè)備和云網(wǎng)關(guān)設(shè)備區(qū)別：
網(wǎng)關(guān)設(shè)備：使用MQTT協(xié)議且可以掛載子設(shè)備的直連設(shè)備，通過(guò)設(shè)備密鑰方式進(jìn)行設(shè)備身份認(rèn)證后接入物聯(lián)網(wǎng)平臺(tái)。
云網(wǎng)關(guān)設(shè)備：支持使用MQTT協(xié)議、JT/T 808協(xié)議、GB/T 32960協(xié)議、中國(guó)電信NB-IoT協(xié)議的云網(wǎng)關(guān)接入設(shè)備。
MQTT協(xié)議、JT/T 808協(xié)議、GB/T 32960協(xié)議和SL 651協(xié)議的云網(wǎng)關(guān)設(shè)備，使用自定義證書信息進(jìn)行設(shè)備身份認(rèn)證。
使用MQTT協(xié)議云網(wǎng)關(guān)可以將存量設(shè)備在無(wú)需做改造的情況下遷移到阿里云企業(yè)物聯(lián)網(wǎng)平臺(tái)。
使用JT/T 808協(xié)議云網(wǎng)關(guān)接入的設(shè)備，適用于道路運(yùn)輸車輛衛(wèi)星定位系統(tǒng)車載終端與阿里云企業(yè)物聯(lián)網(wǎng)平臺(tái)之間的通信。
使用GB/T 32960協(xié)議云網(wǎng)關(guān)可以將電動(dòng)汽車設(shè)備接入物聯(lián)網(wǎng)平臺(tái)，實(shí)現(xiàn)電動(dòng)汽車遠(yuǎn)程服務(wù)和系統(tǒng)管理。
使用SL 651協(xié)議云網(wǎng)關(guān)將遙測(cè)站設(shè)備接入物聯(lián)網(wǎng)平臺(tái)，用于水文監(jiān)測(cè)數(shù)據(jù)的采集與傳輸。
中國(guó)電信NB-IoT的云網(wǎng)關(guān)設(shè)備，是通過(guò)直連方式接入中國(guó)電信AEP平臺(tái)中已完成開發(fā)的NB-IoT設(shè)備。
接入?yún)f(xié)議說(shuō)明
MQTT協(xié)議
認(rèn)證方式
直連設(shè)備和網(wǎng)關(guān)子設(shè)備：采用物聯(lián)網(wǎng)平臺(tái)的設(shè)備證書信息ProductKey（產(chǎn)品信息唯一標(biāo)識(shí)）、DeviceName（設(shè)備名稱）、DeviceSecret（設(shè)備密鑰）進(jìn)行認(rèn)證。
MQTT協(xié)議云網(wǎng)關(guān)設(shè)備：采用標(biāo)準(zhǔn)的MQTT協(xié)議規(guī)范的UserName作為身份信息進(jìn)行認(rèn)證，支持使用自定義證書、自定義設(shè)備認(rèn)證方式、自定義通信Topic能力、設(shè)備端和服務(wù)端證書OCSP能力、設(shè)備和服務(wù)端雙向安全認(rèn)證等能力。
設(shè)備身份信息說(shuō)明
設(shè)備 | 說(shuō)明 |
直連設(shè)備 |
|
網(wǎng)關(guān)子設(shè)備 | 支持網(wǎng)關(guān)設(shè)備代理子設(shè)備接入物聯(lián)網(wǎng)平臺(tái)。網(wǎng)關(guān)設(shè)備與物聯(lián)網(wǎng)平臺(tái)建連后，子設(shè)備復(fù)用相同的連接和物聯(lián)網(wǎng)平臺(tái)通信。具體內(nèi)容，請(qǐng)參見(jiàn)網(wǎng)關(guān)與子設(shè)備。 |
云網(wǎng)關(guān)設(shè)備 |
|
使用說(shuō)明
MQTT協(xié)議規(guī)范和使用說(shuō)明，請(qǐng)參見(jiàn)使用MQTT協(xié)議。
HTTPS協(xié)議
支持HTTPS協(xié)議，推薦采用TLS協(xié)議1.3版本加密接入阿里云物聯(lián)網(wǎng)平臺(tái)。
認(rèn)證方式
采用物聯(lián)網(wǎng)平臺(tái)的設(shè)備證書信息ProductKey（產(chǎn)品信息唯一標(biāo)識(shí)）、DeviceName（設(shè)備名稱）、DeviceSecret（設(shè)備密鑰）進(jìn)行認(rèn)證。
設(shè)備身份信息說(shuō)明
通過(guò)物聯(lián)網(wǎng)平臺(tái)控制臺(tái)或云端API創(chuàng)建設(shè)備，獲取設(shè)備證書信息。具體內(nèi)容，請(qǐng)參見(jiàn)創(chuàng)建設(shè)備和RegisterDevice。
使用說(shuō)明
HTTPS協(xié)議規(guī)范和使用說(shuō)明，請(qǐng)參見(jiàn)使用HTTPS協(xié)議。
CoAP協(xié)議
支持UDP協(xié)議，采用DTLS和對(duì)稱加密兩種安全模式接入阿里云物聯(lián)網(wǎng)平臺(tái)。
認(rèn)證方式
采用物聯(lián)網(wǎng)平臺(tái)的設(shè)備證書信息ProductKey（產(chǎn)品信息唯一標(biāo)識(shí)）、DeviceName（設(shè)備名稱）、DeviceSecret（設(shè)備密鑰）進(jìn)行認(rèn)證。
設(shè)備身份信息說(shuō)明
通過(guò)物聯(lián)網(wǎng)平臺(tái)控制臺(tái)或云端API創(chuàng)建設(shè)備，獲取設(shè)備證書信息。具體內(nèi)容，請(qǐng)參見(jiàn)創(chuàng)建設(shè)備和RegisterDevice。
使用說(shuō)明
CoAP協(xié)議規(guī)范和使用說(shuō)明，請(qǐng)參見(jiàn)使用CoAP協(xié)議。
JT/T 808協(xié)議
云網(wǎng)關(guān)JT/T 808協(xié)議應(yīng)用于汽車行業(yè)，支持使用自定義證書、自定義設(shè)備認(rèn)證方式、自定義通信Topic能力、設(shè)備端和服務(wù)端證書OCSP能力、設(shè)備和服務(wù)端雙向安全認(rèn)證等能力。
認(rèn)證方式
一方認(rèn)證：需要提前在物聯(lián)網(wǎng)平臺(tái)控制臺(tái)批量導(dǎo)入Manufacturer ID（廠商ID）、Terminal Model（設(shè)備型號(hào)）和Terminal ID（設(shè)備ID）信息創(chuàng)建設(shè)備， 設(shè)備建連時(shí)物聯(lián)網(wǎng)平臺(tái)校驗(yàn)設(shè)備身份信息。
三方認(rèn)證：物聯(lián)網(wǎng)平臺(tái)調(diào)用自定義的FC函數(shù)進(jìn)行認(rèn)證，認(rèn)證成功后自動(dòng)創(chuàng)建設(shè)備身份。
使用說(shuō)明
使用JT/T 808協(xié)議云網(wǎng)關(guān)接入設(shè)備的詳細(xì)說(shuō)明，請(qǐng)參見(jiàn)JT/T 808協(xié)議云網(wǎng)關(guān)概述。
GB/T 32960協(xié)議
云網(wǎng)關(guān)GB/T 32960協(xié)議應(yīng)用于汽車行業(yè)，支持使用自定義證書、自定義設(shè)備認(rèn)證方式、自定義通信Topic能力、設(shè)備端和服務(wù)端證書OCSP能力、設(shè)備和服務(wù)端雙向安全認(rèn)證等能力。
認(rèn)證方式
一方認(rèn)證：需要提前物聯(lián)網(wǎng)控制臺(tái)批量導(dǎo)入車輛VIN信息創(chuàng)建設(shè)備， 設(shè)備建連時(shí)物聯(lián)網(wǎng)平臺(tái)校驗(yàn)設(shè)備身份信息
三方認(rèn)證：物聯(lián)網(wǎng)平臺(tái)調(diào)用自定義的FC函數(shù)進(jìn)行認(rèn)證，認(rèn)證成功后自動(dòng)創(chuàng)建設(shè)備身份。
使用說(shuō)明
使用GB/T 32960協(xié)議云網(wǎng)關(guān)接入設(shè)備的詳細(xì)說(shuō)明，請(qǐng)參見(jiàn)GB/T 32960協(xié)議云網(wǎng)關(guān)概述。
SL 651協(xié)議
SL 651是國(guó)家水文局制定的用于水文監(jiān)測(cè)數(shù)據(jù)通信的協(xié)議，它規(guī)定了水文監(jiān)測(cè)數(shù)據(jù)采集與傳輸?shù)母袷健?nèi)容、傳輸方式等技術(shù)參數(shù)，支持通過(guò)TCP（安全性低，不推薦）和TLS兩種方式將遙測(cè)站設(shè)備接入物聯(lián)網(wǎng)平臺(tái)。
認(rèn)證方式
一方認(rèn)證：需要將遙測(cè)站地址
telemetryAddress和密碼password導(dǎo)入物聯(lián)網(wǎng)平臺(tái)，物聯(lián)網(wǎng)平臺(tái)會(huì)基于設(shè)備認(rèn)證信息對(duì)設(shè)備進(jìn)行認(rèn)證。三方認(rèn)證：物聯(lián)網(wǎng)平臺(tái)調(diào)用自定義的FC函數(shù)進(jìn)行認(rèn)證，認(rèn)證成功后自動(dòng)創(chuàng)建設(shè)備身份。
使用說(shuō)明
使用SL 651協(xié)議云網(wǎng)關(guān)接入設(shè)備的詳細(xì)說(shuō)明，請(qǐng)參見(jiàn)SL 651協(xié)議云網(wǎng)關(guān)概述。
其它協(xié)議
其它協(xié)議如消防協(xié)議GB/T 26875.3-2011、Modbus等暫不支持。在特定場(chǎng)景下，設(shè)備無(wú)法直接接入阿里云物聯(lián)網(wǎng)平臺(tái)時(shí)，您可使用云云對(duì)接SDK，快速構(gòu)建橋接服務(wù)，搭建設(shè)備或平臺(tái)與阿里云物聯(lián)網(wǎng)平臺(tái)的雙向數(shù)據(jù)通道。
使用說(shuō)明，請(qǐng)參見(jiàn)使用云云對(duì)接（原泛化協(xié)議）SDK。
接入流程
開通物聯(lián)網(wǎng)平臺(tái)服務(wù)后，設(shè)備接入的完整流程如下圖所示，主要分為云端產(chǎn)品開發(fā)和設(shè)備端開發(fā)。
云端開發(fā)
設(shè)備類型 | 操作流程 |
|
|
云網(wǎng)關(guān)設(shè)備 |
|
開發(fā)者也可通過(guò)云端API實(shí)現(xiàn)物聯(lián)網(wǎng)平臺(tái)的云端管理能力，例如：產(chǎn)品管理、設(shè)備管理、Topic管理、服務(wù)端訂閱、云產(chǎn)品流轉(zhuǎn)、消息通信等。
云端API具體內(nèi)容，請(qǐng)參見(jiàn)API列表。云端SDK使用方法，請(qǐng)參見(jiàn)云端SDK。使用示例，請(qǐng)參見(jiàn)使用OpenAPI示例。
設(shè)備端開發(fā)
設(shè)備類型 | 接入方式 | 說(shuō)明 |
| 物聯(lián)網(wǎng)平臺(tái)提供了C、Android、Python、Java、iOS、Node.js語(yǔ)言的SDK，支持各種類型設(shè)備的接入。 | |
如果提供的設(shè)備端SDK無(wú)法滿足您的需求，可自行開發(fā)。例如使用開源MQTT客戶端接入物聯(lián)網(wǎng)平臺(tái)。 物聯(lián)網(wǎng)平臺(tái)提供了基于多種語(yǔ)言的Paho-MQTT的示例，包括Paho-MQTT的Android、Java、C（嵌入式版）、C（非嵌入式版）、C#、Python、Rust、Go等語(yǔ)言。 可以根據(jù)Alink協(xié)議，對(duì)接開發(fā)物聯(lián)網(wǎng)平臺(tái)的各項(xiàng)功能。 | ||
模組接入 | 可以使用支持MQTT、HTTPS指令的AT模組，也可以使用通用TCP AT模組接入。 物聯(lián)網(wǎng)平臺(tái)提供了如下SDK示例：在支持MQTT的模組上集成SDK、在支持TCP的廣域網(wǎng)模組上集成SDK。 | |
私有協(xié)議的設(shè)備 | 支持設(shè)備的數(shù)據(jù)從其他物聯(lián)網(wǎng)平臺(tái)流轉(zhuǎn)到阿里云物聯(lián)網(wǎng)平臺(tái)。 | |
云網(wǎng)關(guān)設(shè)備 | MQTT協(xié)議云網(wǎng)關(guān)接入 | 使用自定義證書信息進(jìn)行設(shè)備身份認(rèn)證，可以將存量設(shè)備在無(wú)需做改造的情況下遷移到阿里云企業(yè)物聯(lián)網(wǎng)平臺(tái)。 物聯(lián)網(wǎng)平臺(tái)提供了如下SDK示例：C語(yǔ)言的接入示例（阿里云FC認(rèn)證）、Java語(yǔ)言的接入示例（雙向認(rèn)證）。 |
JT/T 808協(xié)議云網(wǎng)關(guān)接入 | 使用自定義證書信息進(jìn)行設(shè)備身份認(rèn)證，適用于將有道路運(yùn)輸車輛衛(wèi)星定位系統(tǒng)車載終端的設(shè)備接入物聯(lián)網(wǎng)平臺(tái)。 物聯(lián)網(wǎng)平臺(tái)提供了C語(yǔ)言的SDK示例：接入示例（一方認(rèn)證）。 | |
GB/T 32960協(xié)議云網(wǎng)關(guān)接入 | 使用自定義證書信息進(jìn)行設(shè)備身份認(rèn)證，適用于將電動(dòng)汽車設(shè)備接入物聯(lián)網(wǎng)平臺(tái)。 物聯(lián)網(wǎng)平臺(tái)提供了使用Github開源工程的SDK示例：接入示例（一方認(rèn)證）。 | |
SL 651協(xié)議云網(wǎng)關(guān)接入 | 使用自定義證書信息進(jìn)行設(shè)備身份認(rèn)證，適用于將遙測(cè)站設(shè)備接入物聯(lián)網(wǎng)平臺(tái)。 |
后續(xù)操作
設(shè)備成功接入物聯(lián)網(wǎng)平臺(tái)后，可通過(guò)設(shè)備的消息轉(zhuǎn)發(fā)、數(shù)據(jù)服務(wù)、監(jiān)控運(yùn)維功能，管理物聯(lián)網(wǎng)平臺(tái)設(shè)備相關(guān)數(shù)據(jù)。
消息轉(zhuǎn)發(fā)：可以使用服務(wù)端訂閱和云產(chǎn)品流轉(zhuǎn)功能，進(jìn)行設(shè)備消息轉(zhuǎn)發(fā)，實(shí)現(xiàn)設(shè)備與服務(wù)器的消息通信，以及設(shè)備數(shù)據(jù)的流轉(zhuǎn)和存儲(chǔ)。
數(shù)據(jù)服務(wù)：可以使用數(shù)據(jù)服務(wù)的存儲(chǔ)備份、數(shù)據(jù)解析、存儲(chǔ)管理、指標(biāo)管理、SQL分析、報(bào)表分析和數(shù)據(jù)智能等功能，挖掘物聯(lián)網(wǎng)數(shù)據(jù)中的價(jià)值。
監(jiān)控運(yùn)維：可以使用實(shí)時(shí)監(jiān)控、日志服務(wù)、在線調(diào)試等功能對(duì)設(shè)備和通信消息相關(guān)指標(biāo)數(shù)據(jù)，進(jìn)行監(jiān)控和管理。
更多功能說(shuō)明，請(qǐng)參見(jiàn)功能特性。