團(tuán)體標(biāo)準(zhǔn)

T/ZGCSC00X.00X-202X

(智慧)社區(qū)物聯(lián)網(wǎng)設(shè)備數(shù)據(jù)接口技術(shù)要求

草案

DataInterfaceStandardforIOTDevicesin(Smart)Community

（征求意見(jiàn)稿）

（本草案完成時(shí)間：202X/XX/XX）

在提交反饋意見(jiàn)時(shí)，請(qǐng)將您知道的相關(guān)專利連同支持性文件一并附上。

XXXX-XX-XX發(fā)布XXXX-XX-XX實(shí)施

中關(guān)村智慧城市產(chǎn)業(yè)技術(shù)

發(fā)布

創(chuàng)新戰(zhàn)略聯(lián)盟

T/ZGCSC00X.00X-202X

(智慧)社區(qū)物聯(lián)網(wǎng)設(shè)備數(shù)據(jù)接口技術(shù)要求

1范圍

本文件規(guī)定了(智慧)社區(qū)物聯(lián)網(wǎng)設(shè)備與物聯(lián)網(wǎng)網(wǎng)關(guān)或物聯(lián)網(wǎng)接入平臺(tái)間數(shù)據(jù)接口的具體功能要求。

本文件適用于(智慧)社區(qū)物聯(lián)網(wǎng)場(chǎng)景下物聯(lián)網(wǎng)設(shè)備與物聯(lián)網(wǎng)網(wǎng)關(guān)或物聯(lián)網(wǎng)接入平臺(tái)間數(shù)據(jù)接口的

設(shè)計(jì)、開(kāi)發(fā)和應(yīng)用。

2規(guī)范性引用文件

下列文件中的內(nèi)容通過(guò)文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對(duì)應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

文件。

GB/T6107使用串行二進(jìn)制數(shù)據(jù)交換的數(shù)據(jù)終端設(shè)備和數(shù)據(jù)電路終結(jié)設(shè)備之間的接口

GB/T13000-2010信息技術(shù)通用多八位編碼字符集(UCS)

GB/T33745-2017物聯(lián)網(wǎng)術(shù)語(yǔ)

GB/T36478.3-2019物聯(lián)網(wǎng)信息交換與共享第3部分:元數(shù)據(jù)

ISO/IECPRF20922消息隊(duì)列遙測(cè)傳輸協(xié)議[Informationtechnology-MessageQueuing

TelemetryTransport(MQTT)]

IETFRFC0768用戶數(shù)據(jù)報(bào)協(xié)議

IETFRFC0791網(wǎng)際互聯(lián)協(xié)議

IETFRFC0793傳輸控制協(xié)議

IETFRFC2616超文本傳輸協(xié)議1.1(HypertextTransferProtocol-HTTP/1.1)

IETFRFC4627JSON應(yīng)用與媒體類型[Theapplication/JsonMediaTypeforJavascript

ObjectNotation(JSON)]

IETFRFC7252受限應(yīng)用協(xié)議（TheConstrainedApplicationProtocol）

3術(shù)語(yǔ)和定義

GB/T33745界定的以及下列術(shù)語(yǔ)與定義適用于本文件。

3.1物聯(lián)網(wǎng)產(chǎn)品IoTProduct

指具備相同屬性特征、上報(bào)事件及下發(fā)及執(zhí)行服務(wù)等功能特性的一類物聯(lián)網(wǎng)設(shè)備。

3.2物聯(lián)網(wǎng)設(shè)備IoTDevice

指具體場(chǎng)景下實(shí)際使用的屬于物聯(lián)網(wǎng)產(chǎn)品的具體物理設(shè)備，是符合物聯(lián)網(wǎng)特征的感知設(shè)備或者執(zhí)

行設(shè)備。

2

T/ZGCSC00X.00X-202X

3.3物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述(IOTURD)InternetOfThingsUnifiedResourceDescription

物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述是在智慧社區(qū)物聯(lián)網(wǎng)環(huán)境下對(duì)物聯(lián)網(wǎng)產(chǎn)品實(shí)體的數(shù)字化描述，包含物聯(lián)

網(wǎng)產(chǎn)品資源標(biāo)識(shí)以及物聯(lián)網(wǎng)產(chǎn)品屬性、事件、服務(wù)的描述。

3.4物聯(lián)網(wǎng)產(chǎn)品資源標(biāo)識(shí)(IOTRI)InternetOfThingsResourceIdentifier

物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述的唯一性標(biāo)識(shí)，支持對(duì)物聯(lián)網(wǎng)產(chǎn)品資源標(biāo)識(shí)進(jìn)行檢索的唯一且永久不變

的標(biāo)識(shí)符。

3.5設(shè)備唯一標(biāo)識(shí)(DeviceID)DeviceuniqueIdentifier

物聯(lián)網(wǎng)實(shí)際應(yīng)用場(chǎng)景中具體物聯(lián)網(wǎng)設(shè)備實(shí)體的唯一標(biāo)識(shí)，設(shè)備唯一標(biāo)識(shí)與物聯(lián)網(wǎng)產(chǎn)品資源標(biāo)識(shí)具

有多對(duì)一的關(guān)系?？蓳?jù)二者對(duì)應(yīng)關(guān)系溯源到此物聯(lián)網(wǎng)產(chǎn)品的統(tǒng)一資源描述信息。

3.6屬性Property

物聯(lián)網(wǎng)設(shè)備自身所具備各種特征信息，包括設(shè)備基本信息、狀態(tài)信息、配置信息、監(jiān)測(cè)值等的各種

數(shù)據(jù)信息。

3.7事件Event

物聯(lián)網(wǎng)設(shè)備主動(dòng)上報(bào)物聯(lián)網(wǎng)接入平臺(tái)的行為描述，內(nèi)容可包含多個(gè)輸出參數(shù)的信息、告警或故障等。

3.8服務(wù)Service

物聯(lián)網(wǎng)設(shè)備可供外部調(diào)用的指令或方法，通常分同步和異步兩種調(diào)用方式。

3.9物聯(lián)網(wǎng)統(tǒng)一資源服務(wù)IOTunifiedresourceservice

指可提供物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述生成、查詢以及獲取的相關(guān)模塊接口或者平臺(tái)接口服務(wù)。

3.10直連設(shè)備DirectConnectedDevice

指不能掛載子設(shè)備且具備直接連接物聯(lián)網(wǎng)接入平臺(tái)的物聯(lián)網(wǎng)設(shè)備

3.11網(wǎng)關(guān)子設(shè)備SubDevice

指不具備物聯(lián)網(wǎng)接入平臺(tái)連接能力，需通過(guò)網(wǎng)關(guān)代理連接至物聯(lián)網(wǎng)接入平臺(tái)的物聯(lián)網(wǎng)設(shè)備

3.12網(wǎng)關(guān)設(shè)備GatewayDevice

指具備自身管理功能，能夠掛載子設(shè)備、維持與子設(shè)備的拓?fù)潢P(guān)系，與子設(shè)備通訊獲取數(shù)據(jù)信息并

可直連至物聯(lián)網(wǎng)接入平臺(tái)的物聯(lián)網(wǎng)設(shè)備。

4縮略語(yǔ)

下列縮略語(yǔ)適用于本文件。

HTTP/HTTPS：超文本傳輸協(xié)議（HyperTextTransferProtocol/HyperTextTransferProtocol

Secure）

3

T/ZGCSC00X.00X-202X

CoAP：受限應(yīng)用程序協(xié)議（TheConstrainedApplicationProtocol）

MQTT：消息隊(duì)列遙測(cè)傳輸（MessageQueuingTelemetryTransport）

LwM2M：輕量級(jí)M2M（LightweightMachinetoMachine）

JSON：基于JavaScript語(yǔ)言的輕量級(jí)的數(shù)據(jù)交換格式（JavaScriptObjectNotation）

5智慧社區(qū)中物聯(lián)網(wǎng)設(shè)備分類與數(shù)據(jù)類型

智慧社區(qū)中物聯(lián)網(wǎng)應(yīng)用場(chǎng)景分類主要包括：公共安全類、民生服務(wù)類、社區(qū)治理三大類。相關(guān)應(yīng)用

涉及物聯(lián)網(wǎng)設(shè)備主要分為以下幾類。

1、環(huán)境監(jiān)測(cè)類：這些設(shè)備主要用于監(jiān)測(cè)社區(qū)內(nèi)環(huán)境參數(shù)，如溫度、濕度、空氣質(zhì)量、光照等，用

于實(shí)時(shí)反映社區(qū)環(huán)境狀況。這些設(shè)備大都為單獨(dú)安裝的直連設(shè)備，數(shù)據(jù)類型通常是結(jié)構(gòu)化的數(shù)

值數(shù)據(jù)。

2、安全監(jiān)控類：包括消防火災(zāi)報(bào)警系統(tǒng)，可燃?xì)怏w探測(cè)系統(tǒng)、電氣火災(zāi)監(jiān)測(cè)系統(tǒng)、門(mén)禁系統(tǒng)以及

具備視頻結(jié)構(gòu)化能力的智能攝像頭等，此類設(shè)備大都以網(wǎng)關(guān)與網(wǎng)關(guān)子設(shè)備組成的組合式系統(tǒng)，

數(shù)據(jù)類型以結(jié)構(gòu)化數(shù)據(jù)為主，包括視頻結(jié)構(gòu)化數(shù)據(jù)，同時(shí)也包括了圖像或視頻等非結(jié)構(gòu)化數(shù)據(jù)。

3、物業(yè)管理類：如一卡通管理、智慧停車、智慧路燈、智能充電樁、智能垃圾分類以及供水供電

供氣相關(guān)的能源監(jiān)測(cè)系統(tǒng)等系統(tǒng)類監(jiān)控設(shè)備。這些設(shè)備也是以網(wǎng)關(guān)與網(wǎng)關(guān)子設(shè)備組成的組合式

系統(tǒng)居多，部分輔以單獨(dú)安裝的直連設(shè)備。數(shù)據(jù)類型通常是結(jié)構(gòu)化數(shù)據(jù)。

4、智能家居類：包括家庭智能門(mén)磁、智能窗簾、燈控、獨(dú)立煙感、家用可燃?xì)怏w探測(cè)、水浸探測(cè)

等家居監(jiān)控類設(shè)備，這些設(shè)備以單獨(dú)安裝的直連設(shè)備為主，數(shù)據(jù)類型通常是結(jié)構(gòu)化數(shù)據(jù)。

5、社區(qū)服務(wù)類：主要為用于社區(qū)健康管理為主的一些生命體征監(jiān)測(cè)設(shè)備。此類設(shè)備多以獨(dú)立式的

直連設(shè)備為主，輔以一些網(wǎng)關(guān)與網(wǎng)關(guān)子設(shè)備組成的組合式系統(tǒng)。數(shù)據(jù)類型以結(jié)構(gòu)化數(shù)據(jù)為主。

智慧社區(qū)場(chǎng)景中的物聯(lián)設(shè)備包含了可移動(dòng)或獨(dú)立安裝的直連設(shè)備與采用網(wǎng)關(guān)設(shè)備代理連接物聯(lián)

網(wǎng)平臺(tái)的組合式設(shè)備兩類，主要功能包括感知監(jiān)測(cè)與控制執(zhí)行。傳輸?shù)臄?shù)據(jù)類型主要以結(jié)構(gòu)化數(shù)據(jù)

為主，同時(shí)也存在少量的非結(jié)構(gòu)化數(shù)據(jù)。

結(jié)構(gòu)化數(shù)據(jù)通常采用輕量級(jí)的數(shù)據(jù)交換格式如JSON進(jìn)行定義以保證靈活性和擴(kuò)展性。對(duì)于圖片、

視頻等非結(jié)構(gòu)化數(shù)據(jù)，如數(shù)據(jù)量較小可采用在JSON中將非結(jié)構(gòu)化數(shù)據(jù)轉(zhuǎn)化為Base64編碼進(jìn)行傳輸，

對(duì)于數(shù)據(jù)量較大的非結(jié)構(gòu)化數(shù)據(jù)可在云端或網(wǎng)關(guān)側(cè)保存文件，JSON格式數(shù)據(jù)使用URL路徑對(duì)非結(jié)構(gòu)

化文件進(jìn)行索引和訪問(wèn)。

6數(shù)據(jù)接口技術(shù)要求

物聯(lián)網(wǎng)設(shè)備數(shù)據(jù)接口工作在物聯(lián)網(wǎng)設(shè)備與物聯(lián)網(wǎng)接入平臺(tái)之間，規(guī)定了物聯(lián)網(wǎng)設(shè)備接入（注冊(cè)）及

數(shù)據(jù)采集、設(shè)備控制、配置等交互過(guò)程中數(shù)據(jù)交換的內(nèi)容和格式。

4

T/ZGCSC00X.00X-202X

圖1數(shù)據(jù)接口標(biāo)準(zhǔn)應(yīng)用架構(gòu)

6.1數(shù)據(jù)接口技術(shù)總體概述

本部分描述生成數(shù)據(jù)接口所需的物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述、數(shù)據(jù)接口內(nèi)容及數(shù)據(jù)接口的生成。

1）物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述（IOTURD）包括物聯(lián)網(wǎng)產(chǎn)品資源標(biāo)識(shí)（IOTRI）、產(chǎn)品屬性、事件

及服務(wù)的數(shù)據(jù)接口描述與定義，是數(shù)據(jù)接口生成所需的前置條件。

2）數(shù)據(jù)接口內(nèi)容對(duì)應(yīng)數(shù)據(jù)傳輸?shù)娜齻€(gè)過(guò)程（事件發(fā)送、服務(wù)發(fā)送、服務(wù)響應(yīng)反饋）,包括三

類：

a)事件發(fā)送時(shí)，物聯(lián)網(wǎng)設(shè)備向物聯(lián)網(wǎng)平臺(tái)發(fā)送信息的數(shù)據(jù)內(nèi)容；

b)服務(wù)發(fā)送時(shí)，物聯(lián)網(wǎng)平臺(tái)向物聯(lián)網(wǎng)設(shè)備發(fā)送信息的數(shù)據(jù)內(nèi)容；

c)服務(wù)反饋時(shí)，物聯(lián)網(wǎng)設(shè)備向物聯(lián)網(wǎng)平臺(tái)發(fā)送信息的數(shù)據(jù)內(nèi)容；

3）數(shù)據(jù)接口的生成：設(shè)備連接后依據(jù)物聯(lián)網(wǎng)產(chǎn)品資源標(biāo)識(shí)獲取物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述，根

據(jù)物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述（6.3）生成事件發(fā)送、服務(wù)發(fā)送、服務(wù)反饋的數(shù)據(jù)接口內(nèi)容和

格式（6.5）。

注：物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述（IOTURD）由物聯(lián)網(wǎng)統(tǒng)一資源服務(wù)中心或者物聯(lián)網(wǎng)接入平臺(tái)物聯(lián)

網(wǎng)統(tǒng)一資源服務(wù)模塊根據(jù)產(chǎn)品類型在設(shè)備注冊(cè)前預(yù)先定義及生成。

6.2通信協(xié)議

物聯(lián)網(wǎng)設(shè)備接口通信協(xié)議應(yīng)基于HTTP/HTTPS協(xié)議、CoAP、MQTT和LwM2M等網(wǎng)絡(luò)傳輸協(xié)議。

6.3物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述的內(nèi)容與JSON數(shù)據(jù)表達(dá)

5

T/ZGCSC00X.00X-202X

物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述（IOTURD）由物聯(lián)網(wǎng)產(chǎn)品資源標(biāo)識(shí)（IOTRI）和針對(duì)該類物聯(lián)網(wǎng)設(shè)備的特

征功能描述兩部分組成。其中特征功能描述部分又可分為對(duì)設(shè)備整體概要狀況描述和該類物聯(lián)網(wǎng)產(chǎn)品

具備的屬性信息描述及產(chǎn)品所具備的事件及服務(wù)的交互數(shù)據(jù)內(nèi)容描述。

物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述通常采用JSON數(shù)據(jù)來(lái)表達(dá)，包含整體概述(profile)、產(chǎn)品的屬性

（properties）、事件（events）、服務(wù)（services）四部分構(gòu)成。其字段說(shuō)明如下表1：

表1物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述JSON數(shù)據(jù)表達(dá)字段說(shuō)明

序

字段名父級(jí)字段名可選/必選類型說(shuō)明

號(hào)

1profile必選JSONObject整體概述

2IOTRIprofile必選Uint32物聯(lián)網(wǎng)產(chǎn)品資源標(biāo)識(shí)

設(shè)備節(jié)點(diǎn)類型1網(wǎng)關(guān)設(shè)備2直連設(shè)備3網(wǎng)關(guān)

3nodeTypeprofile必選Enum

子設(shè)備

聯(lián)網(wǎng)方式,根據(jù)節(jié)點(diǎn)類型確定，南向聯(lián)網(wǎng)方式

包括Modbus、ZigBee、Lora、BLE、OPC、

4linkModeprofile必選Enum

WiFi等，北向聯(lián)網(wǎng)方式包括RJ45、蜂窩

2G/3G/4G/5G，NB-IoT等。

5protocolprofile必選Enum傳輸協(xié)議MQTT、HTTP、CoAP、LwM2M

6msgFormatprofile必選Enum消息格式,枚舉值，緊湊二進(jìn)制、JSON

7manufacturerprofile可選string生產(chǎn)廠商

8properties可選JSONObjectArray設(shè)備屬性定義

9propertyIDproperties必選Uint16屬性ID值

10identifierproperties必選string屬性標(biāo)識(shí)符

11nameproperties必選string屬性名

12infoTypeproperties必選string屬性信息分類說(shuō)明

13accessModeproperties必選string讀寫(xiě)方式，r-只讀，rw-讀寫(xiě),w-只寫(xiě)

14descproperties可選string屬性的描述信息

15dataTypeproperties必選JSONObject屬性類型描述信息

16typedataType必選string屬性類型，值可選text、enum、number、date

17specsdataType可選JSONObject屬性空間描述

18lengthspecs必選string（屬性類型為text時(shí)）文本長(zhǎng)度

（屬性類型為enum時(shí)）枚舉內(nèi)容，i為從0開(kāi)始自

19ispecs可選string

然數(shù)

20minspecs可選string（屬性類型為number）數(shù)值最小值

21maxspecs可選string（屬性類型為number）數(shù)值最大值

22unitspecs可選string（屬性類型為number）數(shù)值顯示單位

23stepspecs可選string（屬性類型為number）數(shù)值精度/步長(zhǎng)

（屬性類型為date）時(shí)間格式，例如“yyyy-

24formatspecs必選stringMM-ddHH:mm:ss”、“yyyy-MM-dd”

“HH:mm:ss”

25events可選JSONObjectArray設(shè)備事件定義

6

T/ZGCSC00X.00X-202X

序

字段名父級(jí)字段名可選/必選類型說(shuō)明

號(hào)

26eventIDevents必選Uint8事件ID

27identifierevents必選string事件標(biāo)識(shí)符

表1（續(xù)）

序

字段名父級(jí)字段名可選/必選類型說(shuō)明

號(hào)

28nameevents必選string事件名

29eventTypeevents必選string事件類型0-信息1-告警2-故障

30descevents可選string事件描述信息

31parametersevents必選JSONObjectArray事件屬性定義，同設(shè)備屬性定義properties

32services可選JSONObjectArray設(shè)備服務(wù)定義

33serviceIDservices必選Uint8服務(wù)ID

34identifierservices必選string服務(wù)標(biāo)識(shí)符

35nameservices必選string服務(wù)名

36serviceTypeservices必選string服務(wù)類型0-指令下發(fā)1-指令響應(yīng)回復(fù)

37descservices可選string服務(wù)描述信息

38parametersservices必選JSONObjectArray服務(wù)屬性定義，同設(shè)備屬性定義properties

物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述JSON數(shù)據(jù)表達(dá)JSON格式示例參見(jiàn)附錄A。

注：

（1）物聯(lián)網(wǎng)產(chǎn)品資源標(biāo)識(shí)應(yīng)保證唯一且不變，用于設(shè)備交互時(shí)對(duì)于物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述的檢

索。

6.4視頻結(jié)構(gòu)化數(shù)據(jù)的統(tǒng)一資源描述

將視頻結(jié)構(gòu)化設(shè)備視為一類特殊的物聯(lián)網(wǎng)設(shè)備，對(duì)具有同類型功能的視頻結(jié)構(gòu)化產(chǎn)品定義相同的

IOTRI。將視頻結(jié)構(gòu)化數(shù)據(jù)中的“視頻對(duì)象”和“對(duì)象行為”統(tǒng)一用物聯(lián)網(wǎng)的“事件”進(jìn)行表達(dá)，通過(guò)

物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述中事件屬性定義來(lái)描述視頻結(jié)構(gòu)化對(duì)象/行為的特征與屬性，實(shí)現(xiàn)視頻結(jié)構(gòu)化

數(shù)據(jù)和物聯(lián)網(wǎng)設(shè)備數(shù)據(jù)在語(yǔ)義表達(dá)和數(shù)據(jù)接口的統(tǒng)一。

6.5數(shù)據(jù)接口格式

物聯(lián)網(wǎng)設(shè)備傳輸?shù)臄?shù)據(jù)報(bào)文宜采用可序列化的JSON（RFC4627）或緊湊二進(jìn)制流作為數(shù)據(jù)接口格

式，采用HTTP協(xié)議或CoAP協(xié)議進(jìn)行數(shù)據(jù)傳輸。

兩種方式只是對(duì)于傳輸數(shù)據(jù)的不同編碼方式，因此在平臺(tái)-設(shè)備交互時(shí)，可自主選擇數(shù)據(jù)的傳輸格

式，并應(yīng)支持二者進(jìn)行相互轉(zhuǎn)化。數(shù)據(jù)接口格式的兩種表達(dá)對(duì)比示例參見(jiàn)附錄D。

6.5.1JSON格式接口數(shù)據(jù)格式

物聯(lián)網(wǎng)設(shè)備與物聯(lián)網(wǎng)關(guān)或平臺(tái)交互應(yīng)以物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述約定的事件或服務(wù)定義的描述內(nèi)

容進(jìn)行數(shù)據(jù)交互。發(fā)送或接收時(shí)接口數(shù)據(jù)參考格式如下。

7

T/ZGCSC00X.00X-202X

事件發(fā)送

事件是由物聯(lián)網(wǎng)設(shè)備上傳，描述設(shè)備感知的信息。事件由設(shè)備端主動(dòng)發(fā)送，表2為物聯(lián)網(wǎng)設(shè)備事件

發(fā)送JSON字段說(shuō)明，表3為視頻結(jié)構(gòu)化事件發(fā)送數(shù)據(jù)JSON格式字段說(shuō)明。相關(guān)示例參見(jiàn)附錄B.1。

表2事件發(fā)送數(shù)據(jù)JSON格式字段說(shuō)明

序號(hào)字段名父級(jí)字段名可選/必選類型說(shuō)明

1IOTRI必選Uint32物聯(lián)網(wǎng)產(chǎn)品資源標(biāo)識(shí)

2deviceID必選string設(shè)備ID,設(shè)備的唯一標(biāo)識(shí)符

3eventID必選Uint8為與平臺(tái)約定的事件ID，用于區(qū)分具體上報(bào)事件

4data必選JSONObject設(shè)備上報(bào)的事件參數(shù)信息內(nèi)容，格式為"參數(shù)名":參數(shù)值

5dev可選JSONObject子設(shè)備信息：當(dāng)前上報(bào)信息包含子設(shè)備信息時(shí)需具備

6devnumdev可選string用于通過(guò)RS232或RS485口接入的網(wǎng)關(guān)子設(shè)備地址描述

7datadev可選JSONObject子設(shè)備上報(bào)的事件參數(shù)信息內(nèi)容，格式同data

表2視頻結(jié)構(gòu)化事件發(fā)送數(shù)據(jù)JSON格式字段說(shuō)明

序號(hào)字段名父級(jí)字段名可選/必選類型說(shuō)明

1IOTRI必選Uint32視頻結(jié)構(gòu)化產(chǎn)品資源標(biāo)識(shí)

2deviceID必選string視頻源（攝像頭）設(shè)備ID,視頻源的唯一標(biāo)識(shí)符

為與平臺(tái)約定的事件（視頻結(jié)構(gòu)化對(duì)象或行為）ID，用于

3eventID必選Uint8

區(qū)分具體上報(bào)事件

4data必選JSONObject設(shè)備上報(bào)的事件參數(shù)信息內(nèi)容，格式為"參數(shù)名":參數(shù)值

子畫(huà)面（ROI區(qū)域）信息：當(dāng)前上報(bào)信息包含子畫(huà)面

5dev可選JSONObject

（ROI）信息時(shí)需具備

6devnumdev可選string

7datadev可選JSONObject子畫(huà)面（ROI）上報(bào)的事件參數(shù)信息內(nèi)容，格式同data

服務(wù)發(fā)送

服務(wù)發(fā)送由平臺(tái)側(cè)主動(dòng)發(fā)起，設(shè)備側(cè)異步返回反饋信息，JSON數(shù)據(jù)字段說(shuō)明如表4所示。相關(guān)示例

參見(jiàn)附錄B.2。

表3服務(wù)發(fā)送數(shù)據(jù)JSON格式字段說(shuō)明

序號(hào)字段名父級(jí)字段名可選/必選類型說(shuō)明

1IOTRI必選Uint32物聯(lián)網(wǎng)產(chǎn)品資源標(biāo)識(shí)

2deviceID必選string設(shè)備ID,設(shè)備的唯一標(biāo)識(shí)符

3serviceID必選Uint8為與平臺(tái)約定的服務(wù)ID，用于區(qū)分具體下發(fā)服務(wù)

4data必選JSONObject平臺(tái)下發(fā)的服務(wù)參數(shù)信息內(nèi)容，格式為"參數(shù)名":參數(shù)值

5dev可選JSONObject子設(shè)備信息：當(dāng)前上報(bào)信息包含子設(shè)備信息時(shí)需具備

6devnumdev可選string用于通過(guò)RS232或RS485口接入的網(wǎng)關(guān)子設(shè)備地址描述

7datadev可選JSONObject子設(shè)備上報(bào)的事件參數(shù)信息內(nèi)容，格式同data

服務(wù)響應(yīng)反饋

8

T/ZGCSC00X.00X-202X

服務(wù)響應(yīng)反饋由設(shè)備側(cè)發(fā)起返回反饋信息，其JSON數(shù)據(jù)格式字段說(shuō)明如表5所示。相關(guān)示例參見(jiàn)附

錄B.3。

表4服務(wù)相應(yīng)反饋數(shù)據(jù)JSON格式字段說(shuō)明

序號(hào)字段名父級(jí)字段名可選/必選類型說(shuō)明

1code必選uint為設(shè)備端返回響應(yīng)碼

2msg可選string設(shè)備端反饋的響應(yīng)信息，可為空

3IOTRI必選Uint32物聯(lián)網(wǎng)產(chǎn)品資源標(biāo)識(shí)

4deviceID必選string設(shè)備ID,設(shè)備的唯一標(biāo)識(shí)符

5serviceID必選Uint8為與平臺(tái)約定的服務(wù)ID，用于區(qū)分具體下發(fā)或反饋服務(wù)

6data必選JSONObject平臺(tái)下發(fā)的服務(wù)參數(shù)信息內(nèi)容，格式為"參數(shù)名":參數(shù)值

7dev可選JSONObject子設(shè)備信息：當(dāng)前上報(bào)信息包含子設(shè)備信息時(shí)需具備

8devnumdev可選string用于通過(guò)RS232或RS485口接入的網(wǎng)關(guān)子設(shè)備地址描述

9datadev可選JSONObject子設(shè)備上報(bào)的事件參數(shù)信息內(nèi)容，格式同data

6.5.2緊湊二進(jìn)制接口數(shù)據(jù)格式

通信數(shù)據(jù)包結(jié)構(gòu)總圖

圖2通信數(shù)據(jù)包結(jié)構(gòu)總圖

通信數(shù)據(jù)包整體分為三層：

接入層：定義通信傳輸?shù)牡讓痈袷?，以便?shí)現(xiàn)與各種不同媒介的信息互通。接入層承載并保證

網(wǎng)絡(luò)層協(xié)議數(shù)據(jù)的可靠傳輸，在本協(xié)議支持多種接入層。

應(yīng)用層：針對(duì)各種監(jiān)控所需功能，提供接口指令，實(shí)現(xiàn)了面向監(jiān)控功能的數(shù)據(jù)組織。

實(shí)體層：組織應(yīng)用層下數(shù)據(jù)單元的各監(jiān)控量（設(shè)備屬性）的數(shù)據(jù)表達(dá)。

接入層數(shù)據(jù)格式

9

T/ZGCSC00X.00X-202X

以數(shù)據(jù)包的形式進(jìn)行交互，一個(gè)完整的接入層協(xié)議包由起始標(biāo)志、數(shù)據(jù)長(zhǎng)度、校驗(yàn)單元、數(shù)據(jù)單元、

結(jié)束標(biāo)志5部分組成。

圖3接入層數(shù)據(jù)包結(jié)構(gòu)圖

各單元詳細(xì)說(shuō)明：

起始標(biāo)志：

表示一個(gè)完整數(shù)據(jù)包（分組）起始的標(biāo)志；長(zhǎng)度為1字節(jié)，固定為&。

協(xié)議類型：

采用的數(shù)據(jù)傳輸協(xié)議；長(zhǎng)度為1字節(jié)，固定為ASCII字符。目前定義A:二進(jìn)制字節(jié)流，B:16

進(jìn)制字符傳輸，C:Base64傳輸，D:字節(jié)流傳輸。

數(shù)據(jù)長(zhǎng)度：

校驗(yàn)單元長(zhǎng)度+數(shù)據(jù)單元長(zhǎng)度+結(jié)束標(biāo)志長(zhǎng)度的總和；長(zhǎng)度為四個(gè)字節(jié)位，十六進(jìn)制字符表示。

高字節(jié)字符在前，低字節(jié)字符在后。

校驗(yàn)單元：

對(duì)協(xié)議中“數(shù)據(jù)單元”的內(nèi)容進(jìn)行校驗(yàn)；長(zhǎng)度為兩個(gè)字節(jié)位，十六進(jìn)制字符表示。高字節(jié)字

符在前，低字節(jié)字符在后。根據(jù)通信包（數(shù)據(jù)單元）生成校驗(yàn)值，采用CRC16循環(huán)冗余校驗(yàn)，如

果所計(jì)算出的校驗(yàn)值和收到的校驗(yàn)值相同則表明該數(shù)據(jù)包有效，否則認(rèn)為該包在傳輸?shù)倪^(guò)程中產(chǎn)

生了差錯(cuò)。

數(shù)據(jù)單元：

接入層協(xié)議的有效載荷（PDU），為應(yīng)用層數(shù)據(jù)；數(shù)據(jù)格式取決于協(xié)議類型。數(shù)據(jù)內(nèi)容見(jiàn)應(yīng)用

層定義。

結(jié)束標(biāo)志：

表示一個(gè)完整數(shù)據(jù)包（分組）結(jié)束的標(biāo)志。長(zhǎng)度為1字節(jié)，固定為‘!’。需要判斷數(shù)據(jù)包最

后一個(gè)字符是否為正確的結(jié)束標(biāo)志，如果不是，則為串包，需要對(duì)端重發(fā)該數(shù)據(jù)包。

注：考慮某些通信方式可能存在部分不可見(jiàn)字符無(wú)法傳遞的問(wèn)題，對(duì)于接入層的數(shù)據(jù)長(zhǎng)度和校驗(yàn)單

元采用16進(jìn)制字符傳輸。如“2B”表示為0x2B。

應(yīng)用層數(shù)據(jù)格式

在本協(xié)議中應(yīng)用層數(shù)據(jù)對(duì)應(yīng)接入的數(shù)據(jù)單元，數(shù)據(jù)傳輸格式取決于接入層協(xié)議類型。各應(yīng)用在解析

的時(shí)候需要先把該數(shù)據(jù)單元數(shù)據(jù)統(tǒng)一成二進(jìn)制數(shù)據(jù)流。在發(fā)送給對(duì)方時(shí)則要反向處理成相應(yīng)格式，再計(jì)

算校驗(yàn)值，加上接入層后發(fā)給對(duì)方。

1

T/ZGCSC00X.00X-202X

以數(shù)據(jù)包形式進(jìn)行交互，一個(gè)完整的應(yīng)用層協(xié)議包由統(tǒng)一資源標(biāo)識(shí)符（IOTRI）、設(shè)備唯一標(biāo)識(shí)

(DEVID)、通信包標(biāo)識(shí)、交互標(biāo)志、命令單元、數(shù)據(jù)單元6部分組成：

圖4應(yīng)用層數(shù)據(jù)包結(jié)構(gòu)圖

各單元詳細(xì)說(shuō)明：

統(tǒng)一資源標(biāo)識(shí)符：為當(dāng)前設(shè)備的IOTRI值，表示設(shè)備的類型，4個(gè)字節(jié)長(zhǎng)度

設(shè)備地址：為該設(shè)備唯一標(biāo)識(shí)，對(duì)應(yīng)設(shè)備的deviceID屬性，32個(gè)字節(jié)長(zhǎng)度。網(wǎng)絡(luò)字節(jié)序，在傳輸時(shí)

低字節(jié)在前，高字節(jié)在后。

通信包標(biāo)識(shí)：為每個(gè)通信包的標(biāo)識(shí)編號(hào)，由發(fā)起通信的一端產(chǎn)生,兩個(gè)字節(jié)長(zhǎng)度。

長(zhǎng)度為2個(gè)字節(jié)，含義如下：

第一個(gè)字節(jié)第二個(gè)字節(jié)

命令類型（0x01事件，0x02服務(wù)；其通信包任務(wù)標(biāo)識(shí)，由發(fā)起通信的一端產(chǎn)生，

他暫保留用于擴(kuò)展）用于標(biāo)識(shí)每個(gè)通信包的編號(hào)

通信包標(biāo)識(shí)由兩部分組成，首字節(jié)標(biāo)識(shí)命令類型（0x01事件，0x02服務(wù)；其他暫保留用于擴(kuò)展）

通信包任務(wù)標(biāo)識(shí)由發(fā)起通信的一端產(chǎn)生，用于標(biāo)識(shí)每個(gè)通信包的編號(hào)。接收端在接收到之后不處

理，而是在返回時(shí)將此值原封不動(dòng)地發(fā)回給發(fā)起端，以便于發(fā)起端分辨通信包。網(wǎng)絡(luò)字節(jié)序。

交互標(biāo)志：處理標(biāo)志，一個(gè)字節(jié)，通信發(fā)起端用此標(biāo)志通知接收端如何處理通信包，接收端用于返

回發(fā)起端通信包的執(zhí)行結(jié)果。

命令單元：命令的唯一標(biāo)識(shí)，一個(gè)字節(jié)，事件或服務(wù)命令的唯一ID，也即對(duì)應(yīng)Json格式中的

eventsID/serviceID。

數(shù)據(jù)單元：實(shí)體層數(shù)據(jù)，以鍵值對(duì)方式標(biāo)識(shí)屬性ID及屬性值，N字節(jié)。格式如下

圖5實(shí)體層數(shù)據(jù)包結(jié)構(gòu)圖

屬性ID：長(zhǎng)度固定2個(gè)字節(jié)，用于標(biāo)識(shí)該設(shè)備的屬性，網(wǎng)絡(luò)字節(jié)序，在傳輸時(shí)低字節(jié)在前，高

字節(jié)在后。

屬性值：對(duì)應(yīng)屬性ID的值，類型和長(zhǎng)度由屬性ID決定。

數(shù)據(jù)單元的總長(zhǎng)度為每組鍵值所占字節(jié)數(shù)之和。

子設(shè)備單元：

當(dāng)存在子設(shè)備時(shí)，應(yīng)采用子數(shù)據(jù)分隔標(biāo)識(shí)將作為子設(shè)備單元起始標(biāo)志，每個(gè)子設(shè)備均以子設(shè)備

數(shù)據(jù)分隔標(biāo)識(shí)作為起始標(biāo)志。子設(shè)備單元為數(shù)據(jù)單元的擴(kuò)展數(shù)據(jù)。子設(shè)備單元格式如下：

1

T/ZGCSC00X.00X-202X

圖6子設(shè)備單元結(jié)構(gòu)圖

子設(shè)備單元包括子設(shè)備數(shù)據(jù)分隔標(biāo)識(shí)、子設(shè)備DeviceID單元、子設(shè)備數(shù)據(jù)單元。

子設(shè)備數(shù)據(jù)分隔標(biāo)識(shí)：固定標(biāo)識(shí)，長(zhǎng)度2字節(jié)，值為0x1b00

子設(shè)備DeviceID單元：子設(shè)備DeviceID標(biāo)識(shí)符與子設(shè)備DeviceID的鍵值對(duì)。子設(shè)備DeviceID標(biāo)

識(shí)符為固定標(biāo)識(shí)，長(zhǎng)度為2字節(jié)，為0x0300。子設(shè)備DeviceID為實(shí)際子設(shè)備DeviceID,長(zhǎng)度為32字節(jié)。

子設(shè)備數(shù)據(jù)單元:與數(shù)據(jù)單元中格式一致，見(jiàn)圖5。

.1事件發(fā)送

事件發(fā)送的二進(jìn)制格式字段說(shuō)明如下表6所示。

表6事件發(fā)送數(shù)據(jù)二進(jìn)制格式字段說(shuō)明

序號(hào)單元名JSON字段名可選/必選長(zhǎng)度說(shuō)明

1統(tǒng)一資源標(biāo)識(shí)符IOTRI必選4字節(jié)物聯(lián)網(wǎng)產(chǎn)品資源標(biāo)識(shí)

2設(shè)備地址deviceID必選32字節(jié)設(shè)備ID,設(shè)備的唯一標(biāo)識(shí)符

3通信包標(biāo)識(shí)必選2字節(jié)交互類型為事件發(fā)送時(shí)，值為0x01

通信發(fā)起端用此標(biāo)志通知接收端如何處理通信包，接

4交互標(biāo)志必選1字節(jié)

收端用于返回發(fā)起端通信包的執(zhí)行結(jié)果

5命令單元eventID必選1字節(jié)為與平臺(tái)約定的事件ID，用于區(qū)分具體上報(bào)事件

設(shè)備上報(bào)的事件參數(shù)信息內(nèi)容，基本組成單元為屬性

6數(shù)據(jù)單元data必選N字節(jié)

ID和屬性值的鍵值對(duì)

7子設(shè)備數(shù)據(jù)分隔標(biāo)識(shí)可選2字節(jié)子設(shè)備數(shù)據(jù)的起始標(biāo)記

子設(shè)備ID,子設(shè)備的唯一標(biāo)識(shí)符，按照子設(shè)備

8子設(shè)備DeviceIDdevnum可選32字節(jié)DeviceID標(biāo)識(shí)-子設(shè)備DeviceID鍵值對(duì)的方式進(jìn)行傳

輸

設(shè)備上報(bào)的事件參數(shù)信息內(nèi)容，基本組成單元為屬性

9子設(shè)備數(shù)據(jù)單元data可選N字節(jié)

ID和屬性值的鍵值對(duì)

.2服務(wù)發(fā)送

服務(wù)發(fā)送的二進(jìn)制格式字段說(shuō)明如下表7所示。

表7服務(wù)發(fā)送數(shù)據(jù)二進(jìn)制格式字段說(shuō)明

序號(hào)單元名JSON字段名可選/必選類型說(shuō)明

統(tǒng)一資源標(biāo)

1IOTRI必選4字節(jié)物聯(lián)網(wǎng)產(chǎn)品資源標(biāo)識(shí)

識(shí)符

2設(shè)備地址deviceID必選32字節(jié)設(shè)備ID,設(shè)備的唯一標(biāo)識(shí)符

1

T/ZGCSC00X.00X-202X

3通信包標(biāo)識(shí)必選2字節(jié)交互類型為服務(wù)發(fā)送時(shí)，值為0x02

通信發(fā)起端用此標(biāo)志通知接收端如何處理通信包，接收端用于

4交互標(biāo)志必選1字節(jié)

返回發(fā)起端通信包的執(zhí)行結(jié)果

5命令單元serviceID必選1字節(jié)為與平臺(tái)約定的服務(wù)ID，用于區(qū)分具體下發(fā)或反饋服務(wù)

平臺(tái)下發(fā)的服務(wù)參數(shù)信息內(nèi)容，基本組成單元為屬性ID和屬性

6數(shù)據(jù)單元data必選N字節(jié)

值的鍵值對(duì)

子設(shè)備數(shù)據(jù)

7可選2字節(jié)子設(shè)備數(shù)據(jù)的起始標(biāo)記

分隔標(biāo)識(shí)

子設(shè)備子設(shè)備ID,子設(shè)備的唯一標(biāo)識(shí)符，按照子設(shè)備DeviceID標(biāo)識(shí)-

8devnum可選32字節(jié)

DeviceID子設(shè)備DeviceID鍵值對(duì)的方式進(jìn)行傳輸

子設(shè)備數(shù)據(jù)設(shè)備上報(bào)的事件參數(shù)信息內(nèi)容，基本組成單元為屬性ID和屬性

9data可選N字節(jié)

單元值的鍵值對(duì)

.3服務(wù)響應(yīng)反饋

服務(wù)響應(yīng)反饋的二進(jìn)制格式字段說(shuō)明如下表8所示。

表8服務(wù)響應(yīng)反饋數(shù)據(jù)二進(jìn)制格式字段說(shuō)明

序號(hào)單元名JSON字段名可選/必選類型說(shuō)明

統(tǒng)一資源標(biāo)

1IOTRI必選4字節(jié)物聯(lián)網(wǎng)產(chǎn)品資源標(biāo)識(shí)

識(shí)符

2設(shè)備地址deviceID必選32字節(jié)設(shè)備ID,設(shè)備的唯一標(biāo)識(shí)符

3通信包標(biāo)識(shí)必選2字節(jié)交互類型為服務(wù)發(fā)送反饋時(shí)，值為0x02

通信發(fā)起端用此標(biāo)志通知接收端如何處理通信包，接收端用于返回

4交互標(biāo)志code必選1字節(jié)

發(fā)起端通信包的執(zhí)行結(jié)果

5命令單元serviceID必選1字節(jié)為與平臺(tái)約定的服務(wù)ID，用于區(qū)分具體下發(fā)或反饋服務(wù)

平臺(tái)下發(fā)的服務(wù)參數(shù)信息內(nèi)容，基本組成單元為屬性ID和屬性值的

6數(shù)據(jù)單元data必選N字節(jié)

鍵值對(duì)

子設(shè)備數(shù)據(jù)

7可選2字節(jié)子設(shè)備數(shù)據(jù)的起始標(biāo)記

分隔標(biāo)識(shí)

子設(shè)備子設(shè)備ID,子設(shè)備的唯一標(biāo)識(shí)符，按照子設(shè)備DeviceID標(biāo)識(shí)-子設(shè)

8devnum可選32字節(jié)

DeviceID備DeviceID鍵值對(duì)的方式進(jìn)行傳輸

子設(shè)備數(shù)據(jù)設(shè)備上報(bào)的事件參數(shù)信息內(nèi)容，基本組成單元為屬性ID和屬性值的

9data可選N字節(jié)

單元鍵值對(duì)

1

T/ZGCSC00X.00X-202X

附錄A

（資料性）

物聯(lián)網(wǎng)產(chǎn)品統(tǒng)一資源描述JSON數(shù)據(jù)表達(dá)示例

{

"profile":{

"IOTRI":"",

"nodeType":1,//設(shè)備節(jié)點(diǎn)類型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":"",//讀寫(xiě)方式，r-只讀，rw-讀寫(xiě),w-只寫(xiě)

"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":"打開(kāi)"

}

1

T/ZGCSC00X.00X-202X

}

},

{

"propertyID":3,

"identifier":"",

"name":"",

"infoType":"",

"accessMode":