單元十三ESP8266WiFi模塊-EDP-LED主講人：湯宇嬌上海城建職業(yè)學(xué)院本單元內(nèi)容EDP基本概念EDP協(xié)議解析配置基于EDP協(xié)議的設(shè)備端、云端通信教學(xué)目標(biāo)了解EDP基本概念了解EDP協(xié)議設(shè)計(jì)方法掌握配置基于EDP協(xié)議的設(shè)備端、云端通信13.1EDP基本概念EDP概念EDPEDP基本概念EDP(EnhancedDeviceProtocol增強(qiáng)設(shè)備協(xié)議）是OneNET平臺(tái)根據(jù)物聯(lián)網(wǎng)特點(diǎn)專(zhuān)門(mén)定制的完全公開(kāi)的基于TCP的協(xié)議，可以廣泛應(yīng)用到家居、交通、物流、能源以及其他行業(yè)應(yīng)用中。功能特點(diǎn)：長(zhǎng)連接協(xié)議數(shù)據(jù)加密傳輸終端數(shù)據(jù)點(diǎn)上報(bào)，平臺(tái)消息下發(fā)端到端數(shù)據(jù)轉(zhuǎn)發(fā)EDP概念EDP典型應(yīng)用場(chǎng)景EDP協(xié)議適用于設(shè)備和平臺(tái)需要保持長(zhǎng)連接點(diǎn)對(duì)點(diǎn)控制的使用場(chǎng)景?；赥CP協(xié)議的，該協(xié)議只傳輸數(shù)據(jù)包到達(dá)目的地，不保證傳輸?shù)捻樞蚺c到達(dá)的順序相同，事務(wù)機(jī)制需要在上層實(shí)現(xiàn)；若客戶端同時(shí)發(fā)起兩次請(qǐng)求，服務(wù)器返回時(shí)，不保障返回報(bào)文的順序。EDP協(xié)議適合于數(shù)據(jù)的長(zhǎng)連接上報(bào)、透?jìng)鳌⑥D(zhuǎn)發(fā)、存儲(chǔ)、數(shù)據(jù)主動(dòng)下發(fā)等場(chǎng)景。開(kāi)發(fā)流程EDP測(cè)試流程圖接入流程分為設(shè)備域和平臺(tái)域13.2EDP協(xié)議解析消息格式消息格式定義EDP協(xié)議解析字節(jié)\bit76543210Byte1消息類(lèi)型保留位（全零）Multi-bytes剩余消息長(zhǎng)度（1-4字節(jié)，指示選項(xiàng)+消息體的長(zhǎng)度）Multi-bytes選項(xiàng)（根據(jù)消息類(lèi)型0個(gè)或多個(gè)）Multi-bytes消息體（根據(jù)消息類(lèi)型0或多個(gè)字節(jié)）消息包括三個(gè)部分：必選的消息頭（綠色），可選的多個(gè)選項(xiàng)（黃色）以及可選的消息體（藍(lán)色）。登錄認(rèn)證可選的登錄認(rèn)證方式EDP協(xié)議解析登陸認(rèn)證方式攜帶信息說(shuō)明消息示例1設(shè)備ID+鑒權(quán)信息（api-key）設(shè)備ID：申請(qǐng)?jiān)O(shè)備時(shí)平臺(tái)返回的ID；鑒權(quán)信息：在平臺(tái)申請(qǐng)的可以操作該設(shè)備的api-key字符串；2產(chǎn)品ID+鑒權(quán)信息（auth_info）產(chǎn)品ID：在平臺(tái)添加產(chǎn)品時(shí)平臺(tái)生成的ID；鑒權(quán)信息：在平臺(tái)申請(qǐng)?jiān)O(shè)備時(shí)填寫(xiě)設(shè)備的auth_info屬性（json對(duì)象字符串），該屬性需要產(chǎn)品內(nèi)具備唯一性；可選的登錄認(rèn)證方式：示例1：采用登陸方式1：設(shè)備ID“43101”和api-key“abcdefg”，登錄平臺(tái)的連接請(qǐng)求消息格式如下：消息示例采用方式1登錄的消息格式示例EDP協(xié)議解析字節(jié)說(shuō)明\bit76543210消息頭Byte1第一字節(jié)：Bit（4-7）：消息類(lèi)型，值為1；Bit（0-3）：保留位，值為0；00010000變長(zhǎng)剩余消息長(zhǎng)度(25編碼后需要占用1個(gè)字節(jié))Byte2第二字節(jié)：消息剩余字節(jié)長(zhǎng)度，值為2500011001選項(xiàng)1：協(xié)議描述（字符串格式）Byte3長(zhǎng)度高位字節(jié)，值為000000000Byte4長(zhǎng)度低位字節(jié)，值為300000011Byte5字母’E’01000101Byte6字母’D’01000100Byte7字母’P’01010000選項(xiàng)2：協(xié)議版本Byte8一個(gè)字節(jié)表示，值為100000001選項(xiàng)3：連接標(biāo)志Byte9Bit（7）：產(chǎn)品ID標(biāo)志位，值0，Bit（6）：鑒權(quán)信息標(biāo)志位，值1，表示后面消息體有該項(xiàng)Bit（0-5）：系統(tǒng)保留位，填001000000選項(xiàng)4：保持連接時(shí)間（256秒=0x0100）Byte10

第一字節(jié)，時(shí)間值的高位字節(jié)，值100000001Byte11第二字節(jié)，時(shí)間值的低位字節(jié)，值000000000消息示例采用方式1登錄的消息格式示例EDP協(xié)議解析消息體-設(shè)備ID（字符串格式）Byte12長(zhǎng)度高位字節(jié)，值為000000000Byte13長(zhǎng)度低位字節(jié)，值為500000101Byte14字符’4’00110100Byte15字符’3’00110011Byte16字符’1’00110001Byte17字符’0’00110000Byte18字符’1’00110001消息體-鑒權(quán)信息（字符串格式）Byte19長(zhǎng)度高位字節(jié)，值為000000000Byte20長(zhǎng)度低位字節(jié)，值為700000111Byte21字符’a’01100001Byte22字符’b’01100010Byte23字符’c’01100011Byte24字符’d’01100100Byte25字符’e’01100101Byte26字符’f’01100110Byte27字符’g’01100111設(shè)備登錄登錄流程EDP協(xié)議解析EDP設(shè)備登錄設(shè)備云流程：訪問(wèn)設(shè)備云門(mén)戶/注冊(cè)用戶；用戶根據(jù)業(yè)務(wù)情況，在”連接請(qǐng)求”章節(jié)中選擇EDP登錄方式；根據(jù)登錄方式，填寫(xiě)設(shè)備相關(guān)屬性，在產(chǎn)品下新增設(shè)備，獲取產(chǎn)品ID、設(shè)備ID，以及api-key等信息；設(shè)備發(fā)送連接請(qǐng)求報(bào)文到設(shè)備云服務(wù)器地址：，端口876或29876EDP登陸消息流根據(jù)相關(guān)登陸方式，在CONN_REQ消息中攜帶驗(yàn)證信息；平臺(tái)驗(yàn)證后，返回鑒權(quán)響應(yīng)碼。數(shù)據(jù)收發(fā)數(shù)據(jù)收發(fā)流程EDP協(xié)議解析要實(shí)現(xiàn)透?jìng)鳎ㄐ烹p方必須都要登陸到設(shè)備云；設(shè)備1使用消息類(lèi)型3“發(fā)送數(shù)據(jù)”發(fā)送數(shù)據(jù)到設(shè)備云，目的地址寫(xiě)明設(shè)備2的ID（若目的地址長(zhǎng)度為零則使用創(chuàng)建設(shè)備時(shí)的route_to為默認(rèn)接收地址），設(shè)備云根據(jù)目的地址使用消息類(lèi)型3（源地址填充為設(shè)備2的ID）轉(zhuǎn)發(fā)數(shù)據(jù)給設(shè)備2；設(shè)備2接收到數(shù)據(jù)（消息類(lèi)型3），可以查看到源地址（設(shè)備1的ID），通過(guò)平臺(tái)向設(shè)備1發(fā)送應(yīng)答。數(shù)據(jù)存儲(chǔ)EDP協(xié)議解析存儲(chǔ)數(shù)據(jù)點(diǎn)利用EDP上報(bào)數(shù)據(jù)點(diǎn)到設(shè)備云進(jìn)行存儲(chǔ)的流程：在設(shè)備云門(mén)戶注冊(cè)用戶，創(chuàng)建需要登錄的設(shè)備（詳見(jiàn)登錄流程）；通過(guò)設(shè)備云門(mén)戶該設(shè)備的詳情頁(yè)，或RESTAPI創(chuàng)建需要存儲(chǔ)的數(shù)據(jù)流（定義上傳數(shù)據(jù)類(lèi)型名稱(chēng)）；設(shè)備進(jìn)行EDP登錄鑒權(quán)；根據(jù)數(shù)據(jù)類(lèi)型（json或二進(jìn)制），數(shù)據(jù)流ID（名稱(chēng)）和當(dāng)前值，時(shí)間（默認(rèn)當(dāng)前系統(tǒng)時(shí)間）等信息，封裝消息類(lèi)型8（”存儲(chǔ)數(shù)據(jù)”，具體格式見(jiàn)消息定義中的示例）發(fā)送到設(shè)備云，設(shè)備云解析后將數(shù)據(jù)點(diǎn)保存在該設(shè)備對(duì)應(yīng)數(shù)據(jù)流中。命令下發(fā)EDP協(xié)議解析從平臺(tái)下發(fā)命令道設(shè)備

平臺(tái)向設(shè)備發(fā)送CMD_REQ命令，攜帶要執(zhí)行的命令及命令I(lǐng)D信息。設(shè)備收到此消息后處理此命令消息，并向平臺(tái)回應(yīng)CMD_RESP消息。此消息中攜帶回應(yīng)的命令I(lǐng)D及響應(yīng)內(nèi)容。13.3基于EDP的云、設(shè)備端配置配置步驟云、端協(xié)同配置登錄OneNet云平臺(tái)，選擇控制臺(tái)配置步驟云、端協(xié)同配置選擇全部產(chǎn)品服務(wù)，基礎(chǔ)服務(wù)下的多協(xié)議接入配置步驟云、端協(xié)同配置選擇EDP協(xié)議，點(diǎn)擊創(chuàng)建產(chǎn)品配置步驟云、端協(xié)同配置選擇添加產(chǎn)品信息配置步驟云、端協(xié)同配置產(chǎn)品添加成功配置步驟云、端協(xié)同配置添加設(shè)備配置步驟云、端協(xié)同配置設(shè)備詳情中添加APIKey配置步驟云、端協(xié)同配置記錄設(shè)備ID和AP