T/ZSA 179-2023 通用物联感知设备数据交换规范

ICS35.240.01

CCSL67

团体标准

T/ZSA179-2023

通用物联感知设备数据交换规范

DataexchangespecificationforuniversalIoTsensingdevice

2023-11-25发布2023-11-26实施

中关村标准化协会发布

T/ZSA179-2023

目次

目次I

前言1

1范围2

2规范性引用文件2

3术语和定义2

4缩略语3

5感知设备数据通用模型3

6数据接入7

7数据接出12

8数据处理17

附录A（资料性）代码示例19

I

T/ZSA179-2023

前言

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

起草。

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

本文件由中关村标准化协会技术委员会提出并归口。

本文件起草单位：北京数字政通科技股份有限公司、北京长风信息技术产业联盟、阿里云计算有限

公司、北京清环水务技术研究院有限公司、上海顺舟智能科技股份有限公司。

本文件主要起草人：李明海、胡自和、宋宇震、张东旭、朱康特、鑫超、李磊、王良源、孙启、

张健。

1

T/ZSA179-2023

通用物联感知设备数据交换规范

1范围

本文件规定了物联感知设备数据的通用模型和数据格式，以及数据接入、数据接出的方式、数据存

储的要求。

本文件适用于物联感知设备数据传输过程中的数据交换。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

GB/T33745-2017物联网术语

GB/T34069-2017物联网总体技术智能传感器特性与分类

HJ212-2017污染物在线监控（监测）系统数据传输标准

3术语和定义

下列术语和定义适用于本文件。

3.1

物联网internetofthings;IoT

通过感知设备，按照约定协议，连接物、人、系统和信息资源，实现对物理和虚拟世界的信息进行

处理并作出反应的智能服务系统。

注：物即物理实体。

[GB/T33745-2017，定义2.1.1]

3.2

感知设备sensingdevice

能够获取对象信息的设备，并提供接入网络的能力。

注：常见的感知设备有传感结点、RFID读写器等。

[GB/T33745-2017，定义2.1.9]

3.3

物联网平台platformforIoT

对感知设备数据进行数据采集、数据清洗、数据交换、数据计算的数据平台。

3.4

感知设备平台platformforsensingdevice

特指感知设备厂家部署的物联网平台。

3.5

2

T/ZSA179-2023

监测指标monitoringindex

用于感知设备监测维度的指标项，感知设备可以有多个监测指标。

3.6

实时数据realtimedata

感知设备按照天、小时、分钟等时间维度搜集的监测指标数据。

3.7

报警数据alarmdata

实时数据中指标项异常的数据。

4缩略语

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

HTTP超文本传输协议（HyperTextTransferProtocol）

JDBCJava数据库连接（JavaDatabaseConnectivity）

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

MQ消息队列（MessageQueue）

5感知设备数据通用模型

5.1感知设备模型

感知设备模型抽象出所有物联感知设备的基础属性，见表1。感知设备的特殊扩展属性见表2。感

知设备类型见表3，应符合GB/T34069-2017第6.1节的规定。

表1iot_equip_info(感知设备信息表)

序号名称数据类型长度小数位允许空值主键说明

1equip_idvarchar50—NY感知设备标识

2equip_namevarchar50—YN感知设备名称

3equip_codevarchar80—YN感知设备代码

4addressvarchar80—YN地址

5longitudedouble165YN经度

6latitudedouble165YN纬度

7xdouble165YN平面x坐标

8ydouble165YN平面y坐标

感知设备类型

9equip_type_idvarchar3—YN

id，见表3

10valid_flagint1—YN是否有效

关联感知设备列

11relate_equip_listvarchar500—YN

表

3

T/ZSA179-2023

序号名称数据类型长度小数位允许空值主键说明

是否包含子感知

12has_subint1—YN

设备

父感知设备标

13parent_idvarchar50—YN识，见表1的

equip_id

14install_timedatetime—YN安装时间

15create_timedatetime—YN创建时间

16region_namevarchar50—YN区域名称

17manufacturer_namevarchar50—YN厂家名称

18serial_numbervarchar50—YN感知设备序列号

19response_unit_namevarchar50—YN责任单位

20manage_unit_namevarchar50—YN管理单位

21responsible_namevarchar20—YN责任人

注：—代表占位符，该条目不需要。Y代表是。N代表不是。

表2iot_equip_info_ex(感知设备扩展信息字段表)

序号名称数据类型长度小数位允许空值主键说明

1idvarchar50NY

2labelvarchar20YN名称

3namevarchar50YN字段名

4valuevarchar50YN值

感知设备标识，

5equip_idvarchar50YN

见表1

6value_typevarchar15YN值类型

7value_formatvarchar15YN格式

注：—代表占位符，该条目不需要。Y代表是。N代表不是。

表3iot_dic_equip_type(感知设备类型表)

序号名称数据类型长度小数位允许空值主键说明

1equip_type_idvarchar3NY

感知设备类型名

2equip_type_namevarchar100YN

称

注：—代表占位符，该条目不需要。Y代表是。N代表不是。

5.2感知设备状态模型

感知设备状态模型主要描述当前感知设备的状态信息，包括是否报警、是否在线、是否频繁报警、

是否撤防等，和感知设备是一对一关联，见表4。

表4iot_equip_status(感知设备状态表)

4

T/ZSA179-2023

序号名称数据类型长度小数位允许空值主键说明

1equip_idvarchar50NY

2batterydouble62YN电量

3signdouble62YN信号

4online_stateintYN在线状态

5alarm_flagintYN报警状态

6defenceintYN设防状态

7record_timedatetimeYN记录时间

8timedatetimeYN时间

9none_alarmintYN是否无报警

10freq_alarmintYN是否频繁报警

11freq_offlineintYN是否频繁掉线

注：—代表占位符，该条目不需要。Y代表是。N代表不是。

5.3监测指标模型

监测指标模型是感知设备所关联的监测指标模型，主要包括数据值、数据时间、数据类型、数据单

位、数据阈值等，和感知设备是一对多的关系，见表5。一个感知设备可以有多个监测指标模型，监测

指标根据数据类型划分不同，有数值类、枚举类、字符类、图片类共4种。数值类数据如水位10cm、

电压255V；枚举类数据如开关；字符类数据如实时的位置描述信息；图片类则是图片路径等。

表5iot_equip_field(感知设备监测指标表)

序号名称数据类型长度小数位允许空值主键说明

1field_idvarchar50NY

2equip_idvarchar50YN感知设备id

3field_codevarchar50YN监测指标id

4field_namevarchar50YN监测指标名称

5gen_alarmintYN是否生成报警

6data_typeintYN数据类型

监测指标类型：

7field_typeintYN数值、枚举、字

符、图片

8field_unitvarchar20YN单位

9max_valuedouble123YN最大值

10min_valuedouble123YN最小值

11valuedouble123YN值

12detailvarchar1000YN详情

13value_type_idvarchar10YN报警类型id

14timedatetimeYN时间

5

T/ZSA179-2023

序号名称数据类型长度小数位允许空值主键说明

15alarm_stateintYN是否报警

16chart_typeintYN图表类型

17group_idintYN分组id

注：—代表占位符，该条目不需要。Y代表是。N代表不是。

5.4实时数据模型

实时数据模型即是物联感知设备每一次的指标数据，见表6。

表6iot_equip_data(感知设备实时数据表)

序号名称数据类型长度小数位允许空值主键说明

1idvarchar50NY

2equip_idvarchar50YN感知设备id

3field_idvarchar50YN监测指标id

4field_codevarchar50YN监测指标编码

5equip_type_idvarchar10YN感知设备类型id

6timedatetimeYN时间

7receive_timedatetimeYN接收时间

8valuedouble123YN值

9value_type_idvarchar10YN报警类型id

10alarm_flagintYN是否报警

11is_noiseintYN是否噪点

12detailvarchar100YN详情

注：—代表占位符，该条目不需要。Y代表是。N代表不是。

5.5报警数据模型

感知设备报警模型即物联感知设备的报警数据，包括类型、报警数据值、报警时间、报警详情、持

续时间等，见表7。一个感知设备可以有多条报警记录，但为了避免无意义的频繁报警信息，应当为报

警模型指定时间范围，如m时长范围内n次超阈值报警。

表7iot_equip_alarm(感知设备报警数据表)

序号名称数据类型长度小数位允许空值主键说明

1idvarchar500NY

2equip_idvarchar50YN感知设备id

3field_idvarchar50YN监测指标id

4alarm_timedatetimeYN报警时间

5valuedouble123YN报警值

6xdouble165YNx坐标

7ydouble165YNy坐标

6

T/ZSA17