团
体 标 准
T/ZGCSC 012—2024
数字道路路灯控制器数据接口规范
Specification of data interface for Digital Road Streetlight Controller
2024 - 08 - 20 发布
2024 - 08 - 21 实施
中关村智慧城市产业技术创新战略联盟 发 布
T/ZGCSC 012—2024
目
次
前言 ................................................................................. II
1 范围 ............................................................................... 1
2 规范性引用文件 ..................................................................... 1
3 术语和定义 ......................................................................... 1
4 缩略语 ............................................................................. 1
5 系统架构 ........................................................................... 1
6 接口通用要求 ....................................................................... 2
7 数据上报类接口 ..................................................................... 6
8 控制下发类接口 ..................................................................... 7
9 实时查询类接口 ..................................................................... 8
10 参数配置类接口 .................................................................... 8
附录 A（规范性） 数字道路路灯控制器数据接口消息体结构 JSON 数据属性说明表 ............. 10
I
T/ZGCSC 012—2024
前
言
本文件按照GB/T 1.1—2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定
起草。
本文件的某些内容可能涉及专利。本标准的发布机构不承担识别专利的责任。
本文件由中关村智慧城市产业技术创新战略联盟发布。
本文件起草单位：中电信数字城市科技有限公司、深圳市云之声科技有限公司、北京鉴衡认证中心
有限公司、浙大城市学院、欧普道路照明有限公司、重庆中科汽车软件创新中心、中科智城（广州）信
息科技有限公司、上海无线电设备研究所。
本文件主要起草人：张银河、王海瑞、孙培华、封顺天、谷博宇、张南松、黄成华、朱佑华、王井
伟、刘红文、饶兵、吴伟、林雪峰、李彦峰、武会添、袁峰、王建。
本文件为首次发布。
II
T/ZGCSC 012—2024
数字道路路灯控制器数据接口规范
1 范围
本文件规定了数字道路中路灯控制器设备与上层系统之间数据上报接口、控制下发接口及查询配
置接口的通信要求、信息格式和信息内容。
本文件适用于面向数字道路应用的采用MQTT协议的路灯灯控器与统一采控平台间接口的设计、开
发和应用。
2 规范性引用文件
下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，
仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本
文件。
GB/T 34923-2017 路灯控制管理系统
3 术语和定义
下列术语和定义适用于本文件。
路灯控制器采控系统 streetlight control and acquisition system
路灯控制器采控系统通过智能化的路灯终端设备与云端管理平台的配合，实现对城市路灯的远程
监控、智能调度及数据采集。
双灯控制器 dual light controller
双路输出型路灯控制器的简称，是道路照明中，用于控制灯具开关、亮度调节、照明策略调整等功
能的终端设备。
调光策略 dimming strategy
灯控器的照明方案，可以预置到双灯控制器内部，双灯控制器根据预置的照明方案进行路灯的开关、
调光控制。
4 缩略语
下列缩略语适用于本文件。
HTTP:超文本传输协议(Hyper Text Transfer Protocol)
JSON:JS 对象简谱(JavaScript Object Notation)
MQTT:消息队列遥测传输(Message Queuing Telemetry Transport)
QoS:服务质量(Quality of Service)
5 系统架构
1
T/ZGCSC 012—2024
图1 系统架构设计
路灯控制器采控系统由路灯控制器和采控平台组成。路灯控制器实时监测并控制着路灯的状态，同
时将采集到的相关数据通过网络传输至采控平台。采控平台进行集中管理和调度，接收并处理来自各个
控制器的数据上报，并发出控制指令以实现对路灯的远程调控。采控平台也具备对灯控器查询和配置功
能，使得管理人员能获取所需的历史记录或者对系统进行配置。采控平台在接收到控制器的数据后，可
以运用大数据分析与AI算法，优化路灯运维策略，如根据实际车流和天气变化自动调节照明方案。同时，
平台也可与城市交通管理系统、应急响应系统等其他数字道路系统进行交互以实现数字道路应用。
6 接口通用要求
接口范围
6.1.1 设备范围
本规范所规定的路灯设备主要包括单灯控制器、双灯控制器。
6.1.2 接口功能和数据范围
1) 通过数据主动上报接口获取控制器基本信息、心跳信息、告警信息、设备运行状态信息（状
态变化信息）。
2) 通过实时查询类接口可以查询设备基本信息、设备运行状态、告警信息、调光策略配置、
设备巡检信息、数据上报周期、告警配置参数等数据。
3) 通过操作控制类接口实现开关灯、控制亮度、重启、恢复默认等。
4) 通过参数配置类接口可以实现调光策略配置、各类数据上报周期配置、告警参数配置等功
能。
通信规程
6.2.1 指令数据下发
采控系统下发带主题的指令数据到MQTT服务器, MQTT平台依据设备订阅的主题，将消息推送给相
应的设备，设备收到该主题的消息后，发送Puback，并解析处理，然后做出相应的响应回复，MQTT服务
器收到该响应后将其推送给采控系统。MQTT服务器由采控系统提供，同侧部署。见图2
2
T/ZGCSC 012—2024
图2 指令数据下发
指令数据下发模式的接口主要包括对设备的控制类接口、实时查询类接口、参数配置类接口等。
6.2.2 设备主动上报
设备主动向MQTT服务器发送数据，MQTT服务器判断采控系统是否订阅该主题的数据，如果订阅，则
MQTT平台再将其推送到采控系统。MQTT服务器由采控系统提供，同侧部署。见图3
图3 数据上报
设备主动上报模式的接口包括数据上报类接口。
接口协议
路灯控制器的网络通信方式主要有4G LTE、NB-IOT、wifi或有线网络等，与采控系统接口数据通讯
协议使用MQTT3.1.1，应支持MQTT+TLS单向认证（开发/测试可只采用MQTT），数据格式使用JSON格式。
3
T/ZGCSC 012—2024
在路灯控制器与采控系统使用MQTT通讯协议时，使用发布/订阅消息模式，每个设备的设备序列号
使用控制器的IMEI，作为设备的唯一标识，订阅主题见表1：
表1
主题 发布/订阅 QoS 说明
数据上报消息主题 /Lamp/Report/XXX 设备->采控系统 1 设备向服务器上报消息 其中：XXX 表示设备 IMEI 码，下同
下发命令请求消息 /Lamp/CmdInput/XXX 采控系统->设备 1 服务器向设备发送命令，包括实时查询 和控制操作。
下发命令响应 /Lamp/CmdOutput/XXX 设备->采控系统 1 设备响应服务发送的命令请求，包括返 回查询结果和操作结果。
升级接口 /Lamp/UpgradeIn/XXX 采控系统->设备 1 升级指令下发
升级返回接口 /Lamp/UpgradeOut/XXX 设备->采控系统 1 升级的进度信息，以及升级完成的信 息。
/Lamp/Lwt/XXX MQTT->采控系统 1 遗言信息，设备掉线信息。
为保证消息的可靠性，MQTT的QoS应配置为1，在使用过程中如果性能消耗过大，也可以考虑将路灯
发给采控系统的消息的QoS配置为0。
基础数据结构
路灯控制器的基础数据结构见表2至表14，包括设备状态监测元素，如:
1) 电参数结构记录电流、电压等；
2) 能耗结构跟踪自上电和出厂以来的能耗；
3) 运行时间结构计量设备运行时长；
4) 亮灯时间结构统计历史和当前亮灯分钟数；
5) 网络基本信息涵盖 4G 模组标识、国际移动用户识别码和 USIM 卡标识；
6) 网络状态结构涉及运营商、信号强度等；
7) 定位信息结构提供经纬度坐标；
8) 光感信息结构测量光照强度；
9) 姿态信息结构捕捉设备倾斜角度；
10) 姿态变化信息结构捕捉设备倾斜角度的变化；
11) 网络状态详细信息反映信号质量；
12) 网络详细信息整合 4G 模块详情；
13) 姿态变化告警阈值结构设定异常角度变化预警。
这些结构数据共同组成了设备运行状态信息，为数据分析和故障诊断提供数据支撑。
表2 电参数结构 elecStruct
参数名称 数据类型 是否必填 取值范围 描述
current int M 0-10000 电流，单位 mA
voltage int M 0-300 电压，单位 V
factor int M 0-1000 功率因数
power int M 0-2500 功率，单位 W
表3 能耗结构 emInfoStruct
参数名称 数据类型 是否必填 取值范围 描述
ec int M 0-178956970 自系统上电后的能耗，单位 Wh
4
T/ZGCSC 012—2024
hec int M
0-178956970 自出厂后的能耗，单位 Wh
表4 设备运行时间结构 runLongStruct
参数名称 数据类型 是否必填 取值范围 描述
rTime int M 0-2147483647 设备本次上电运行时间，单位分钟
hTime int M 0-2147483647 设备总运行时间，单位分钟
表5 亮灯时间结构 briLongStruct
参数名称 数据类型 是否必填 取值范围 描述
hlTime int M [0,16777215] 历史亮灯时间，单位分钟
lTime int M [0,16777215] 当前亮灯时间，单位分钟
表6 网络基本信息结构 netBaseInfoStruct
属性 类型 操作权限 取值范围 属性描述
IMEI string M 4G 模组标识
IMSI string M 国际移动用户识别码
ICCID string M USIM 卡标识
表7 网络状态结构 netStatusStruct
参数名称 数据类型 是否必填 取值范围 描述
O string M CHN-CT 运营商
R int M [-144,~] RSRP
S int M [-20,~] SNR
C string M [“0”,”FFFFFFFF”] CELLID
表8 定位信息结构 posStruct
参数名称 数据类型 是否必填 描述
lat string O 负数代表南纬，正数代表北纬 lat 表示格式：±dd.mmmmmm
lng string O 负数代表西经，正数代表东经 lng 表示格式：±ddd.mmmmmm
GCSType string 0 WGS84 代表 1984 年世界大地测量系统，CGCS2000 代 表中国大地坐标系 2000
表9 光感信息结构 lSnsrStruct
参数名称 数据类型 是否必填 描述
lux int O 光感，单位 lux
lx int O 光感传感器电压值，单位 mV
表10 当前姿态信息结构 angleStruct
参数名称 数据类型 是否必填 描述
x int M x:x 轴与水平面夹角,[-90,90]
y int M y:y 轴与水平面夹角,[-90,90]
z int M z:z 轴与水平面夹角,[-90,90]
表11 姿态变化信息结构 dAngleStruct
参数名称 数据类型 是否必填 描述
x int M x:x 轴变化量,[-90,90]
y int M y:y 轴变化量,[-90,90]
5
T/ZGCSC 012—2024
z int M z:z 轴变化量,[-90,90]
表12 网络状态详细信息结构 networkStatusStruct
属性 类型 操作权限 取值范围 属性描述
rsrp int R -1400～440 接收信号强度，单位 10 分之一 dbm。换算到单位 为 dbm 需要除以 10
rsrq int R -200 ～ -30 参考信号接收质量，单位 10 分之一 db。换算到 单位为 db 需要除以 10
cellid string R 0～2147483647 小区标识
pcid string R 0～503 物理小区标识
snr int R -200～300 信噪比，单位 10 分之一 db。换算到单位为 db 需 要除以 10
earfcn string R 0～65535 信道
state string R NOCONN/CONN 连接状态
表13 网络详细信息结构 networkInfoStruct
属性 类型 操作 权限 数值举例 属性描述
imei string R 861681054755579 4G 模组标识
imsi string R 460044630411938 国际移动用户识别码
iccid string R 89860426102040618188 USIM 卡标识
oper string R CHINA MOBILE 运营商
state string R NOCONN 连接状态
mode string R LTE 模式
is_tdd string R TDD 是否 TDD
mcc int R 460 移动设备国家代码
mnc int R 0 移动设备网络代码
cellid string R D749100 小区标识
pcid int R 233 物理小区标识
earfcn int R 38950 信道
rsrp int R -87 接收信号强度
rsrq int R -3 参考信号接收质量
rssi int R -78 信号强度
sinr int R 27 信噪比
devState int R 5 设备状态
表14 姿态变化告警阈值结构 cfgAngleStruct
参数名称 数据类型 是否必填 描述
x int M x:x 轴变化量阈值,[-90,90]
y int M y:y 轴变化量阈值,[-90,90]
z int M z:z 轴变化量阈值,[-90,90]
7 数据上报类接口
设备上线初始信息上报
设备上电并成功登陆网络后将设备的基本信息、状态、网络状态及电参电量等数据主动上报给采控
系统，为设备连接网络成功后发送的第一个报文信息。
上报消息体结构JSON数据格式和定义应符合附录A.1表1的规定。
6
T/ZGCSC 012—2024
设备状态周期上报
设备根据预先设定的周期，主动上报每个通道灯的状态、电参数及控制器的网络状态等信息。其接
口参数应包括灯端信息（开关灯状态，电参数信息，能耗信息），运行时长，运营商网络状态等信息。
消息体结构JSON数据报文格式和定义应符合附录A.2表2的规定。
告警数据上报
设备依据预设的各种告警阈值实时判断告警状况，当告警发生或解除时主动上传告警信息到采控
系统。其上报规则见表15：
表15 告警数据上报规则
告警内容 默认发生值 默认恢复值 回差
10000-过压告警 > 274V < 264V 10V
10001-过流告警 > 1.6A < 1.5A 0.1A
10002-欠压告警 < 166V > 176V 10V
10004-开灯异常 告警 亮度非 100%：< 3.5V 亮度为 100% ： < 30W 亮度非 100%：> 4W 亮度为 100%：> 32W 亮度非 100%： 0.5W 亮度为 100%：2W
10005-关灯异常 告警 > 4W < 3.5W 0.5W
10006-倾斜告警 发生倾斜 不会恢复
10007-漏电告警 > 30mA < 20mA 10mA
其接口参数包括告警类型，告警时间，告警状态，告警发生时监控的值，告警其他扩展信息。
消息体JSON数据报文格式和定义应符合附录A.3表3的规定。
设备状态变化上报
当设备的状态（开关状态及亮度）发生变化时，主动上报采控系统，并将变化发生后的电参数及策
略情况发送给采控系统。上报此消息主要用于查找状态变化的原因，并实时更新采控系统上的设备状态。
接口参数应包括开关灯状态和亮度发生变化时，设备端上报状态变化的触发源，发生时间，以及当前开
关灯状态和电参数等信息。
消息体JSON数据报文格式和定义应符合附录A.4表4的规定。
遗言消息
设备在连接MQTT服务器时，带上遗言消息寄存在MQTT服务器，当MQTT服务器监测到设备断开了连接，
则将设备遗言消息发送给订阅方，接口参数主要包括请求消息Id，消息类型，设备sn码。
消息体JSON数据报文格式和定义应符合附录A.5表5的规定。
8 控制下发类接口
开关灯命令
采控系统发送开关灯消息给灯控设备，开关路灯。也可附加包括延时开关灯的时间点信息进行定时
间点的开关灯。在有调光策略执行时，调用此接口控制路灯开关状态时，只会影响调光策略中当前时间
段，其他时间段仍会按照调光策略继续行，不受影响。请求消息体JSON数据报文应包括动作类型及动作
时间等信息。
响应消息体JSON数据报文格式和定义应符合附录A.6表7的规定。
调光命令
7
T/ZGCSC 012—2024
平台给终端设备发送调光指令。一次可以调同一控制器的多个通道的亮度。控制器按照平台发送的
调光命令改变0~10V的模拟量输出。请注意：当用此命令进行控制，如果当前设备有调光策略在运行，
只会影响当前命中的时间段，其他时间段按照调光策略继续运行，不受影响。
请求消息体JSON报文格式和定义应符合附录A.7表8的规定。
响应消息体JSON报文格式和定义应符合附录A.7表9的规定。
设备重启命令
采控系统发送给设备，远程重启设备。设备收到指令后，返回成功。等重新启动后再上报设备上线
信息。当设备上电或者重启之后，需要按照之前设定的策略/开关灯/亮度状态工作。
请求消息体JSON报文格式和定义应符合附录A.8表10的规定。
响应消息体JSON报文格式和定义应符合附录A.8表11的规定。
软件升级命令
采控系统向设备发送软件升级消息请求，设备收到消息后，给予确认。并按收到的消息中的链接以
HTTP或HTTPS协议新的软件版本，并进行安装。安装重启后再给采控系统发设备上线初始信息上报
消息，由采控系统判断是不是最新版本。请注意：升级的固件URL应是公网可达的链接。
请求消息体JSON报文应包括原始固件版本号、新的固件版本号以及固件链接等信息，其格式和
定义应符合附录A.9表12的规定。
响应消息体JSON报文应包括返回的消息参数及说明等内容，在升级过程中，会多次主动上报该条升
级响应，其格式和定义应符合附录A.9表13的规定。
9 实时查询类接口
设备通用属性表信息查询
采控发送给终端设备，查询设备基本信息通用属性表内字段均支持查询，采控系统依据自身需求来
确定支持哪些设备查询指令。
请求消息体JSON报文格式和定义应符合附录A.10表14的规定。
响应消息体JSON报文格式和定义应符合附录A.10表15的规定。
设备实时信息查询
采控系统发送给设备，查询设备状态信息（巡检）。
请求消息体JSON报文格式和定义应符合附录A.11表16的规定。
响应消息体JSON报文格式和定义应符合附录A.11表17的规定。
告警配置信息查询
采控系统发送给设备，查询告警配置参数。一次可以查一个通道或所有通道配置的参数。
请求消息体JSON报文格式和定义应符合附录A.12表18的规定。
响应消息体JSON报文格式和定义应符合附录A.12表19的规定。
10 参数配置类接口
告警参数配置
采控系统发送给设备，配置各个告警类型的阈值。每次配置一类告警的阈值，也可以配置多类告警
的阈值。
请求消息体JSON报文格式和定义应符合附录A.13表20的规定。
响应消息体JSON报文格式和定义应符合附录A.13表21的规定。
设备状态上报周期配置
采控系统发送给设备，配置设备状态上报的周期。
8
T/ZGCSC 012—2024
请求消息体JSON报文格式和定义应符合附录A.14表22的规定。
响应消息体JSON报文格式和定义应符合附录A.14表23的规定。
分段调光策略配置（周计划）
采控系统发送给设备，配置设备周工作计划调光策略。在某个时间段中如果被开关灯、调光命令接
口干预，则会影响该时间段的策略，但不会影响其他时间段的策略，其它时间段仍然按照策略运行。在
周策略时间段之外，默认为亮灯状态。
请求消息体JSON报文格式和定义应符合附录A.15表24的规定。
响应消息体JSON报文格式和定义应符合附录A.15表25的规定。
分段调光策略配置（日期计划）
采控系统发送给设备，配置设备日期工作计划调光策略。在某个时间段中如果被开关灯、调光命令
接口干预，则会影响该时间段的策略，但不会影响其他时间段的策略，其它时间段仍然按照策略运行。
在日策略的时间段之外，默认为亮灯状态。
请求消息体JSON报文格式和定义应符合附录A.16表26的规定。
响应消息体JSON报文格式和定义应符合附录A.16表27的规定。
分段调光策略配置（日出日落计划）
采控系统发送给终端设备，配置设备调光策略，日出日落工作计划配置。在某个时间段中如果被开
关灯、调光命令接口干预，则会影响该时间段的策略，但不会影响其他时间段的策略，其它时间段仍然
按照策略运行。在日出日落策略配置的时间段范围之外，默认为关灯状态。
请求消息体JSON报文格式和定义应符合附录A.17表28的规定。
响应消息体JSON报文格式和定义应符合附录A.17表29的规定。
分段调光策略配置（光感计划）（可选）
采控系统发送给设备，配置设备日出日落工作计划调光策略。带有光感知器的设备支持此接口。在
某个时间段中如果被开关灯、调光命令接口干预，则会影响该时间段的策略，但不会影响其他时间段的
策略，其它时间段仍然按照策略运行。在满足光感策略配置规则的时间内，当光感值大于配置的关灯阈
值时则关灯，光感值小于配置的开灯阈值时则开灯。
请求消息体JSON报文格式和定义应符合附录A.18表30的规定。
响应消息体JSON报文格式和定义应符合附录A.18表31的规定。
分段调光策略删除
采控系统发送给设备，删除被指定的通道的策略ID的调光策略。
请求消息体JSON报文格式和定义应符合附录A.19表32的规定。
响应消息体JSON报文格式和定义应符合附录A.19表33的规定。
分段调光策略查询
采控系统发送给设备，查询被指定的通道的策略ID的调光策略详细内容
请求消息体JSON报文格式和定义应符合附录A.20表34的规定。
响应消息单次最多查询8条策略，一次返回一条查询结果，多个策略分多次返回。响应消息体JSON
报文格式和定义应符合附录A.20表35的规定。
定位信息配置
采控系统发送给设备，配置设备的定位信息。
请求消息体JSON报文格式和定义应符合附录A.21表36的规定。
响应消息体JSON报文格式和定义应符合附录A.21表37的规定。
9
T/ZGCSC 012—2024
附 A A A
录
（规范性）
数字道路路灯控制器数据接口消息体结构 JSON 数据属性说明表
A.1 设备上线初始信息上报
上报消息体结构JSON数据中各属性说明表
表1
字段名称 字段类型 是否必填 说明
reqId int M 报文标识，消息流水号,取值范围 1-2147483647。若达 到上限后，再从 1 开始循环。
msgType string M 消息分类， Online 上线消息
sn string M 灯控器序列号，唯一标识
cmdData object M 实际命令数据内容
vender string M 厂家信息
ctlVer string M 灯控器型号
softVer int M 软件版本号
hardVer int M 硬件版本号
ctlType string M 分类： 1:单路控制，2:双路控制
supGps boolean M true:支持 gps，false：不支持 gps
supLuxCtrl boolean M true:支持光控，false：不支持光控
chnList object array M 通道实时状态数据
chnNo int M 通道号, 取值范围: 0-2，如果为 0，则表示所有通道的 信息相同。
onoff int M 灯开关状态: 取值范围 0，1 关灯 0 开灯 1
bri int M 灯亮度取值范围 0-100，代表灯控其调光口输出 0~10V。
elec elecStruct M 详见“6.4 电参数相关 elec 结构描述”
emInfo enInfoStruct M 详见“6.4 能耗相关 emInfo 结构描述”
briLong briLongStruct M 详见“6.4 亮灯时间 briLong 结构描述”
runLong runLongStruct M 详见“6.4 设备运行时间 runLong 结构描述
netStat netStatusStruct M 详见“6.4 网络状态 netStat 结构描述”
netBase netBaseInfoStruc t M 详见“6.4 网络卡基本信息 netBase 结构描述”
pos posStruct O 详见“6.4 定位信息 pos 结构描述”
deviceStat int array O 设备状态 0=>设备正常 1=>计量故障 2=>存储器故障 ....
A.2 设备状态周期上报
消息体结构JSON数据报文中各属性说明表
10
T/ZGCSC 012—2024
表2
字段名称 字段类型 是否必填 说明
reqId int M 报文标识，消息流水号,取值范围 1-2147483647。若达 到上限后，再从 1 开始循环。
msgType string M 消息分类，devStatRpt
sn string M 灯控器序列号，唯一标识
cmdData object M 实际命令数据内容
chnList object array M 通道实时状态数据
chnNo int M 通道号, 取值范围: 0-2，如果为 0，则表示所有通道 的信息相同。
onoff int M 灯开关状态 关灯 0 开灯 1 取值范围 0，1
bri int M 灯亮度 0-100
elec elecStruct M 详见“6.4 电参数相关 elec 子字段描述”
emInfo enInfoStruct M 详见“6.4 能耗相关 emInfo 子字段描述”
briLong briLongStruct M 详见“6.4 亮灯时间 briLong 子字段描述”
runLong runLongStruct M 详见“6.4 设备运行时间 runLong 子字段描述”
netStat netStatusStruct M 详见“6.4 网络状态 netStat 子字段描述”
lSnsr lSnsrStruct O 详见“6.4 光感信息 lSnsr 子字段描述”
lc int O 漏电电流，单位 mA
A.3 告警数据上报
消息体JSON数据报文中各属性说明表
表3
字段名称 字段类型 是否必填 说明
reqId int M 报文标识，消息流水号,取值范围 1-2147483647。 若达到上限后，再从 1 开始循环。
msgType string M 消息分类，Alarm
sn string M 灯控器序列号，唯一标识
cmdData object M 实际命令数据内容
time string M 告警触发的时间
status int M 告警状态 0， 恢复告警 1， 活动告警
level int O 告警级别 一级、二级、三级 取值范围：[1,3]
alarmId int M 告警 ID 10000-过压告警 10001-过流告警 10002-欠压告警 10003-欠流告警 10004-开灯异常告警 10005-关灯异常告警 10006-倾斜告警 10007-漏电告警 10008-设备故障告警 取值范围:>=10000
chnList object array O 通道告警信息,ID 号为 10006-10008 的告警无此 信息。描述是各个通道告警。
11
T/ZGCSC 012—2024
chnNo int O 通道号 ,ID 号为 10006-10008 的告警无此信息 通道号, 取值范围: 0-2，如果为 0，则表示所有 通道的信息相同。
value int M 触发告警的实际值
alarmVal int M 告警触发阈值
rcvrVal int M 告警恢复阈值
cause int O 告警原因 (仅做为 10008 设备故障告警有效，作为扩展) 1=>计量故障 2=>存储故障 ...
ext object O 倾斜告警对象，当发生倾斜告警时有值，即当 alarmId=10006
angle angleStruct O 表示报警发生时的 3 轴角度值
dAngle dAngleStruct O 表示配置的倾斜报警阈值
A.4 设备状态变化上报
消息体JSON数据报文中各属性说明表
表4
字段名称 字段类型 是否必填 说明
reqId int M 报文标识，消息流水号。若达到上限后，再从 1 开始循 环。
msgType string M 消息分类，lampStChgRpt 灯端状态变化上报
sn string M 灯控器序列号，唯一标识
cmdData object M 实际命令数据内容
chnList object array M 通道状态数据
chnNo int M 通道号, 取值范围: 0-2，如果为 0，则表示所有通道 的信息相同。
onoff int M 开关灯状态 取值范围:0,1
bri int M 灯具亮度百分比。 取值范围:0-100

at int M 状态变化发生时间 “yyyy-MM-dd HH:mm:ss”
elec elecStruct M 灯具状态变化后电参数， 详见“6.4 电参数相关 elec 子字段描述”
srcType string M 操作源类型 “NB”, “CAT1”,“DimPlan”，其中 DimPlan 表示调 光策略
srcInfo object O 操作源信息，可选, DimPlan 时有效
dimType int 0~3 策略类型。 0:日出日落模式 1:日期模式 2:星期模式 3:光感模式
planId int 1~8 调光计划 ID
jobId int 1~6 调光段 ID
A.5 遗言消息
消息体JSON数据报文中各属性说明表
12
T/ZGCSC 012—2024
表5
字段名称 字段类型 是否必填 说明
reqId int M 报文标识，消息流水号。若达到上限后，再从 1 开始循 环。
msgType string M 消息分类，lampStChgRpt 灯端状态变化上报
sn string M 灯控器序列号，唯一标识
err int M 错误码，0 成功
A.6 开关灯命令
请求消息体JSON数据报文中各属性表
表6
参数名称 参数类型 是 否 必 填 说明
reqId int M 请求消息流水号,与此消息对就的请求消息的 reqId 相同。
msgType string M 属性操作类消息类型：propOpreation
sn string M 灯控器序列号，唯一标识
op string M 操作类型，R 读操作，W 写操作
prop propStruct M 实际操作数据内容
chnList object array M 多路灯控对象
chnNo int M 通道号, 取值范围: 0-2，如果为 0，则表示所有通 道的信息相同。
onoff int M 1 开灯；0 关灯
actTime string O 动作时间, 格式为“yyyy-MM-dd HH:mm:ss”，与 onoff 一起生 效,无此项表示立即开关
响应消息体JSON数据报文中各属性说明表
表7
参数名称 参数类型 是否必填 说明
reqId int M 请求消息流水号,与此消息对应的请求消息的 reqId 相同
msgType string M 属性操作类消息类型：propOpreation
sn string M 灯控器序列号，唯一标识
err int M 错误码，0 成功，非 0 失败
errInfo string O 错误原因，当 err 不等于 0 时有值
A.7 调光命令
请求消息体JSON报文各属性说明表
表8
参数名称 参数类型 是否必填 说明
reqId int M 报文标识，消息流水号,取值范围 1-2147483647。若 达到上限后，再从 1 开始循环。
msgType string M 属性操作类消息类型：propOpreation
sn string M 灯控器序列号，唯一标识
13
T/ZGCSC 012—2024
op string M 操作类型，R 读操作，W 写操作
prop propStruct M 实际操作数据内容
chnList object array M 多路灯控对象
chnNo int M 通道号, 取值范围: 0-2，如果为 0，则表示所有通道 的信息相同。
bri int M 1-100，亮度值。
响应消息体JSON报文中各属性说明表
表9
参数名称 参数类型 是否必填 说明
reqId int M 请求消息流水号,与此消息对应的请求消息的 reqId 相同
msgType string M 属性操作类消息类型：propOpreation
sn string M 灯控器序列号，唯一标识
err int M 错误码，0 成功，非 0 失败
errInfo string O 错误原因，当 err 不等于 0 时有值