T/ZGCSC 002-2024 智慧社区物联网设备数据接口技术要求

ICS35.020

CCSL70

团体标准

T/ZGCSC002—2024

智慧社区物联网设备数据接口技术要求

DataInterfaceStandardforIOTDevicesinSmartCommunity

2024-03-06发布2024-03-07实施

中关村智慧城市产业技术创新战略联盟发布

T/ZGCSC002—2024

目次

前言................................................................................II

1范围.................................................................................1

2规范性引用文件.......................................................................1

3术语和定义...........................................................................1

4缩略语...............................................................................2

5技术要求.............................................................................2

5.1概述.............................................................................2

5.2通信协议.........................................................................3

5.3物联网产品统一资源描述内容及JSON数据表达........................................3

5.4视频结构化数据的统一资源描述.....................................................5

6数据接口格式.........................................................................6

6.1概述.............................................................................6

6.2JSON接口数据格式.................................................................6

6.3紧凑二进制接口数据格式...........................................................8

附录A（资料性）物联网产品统一资源描述JSON数据表达示例...........................13

附录B（资料性）数据接口JSON格式示例.............................................16

附录C（资料性）物联网产品统一资源描述相关重点数据表结构说明......................18

附录D（资料性）数据协议交互过程..................................................20

附录E（资料性）智慧社区中典型物联网设备接口应用示例典型物联网设备接口应用示例....23

Ⅰ

T/ZGCSC002—2024

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定

起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由中关村智慧城市产业技术创新战略联盟提出并归口。

本文件起草单位：清华大学、深圳市中电数通智慧安全科技股份有限公司、深圳市城市公共安全技

术研究院有限公司、北京航天长峰股份有限公司、广州欣纬智慧安全科技有限公司、神州数码信息系统

有限公司、中科诺信集团有限公司、深圳市中智盛安安全技术科技有限公司、杭州奇际科技有限公司、

山东和同信息科技股份有限公司、深圳市大成智慧科技有限公司、中国联通智能城市研究院、北京东土

科技股份有限公司、高维密码测评技术（山东）有限公司、鹰潭泰尔物联网研究中心有限公司、江西明

鸿光电科技有限公司、北京数字政通科技股份有限公司、特斯联科技集团有限公司、信通院（江西）科

技创新研究院有限公司、软通智慧科技有限公司、中国联通（海南）创新研究院、七腾机器人有限公司、

北京柏睿数据技术股份有限公司、上海无线电设备研究所、北京玖典科技发展有限公司。

本文件主要起草人：张轩、王琰、何文铎、乔冠涵、张涛、尹继尧、张黎明、张鼎、王春华、邵景

莅、荣涛、张淑贞、亓恒忠、张太祥、张浩、郭中梅、白森、董正浩、单斐、祝欣越、魏天呈、金程、

刘友社、王鹏、赵菁华、许苗峰、毛鹏轩、洪军华、张汉宁、王驰、付骏、项小龙、李靖、朱冬、董南、

胡小东、王承承、赵明明、王芳、霍文虎、胡志明、王建、郭如聪、谢加琪。

Ⅱ

T/ZGCSC002—2024

智慧社区物联网设备数据接口技术要求

1范围

本文件规定了智慧社区物联网设备与物联网接入平台间数据接口的技术要求。

本文件适用于智慧社区物联网场景下物联网设备与物联网接入平台间数据接口的设计、开发和应

用。

2规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。

凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。

3术语和定义

GB/T33745-2017及GB/T42455.1-2023中界定的以及下列术语与定义适用于本文件。

3.1

物联网产品IoTProduct

具备相同属性特征、上报事件及下发及执行服务等功能特性的一类物联网设备。

3.2

物联网设备IoTdevice

具体场景下实际使用的属于物联网产品的具体物理设备，是符合物联网特征的感知设备或者执行

设备。

3.3

物联网产品统一资源描述(IOTURD)IoTUnifiedResourceDescription

物联网产品统一资源描述是在智慧社区物联网环境下对物联网产品实体的数字化描述，包含物联

网产品资源标识以及物联网产品属性、事件、服务的描述。

3.4

物联网产品资源标识(IOTRI)IoTResourceIdentifier

物联网产品统一资源描述的唯一性标识，支持对物联网产品资源标识进行检索的唯一且永久不变

的标识符。

3.5

物联网统一资源服务IoTunifiedresourceservice

指可提供物联网产品统一资源描述生成、查询以及获取的相关模块接口或者平台接口服务。

3.6

设备唯一标识(DeviceID)DeviceuniqueIdentifier

1

T/ZGCSC002—2024

物联网实际应用场景中具体物联网设备实体的唯一标识，设备唯一标识与物联网产品资源标识具

有多对一的关系。可据二者对应关系溯源到此物联网产品的统一资源描述信息。

3.7

属性Property

物联网设备自身所具备各种特征信息，包括设备基本信息、状态信息、配置信息、监测值等的各种

数据信息。

3.8

事件Event

物联网设备主动上报物联网接入平台的行为描述，内容可包含多个输出参数的信息、告警或故障等。

3.9

服务Service

物联网设备可供外部调用的指令或方法，通常分同步和异步两种调用方式。

3.10

直连设备DirectConnectedDevice

指不能挂载子设备且具备直接连接物联网接入平台的物联网设备

3.11

网关子设备SubDevice

指不具备物联网接入平台连接能力，需通过网关代理连接至物联网接入平台的物联网设备

3.12

网关设备GatewayDevice

指具备自身管理功能，能够挂载子设备、维持与子设备的拓扑关系，与子设备通讯获取数据信息并

可直连至物联网接入平台的物联网设备。

4缩略语

下列缩略语适用于本文件。

CoAP：受限应用程序协议（TheConstrainedApplicationProtocol）

IOTURD：物联网产品统一资源描述(InternetOfThingsUnifiedResourceDescription)

IOTRI：物联网产品资源标识(InternetOfThingsResourceIdentifier)

HTTP：超文本传输协议（HyperTextTransferProtocol）

HTTPS：超文本传输安全协议（HyperTextTransferProtocolSecure）

JSON：基于JavaScript语言的轻量级的数据交换格式（JavaScriptObjectNotation）

LwM2M：轻量级M2M（LightweightMachinetoMachine）

MQTT：消息队列遥测传输（MessageQueuingTelemetryTransport）

MQTTS：消息队列遥测传输安全协议（MessageQueuingTelemetryTransportSecure）

5技术要求

5.1概述

2

T/ZGCSC002—2024

物联网设备数据接口工作在物联网设备与物联网接入平台或物联网网关之间，规定了物联网设备

接入（注册）及数据采集、设备控制、配置等交互过程中数据交换的内容和格式。

感知设备网关设备物联接入服务（云端、边缘侧）

交互接口类型

传感器

、事件上报

11

有线连接2、服务指令下发

传感器RS232,3、指令下发反馈语法

数据接入与协

RS485、构造

2议解析

Ethernet、接口数据格式并下各

……CAN设

1、紧凑二进制发服

传感器……务指备

统一资源标识持久化存储

2、JSON统

3网络协议令

一

HTTP/HTTPS资物联网产OpenAPI

传感器无线连接统一接口语法业务

MQTT源品的统一

4WIFI，构造与解析

CoAP标资源标识

BLE,LwM2M

响应识定义

传感器Zigbee,语义解析标准平台

LoRa,事件持

5物联网产品

433/470M或服久

统一资源标识

…………务反化

馈及存

语义储

解析

直连设备

统一数据接入与协

资源议解析

传感器

标识

N持久

化存统一接口语法

储构造与解析

图1数据接口标准应用框架

本节描述生成数据接口所需的物联网产品统一资源描述、数据接口内容及数据接口数据生成。

a)物联网产品统一资源描述（IOTURD）应包括物联网产品资源标识（IOTRI）、产品属性、事件及

服务的数据接口描述与定义，是数据接口生成所需的前置条件。

b)数据接口内容应对应数据传输的三个过程（事件发送、服务发送、服务响应反馈），包括（a）

事件发送时，物联网设备向物联网平台发送信息的数据内容；(b）服务发送时，物联网平台向

物联网设备发送信息的数据内容；(c)服务响应反馈时，物联网设备向物联网平台发送信息的

数据内容。

c)数据接口数据生成：应依据物联网产品资源标识获取物联网产品统一资源描述并根据物联网

产品统一资源描述（6.3）生成事件发送、服务发送、服务响应反馈的数据接口内容和格式（第

7章）。

注：物联网产品统一资源描述（IOTURD）由物联网统一资源服务中心或者物联网接入平台的物联网统一资源服务模

块根据产品类型在设备注册前预先定义及生成。

5.2通信协议

物联网设备接口通信协议应基于HTTP/HTTPS协议、CoAP、MQTT/MQTTS和LwM2M等网络传输协议。

5.3物联网产品统一资源描述内容及JSON数据表达

物联网产品统一资源描述（IOTURD）应包含物联网产品资源标识（IOTRI）和针对该类物联网设备

的特征功能描述两部分组成。其中特征功能描述部分应对设备整体概要状况描述和该类物联网产品具

备的属性信息描述及产品所具备的事件及服务的交互数据内容描述。

物联网产品资源标识（IOTRI）应保证唯一且不变，用于设备交互时对于物联网产品统一资源描述

的检索。

物联网产品统一资源描述可采用JSON数据来表达。应包含整体概述(profile)、产品的属性（pro

perties）、事件（events）、服务（services）四部分构成。其字段说明如下表1：

3

T/ZGCSC002—2024

表1物联网产品统一资源描述JSON数据表达字段说明

序号字段名父级字段名可选/必选类型说明

1profile--必选JSONObject整体概述

物联网产品资源

2IOTRIprofile必选Uint32

标识

设备节点类型1

网关设备2直连

3nodeTypeprofile必选Enum

设备3网关子设

备

联网方式,根据

节点类型确定，南

向联网方式包括

Modbus、ZigBee、

4linkModeprofile必选EnumLora、BLE、OPC、

WiFi等，北向联

网方式包括RJ4

5、蜂窝2G/3G/4G

/5G，NB-IoT等。

传输协议MQTT、

MQTTS、HTTP、HT

5protocolprofile必选Enum

TPS、CoAP、LwM2

M

消息格式,枚举

6msgFormatprofile必选Enum值，紧凑二进制、

JSON

7manufacturerprofile可选string生产厂商

JSONObjectArr

8properties--可选设备属性定义

ay

9propertyIDproperties必选Uint16属性ID值

10identifierproperties必选string属性标识符

11nameproperties必选string属性名

属性信息分类说

12infoTypeproperties必选string

明

读写方式，r-只

13accessModeproperties必选string读，rw-读写,w-只

写

14descproperties可选string属性的描述信息

属性类型描述信

15dataTypeproperties必选JSONObject

息

属性类型，值可选

16typedataType必选stringtext、enum、num

ber、date

17specsdataType可选JSONObject属性空间描述

（属性类型为te

18lengthspecs必选string

xt时）文本长度

（属性类型为en

um时）枚举内容，

19ispecs可选string

i为从0开始自然

数

（属性类型为nu

20minspecs可选string

mber）数值最小值

4

T/ZGCSC002—2024

（属性类型为nu

21maxspecs可选string

mber）数值最大值

（属性类型为nu

22unitspecs可选stringmber）数值显示单

位

（属性类型为nu

23stepspecs可选stringmber）数值精度/

步长

（属性类型为da

te）时间格式，例

如“yyyy-MM-dd

24formatspecs必选string

HH:mm:ss”、“yyy

y-MM-dd”“HH:mm:

ss”

JSONObjectArr

25events--可选设备事件定义

ay

26eventIDevents必选Uint8事件ID

27identifierevents必选string事件标识符

28nameevents必选string事件名

事件类型0-信息

29eventTypeevents必选string

1-告警2-故障

30descevents可选string事件描述信息

事件属性定义，同

JSONObjectArr

31parametersevents必选设备属性定义pr

ay

operties

JSONObjectArr

32services--可选设备服务定义

ay

33serviceIDservices必选Uint8服务ID

34identifierservices必选string服务标识符

35nameservices必选string服务名

服务类型0-指令

36serviceTypeservices必选string下发1-指令响应

回复

37descservices可选string服务描述信息

服务属性定义，同

JSONOb