团 体 标 准 T/ZGCSC012-2024 数字道路路灯控制器数据接口规范 Specification of data interfaceforDigitalRoadStreetlight Controller 2024-08-20发布 2024-08-21实施 中关村智慧城市产业技术创新战略联盟 发布
T/ZGCSC 012-2024 目次 前言. 1范围.. 2规范性引用文件 3术语和定义 4缩略语 5系统架构.
6接口通用要求 7数据上报类接口 8控制下发类接口 9实时查询类接口 10参数配置类接口 附录A（规范性） 数字道路路灯控制器数据接口消息体结构JSON数据属性说明表. 10
T/ZGCSC012-2024 前言 本文件按照GB/T1.1-2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定 起草.
本文件的某些内容可能涉及专利.
本标准的发布机构不承担识别专利的责任.
本文件由中关村智慧城市产业技术创新战略联盟发布.
本文件起草单位：中电信数字城市科技有限公司、深圳市云之声科技有限公司、北京鉴衡认证中心 有限公司、浙大城市学院、欧普道路照明有限公司、重庆中科汽车软件创新中心、中科智城（广州）信 息科技有限公司、上海无线电设备研究所.
本文件主要起草人：张银河、王海瑞、孙培华、封顺天、谷博宇、张南松、黄成华、朱佑华、王井 伟、刘红文、饶兵、吴伟、林雪峰、李彦峰、武会添、袁峰、王建.
本文件为首次发布.
ⅡI
T/ZGCSC 012-2024 数字道路路灯控制器数据接口规范 1范围 本文件规定了数字道路中路灯控制器设备与上层系统之间数据上报接口、控制下发接口及查询配 置接口的通信要求、信息格式和信息内容.
本文件适用于面向数字道路应用的采用MQTT协议的路灯灯控器与统一采控平台间接口的设计、开 发和应用.
2规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款.
其中，注日期的引用文件， 仅该日期对应的版本适用于本文件：不注日期的引用文件，其最新版本（包括的修改单）适用于本 文件.
GB/T34923-2017路灯控制管理系统 3术语和定义 下列术语和定义适用于本文件.
3. 1 路灯控制器采控系统streetlightcontrolandacquisitionsystem 路灯控制器采控系统通过智能化的路灯终端设备与云端管理平台的配合，实现对城市路灯的远程 监控、智能调度及数据采集.
3. 2 双灯控制器duallightcontroller 双路输出型路灯控制器的简称，是道路照明中，用于控制灯具开关、亮度调节、照明策略调整等功 能的终端设备.
3. 3 调光策略dimmingstrategy 灯控器的照明方案，可以预置到双灯控制器内部，双灯控制器根据预置的照明方案进行路灯的开关、 调光控制.
4缩略语 下列缩略语适用于本文件.
HTTP:超文本传输协议(Hyper Text Transfer Protocol) JSON:JS 对象简谱（JavaScript Object Notation) MQTT：消息队列遥测传输（Message Queuing Telemetry Transport) QoS：服务质量(Qualityof Service) 5系统架构
T/ZGCSC012--2024 路 数据上报 灯 采 控 控制下发 控 制 平 查询/配置 台 器 图1系统架构设计 路灯控制器采控系统由路灯控制器和采控平台组成.
路灯控制器实时监测并控制着路灯的状态，同 时将采集到的相关数据通过网络传输至采控平台.
采控平台进行集中管理和调度，接收并处理来自各个 控制器的数据上报，并发出控制指令以实现对路灯的远程调控.
采控平台也具备对灯控器查询和配置功 能，使得管理人员能获取所需的历史记录或者对系统进行配置.
采控平台在接收到控制器的数据后，可 以运用大数据分析与AI算法，优化路灯运维策略，如根据实际车流和天气变化自动调节照明方案.
同时， 平台也可与城市交通管理系统、应急响应系统等其他数字道路系统进行交互以实现数字道路应用.
6接口通用要求 6.1接口范围 6.1.1设备范围 本规范所规定的路灯设备主要包括单灯控制器、双灯控制器.
6.1.2接口功能和数据范围 1）通过数据主动上报接口获取控制器基本信息、心跳信息、告警信息、设备运行状态信息（状 态变化信息）.
2）通过实时查询类接口可以查询设备基本信息、设备运行状态、告警信息、调光策略配置、 设备巡检信息、数据上报周期、告警配置参数等数据.
3）通过操作控制类接口实现开关灯、控制亮度、重启、恢复默认等.
4）通过参数配置类接口可以实现调光策略配置、各类数据上报周期配置、告警参数配置等功 能.
6.2通信规程 6.2.1指令数据下发 采控系统下发带主题的指令数据到MQTT服务器，MQTT平台依据设备订阅的主题，将消息推送给相 应的设备，设备收到该主题的消息后，发送Puback，并解析处理，然后做出相应的响应回复，MQTT服务 器收到该响应后将其推送给采控系统.
MQTT服务器由采控系统提供，同侧部署.
见图2