2(智慧)社區(qū)物聯(lián)網(wǎng)設(shè)備數(shù)據(jù)接口技術(shù)要求本文件適用于(智慧)社區(qū)物聯(lián)網(wǎng)場景下物聯(lián)網(wǎng)設(shè)備與物聯(lián)網(wǎng)網(wǎng)關(guān)或物聯(lián)網(wǎng)接入平臺間數(shù)據(jù)接口的GB/T6107使用串行二進制數(shù)據(jù)交換的數(shù)據(jù)終端設(shè)備和數(shù)據(jù)電路終結(jié)設(shè)備之間的接口GB/T13000-2010信息技術(shù)通用多八位編碼字符集(GB/T36478.3-2019物聯(lián)網(wǎng)信息交換與共享第3部分:元ISO/IECPRF20922消息隊列遙測傳輸協(xié)議[Informationtechnology-MessageQueuingTelemetryTransport(IETFRFC2616超文本傳輸協(xié)議1.1(HypertextTransferIETFRFC4627JSON應(yīng)用與媒體類型[Theapplication/JsonMediaTypeforJavascriptIETFRFC7252受限應(yīng)用協(xié)議（TheConstrainedA指具體場景下實際使用的屬于物聯(lián)網(wǎng)產(chǎn)品的具體物理設(shè)備，是符合物聯(lián)網(wǎng)特征的感知設(shè);3.3物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述(IOTU物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述是在智慧社區(qū)物聯(lián)網(wǎng)環(huán)境下對物聯(lián)網(wǎng)產(chǎn)品實體的數(shù)字化描述，包含物聯(lián)物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述的唯一性標識，支持對物聯(lián)網(wǎng)產(chǎn)品資源標識進行檢索的唯一且永久不變物聯(lián)網(wǎng)實際應(yīng)用場景中具體物聯(lián)網(wǎng)設(shè)備實體的唯一標識，設(shè)備唯一標識與物聯(lián)網(wǎng)產(chǎn)品資源標識具有多對一的關(guān)系。可據(jù)二者對應(yīng)關(guān)系溯源到此物聯(lián)網(wǎng)產(chǎn)品的統(tǒng)一資源指可提供物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述生成、查指不能掛載子設(shè)備且具備直接連接物聯(lián)網(wǎng)接入平臺4縮略語4CoAP：受限應(yīng)用程序協(xié)議（TheConstrainedApplicationProMQTT：消息隊列遙測傳輸（MessageQueuingTelemetryTransport）LwM2M：輕量級M2M（LightweightMachinetoJSON：基于JavaScript語言的輕量級的數(shù)據(jù)交換格式（JavaScriptObjectNota5智慧社區(qū)中物聯(lián)網(wǎng)設(shè)備分類與數(shù)據(jù)類型直連設(shè)備為主，輔以一些網(wǎng)關(guān)與網(wǎng)關(guān)子設(shè)備組成的組合式系統(tǒng)。數(shù)據(jù)類型以結(jié)構(gòu)化數(shù)據(jù)為主。智慧社區(qū)場景中的物聯(lián)設(shè)備包含了可移動或獨立安裝的直連設(shè)備與采用網(wǎng)關(guān)設(shè)備代理連接物聯(lián)52）數(shù)據(jù)接口內(nèi)容對應(yīng)數(shù)據(jù)傳輸?shù)娜齻€過程（事件發(fā)送、服務(wù)發(fā)送、服務(wù)響應(yīng)反饋）,包括三a)事件發(fā)送時，物聯(lián)網(wǎng)設(shè)備向物聯(lián)網(wǎng)平臺發(fā)送b)服務(wù)發(fā)送時，物聯(lián)網(wǎng)平臺向物聯(lián)網(wǎng)設(shè)備發(fā)送信息的數(shù)c)服務(wù)反饋時，物聯(lián)網(wǎng)設(shè)備向物聯(lián)網(wǎng)平物聯(lián)網(wǎng)設(shè)備接口通信協(xié)議應(yīng)基于HTTP/HTTPS協(xié)議、CoAP、MQTT和LwM2M等網(wǎng)絡(luò)6物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述（IOTURD）由物聯(lián)網(wǎng)產(chǎn)品資源標識（IOTRI）和針對該類物聯(lián)網(wǎng)設(shè)備的特征功能描述兩部分組成。其中特征功能描述部分又可分為對設(shè)備整體概要狀況描述和該類物聯(lián)網(wǎng)產(chǎn)品物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述通常采用JSON數(shù)據(jù)來表達，包含整體概述(profile)、產(chǎn)品的屬性（properties）、事件（events）、服務(wù)（services）四部分表1物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述JSO序號1profile2profileUint323nodeTypeprofile4profile5protocolprofile6profile7manufacturerprofile8properties9propertyIDpropertiesUint16propertiespropertiespropertiespropertiespropertiespropertiestypeiunitMM-ddHH:mm:ss”、“yyyy-MM-dd”“HH:mm:ss”7序號Uint8序號Uint8物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述JSON數(shù)據(jù)表達JSON格式（1）物聯(lián)網(wǎng)產(chǎn)品資源標識應(yīng)保證唯一且不變，用于設(shè)備交互時對于物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描將視頻結(jié)構(gòu)化設(shè)備視為一類特殊的物聯(lián)網(wǎng)設(shè)備，對具有同類型功能的視頻結(jié)構(gòu)化產(chǎn)品定義相同的IOTRI。將視頻結(jié)構(gòu)化數(shù)據(jù)中的“視頻對象”和“對象行為”統(tǒng)一用物聯(lián)網(wǎng)的“事件”進行表達，通過物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述中事件屬性定義來描述視頻結(jié)構(gòu)化對象/行為的特征與屬性，實現(xiàn)視頻結(jié)構(gòu)化物聯(lián)網(wǎng)設(shè)備傳輸?shù)臄?shù)據(jù)報文宜采用可序列化的JSON（RFC4627）或緊湊二進制流作為數(shù)據(jù)接口格兩種方式只是對于傳輸數(shù)據(jù)的不同編碼方式，因此在平臺-設(shè)備交互時，可自主選擇數(shù)據(jù)的傳輸格式，并應(yīng)支持二者進行相互轉(zhuǎn)化。數(shù)據(jù)接口格式的兩種表達對物聯(lián)網(wǎng)設(shè)備與物聯(lián)網(wǎng)關(guān)或平臺交互應(yīng)以物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述約定的事件或服務(wù)定義的描述內(nèi)8發(fā)送JSON字段說明，表3為視頻結(jié)構(gòu)化事件發(fā)送數(shù)據(jù)JSON格式字段說明。1Uint3223Uint84設(shè)備上報的事件參數(shù)信息內(nèi)容，格式為"參數(shù)名":567表2視頻結(jié)構(gòu)化事件發(fā)送數(shù)據(jù)JSON1Uint3223Uint84設(shè)備上報的事件參數(shù)信息內(nèi)容，格式為"參數(shù)名5671Uint3223Uint84平臺下發(fā)的服務(wù)參數(shù)信息內(nèi)容，格式為"參數(shù)名":參56791uint23Uint3245Uint86平臺下發(fā)的服務(wù)參數(shù)信息內(nèi)容，格式為"參數(shù)名":參789通信數(shù)據(jù)包整體分為三層：1果所計算出的校驗值和收到的校驗值相同則表元采用16進制字符傳輸。如“2B”表示為0x2B。1以數(shù)據(jù)包形式進行交互，一個完整的應(yīng)用層協(xié)議包由統(tǒng)通信包任務(wù)標識由發(fā)起通信的一端產(chǎn)生，用于標識每個通信包的編號。接收端在接收到之后不處理，而是在返回時將此值原封不動地發(fā)回給發(fā)起端，以便于發(fā)起端分辨通信包。網(wǎng)命令單元：命令的唯一標識，一個字節(jié)，事件或服務(wù)命令的唯一ID，也即對應(yīng)Json格式中的1子設(shè)備數(shù)據(jù)單元:與數(shù)據(jù)單元中格式一致，見圖表6事件發(fā)送數(shù)據(jù)二進制格式字段說明12345678輸9表7服務(wù)發(fā)送數(shù)據(jù)二進制格式字段說明1213456789表8服務(wù)響應(yīng)反饋數(shù)據(jù)二進制格式字段說明1234通信發(fā)起端用此標志通知接收端如何處理通信567891{"profile":{"IOTRI":"","nodeType":1,//設(shè)備節(jié)點類型1網(wǎng)關(guān)設(shè)備2直連設(shè)備3網(wǎng)關(guān)子設(shè)備"linkMode":1,//聯(lián)網(wǎng)方式"protocol":1,//傳輸協(xié)議"msgFormat":1,//消息格式"manufacturer":""http://生產(chǎn)廠商/*屬性定義*/"properties":[{"propertyID":1,"identifier":"","name":"","infoType":"","accessMode":"",//讀寫方式，r-只讀，rw-讀寫,w-只寫"desc":"",//屬性的描述信息"dataType":{"type":"text",//屬性數(shù)據(jù)類型,此處為文本型示例"specs":{"length":"1024"}}{"propertyID":2,"identifier":"","name":"","infoType":"","accessMode":"","desc":"","dataType":{"type":"enum",//屬性數(shù)據(jù)類型,此處為枚舉或布爾型示例"specs":{//枚舉型或布爾型值描述"0":"關(guān)閉","1":"打開"}}{"propertyID":3,"identifier":"","name":"","infoType":"","accessMode":"","desc":"","dataType":{"type":"number",//屬性數(shù)據(jù)類型,此處為數(shù)值型示例"specs":{"min":"0",//數(shù)值最小值"max":"100",//數(shù)值最大值"unit":"%",//數(shù)值顯示單位"step":"1"http://數(shù)值精度/步長}}{"propertyID":4,"identifier":"","name":"","infoType":"","accessMode":"","desc":"","dataType":{"type":"date",//屬性數(shù)據(jù)類型,此處為時間示例"specs":{"format":"yyyy-MM-ddHH:mm:ss"http://時間格式}}}/*事件定義*/"events":[{"eventID":1,"identifier":"","name":"","eventType":"",//事件類型0-信息1-告警2-故障1"desc":"",//事件描述信息"parameters":[/*同屬性定義時寫法,以下以數(shù)值型參數(shù)示例*/{"parameterID":3,"identifier":"","name":"","desc":"","dataType":{"type":"number",//屬性數(shù)據(jù)類型,此處為數(shù)值型示例"specs":{"min":"0","max":"100","unit":"%","step":"1"}}}]}/*服務(wù)定義*/"services":[{"serviceID":1,"identifier":"","name":"","serviceType":"",//服務(wù)類型0-指令下發(fā)1-指令響應(yīng)回復"desc":"","parameters":[/*同屬性定義時寫法,以下以數(shù)值型參數(shù)示例*/{"parameterID":3,"identifier":"","name":"","desc":"","dataType":{"type":"number",//屬性數(shù)據(jù)類型,此處為數(shù)值型示例"specs":{"min":"0","max":"100","unit":"%","step":"1"}}}]}]}1{"deviceID":"f85df91e98a14980926f6f6226a6f24c""eventID":1,//為與平臺約定的事件ID，用于區(qū)分具體上報事件"propertyName1":"ZDST-Ver001"devnum":"H001L001D001",//用于通過RS232或RS48"data":{//子設(shè)備上報的事件參數(shù)信息內(nèi)容，格式為"參}}}{"servicesID":2,//為與平臺約定的服務(wù)ID，用于區(qū)分具體下發(fā)服務(wù)}}{"msg":"",//設(shè)備端反饋的響應(yīng)信息，可以為空"deviceId":"f85df91e98a14980926f6f6226a6"servicesID":"3",//為與平臺約定的服務(wù)ID，用于區(qū)分具體下發(fā)或反饋服務(wù)}}2本物聯(lián)網(wǎng)產(chǎn)品定義中唯一參數(shù)唯一英文屬性的信息分類僅配置信息可選，可選“讀”“寫”“讀寫”表示參數(shù)的讀事件表用于對物聯(lián)網(wǎng)設(shè)備主動上報的各類事件及上報內(nèi)容進2數(shù)字型，本物聯(lián)網(wǎng)產(chǎn)品內(nèi)所有事件及服務(wù)內(nèi)唯一設(shè)備上報事件的類型服務(wù)表用于描述物聯(lián)網(wǎng)設(shè)備所具備的各類可下發(fā)配置指令及指令下發(fā)后反饋響應(yīng)的數(shù)字型，本物聯(lián)網(wǎng)產(chǎn)品內(nèi)所有事件及服務(wù)內(nèi)唯一參數(shù)唯一英文標識定義是下發(fā)配置或下發(fā)后反饋信指令下發(fā)及指令下發(fā)響應(yīng)二者選其一2數(shù)據(jù)協(xié)議的使用前提是設(shè)備在激活使用時需到統(tǒng)一資源標識服務(wù)平臺（或集成在物聯(lián)接入服務(wù)平物聯(lián)接入平臺需具備對事件及服務(wù)解析及構(gòu)造為JSON字節(jié)流或緊湊二進制流方式進行下發(fā)及接收2、物聯(lián)接入服務(wù)接收到請求后根據(jù)激活設(shè)備上報的產(chǎn)品IOTRI及設(shè)備唯一ID向統(tǒng)一資源標識服設(shè)備拓撲建立時根據(jù)不同設(shè)備形態(tài)分為從北向業(yè)務(wù)平臺側(cè)定義拓撲并下發(fā)給設(shè)備及從南向設(shè)備21、網(wǎng)關(guān)側(cè)獲取到連接上來的子設(shè)備后將其產(chǎn)品IOTRI及設(shè)備唯一3、網(wǎng)關(guān)設(shè)備根據(jù)鑒權(quán)結(jié)果建立子設(shè)備白名單并回4、物聯(lián)接入服務(wù)平臺將最新拓撲關(guān)系推送給業(yè)22、物聯(lián)接入服務(wù)對上報數(shù)據(jù)報文按物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述定義規(guī)范要求進行參數(shù)合法性1、業(yè)務(wù)平臺以API方式調(diào)用及下發(fā)服務(wù)請2、物聯(lián)接入平臺根據(jù)物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述定義驗證參數(shù)合法性、以統(tǒng)一協(xié)議格式要求構(gòu)造5、物聯(lián)設(shè)備以統(tǒng)一協(xié)議標準要求進行報文解2如有配置規(guī)則引擎按規(guī)則引擎轉(zhuǎn)發(fā)條件進行數(shù)據(jù)轉(zhuǎn)發(fā)2業(yè)服務(wù)、文化教育等場景，社區(qū)治理類包括群防群治、矛或服務(wù)上報反饋信息的JSON格式結(jié)構(gòu)體進行協(xié)議包語法構(gòu)造與物聯(lián)接入平臺進行通信并上傳給物聯(lián)接入服務(wù)平臺以及對于物聯(lián)接入服務(wù)平臺下發(fā)的服務(wù)數(shù)據(jù)報文進行標準化解析并對本設(shè)備進行控制平臺先查找網(wǎng)關(guān)設(shè)備然后再根據(jù)設(shè)備拓撲關(guān)系查找需要下發(fā)的子設(shè)備，把需要下發(fā)的控制服務(wù)或配置服務(wù)封裝到下發(fā)的報文參數(shù)內(nèi)，然后IOT平臺把下發(fā)的報文發(fā)送給網(wǎng)關(guān)設(shè)備，網(wǎng)關(guān)設(shè)備再根據(jù)其統(tǒng)26412e00000041390200066383564663931653938613134393830393236663666363232366136663235632"f85df91e98a14980926f6f61{"deviceID":"f85df91e98a14980926f6f6226a6f25c",//設(shè)備ID,設(shè)備的唯一標識符"data":{//設(shè)備上報的事件參數(shù)信息內(nèi)容，格式為"參數(shù)名"}：（6638356466393165393861313439383039323666366636323236613666323563020200323c0024"f85df91e98a14980926f6f62{"deviceID":"f85df91e98a14980926f6f6226a6f25c",//設(shè)備ID,設(shè)備的唯一標識符"data":{//平臺下發(fā)服務(wù)的參數(shù)信息內(nèi)容，格式為"參數(shù)名"}6638356466393165393861313439383039323666366636323236613666323563020200033c00246638356466393165393861313439383039323666366636323236613666323"f85df91e98a14980926f6f62{"code":"200",//為設(shè)備端返回響應(yīng)碼"msg":"",//設(shè)備端反饋的響應(yīng)信息，可以為空"deviceId":"f85df91e98a14980926f6f6226a6f25c","servicesID":"3",//為與平"data":{//設(shè)備的反饋服務(wù)參數(shù)信息內(nèi)容，格式為"參數(shù)名":參數(shù)值，以下為示例}}通常通過加裝網(wǎng)關(guān)類設(shè)備使其具備遠程感知能力。66383564663931653938613134393830393236663666363232366136663235630003483030314c3030314430303121000222003"f85df91e98a14980926f6f6（高低位轉(zhuǎn)換0483030314c303031443030483030314c3030314430302{"deviceID":"f85df91e98a14980926f6f6226a6f25c",//設(shè)備ID,設(shè)備的唯一標識符"eventID":1,//為與平"data":{//設(shè)備上報的事件參數(shù)信息內(nèi)容，格式為"參數(shù)名"3"data":{//子設(shè)備上報的事件參數(shù)信息內(nèi)容，格式為"參數(shù)名":參數(shù)值}}}26413e0000004238030000006638356466393165393861313439383039323666366636323236613666323563020100321b0000034830303663835646639316539386131343938303932"f85df91e98a14980926f6f6483030314c303031443030483030314c3030314430303{"deviceID":"f85df91e98a14980926"data":{//子設(shè)備下發(fā)的服務(wù)參數(shù)信息內(nèi)容，格式為"參數(shù)名":參數(shù)值}}}26413e0000004335030000006638356466393165393861313439383039323666366636323236613666323563020100031b0000034830303"f85df91e98a14980926f6f630003483030314c30303140003483030314c3030314