什么是云云對(duì)接（原泛化協(xié)議）SDK
阿里云物聯(lián)網(wǎng)平臺(tái)支持基于MQTT、CoAP和HTTP協(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ù)通道。
僅支持在以下地域使用云云對(duì)接SDK：華東2（上海）、華北2（北京）、華南1（深圳）、德國(guó)（法蘭克福）和美國(guó)（弗吉尼亞）。
服務(wù)架構(gòu)
云云對(duì)接SDK是協(xié)議自適應(yīng)的框架，用以構(gòu)建與阿里云物聯(lián)網(wǎng)平臺(tái)進(jìn)行高效雙向通信的橋接服務(wù)。
適用場(chǎng)景
由于網(wǎng)絡(luò)環(huán)境或者硬件限制，設(shè)備無(wú)法直接接入阿里云物聯(lián)網(wǎng)平臺(tái)。
設(shè)備只支持某種類型協(xié)議，而阿里云物聯(lián)網(wǎng)平臺(tái)目前不支持該協(xié)議。
設(shè)備與其接入服務(wù)器（網(wǎng)橋Server）之間已有通信網(wǎng)絡(luò)，您希望在不修改設(shè)備和協(xié)議的情況下，將設(shè)備接入阿里云物聯(lián)網(wǎng)平臺(tái)。
設(shè)備已接入到您的服務(wù)器，需進(jìn)一步升級(jí)服務(wù)。
復(fù)用阿里云物聯(lián)網(wǎng)平臺(tái)的能力，例如OTA升級(jí)功能。
將設(shè)備納入基于阿里云物聯(lián)網(wǎng)平臺(tái)的解決方案。
其他業(yè)務(wù)需要的處理邏輯。
主要功能
云云對(duì)接SDK使網(wǎng)橋Server，具備與阿里云物聯(lián)網(wǎng)平臺(tái)通信的能力。
基礎(chǔ)功能：
基于配置文件的靜態(tài)配置管理能力。
設(shè)備連接管理能力。
上行通信能力。
下行通信能力。
說明下行通信不支持同步方式，包括同步服務(wù)調(diào)用和RRPC通信。
進(jìn)階功能：
基于接口的動(dòng)態(tài)配置管理能力。
已封裝屬性、事件、標(biāo)簽數(shù)據(jù)上報(bào)接口；屬性、事件批量上報(bào)接口；屬性設(shè)置接口；服務(wù)調(diào)用接口。
名詞解釋
名詞 | 描述 |
設(shè)備 | 真實(shí)物聯(lián)網(wǎng)場(chǎng)景設(shè)備，該設(shè)備無(wú)法直接使用阿里云物聯(lián)網(wǎng)平臺(tái)所支持的協(xié)議直接與云端通信。 |
網(wǎng)橋Server | 設(shè)備接入服務(wù)器。該服務(wù)器使用特定類型協(xié)議與設(shè)備通信，使用云云對(duì)接SDK與阿里云物聯(lián)網(wǎng)平臺(tái)通信。 |
原始協(xié)議 | 設(shè)備與網(wǎng)橋Server之間使用的特定類型協(xié)議。云云對(duì)接SDK不關(guān)心原始協(xié)議的具體定義和實(shí)現(xiàn)。 |
原始身份標(biāo)識(shí)符 | 設(shè)備與網(wǎng)橋Server使用原始協(xié)議通信時(shí)的唯一標(biāo)識(shí)符。云云對(duì)接SDK接口參數(shù)中，用originalIdentity表示設(shè)備的原始身份標(biāo)識(shí)符。 |
設(shè)備證書 | 在阿里云物聯(lián)網(wǎng)平臺(tái)注冊(cè)設(shè)備后，獲得的設(shè)備證書信息（ProductKey、DeviceName、DeviceSecret）。在云云對(duì)接的場(chǎng)景下，不將設(shè)備證書燒錄到設(shè)備上；而是配置云云對(duì)接SDK文件devices.conf ，由網(wǎng)橋?qū)⒃O(shè)備原始身份標(biāo)識(shí)符originalIdentity映射到設(shè)備證書信息。 |
網(wǎng)橋證書 | 在阿里云物聯(lián)網(wǎng)平臺(tái)注冊(cè)網(wǎng)橋設(shè)備后，獲得的網(wǎng)橋設(shè)備證書信息（ProductKey、DeviceName、DeviceSecret），用于在云端標(biāo)識(shí)網(wǎng)橋的身份。 |
開發(fā)和部署
在阿里云物聯(lián)網(wǎng)平臺(tái)控制臺(tái)，創(chuàng)建產(chǎn)品和設(shè)備，獲取網(wǎng)橋設(shè)備證書信息。
具體操作，請(qǐng)參見創(chuàng)建產(chǎn)品和單個(gè)創(chuàng)建設(shè)備或批量創(chuàng)建設(shè)備。
在配置云云對(duì)接SDK時(shí)，需配置網(wǎng)橋設(shè)備證書信息。
說明網(wǎng)橋是個(gè)虛擬概念，您可使用任意設(shè)備的證書信息作為網(wǎng)橋的證書信息。
配置云云對(duì)接SDK。
具體操作，請(qǐng)參見基礎(chǔ)用法和進(jìn)階用法。
說明目前，僅提供Java語(yǔ)言的云云對(duì)接SDK，支持JDK 1.8及以上版本。
部署已開發(fā)完成的橋接服務(wù)。
以基于阿里云云服務(wù)器ECS為例，上線流程如下。
