DB34 T 5427-2026 监狱安防系统接口规范.pdf

《DB34 T 5427-2026 监狱安防系统接口规范.pdf》由会员分享，可在线阅读，更多相关《DB34 T 5427-2026 监狱安防系统接口规范.pdf（20页珍藏版）》请在麦多课文档分享上搜索。

1、 ICS 35.240.01 CCS A 90 34 安徽省地方标准 DB34/T 54272026 监狱安防系统接口规范 Specification for prison security system interface2026-01-05 发布2026-02-05 实施安徽省市场监督管理局发 布 DB34/T 54272026 I 目次 前言.II 1 范围.1 2 规范性引用文件.1 3 术语和定义.1 4 总体要求.1 5 架构图.1 6 分类.2 监狱安防系统分类.2 6.1 接口分类.2 6.2 7 要求.2 接口协议结构.2 7.1 接口字符串编码.3 7.2 入侵探测和紧急报

2、警.3 7.3 视频监控.4 7.4 出入口控制.5 7.5 防爆安全检查.5 7.6 公共广播.7 7.7 通讯对讲.8 7.8 高压电网.8 7.9 附录 A（规范性）接口协议结构定义.10 A.1 协议头.10 A.2 有效载荷.10 附录 B（规范性）主题名关键字定义.15 附录 C（规范性）状态码和错误码定义.16 C.1 状态码定义.16 C.2 错误码定义.16 DB34/T 54272026 II 前言 本文件按照GB/T 1.12020标准化工作导则 第1部分：标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文

3、件由安徽省监狱管理局提出并归口。本文件起草单位：安徽省监狱管理局、安徽省蜀山监狱、安徽省未成年犯管教所、杭州海康威视数字技术股份有限公司、四创电子股份有限公司。本文件主要起草人：昂扬、张常江、徐文强、徐炜炜、潘伟、王敦林、何超、蔡文骁。DB34/T 54272026 1 监狱安防系统接口规范 1 范围 本文件确立了监狱安防系统接口的总体要求，并规定了监狱安防系统接入架构图、监狱安防系统接口分类和要求。本文件适用于监狱安防系统的数据接口。2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，

4、其最新版本（包括所有的修改单）适用于本文件。GB/T 28181 公共安全视频监控联网系统信息传输、交换、控制技术要求 GB 50348 安全防范工程技术标准 GB 55029 安全防范工程通用规范 3 术语和定义 下列术语和定义适用于本文件。3.1 监狱安防物联中台 prison security iot platform 对监狱安防子系统统一接入管理，具有数据采集、处理和存储等功能的管理平台。4 总体要求 监狱安防各子系统应符合 GB 50348 和 GB 55029 的要求。4.1 视频监控子系统通讯协议应符合 GB/T 28181 规定。4.2 通讯协议应符合 MQTT（遥测传输协议）

5、数据格式为 JSON 格式，应符合附录 A 规定；主题名关4.3 键字定义应符合附录 B 规定；状态码和错误码应符合附录 C 规定。数据在传输过程中宜使用 TLS 协议。4.4 5 架构图 监狱安防各子系统和设备接入监狱安防物联中台架构见图1。DB34/T 54272026 2 监狱安防物联中台属性接口 入侵探测和紧急报警出入口控制入侵报警紧急报警 视频监控普通监控智能分析 防爆安全检查生命探测车底扫描安检门公共广播通讯对讲高压电网操作接口事件接口.图1 监狱安防子系统接入架构 6 分类 监狱安防系统分类 6.1 监狱安防系统包括入侵探测和紧急报警、视频监控、出入口控制、防爆安全检查、公共广

6、播、通讯对讲和高压电网等子系统。接口分类 6.2 接口分为属性接口、操作接口和事件接口三类，见表1。表1 接口分类 序号功能名称功能标识符功能类型1获取属性根据具体属性区分属性2属性上报根据具体属性区分属性3控制操作根据具体操作区分操作4事件上报根据具体事件区分事件7 要求 接口协议结构 7.1 接口协议结构分为协议头和有效载荷，见表2。DB34/T 54272026 3 表2 接口协议结构 结构 协议头(Header)有效载荷(Payload)固定报头（Fixed header）可变报头（Variable header）通用协议体（General Payload）业务协议体（Applicat

7、ion Payload）名称 固定报头 可变报头 长度 内容 内容 符号 Fixed HEADER Variable HEADER LEN Gernal Func 长度 2-5字节 不定 2字节 不定 不定 说明 根据可变报头+有效载荷的长度，固定报头长度在2-5字节间变动 不同的控制报文有不同的可变报头 通用协议体长度 格式见通用协议体定义 格式由具体业务定义 接口字符串编码 7.2 涉及到字符串时，统一采用UTF-8编码。入侵探测和紧急报警 7.3 7.3.1 属性接口 属性接口见表3。表3 入侵探测和紧急报警属性接口 名称 主题 内容 防区状态获取请求/iot/$DEVID/$CHILD

8、ID/$LOCALINDEX-$RESOURCETYPE/model/attribute/get/ZoneMgr/ZoneStatus 无 防区状态获取响应/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/get_reply/ZoneMgr/ZoneStatus 包含在线状态、故障状态、报警状态、防区编号等字段。防区状态上报请求/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/report/ZoneMgr/ZoneStatus 包含在线状态、故

9、障状态、报警状态、防区编号等字段。防区状态上报响应/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/report_reply/ZoneMgr/ZoneStatus 包含状态、描述信息、错误码字段和业务参数。7.3.2 操作接口 操作接口见表4。表4 入侵探测和紧急报警操作接口 名称 主题 内容 控制指定子系统布防请求/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/service/operate/AlarmSubSystemMgr/CtrlSubSystemArm

10、 包含子系统布防类型。控制指定子系统布防响应/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/service/operate_reply/AlarmSubSystemMgr/CtrlSubSystemArm 包含状态、描述信息、错误码字段和业务参数。控制指定子系统撤防请求/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/service/operate/AlarmSubSystemMgr/CtrlSubSystemDisarm 无 控制指定子系统撤防响应/iot/$DEVID/$CHI

11、LDID/$LOCALINDEX-$RESOURCETYPE/model/service/operate_reply/AlarmSubSystemMgr/CtrlSubSystemDisarm 包含状态、描述信息、错误码字段和业务参数。7.3.3 事件接口 事件接口见表 5。DB34/T 54272026 4 表5 入侵探测和紧急报警事件接口 名称 主题 内容 防区报警事件/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/event/report/ZoneMgr/ZoneAlarmEvent 包括事件类型、防区号、报警时间等字段。视频监控

12、 7.4 7.4.1 属性接口 属性接口见表6。表6 视频监控属性接口 名称 主题 内容 视 频 通 道 状态请求/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/get/VideoChannel/VideoChannelStatus 无 视 频 通 道 状态响应/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/get_reply/VideoChannel/VideoChannelStatus 包含在线状态、通道检测状态和密码状态。7.4.2

13、操作接口 操作接口应符合 GB/T 28181 规定。7.4.3 事件接口 事件接口见表 7。表7 视频监控事件接口 名称 主题 内容 人 员 聚 集事件/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/event/report/Group/GroupEvent 包括报警背景大图、人员区域坐标、报警时间、人员数量等字段。人 员 奔 跑分析事件/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/event/report/PersonnelRunning/PersonnelRunningE

14、vent 包含背景大图、事件推送内容、视频时间戳等字段。人 员 倒 地分析事件/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/event/report/PersonnelFallDown/PersonnelFallDownEvent 包含报警背景大图、识别区域坐标、报警时间等字段。人 员 滞 留分析事件/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/event/report/PersonnelRetention/PersonnelRetentionEvent 包含报警背景大图、识

15、别区域坐标、报警时间等字段。人 员 岗 位值 守 情 况事件/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/event/report/LeavePosition/LeavePositionEvent 包含岗位值守情况（离开）、岗位值守情况（睡觉）、检测区域、在离岗检测模式等字段。人 员 剧 烈运动事件/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/event/report/PersonnelViolentMotion/PersonnelViolentMotionEvent 包含报

16、警目标框、目标链表等字段。人 员 攀 高事件/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/event/report/PersonnelReachHeight/PersonnelReachHeightEvent 包含报警背景大图、识别区域坐标、报警时间等字段。徘 徊 侦 测事件/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/event/report/Loitering/LoiteringEvent 包含报警背景大图、识别区域坐标、报警时间等字段。人 员 尾 随运 动 分 析事件/

17、iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/event/report/PersonnelTailingAnalysis/PersonnelTailingAnalysisEvent 包含报警背景大图、时间戳等字段。人 员 抓 拍事件/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/event/report/FaceSnap/FaceSnapEvent 包含抓拍背景大图、人脸抠图、人脸区域坐标、抓拍人脸数量、事件时间等字段。人 员 对 比事件/iot/$DEVID/$CHILDID/

18、LOCALINDEX-$RESOURCETYPE/model/event/report/FaceContrast/FaceContrastEvent 包含抓拍背景大图、人脸抠图、人脸底库图片、人脸区域坐标、人员姓名、人员编号、事件时间等字段。DB34/T 54272026 5 出入口控制 7.5 7.5.1 属性接口 属性接口见表8。表8 出入口控制属性接口 名称 主题 内容 门禁点状态获取请求/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/get/Door/DoorStatus 无 门禁点状态获取响应/iot/$

19、DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/get_reply/Door/DoorStatus 包含门禁点编号、门开关状态字段。7.5.2 操作接口 操作接口见表9。表9 出入口控制操作接口 名称 主题 内容 远程控门请求/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/service/operate/RemoteControlDoor/RemoteControlDoor 包含门禁点编号、控制类型字段，控制类型包括开和关等字段。远程控门响应/iot/$DEVID/$CH

20、ILDID/$LOCALINDEX-$RESOURCETYPE/model/service/operate_reply/RemoteControlDoor/RemoteControlDoor 包含状态、描述信息、错误码字段和业务参数。7.5.3 事件接口 事件接口见表 10。表10 出入口控制事件接口 名称 主题 内容 开 门 超 时 事件/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/event/report/Door/TimeoutOpenEvent 包含人员编号、人员姓名、认证模式、门禁点编号、事件时间字段，其中认证模式包括密码、

21、指纹、卡片。人 脸 认 证 通过事件/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/event/report/UserAndRight/FaceVerifyPassEvent 包含认证的人员编号、人员姓名、人脸抓拍图、事件时间字段。刷 卡 开 门 事件/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/event/report/UserAndRight/CardVerifyPassEvent 包含刷卡的人员姓名、人员编号、卡号以及卡片类型、事件时间字段，其中卡片类型包括普通卡、来宾卡

22、胁迫卡等字段。人 脸 认 证 失败事件/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/event/report/UserAndRight/FaceVerifyFailEvent 包含人员ID、人员姓名、人脸抓拍可见光图片、人脸抓拍热成像图片等字段。卡 号 过 期 事件/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/event/report/UserAndRight/CardNumberExpiredEvent 包含门编号、人员ID、人员姓名、卡号、卡类型等字段。防爆安全检查 7

23、6 7.6.1 属性接口 属性接口见表11。DB34/T 54272026 6 表11 防爆安全检查属性接口 名称 主题 内容 安检门运行参数配置获取请求/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/get/SecurityMetalDetection/SecurityDoorCfg 无 安检门运行参数配置获取响应/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/get_reply/SecurityMetalDetection/Secur

24、ityDoorCfg 包含安检设备应用场景、通行方向是否保持默认、清零时间、红外前数据时间、红外后数据时间等字段。人员生命体征状态请求/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/get/PeopleVitalSignsDetection/PeopleVitalSignsStatus 无人员生命体征状态响应/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/get_reply/PeopleVitalSignsDetection/PeopleV

25、italSignsStatus 包含人员存在状态、心率、呼吸频率、心跳瞬时幅度、呼吸瞬时幅度等字段。自动人车核验等待时间配置获取请求/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/get/PersonVehicleAuthentication/AutoPersonVehicleAuthWaitTime 无自动人车核验等待时间配置获取响应/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/get_reply/PersonVehicleAuthen

26、tication/AutoPersonVehicleAuthWaitTime 包含等待时间。自动人车核验等待时间配置设置请求/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/set/PersonVehicleAuthentication/AutoPersonVehicleAuthWaitTime 包含等待时间。自动人车核验等待时间配置设置响应/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/set_reply/PersonVehicleAuth

27、entication/AutoPersonVehicleAuthWaitTime 包含状态、描述信息、错误码字段和业务参数。7.6.2 操作接口 操作接口见表12。表12 防爆安全检查操作接口 名称 主题 内容 获取安检门提示音列表请求/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/service/operate/SecurityMetalDetection/GetSSAAudioList 无获取安检门提示音列表响应/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/service/

28、operate_reply/SecurityMetalDetection/GetSSAAudioList 包含提示语类型、自定义提示音ID、预置提示音ID。试听指定安检门检测提示音请求/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/service/operate/SecurityMetalDetection/PlaySSAAudio 包含提示语类型、自定义提示音ID、预置提示音ID。试听指定安检门检测提示音响应/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/service/ope

29、rate_reply/SecurityMetalDetection/PlaySSAAudio 包含状态、描述信息、错误码字段和业务参数。查询生命体征数据请求/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/service/operate/PeopleVitalSignsDetection/SearchPeopleVitalSignsData 包含搜索记录唯一标识、查询结果在结果列表中的起始位置、本次协议调用可获取的最大记录数、生命体征状态等字段。查询生命体征数据响应/iot/$DEVID/$CHILDID/$LOCALINDEX-$RES

30、OURCETYPE/model/service/operate_reply/PeopleVitalSignsDetection/SearchPeopleVitalSignsData 包含本次返回的记录条数、符合条件的记录总条数、人员存在状态、生命体征状态、异常类型等字段。7.6.3 事件接口 DB34/T 54272026 7 事件接口见表13。表13 防爆安全检查事件接口 名称 主题 内容 安检门检测事件/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/event/report/SecurityMetalDetection/MetalD

31、etectionEvent 包含探测结果信息、报警区位ID、报警区位位置等字段。生命探测事件/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/event/report/LifeDetects/LifeDetectEvent 包含探测结果、探测点位编号、探测时间字段，探测结果包括绿灯检测正常、黄灯请重新检测、红灯请重新搜查等字段。车底扫描事件/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/event/report/VehBottom/VehBottomScanEvent 包含车底照片

32、车牌照片、识别车牌号、事件时间等字段。公共广播 7.7 7.7.1 属性接口 属性接口见表14。表14 公共广播属性接口 名称 主题 内容 广播音频输出配置请求/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/get/BroadcastMgr/BroadcastAudioCfgList 包含音频输出口编号、广播点状态。广播音频输出配置响应/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/get_reply/BroadcastMgr/Broad

33、castAudioCfgList 包含状态、描述信息、错误码字段和业务参数。7.7.2 操作接口 操作接口见表 15。表15 公共广播操作接口 名称 主题 内容 实时插播请求/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/service/operate/BroadcastMgr/RealTimeInsertion 包含播放模式、音频文件、输出音频口编号、输入音频口编号字段。实时插播响应/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/service/operate_reply/Br

34、oadcastMgr/RealTimeInsertion 包含状态、描述信息、错误码字段和业务参数。7.7.3 事件接口 事件接口见表 16。表16 公共广播事件接口 名称 主题 内容 广播计划下发进度变更上报事件/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/event/report/BroadcastMgr/PlanSchemeProgressEvent 包含任务ID、进度信息、状态信息列表等字段。被广播事件/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/event/repo

35、rt/BroadcastMgr/BroadcastedEvent 包含事件内容、事件流水号。DB34/T 54272026 8 通讯对讲 7.8 7.8.1 属性接口 属性接口见表17。表17 通讯对讲属性接口 名称 主题 内容 语音对讲状态信息请求/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/get/VoiceTalk/VoiceTalkStatusInfo 无 语音对讲状态信息响应/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/get

36、reply/VoiceTalk/VoiceTalkStatusInfo 包含设备支持的最大连接数、当前连接数、语音对讲通道号、连接状态等字段。7.8.2 操作接口 操作接口见表 18。表18 通讯对讲操作接口 名称 主题 内容 发起对讲请求/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/service/operate/IPTalk/StartTalk 包含发起方对讲点编号、接收方对讲点编号字段。发起对讲响应/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/service/oper

37、ate_reply/IPTalk/StartTalk 包含状态、描述信息、错误码字段和业务参数。结束对讲请求/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/service/operate/IPTalk/StopTalk 包含发起方对讲点编号、接收方对讲点编号字段。结束对讲响应/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/service/operate_reply/IPTalk/StopTalk 包含状态、描述信息、错误码字段和业务参数。7.8.3 事件接口 事件接口见表 19。

38、表19 通讯对讲事件接口 名称 主题 内容 对讲开始事件/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/event/report/IPTalk/StartTalkEvent 包含发起方对讲点编号、接收方对讲点编号、对讲发起时间字段。对讲结束事件/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/event/report/IPTalk/StopTalkEvent 包含发起方对讲点编号、接收方对讲点编号、对讲发起时间、对讲结束时间字段。对讲报警事件/iot/$DEVID/$CHILDID

39、/$LOCALINDEX-$RESOURCETYPE/model/event/report/IPTalk/talkAlarmEvent 包含事件内容、对讲报警信息、面板编号等字段。高压电网 7.9 7.9.1 属性接口 属性接口见表 20。DB34/T 54272026 9 表20 高压电网属性接口 名称 主题 内容 电网状态获取请求/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/get/GridMgr/SingleGridStatus 无 电网状态获取响应/iot/$DEVID/$CHILDID/$LOCALIND

40、EX-$RESOURCETYPE/model/attribute/get_reply/GridMgr/SingleGridStatus 包含在线状态、故障状态、报警状态、电网曲段号等字段。电网状态上报请求/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/report/GridMgr/SingleGridStatus 包含在线状态、故障状态、报警状态、电网曲段号等字段。电网状态上报响应/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/report

41、reply/GridMgr/SingleGridStatus 包含状态、描述信息、错误码字段和 业务参数。7.9.2 操作接口 操作接口见表 21。表21 高压电网操作接口 名称 主题 内容 消警请求/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/service/operate/SystemMaintenance/Erasure 包含命令类型、事件类型等字段。消警响应/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/service/operate_reply/SystemMain

42、tenance/Erasure 包含状态、描述信息、错误码字段和 业务参数。7.9.3 事件接口 事件接口见表 22。表22 数字电网事件接口 名称 主题 内容 电网报警事件/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/event/report/GridMgr/GridAlarmEvent 包含报警类型、电网区段号、报警时间等字段。DB34/T 54272026 10 附录A （规范性）接口协议结构定义 A.1 协议头 A.1.1 固定报头 固定报头见表A.1。表A.1 固定报头 bit 7 6 5 4 3 2 1 0 byte1 控

43、制报文类型 控制标志位 byte2.剩余长度（14 字节可变长度）支持的控制报文类型见表A.2。表A.2 支持的控制报文类型 名字 描述 业务应用场景 CONNECT/CONNACKE 连接/连接确认 设备连接 PINGREQ/PINGRESP 注册响应 设备心跳 DISCONNECT 发布消息 设备主动下线 PUBLISH/PUBACK/PUBREC/PUBREL/PUBCOMP 发布消息及消息确认，服务质量QoS0或QoS1 用于传输业务协议 SUBSCRIBE/SUBACK 订阅消息/响应 用于订阅业务协议，指定接收某个或多个业务数据 控制标志位参照 MQTT 的规定。剩余长度是 14

44、字节的可变长度，可变长度编码参照 MQTT 的规定。A.1.2 可变报头 可变报头（Variable header）记录不同请求的特异性信息，它在固定报头和有效载荷之间。不同的请求有不同的可变报头，具体见MQTT的规定。A.2 有效载荷 A.2.1 通用协议体 通用协议体由 2 个字节的通用协议体内容长度值（不包含此 2 字节自身）和通用协议体内容组成，通用协议体内容采用 JSON 格式，通用协议体和业务协议体共同作为有效载荷。通用协议体定义见表 A.3。DB34/T 54272026 11 表A.3 通用协议体定义 名称 类型 有效值 描述 Seq integer 业务消息序号。Contin

45、ued integer 0,1 0-此Seq的内容已经完整，无后续包，默认值。1-此Seq的内容不完整，仍有后续。MsgType integer 1,2 1-请求消息，2-响应消息。IsCompressed integer 0,1 此字段为选填，不填写表示消息未压缩。字段含义：0：表示消息是未压缩（默认）;1：表示消息已压缩。Compress string gzip,zlib 压缩方式，gzip、zlib是压缩格式。注：优先读取IsCompressed字段，当IsCompressed不存在时，才使用Compress字段。A.2.2 业务协议体 业务协议体由业务协议体内容组成，业务协议体内容长度

46、有效载荷长度-通用协议体长度。其中通用协议体长度=2+通用协议体内容长度值。通用协议体和业务协议体共同组成有效载荷。完整有效载荷见表 A.4。表A.4 完整有效载荷 通用协议体长度（2 字节，二进制格式）0 x00 0 x09 通用协议体内容（JSON 格式）Seq:1 业务协议体内容（JSON 格式）data:报文内容，根据 TOPIC 决定 业务协议体根据接口特点，可分为属性、操作、事件三类，对应的主题 TOPIC 和业务协议体内容JSON 格式见如下：a)属性 1)属性获取协议见表 A.5。表A.5 属性获取协议 方向 平台-设备 请求TOPIC/iot/$DEVID/$CHILDID

47、/$LOCALINDEX-$RESOURCETYPE/model/attribute/get/$DOMAIN/$IDENTIFIER 请求协议格式 响应TOPIC/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/get_reply/$DOMAIN/$IDENTIFIER 响应协议格式 见表A.6。2)属性获取响应协议格式见表 A.6。表A.6 属性获取响应协议格式 序号 名称 标识符 类型 长度 必选（R）/可选（O）备注 1 状态 status integer R 2 错误码 code string 32 R 3 错

48、误信息 errorMsg string 512 R 4 业务参数内容 data object R 见表 A.7。DB34/T 54272026 12 业务参数内容见表 A.7。表A.7 业务参数内容 序号 名称 标识符 类型 长度 必选（R）/可选（O）备注 1 业务参数内容 Value array/object/基本数据类型 R Value的类型取决于具体协议的定义。3)属性上报协议见表 A.8。表A.8 属性上报协议 方向 设备-平台 请求TOPIC/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/report/$

49、DOMAIN/$IDENTIFIER 请求协议格式 见表A.9.响应TOPIC/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/model/attribute/report_reply/$DOMAIN/$IDENTIFIER 响应协议格式 见表A.11。4)属性上报请求协议格式见表 A.9。表A.9 属性上报请求协议格式 序号 名称 标识符 类型 长度 必选（R）/可选（O）备注 1 业务参数内容 data object R 见表 A.10。业务参数内容见表 A.10。表A.10 业务参数内容 序号 名称 标识符 类型 长度 必选（R）/可选（O）备

50、注 1 业务参数内容 Value array/object/基本数据类型 R Value的类型取决于具体协议的定义。5)属性上报响应协议格式见表 A.11。表A.11 属性上报响应协议格式 序号 名称 标识符 类型 长度 必选（R）/可选（O）备注 1 状态 status integer R 2 错误码 code string 32 R 3 错误信息 errorMsg string 512 R b)操作 1)下行操作协议见表 A.12。表A.12 下行操作协议 方向 平台-设备 请求TOPIC/iot/$DEVID/$CHILDID/$LOCALINDEX-$RESOURCETYPE/mode