3 4 4 4 5 5 5 5 10 13 14 14 14 14 17 17 17 19 20 20 21 21 24修訂說(shuō)明版本號(hào)修改時(shí)間修改人修改說(shuō)明1.1內(nèi)容和適用范圍本規(guī)范書用以指導(dǎo)南向設(shè)備接入中國(guó)電信物聯(lián)網(wǎng)通用使能平1.2術(shù)語(yǔ)及縮略語(yǔ)定義AEPLwM2M由OMA定義的物聯(lián)網(wǎng)協(xié)議，主要使用在資源受限(包括存儲(chǔ)、功耗等)的NBMQTTTransmissionControlProtHTTP2南向接口技術(shù)規(guī)范2.1LwM2M協(xié)議2.1.1協(xié)議概述LwM2M（LightweightMachineto物聯(lián)網(wǎng)協(xié)議，主要使用在資源受限(包括存儲(chǔ)、功耗等)的NB終端。LwM2M協(xié)議LwM2M定義的Object和Resourc2.1.2接口介紹Register第‘/第‘/27頁(yè)LwM2M業(yè)務(wù)數(shù)據(jù)通過(guò)CoAP協(xié)議進(jìn)行封裝，參數(shù)定義參見下表:Uri-Path(11):{path}path:/rdContent-Format(12):application/link-Uri-Query(15):ep={endpointname}Urn:imei:###########Urn:imei-imsi:########-######Urn:imei+sm9:########-#####Urn:imei+simid:########-#####Uri-Query(15):It={lifetUri-Query(15):lwm2m={LwmUri-Query(15):b={binding}可選，默認(rèn)”U”Uri-Query(15):apn={APN}Uri-Query(15):imsi={IMUri-Query(15):iccid={ICCID}Uri-Query(15):sv={softversion}Uri-Query(15):chip={chiptype}Uri-Query(15):module={module}Uri-Query(15):rsrp={rsrUri-Query(15):sinr={sinr}Uri-Query(15):txpower={txpower}Uri-Query(15):cellid={cellid}“</>;rt=”oma,lwm2m”,</1/0>,</3/0>,</4/0>,</5/0>,</6/0>,</7/0>”4.00BadRequest,參數(shù)4.12PreconditionFailedLoction-path(8):{loction-pLoction-path(8):{loction-pUpdate在lifetime超期之前，設(shè)備需要發(fā)起Update流程，否則平臺(tái)會(huì)認(rèn)為設(shè)備離線，再次連接需要重新發(fā)起Register，當(dāng)設(shè)備參數(shù)（lifetime、bindingmode、ObjectLinks等）發(fā)生變化，設(shè)備可以通過(guò)Update通知平臺(tái)參數(shù)改變。Update流程如下：Update接口參數(shù)如下：設(shè)備通過(guò)Deregister觸發(fā)登出流程deregister接口參數(shù)如下：observe接口參數(shù)：Notify設(shè)備獲取到的數(shù)據(jù)會(huì)上報(bào)給平臺(tái)Notify接口參數(shù)：2.1.3Object19Object19（LwM2MAPPDATA）可以用于應(yīng)用層業(yè)務(wù)數(shù)據(jù)的封裝，實(shí)現(xiàn)包括業(yè)務(wù)數(shù)據(jù)上報(bào)、業(yè)務(wù)指令下發(fā)、終端事件上報(bào)等功能。目前平臺(tái)僅支持Data字段，其他字段暫時(shí)不支持，即：對(duì)于Data字段，平臺(tái)既支持?jǐn)?shù)據(jù)透?jìng)饕仓С謹(jǐn)?shù)據(jù)解析（非透?jìng)鳎?。非透?jìng)髟O(shè)備上報(bào)的業(yè)務(wù)數(shù)據(jù)，平臺(tái)需要對(duì)業(yè)務(wù)數(shù)據(jù)進(jìn)行解析，因此數(shù)據(jù)格式必須遵守平臺(tái)關(guān)于Object19的約定，目前Object19支持緊湊二進(jìn)制和Json兩種數(shù)據(jù)格式。業(yè)務(wù)數(shù)據(jù)上報(bào)的Data字段編碼格式：參數(shù)名稱參數(shù)類型類型說(shuō)明參數(shù)說(shuō)明CMDTypeUnsignedInteger（1）必選定長(zhǎng)ServiceIDUnsignedInteger（2）必選定長(zhǎng)Payload_lengthUnsignedInteger（2）必選定長(zhǎng)業(yè)務(wù)數(shù)據(jù)長(zhǎng)度PayloadBinary長(zhǎng)度為Payload_length業(yè)務(wù)數(shù)據(jù)(二進(jìn)制格式)業(yè)務(wù)指令下發(fā)、指令下發(fā)響應(yīng)的Data字段編碼格式：參數(shù)名稱參數(shù)類型類型說(shuō)明參數(shù)說(shuō)明CMDTypeUnsignedInteger（1）必選定長(zhǎng)報(bào)文類型，下發(fā)指令ServiceIDUnsignedInteger（2）必選定長(zhǎng)UnsignedInteger（2）必選定長(zhǎng)Payload_lengthUnsignedInteger（2）必選定長(zhǎng)數(shù)據(jù)長(zhǎng)度PayloadBinary長(zhǎng)度為Payload_length指令或指令響應(yīng)數(shù)據(jù)（二進(jìn)制格式）服務(wù)ID：1，屬性1：5個(gè)字節(jié)的定長(zhǎng)字符串“hello”，屬性2：2個(gè)字節(jié)的整型，值為（參照ASCII碼表轉(zhuǎn)換），100的十六進(jìn)制為0x0064。編碼過(guò)程為：CMDType：0x02ServiceID：0x0001Payload_length：0x0007Payload：0x68656C6C6F0064因此19/0/0的Data字段應(yīng)填：020001000768656C6C6F0064示例2、設(shè)備上報(bào)的屬性為變長(zhǎng)字符串服務(wù)ID：2，屬性：變長(zhǎng)字符串，長(zhǎng)度為5個(gè)字節(jié)，值為：“hello”。變長(zhǎng)字符串在編碼時(shí)需要攜帶2個(gè)字節(jié)的長(zhǎng)度，即屬性1編碼后的數(shù)據(jù)是0x000568656C6C6F。編碼過(guò)程CMDType：0x02ServiceID：0x0002Payload_length：0x0007Payload：0x000568656C6C6F因此19/0/0的Data字段應(yīng)填：0200020007000568656C6C6F示例3、指令下發(fā)和響應(yīng)下發(fā)的指令服務(wù)ID：8001，TaskID：1，參數(shù)為1個(gè)字節(jié)整形：1-獲取當(dāng)前時(shí)間，0-19/1/0的Data字段為十六進(jìn)制：061F410001000201，解析出指令內(nèi)容為“獲取當(dāng)前時(shí)間”，設(shè)備需要將系統(tǒng)時(shí)間通過(guò)響應(yīng)發(fā)給平臺(tái)。編碼過(guò)程為：Payload：0x323031383132323531{“serviceId”:XXXX,“serviceId”的值為對(duì)應(yīng)服務(wù)的服務(wù)標(biāo)識(shí)，paramet業(yè)務(wù)指令下發(fā)、指令下發(fā)響應(yīng)的Data部分應(yīng)滿足以下格式：“serviceId”的值為對(duì)應(yīng)服務(wù)的服務(wù)標(biāo)識(shí),"taskId"由平臺(tái)分配，用于關(guān)聯(lián)下發(fā)指令和回復(fù)透?jìng)髟O(shè)備平臺(tái)對(duì)19/0/0、19/1/0的Data字段不進(jìn)行解析，支持任意格式的業(yè)務(wù)數(shù)據(jù)的透?jìng)鳌?.1.4OMA標(biāo)準(zhǔn)Object平臺(tái)支持OMA標(biāo)準(zhǔn)Object的訂閱、讀、寫、執(zhí)行操作，詳細(xì)的接口說(shuō)明可參考：LwM2M定義的Object和Resource2.2MQTT協(xié)議2.2.1協(xié)議概述《MQTT_v3.1.1》2.2.2接口介紹2.2.3業(yè)務(wù)數(shù)據(jù)介紹MQTT協(xié)議設(shè)備通過(guò)publish報(bào)文交換業(yè)務(wù)數(shù)據(jù)，平臺(tái)支持?jǐn)?shù)據(jù)上報(bào)、事件上報(bào)、指令下發(fā)等業(yè)務(wù)流程。登陸報(bào)文中ClientId字段填寫AEP平臺(tái)中注冊(cè)的MQTT設(shè)備Id，password字段填寫AEP平臺(tái)為設(shè)備自動(dòng)分配的設(shè)備特征串。平臺(tái)不做解析。對(duì)于電信定制模組，username字段由模組廠商按照格式要求及實(shí)際信息填寫，不允許開放給用戶修改：Username字段txpower十個(gè)參數(shù)均為變長(zhǎng)字節(jié)，組成格式為L(zhǎng)ength+Value(其中，字段Length為2個(gè)字節(jié)，表示后面的字段Value的長(zhǎng)度；Value的實(shí)際長(zhǎng)度不得超過(guò)20字節(jié))。表示模組軟件版本的長(zhǎng)度為6個(gè)字節(jié)，字符串"test01"為模組軟件版本號(hào)的Value值。Iccid及imsi參數(shù)，采用2/3/4G等網(wǎng)絡(luò)模式的模組必須填寫；采用wifi等其他非移動(dòng)網(wǎng)絡(luò)模式的模組，此兩項(xiàng)參數(shù)的length字節(jié)可填寫為"00"。對(duì)于非透?jìng)鳟a(chǎn)品下創(chuàng)建的設(shè)備，必須在門戶上進(jìn)行屬性定義及服務(wù)定義。門戶中定義的屬性列表，即為之后可進(jìn)行規(guī)則引擎的數(shù)據(jù)列表，原則上需在數(shù)據(jù)上報(bào)報(bào)文中涵蓋響應(yīng)的屬性才能使用后續(xù)規(guī)則引擎的能力。門戶中定義的服務(wù)列表，需按照實(shí)際業(yè)務(wù)數(shù)據(jù)選擇服務(wù)類型，每一條服務(wù)唯一對(duì)應(yīng)一個(gè)topic主題，即服務(wù)標(biāo)識(shí)符就是topic主題名稱。設(shè)備的業(yè)務(wù)數(shù)據(jù)需根據(jù)定義的填寫。同時(shí)，payload部分的json結(jié)構(gòu)體，需按照門戶定義的key/value值填寫，否則可能會(huì)出現(xiàn)數(shù)據(jù)不合法而丟棄的現(xiàn)象。用戶可在門戶自定義“數(shù)據(jù)上報(bào)”類型的服務(wù)，生成相應(yīng)topic，publish報(bào)文的topic字段填寫定義的topic，且支持Qos0/1/2三種質(zhì)量等級(jí)數(shù)據(jù)上報(bào)。透?jìng)髟O(shè)備對(duì)于透?jìng)鳟a(chǎn)品下創(chuàng)建的設(shè)備，僅支持?jǐn)?shù)據(jù)上報(bào)及指令下發(fā)兩種業(yè)務(wù)數(shù)據(jù)交互。2.3TCP協(xié)議2.3.1協(xié)議概述2.3.2接口介紹+deviceid_length(2+module_length(2字節(jié))+chiptype_length(2字+softversion_length串；module:模組型號(hào)；(對(duì)于無(wú)SIM的應(yīng)用,iccidrsrp:信號(hào)強(qiáng)度；txpower:發(fā)射功率；上行數(shù)據(jù)0x02+數(shù)據(jù)長(zhǎng)度(2字節(jié))+業(yè)下行數(shù)據(jù)0x03+數(shù)據(jù)長(zhǎng)度(2字節(jié))+業(yè)終端與平臺(tái)心跳周期暫定平臺(tái)回復(fù)終端心跳報(bào)文的2.3.3業(yè)務(wù)流程2.4HTTP協(xié)議2.4.1協(xié)議概述《RFC2616》2.4.2接口介紹2.4.3接入鑒權(quán)接口原型:8992/au請(qǐng)求頭部timestampMasterKey為AEP平臺(tái)上創(chuàng)Content-請(qǐng)求參數(shù)productIdbodybodypasswordversion響應(yīng)參數(shù)鑒權(quán)參數(shù)，訪問AEP平臺(tái)的憑證。每次上報(bào)數(shù)據(jù)時(shí)，都需要攜帶請(qǐng)求示例:8991/auth{“productid”:1000***1,“deviceId”:“1000***11234”,“password”:”2u**************************ss”,“version”:“1.0”}響應(yīng)示例response:{“code”:0,“message”:“SUCCESSFUL”,“accessToken”:“*******”}業(yè)務(wù)返回碼0AuthFailure.對(duì)于電信定制開發(fā)模組，在此基礎(chǔ)之上，接入加相應(yīng)的模組參數(shù)信息。即對(duì)于定制模組而言，實(shí)際的接入鑒權(quán)報(bào)文請(qǐng)求參數(shù)字選productIdbodybodypasswordversionrsrptxpower其中，module、chiptype、softversion和imei等參數(shù)由模組廠商根據(jù)實(shí)際信息填寫，不允許開放給用戶修改，且每個(gè)參數(shù)的實(shí)際長(zhǎng)度均不得超過(guò)20字節(jié)。Iccid及imsi參數(shù)，采用2/3/4G等網(wǎng)絡(luò)模式的模組必須填寫；采用wifi等其他非移動(dòng)網(wǎng)絡(luò)模式的模組，此兩項(xiàng)參數(shù)可為空。2.4.4業(yè)務(wù)數(shù)據(jù)上報(bào)HTTP(S)協(xié)議設(shè)備與平臺(tái)交互，僅支持JSON格式的數(shù)據(jù)上行報(bào)文。平臺(tái)支持非透?jìng)骷巴競(jìng)鲀煞N數(shù)據(jù)傳輸模式。非透?jìng)鳟a(chǎn)品支持在門戶添加數(shù)據(jù)上報(bào)、事件上報(bào)兩種類型服務(wù)，并自行定義服務(wù)標(biāo)識(shí)topic。設(shè)備業(yè)務(wù)數(shù)據(jù)報(bào)文中，topic字段填入平臺(tái)服務(wù)標(biāo)識(shí)，payload字段按照服務(wù)定義的屬性列表填寫JSON格式數(shù)據(jù)內(nèi)容。非透?jìng)髟O(shè)備可使用平臺(tái)提供的規(guī)則引擎能力。透?jìng)鳟a(chǎn)品僅支持?jǐn)?shù)據(jù)上報(bào)一種服務(wù)，topic字段可任意填寫，payload字段數(shù)據(jù)可為任意JSON格式內(nèi)容。透?jìng)鳟a(chǎn)品不支持使用平臺(tái)規(guī)則引擎能力。:8992/topHeadertimestampHeaderHeaderMasterKey為AEP平臺(tái)上創(chuàng)建產(chǎn)Content-StringHeaderapplication/jsonproductIdbodybodytopicStringBody上報(bào)主題。非透?jìng)鳟a(chǎn)品，為服務(wù)定義生成的服務(wù)標(biāo)識(shí)；透?jìng)鳟a(chǎn)品可任意填寫。payloadbodyhttps//:8991/topic{“productId”:10001831,“deviceId”:“100018311234”,“accessToken”:”*********”,“topic”:”test”,“payload”:{“test”:1,“up”:1}}response:{}0SUCCESSFUL數(shù)據(jù)發(fā)送成功commonerror未知錯(cuò)誤Productisnote