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

监狱安防系统接口规范2026-02-05实施2026-02-05实施I 1范围 12规范性引用文件 13术语和定义 14总体要求 15架构图 16分类 26.1监狱安防系统分类 26.2接口分类 27要求 27.1接口协议结构 27.2接口字符串编码 37.3入侵探测和紧急报警 37.4视频监控 47.5出入口控制 57.6防爆安全检查 57.7公共广播 77.8通讯对讲 87.9高压电网 8附录A(规范性)接口协议结构定义 A.1协议头 A.2有效载荷 附录B(规范性)主题名关键字定义 附录C(规范性)状态码和错误码定义 C.1状态码定义 C.2错误码定义 本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由安徽省监狱管理局提出并归口。本文件起草单位：安徽省监狱管理局、安徽省蜀山监狱、安徽省未成年犯管教所、杭州海康威视数字技术股份有限公司、四创电子股份有限公司。本文件主要起草人：昂扬、张常江、徐文强、徐炜炜、潘伟、王敦林、何超、蔡文骁。1本文件确立了监狱安防系统接口的总体要求，并规定了监狱安防系统接入架构图、监狱安防系统接口分类和要求。本文件适用于监狱安防系统的数据接口。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。GB/T28181公共安全视频监控联网系统信息传输、交换、控制技术要求GB50348安全防范工程技术标准GB55029安全防范工程通用规范3术语和定义下列术语和定义适用于本文件。监狱安防物联中台prisonsecurityiotplatform对监狱安防子系统统一接入管理，具有数据采集、处理和存储等功能的管理平台。4总体要求4.1监狱安防各子系统应符合GB50348和GB55029的要求。4.2视频监控子系统通讯协议应符合GB/T28181规定。4.3通讯协议应符合MQTT(遥测传输协议),数据格式为JSON格式，应符合附录A规定；主题名关键字定义应符合附录B规定；状态码和错误码应符合附录C规定。4.4数据在传输过程中宜使用TLS协议。5架构图监狱安防各子系统和设备接入监狱安防物联中台架构见图1。高压电网通讯对讲公共广播防爆安全检查出入口控制入侵探测和紧急报警视频监控图1监狱安防子系统接入架构6.1监狱安防系统分类监狱安防系统包括入侵探测和紧急报警、视频监控、出入口控制、防爆安全检查、公共广播、通讯对讲和高压电网等子系统。6.2接口分类接口分为属性接口、操作接口和事件接口三类，见表1。表1接口分类功能类型12347.1接口协议结构接口协议结构分为协议头和有效载荷，见表2。3表2接口协议结构结构协议头(Header)有效载荷(Payload)固定报头固定报头内容内容不定不定不定说明度，固定报头长度在2-5字节间同的可变报头定义定义7.2接口字符串编码涉及到字符串时，统一采用UTF-8编码。7.3入侵探测和紧急报警7.3.1属性接口属性接口见表3。表3入侵探测和紧急报警属性接口内容防区状态获取请求/iot/${DEVID}/${CHILDID}/${LOCALINDEX}-${RESOURmodel/attribute/get/ZoneMgr/ZoneSt无防区状态获取响应/iot/${DEVID}/${CHILDID}/${LOCALINDEX}-${RESOURmodel/attribute/get_reply/ZoneMgr/ZoneSt状态、防区编号等字段。防区状态上报请求/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURmodel/attribute/report/ZoneMgr/ZoneSt状态、防区编号等字段。防区状态上报响应/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURmodel/attribute/report_reply/ZoneMgr/ZoneSt段和业务参数。7.3.2操作接口操作接口见表4。表4入侵探测和紧急报警操作接口内容/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCEdel/service/operate/AlarmSubSystemMgr/Ctr1/iot/${DEVID}/${CHILDID}/${LOCALINDEX}-${RESOURCEdel/service/operate_reply/AlarmSubSystemMgr/CtrlSubSystem段和业务参数。/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCEdel/service/operate/AlarmSubSystemMgr/CtrlSub无/iot/${DEVID}/${CHILDID}/${LOCALINDEX}-${RESOURCEdel/service/operate_reply/AlarmSubSystemMgr/Ctr1SubSystem段和业务参数。7.3.3事件接口事件接口见表5。4表5入侵探测和紧急报警事件接口内容防区报警警时间等字段。7.4视频监控7.4.1属性接口属性接口见表6。表6视频监控属性接口内容/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCETYPE}ttribute/get/VideoChannel/Video无/iot/${DEVID}/${CHILDID}/${LOCALINDEX}-${RESOURCETYPE}ttribute/get_reply/VideoChannel/Video7.4.2操作接口操作接口应符合GB/T28181规定。7.4.3事件接口事件接口见表7。表7视频监控事件接口内容vent/report/PersonnelRunning/Personvent/report/PersonnelFal1Down/Personn人员滞留vent/report/PersonnelRetention/Personne值守情况vent/report/LeavePosition/Leav在离岗检测模式等字段。人员剧烈vent/report/PersonnelReachHeight/Personnelvent/report/Loitering/L运动分析人员抓拍vent/report/FaceSnap/事件时间等字段。人员对比vent/report/FaceContrast/Face等字段。57.5出入口控制7.5.1属性接口属性接口见表8。表8出入口控制属性接口内容门禁点状态获/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCETYPE}/model/attr无门禁点状态获/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCETYPE}/model/attr包含门禁点编号、门开关状7.5.2操作接口操作接口见表9。表9出入口控制操作接口内容/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCETYPE}/model/service/operate/RemoteControlDoor/Remot包含门禁点编号、控制括开和关等字段。/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCETYPE}/model/service/operate_reply/RemoteControlDoor/Remot包含状态、描述信息、数。7.5.3事件接口事件接口见表10。表10出入口控制事件接口内容件/iot/${DEVID}/${CHILDID}/${LOCALINDEX}-${RESOURCETYP/event/report/Door/TimeoutO纹、卡片。/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCETYPE}/model/event/report/UserAndRight/FaceVerifyP件/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCETYPE}/model/event/report/UserAndRight/CardVerifyP包含刷卡的人员姓名、人员编号、卡号以及卡片类型、事件时间字段，其中卡片类型包括普通卡、来宾卡、胁迫卡等字段。/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCETYPE}/model/event/report/UserAndRight/FaceVerifyF图片等字段。件/iot/${DEVID}/${CHILDID}/${LOCALINDEX}-${RESOURCETYP/event/report/UserAndRight/CardNumberExpi7.6防爆安全检查7.6.1属性接口属性接口见表11。6表11防爆安全检查属性接口内容/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCETY1/attribute/get/SecurityMetalDet无/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCETY1/attribute/get_reply/SecurityMetalDeg间、红外前数据时间、红外后数据时间等字段。/iot/${DEVID}/${CHILDID}/${L0CALINDEX}一${RESOURCETY1/attribute/get/PeopleVitalSignsDetec无/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCETY1/attribute/get_reply/PeopleVitalSign吸频率、心跳瞬时幅度、呼吸瞬时幅度等字段。自动人车核验等待时间配置获取/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCETY1/attribute/get/PersonVehicleAuthenti无自动人车核验等待时间配置获取响应/iot/${DEVID}/${CHILDID}/${LOCALINDEX}-${RESOURCETY1/attribute/get_reply/PersonVehicleAuthenticati包含等待时间。自动人车核验等待时间配置设置/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCETY1/attribute/set/PersonVehicleAuthenti包含等待时间。自动人车核验等待时间配置设置响应/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCETY1/attribute/set_reply/PersonVehicleAuthenticati字段和业务参数。7.6.2操作接口操作接口见表12。表12防爆安全检查操作接口内容/iot/${DEVID}/${CHILDID}/${LOCALINDEX}-${RESOURCETYP/service/operate/SecurityMetalDetection/GetSSAA无/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCETYPE}/model/service/operate_reply/SecurityMetalDetection/GetSSAAudioList/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCETYPE}/model/service/operate/SecurityMetalDetection/Play/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCETYPE}/model/service/operate_reply/SecurityMetalDetection/Play误码字段和业务参数。/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCETYPE}/model/service/operate/PeopleVitalSignsDetection/SearchPeopleVital包含搜索记录唯一标识、查询结果在结果列表中的起始位置、本次协议调用响应/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCETYPE}/model/service/operate_reply/PeopleVitalSignsDetection/SearchPeopl数、符合条件的记录总条数、人员存在状态、生命体征状态、异常类型等字段。7事件接口见表13。表13防爆安全检查事件接口内容/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCEdel/event/report/SecurityMetalDetection/MetalDetectionEveID、报警区位位置等字段。/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCEdel/event/report/LifeDetects/Lif包含探测结果、探测点位编号、灯检测正常、黄灯请重新检测、红灯请重新搜查等字段。/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCEdel/event/report/VehBottom/VehBot包含车底照片、车牌照片、识别7.7公共广播7.7.1属性接口属性接口见表14。内容/iot/${DEVID}/${CHILDID}/${LOCALINDEX}-${RESOURCETYPE}/tribute/get/BroadcastMgr/Broadcas包含音频输出口编响应/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCETYPE}/tribute/get_reply/BroadcastMgr/Broadcas息、错误码字段和业务参数。7.7.2操作接口操作接口见表15。表15公共广播操作接口内容实时插播请求meInsertion频口编号、输入音频口编号字段。实时插播响应7.7.3事件接口事件接口见表16。表16公共广播事件接口内容/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCETYPE}/model/event/report/BroadcastMgr/PlanSchemeProgr包含任务ID、进度信息、/iot/${DEVID}/${CHILDID}/${LOCALINDEX}-${RESOURCETYP/event/report/BroadcastMgr/Broadcas水号。87.8通讯对讲7.8.1属性接口属性接口见表17。表17通讯对讲属性接口内容atusInfo无TalkStatusInfo态等字段。7.8.2操作接口操作接口见表18。表18通讯对讲操作接口内容/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一$ETYPE}/model/service/operate/IPTalk/Sta/iot/${DEVID}/${CHILDID}/${LOCALINDEX}-$ETYPE}/model/service/operate_reply/IPTalk/StartT/iot/${DEVID}/${CHILDID}/${LOCALINDEX}-$ETYPE}/model/service/operate/IPTalk/St/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一$ETYPE}/model/service/operate_reply/IPTalk/StopTa7.8.3事件接口事件接口见表19。表19通讯对讲事件接口内容/iot/${DEVID}/${CHILDID}/${LOCALINDEX}-$ETYPE}/model/event/report/IPTalk/StartTal/iot/${DEVID}/${CHILDID}/${LOCALINDEX}-$ETYPE}/model/event/report/IPTalk/StopTal讲点编号、对讲发起时间、对讲结/iot/${DEVID}/${CHILDID}/${LOCALINDEX}-$ETYPE}/model/event/report/IPTalk/talkAlar7.9高压电网7.9.1属性接口属性接口见表20。9表20高压电网属性接口内容电网状态获取请求/iot/${DEVID}/${CHILDID}/${LOCALINDEX}-$ETYPE}/model/attribute/get/GridMgr/SingleG无电网状态获取响应/iot/${DEVID}/${CHILDID}/${LOCALINDEX}-$ETYPE}/model/attribute/get_reply/GridMgr/SridStatus态、电网曲段号等字段。电网状态上报请求/iot/${DEVID}/${CHILDID}/${LOCALINDEX}-$ETYPE}/model/attribute/report/GridMgr/SingleGrid态、电网曲段号等字段。电网状态上报响应/iot/${DEVID}/${CHILDID}/${LOCALINDEX}-$ETYPE}/model/attribute/report_reply/GridMg和业务参数。7.9.2操作接口操作接口见表21。表21高压电网操作接口内容/iot/${DEVID}/${CHILDID}/${LOCALINDEX}-$ETYPE}/model/service/operate/SystemMaintenrasure/iot/${DEVID}/${CHILDID}/${LOCALINDEX}-$ETYPE}/model/service/operate_reply/SystemMainten和业务参数。7.9.3事件接口事件接口见表22。表22数字电网事件接口内容电网报警事件(规范性)接口协议结构定义A.1协议头A.1.1固定报头固定报头见表A.1。表A.1固定报头76543210byte2...剩余长度(1～4字节可变长度)支持的控制报文类型见表A.2。表A.2支持的控制报文类型发布消息设备主动下线PUBLISH/PUBACK/PUBREC/PUBREL/PQoSO或QoS1多个业务数据剩余长度是1～4字节的可变长度，可变长度编码参照MQTT的规定。A.1.2可变报头可变报头(Variableheader)记录不同请求的特异性信息，它在固定报头和有效载荷之间。不同的请求有不同的可变报头，具体见MQTT的规定。A.2有效载荷A.2.1通用协议体通用协议体由2个字节的通用协议体内容长度值(不包含此2字节自身)和通用协议体内容组成，通用协议体内容采用JSON格式，通用协议体和业务协议体共同作为有效载荷。通用协议体定义见表A.3。表A.3通用协议体定义业务消息序号。0-此Seq的内容已经完整，无后续包，默认值。1-请求消息，2-响应消息。此字段为选填，不填写表示消息未压缩。字段含义：0:表示消息是未压缩(默认);1:表示消息已压缩。压缩方式，gzip、zlib是压缩格式。注：优先读取IsCompressed字段，当IsCompressed不存在时，才使用A.2.2业务协议体业务协议体由业务协议体内容组成，业务协议体内容长度=有效载荷长度-通用协议体长度。其中通用协议体长度=2+通用协议体内容长度值。通用协议体和业务协议体共同组成有效载荷。完整有效载荷见表A.4。表A.4完整有效载荷通用协议体长度(2字节，二进制格式)通用协议体内容(JSON格式)业务协议体内容(JSON格式){"data":{报文内容，根据TOPIC决定}业务协议体根据接口特点，可分为属性、操作、事件三类，对应的主题TOPIC和业务协议体内容1)属性获取协议见表A.5。表A.5属性获取协议方向平台一>设备{_reply/${DOMAIN/${IDENT响应协议格式见表A.6。2)属性获取响应协议格式见表A.6。表A.6属性获取响应协议格式必选(R)/可选(O)1R2R3错误信息R4R见表A.7。业务参数内容见表A.7。表A.7业务参数内容必选(R)/可选(0)1R3)属性上报协议见表A.8。表A.8属性上报协议方向设备->平台见表A.9.ort_reply/${D0MAIN}/$响应协议格式见表A.11。4)属性上报请求协议格式见表A.9。表A.9属性上报请求协议格式名称类型长度可选(0)备注1R见表A.10。业务参数内容见表A.10。表A.10业务参数内容必选(R)/可选(0)1RValue的类型取决于具体协议的定5)属性上报响应协议格式见表A.11。表A.11属性上报响应协议格式必选(R)/可选(0)1R2R3错误信息Rb)操作1)下行操作协议见表A.12。表A.12下行操作协议方向/iot/${DEVID}/${CHILDID}/${LOCALINDEX}一${RESOURCETYPE}/model/servi见表A.13。响应TOPIC/iot/${DEVID}/${CHILDID}/${LOCALINDEX}-${RESOURCETYPE}/model/servite_rep