《数字道路路灯控制器数据接口规范》（征求意见稿）

1数字道路路灯控制器数据接口规范本文件规定了数字道路中路灯控制器设备与上层系统之间数据上报接口、控制下发接口及查询配本文件适用于面向数字道路应用的路灯灯控器与统一采控平台3.1路灯控制器采控系统StreetlightControlandAcquisi路灯控制器采控系统是智慧城市建设中的一项关键技术设施，它通过智能化的路灯终端设备与云端管理平台的配合，实现对城市路灯的远程监控、智能调度及4缩略语MQTT消息队列遥测传输MessageQueuingTelemetryTransportJSONJS对象简谱JavaScriptObjectNHTTP超文本传输协议HyperTextTransferProtoc2•通过实时查询类接口可以查询设备基本信息、设备运行状态、告警信息、调光策略配置、•通过操作控制类接口实现开关灯、控制亮度、重启、恢复默认等。采控系统下发带主题的指令数据到MQTT服务器,MQTT平台依据设备订阅的主题，将消息推送给相器收到该响应后将其推送给采控系统。MQTT服务器由采控系统提供，同侧部署。指令数据下发模式的接口主要包括对设备的控制3MQTT平台再将其推送到采控系统。MQTT服务器由采控系统提供，同侧部署。见图3在路灯控制器与采控系统使用MQTT通讯协议时，使用发布/订阅消息模式使用控制器的IMEI，作为设备的唯一标识，订阅/Lamp/Report/XXX1/Lamp/CmdInput/XXX1/Lamp/CmdOutput/XXX1/Lamp/UpgradeIn/XXX1/Lamp/UpgradeOut/XXX1/Lamp/Lwt/XXX1为保证消息的可靠性，MQTT的QOS应配置为1,在使用过程中如果性能消耗过大，也可以考虑将路灯发给采控系统的消息的QOS配置为0。6.4基础数据结构4路灯控制器的基础数据结构见表2至表14，包括设备状态监测元素，如电参数结构记录电流、电压MMMMMMMMMMMMMOMRMSMCMOO5OOxMyMzMxMyMzMRRRRRRRNOCONN/CONNRRRRRNOCONNmodeRRmccRmncR0RRRRRRR6R5xMyMzM上报消息体结构JSON数据格式和定义应符合附录A.），消息体结构JSON数据报文格式和定义应符合附设备依据预设的各种告警阈值实时判断告警状况，当告警发生或解除时主动上传告警信息到采控消息体JSON数据报文格式和定义应符合附录A7.4设备状态变化上报消息体JSON数据报文格式和定义应符合附录A7则将设备遗言消息发送给订阅方，接口参数主要包括请求消息Id，消息类型消息体JSON数据报文格式和定义应符合附录A调光命令改变0~10V的模拟量输出。请注意：当用此命令进行控制，如果当前设备有调光策略在运行，只会影响当前命中的时间段，其他时间段按照调光策略继续运行，信息。当设备上电或者重启之后，需要按照8.4软件升级命令HTTP或HTTPS协议下载新的软件版本，并进行安装。安装重启后再给采控系统发设备上线初始信息上报消息，由采控系统判断是不是最新版本。请注意：升级的固件URL应是公网可达的链接。9实时查询类接口9.2设备实时信息查询810.2设备状态上报周期配置10.3分段调光策略配置（周计划）10.5分段调光策略配置（日出日落计划）10.7分段调光策略删除采控系统发送给设备，删除被指定的通道的策略ID的调光910.8分段调光策略查询采控系统发送给设备，查询被指定的通道的策略ID的调光策略详响应消息单次最多查询8条策略，一次返回一条查询结果，多个策略分多次返回。响10.9定位信息配置1A.1设备上线初始信息上报MmsgTypeMMMMMMMMMMMMMMM详见“6.3电参数相关elec结构描述”M详见“6.3能耗相关emInfo结构描述”M详见“6.3亮灯时间briLong结构描述”MM详见“6.3网络状态netStat结构描述”tM详见“6.3网络卡基本信息netBase结构描述”O详见“6.3定位信息pos结构描述”OA.2设备状态周期上报2MmsgTypeMMMMMM取值范围0，1MM详见“6.3电参数相关elec子字段描述”M详见“6.3能耗相关emInfo子字段描述”M详见“6.3亮灯时间briLong子字段描述”M详见“6.3设备运行时间runLong子字段描述”M详见“6.3网络状态netStat子字段描述”O详见“6.3光感信息lSnsr子字段描述”OA.3告警数据上报MmsgTypeMMMMMOMO3OMMMOO倾斜告警对象，当发生倾斜告警时有值，即当OOA.4设备状态变化上报MmsgTypeMMMMMMMM“yyyy-MM-ddHH:mm:ss”M详见“6.3电参数相关elec子字段描述”MOA.5遗言消息4MmsgTypeMMMA.6开关灯命令填MmsgTypeMMMMMMMOM请求消息流水号,与此消息对应的请求消息的msgTypeMMMOA.7调光命令MmsgTypeMM5MMMMMM请求消息流水号,与此消息对应的请求消息的msgTypeMMMOA.8设备重启命令MmsgTypeMMM同msgTypeMMMOA.9软件升级命令MmsgTypeMMMMMMmd5M固件文件的md5值（32位小写字母数字）6M请求消息流水号,与此消息对应的请求消息的msgTypeMMMM3:升级版本检验出错.4:md5检验出错.MOOA.10设备通用属性表信息查询MmsgTypeMMMMM实际读取的数据内容，取值范围为以下对象一种或几种的组合。7MmsgTypeMMMM返回读取的数据内容，内容为以下一种或几种对象的组合。具体定位信息，内容参见“6.3定位信息posStruct”态详细信息networkStatusStruct”信息networkInfoStruct”灯控器型号，内容为："ctlVer":"MM-ddHH:mm:ss”信息angleStruct”A.11设备实时信息查询MmsgTypeMM8M请求消息流水号,与此消息对应的请求消息的reqId相同msgTypeMMMMMMMM详见“6.3电参数相关elecStruct子字段描述”M详见“6.3能耗相关emInfoStruct子字段描述”M详见“6.3亮灯时间briLongStruct子字段描述”M述”MM详见“6.3光感信息lSnsrStruct子字段描述”OA.12告警配置信息查询请求消息体JSON报文中各属性说明见表MmsgTypeMMMMM同msgTypeMMMM9MMMO阈值cfgAngle组合属性描述”A.13告警参数配置M消息流水号取值范围:msgTypeMMMMMMMOM请求消息流水号,与此消息对应的请求消息的reqIdmsgTypeMMOMMMMA.14设备状态上报周期配置MmsgTypeMMMMM请求消息流水号,与此消息对应的请求消息的msgTypeMMMMmsgTypeMMMMMMMMMMMMweekM星期格式：xxxxxxx，从左到右依次表示星期效MMMMM请求消息流水号,与此消息对应的请求消MMmsgTypeMMMMMMmsgTypeMMWMMMMMMMMMMMMMM请求消息流水号,与此消息对应的请求消MMmsgTypeMMMMMMmsgTypeMMWMMMMMMMMMMMMminMMM请求消息流水号,与此消息对应的请求消MMmsgTypeMMMMMMmsgTypeMMWMMMMMMMMminMMMMMMMMMM请求消息流水号,与此消息对应的请求消MMmsgTypeMMMMMA.19分段调光策略删除M消息流水号，取值范围:1-2147483647。若达到上限msgTypeMMWMMMM请求