DB13-T5719-2023高速公路可变信息标志网关接入规范

ICS03.220.20

CCSR85

13

河北省地方标准

DB13/T5719—2023

高速公路可变信息标志网关接入规范

Accessspecificationofchangeablemessagesigngatewayforexpressway

2023-05-06发布2023-06-06实施

河北省市场监督管理局发布

DB13/T5719—2023

高速公路可变信息标志网关接入规范

1范围

本文件规定了用于高速公路的可变信息标志网关数据接入的体系结构、一般要求、数据格式和

消息定义。

本文件适用于高速公路运营管理应用平台与可变信息标志网关之间的数据交换，其他道路的应

用平台与可变信息标志网关之间的数据交换可参照使用。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，标注日期的引

用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本(包括所有的修改单)

适用于本文件。

GB/T34428.3-2017高速公路监控设施通信规程第3部分：LED可变信息标志

3术语和定义

GB/T34428.3界定的以及下列术语和定义适用于本文件。

可变信息标志changeablemessagesign简称CMS

安装在高速公路路侧、中间隔离带或道路上方的点阵式显示屏，可通过控制指令改变显示内容，

显示文字或图形信息，用于发布交通疏导、车速反馈、限速提示等信息的设施。[来源：GB/T34428.3-

2017，3.1，有修改]

可变信息标志网关changeablemessagesigngateway简称CMSGW

用于集中管理多个可变信息标志的软件或硬件设施。该设施对各类型号可变信息标志进行协议

适配，实现CMS接入CMSGW,用于CMS设备管控的业务应用系统（以下简称应用平台）提供统一的管理

操控接口。

4体系结构

基于CMSGW构建的系统，结构如图1所示。CMSGW处于应用平台与CMS之间，将多个CMS进行集中接

入和协议适配，对CMSGW向应用平台传输的数据（以下简称上行数据）和应用平台向CMSGW传输的数

据（以下简下行数据）进行传递。一个CMSGW设施，可为多个应用平台提供服务。

1

DB13/T5719—2023

注：CMS-1，CMS-2，CMS-N为不同协议、不同标准可变信息标志产品，经过CMSGW进行通信协议适配后，统一接入

应用平台。

图1基于CMSGW的应用体系结构

5一般要求

通信方式

CMSGW与应用平台间通信为双向通信，基于HTTP协议实现。

CMSGW开放HTTP接口，用于接收控制指令；应用平台开放HTTP接口，用于接收CMSGW的配置数据

和CMS设备实时数据。

CMSGW与应用平台交互流程

CMSGW与应用平台交互流程如图2所示：

图2CMSGW与应用平台交互流程示意图

应用平台基于SM2算法，生成两对非对称密钥A和B。A组密钥用于上行通信签名和验签，B组密

钥用于下行通信签名和验签。

2

DB13/T5719—2023

线下交换密钥，CMSGW持有A组私钥Key-A-Priv和B组公钥Key-B-Pub，用于上行通信签名和下行

数据验签；应用平台持有A组公钥Key-A-Pub和B组私钥Key-B-Priv，用于上行数据验签和下行数据签

名。

上行通信流程为：CMSGW将待发送的数据使用Key-A-Priv进行签名，并将数据原文与数字签名一

并发送至应用平台。应用平台采用Key-A-Pub进行验签，若通过即为合法数据。

下行通信流程为：应用平台将待发送的数据使用Key-B-Priv进行签名，并将数据原文与数字签

名一并发送至CMSGW。CMSGW采用Key-B-Pub进行验签，若通过即为合法数据。

数据接口

CMSGW数据接收接口，请求参数见表1。

接口用途：接收应用平台的下行数据

接口地址：http://ip_address:port/cmsgw/gw/v1.0.0/data

提交方式：POST

表1CMSGW数据接收接口请求参数

参数名称参数说明请求类型是否必须数据类型

data下行数据原文的BASE64编码BODY是字符串

sign下行数据签名BODY是字符串

应用平台数据接收接口，请求参数见表2。

接口用途：接收CMSGW的上行数据

接口地址：http://ip_address:port/cmsgw/ap/v1.0.0/data

提交方式：POST

表2应用平台数据接收接口请求参数

参数名称参数说明请求类型是否必须数据类型

data上行数据原文的BASE64编码BODY是字符串

sign上行数据签名BODY是字符串

6数据格式

为保证数据通用性和可理解性，GMSGW与应用平台数据传输格式基于JSON规范。

数据格式约定

设备数据和指令数据都以JSON格式进行组织，包含header和body部分。其中header用于描述该

信息，body部分为实际要传输的数据。

3

DB13/T5719—2023

示例1：

数据结构示例(仅为说明数据格式，数据无实际意义)

{

"body":[

{

"key1":"value1"

},

{

"key2":"value2"

}

],

"header":{

"infoN":"valueN"

}

}

示例2：

消息示例数据

{

"body":[

{

"deviceNo":"1001",

"special":"1",

"stayTime":"5"

},

{

"deviceNo":"1002",

"special":"1",

"stayTime":"5"

}

],

"header":{

"deviceNo":"008",

"deviceType":"CMS",

"msgType":"CMSMessage",

"gwAddr":":8080"

}

}

消息头

消息头字段说明见表3。

4

DB13/T5719—2023

表3消息头字段说明

字段必填类型描述示例值

CMSMessage：当前显示内容

msgType是String(32)消息类型

CMSStatus：设备状态

CMSPropertyAll：全量上报的配置信息

CMSPropertyIncre：增量上报的配置信息

CMSResponsePlayMessage：下发播放信息指令回应

CMSResponseQueryFailure：查询故障回应

CMSReaponseSetLight：设置亮度回应

CMSReaponseQueryLight：查询亮度回应

CMSReaponseTurnOnOff：开关屏回应

CMSPlayMessage：播放信息

CMSQueryFailure：查询故障

CMSSetLigth：设置亮度

CMSQueryLigth：查询亮度

CMSTurnOnOff：开关CMS设备

deviceType是String(32)设备类型，针对CMS设备，CMS

取值固定为CMS。

deviceNo是String(32)集中接入程序或设备的唯一JD_CMS_001

标识码。

apAddr否String(32)应用平台地址+端口:8080

gwAddr否String(32)CMSGW程序或设备地址+端口:8080

传输的数据类型分为两类：第一类为设备数据、设备状态、请求回应等，由CMSGW发往应用平台。

第二类为管控指令，包括设备动作指令、查询指令等。

消息体格式

不同消息类型的消息体字段不同。

5

DB13/T5719—2023

示例：

当前显示内容消息体。

{

"body":[

{

"align":"1",

"content":[

{

"font":"0",

"fontColor":"0",

"fontSize":"0",

"fontSpace":"0",

"imgNo":"3",

"text":"",

"type":"IMG",

"x":"0",

"y":"0"

},

{

"font":"1",

"fontColor":"1",

"fontSize":"16",

"fontSpace":"0",

"imgNo":"0",

"text":"限速抓拍80KM/h",

"type":"TEXT",

"x":"50",

"y":"0"

}

],

"deviceNo":"1001",

"special":"1",

"stayTime":"5"

}

]

}

回应数据

回应数据字段说明见表4。

表4回应数据字段说明

变量名必填类型示例值描述

resultCode是String(16)SUCCESSSUCCESS/FAIL

errCode否String(32)

errDes否String(128)系统错误错误返回的信息描述

deviceNo是String设备在路段上的编码

result是String

其它有效信息

错误代码

6

DB13/T5719—2023

错误代码说明见表5。

表5错误代码说明

返回值描述

5001XX错误

5002XX错误

5003XX错误

注：仅为说明数据格式，数据无实际意义

7消息定义

说明

本章节仅阐述消息定义和消息构成的要素，消息示例数据参见附录A。

CMS内容实时数据

7.2.1消息头消息类型

"msgType":"CMSMessage"

7.2.2消息体内容

内容实时上报BODY结构见表6。

表6内容实时上报BODY结构

数据项父项字段类型是否必填说明

bodyCommonMsgJSONArray是json数组

CMSReportMessagebodyJSONObject是情报板的实时信息结构

deviceNoCMSReportMessageString是设备在路段上的编码

stayTimeCMSReportMessageString是停留时间

对齐方式:

alignString是

1:居左

2:居中

3:居右

4:自定义

默认2

入屏特效

specialCMSReportMessageString是

1:立即显示;

2:闪烁;

3:左移;

4:上移;

5:右移;

6:下移;

contentCMSReportMessageJSONArray是内容项数组

CMSMessageContentcontentJSONObject是信息内容项

typeCMSMessageContentString是数据类型IMG：图片，TEXT：文本

7

DB13/T5719—2023

表6内容实时上报BODY结构（续）

数据项父项字段类型是否必填说明

字体

fontCMSMessageContentString否

1:宋体;

2:仿宋;

3:黑体;

4:楷体;

字号

fontSizeCMSMessageContentString否

16；24；32；48；64

字体颜色

fontColorCMSMessageContentString否

1:红色;

2:绿色;

3:蓝色;

4:黄色;

5:紫色;

6:青色;

7:白色;

fontSpaceCMSMessageContentString否字间距，当对齐方式为4时有用。

xCMSMessageContentString是x坐标

yCMSMessageContentString是y坐标

imgNoCMSMessageContentString否图素编码

textCMSMessageContentString否文本内容

CMS状态实时数据

7.3.1消息头消息类型

"msgType":"CMSStatus"

7.3.2消息体内容

CMS状态数据消息体内容说明定义见表7。

表7CMS状态数据消息体内容说明定义

数据项父项字段类型是否必填说明

bodyCommonMsgJSONArray是数组

CMSStatusbodyJSONObject是状态实时数据结构

deviceNoCMSStatusString是设备在路段上的编码

状态编码，

statusCMSStatusString是

-1:"异常";

0:"未知";

1:"正常";

2:"故障";

3:"通讯断开";

4:"未使用";

msgCMSStatusString否状态描述

CMS播放指令响应数据

7.4.1消息头消息类型

"msgType":"CMSResponsePlayMessage"

8

DB13/T5719—2023

7.4.2消息体内容

CMS播放指令内容说明见表8。

表8CMS播放指令内容说明

数据项父项字段类型是否必填说明

bodyCommonMsgJSONArray是数组

CMSResponsePlayMessagebodyJSONObject是播放指令后异步返

回的响应数据

deviceNoCMSResponsePlayMessageString是设备在路段上的编

码

返回码，

resultCMSResponsePlayMessageString是

-1:"异常";

0:"未知";

1:"正常";

2:"故障";

3:"通讯断开";

4:"未使用";

CMS亮度指令响应数据

7.5.1消息头消息类型

"msgType":"CMSReaponseSetLight"

7.5.2消息体内容

CMS亮度指令内容说明见表9。

表9CMS亮度指令内容说明

数据项父项字段类型是否必填说明

bodyCommonMsgJSONArray是数组

CMSResponseSetLightbodyJSONObject是亮度设置指令后异步

返回的响应数据

deviceNoCMSResponseSetLightString是设备在路段上的编码

返回码，

resultCMSResponseSetLightString是

-1:"异常";

0:"未知";

1:"正常";

2:"故障";

3:"通讯断开";

4:"未使用";

亮度查询指令响应数据

7.6.1消息头消息类型

"smgType":"CMSResponseQueryLight"

7.6.2消息体内容

亮度查询指令相应BODY结构见表10。

9

DB13/T5719—2023

表10亮度查询指令响应BODY结构

数据项父项字段类型是否必填说明

bodyCommonMsgJSONArray是数组

CMSReaponseQueryLightbodyJSONObject是亮度查询指令后异

步返回的响应数据

deviceNoCMSReaponseQueryLightString是设备在路段上的编

码

lightCMSReaponseQueryLightString是0-31的亮度值

返回码，

resultCMSReaponseQueryLightString是

-1:"异常";

0:"未知";

1:"正常";

2:"故障";

3:"通讯断开";

4:"未使用";

设备开关指令响应数据

7.7.1消息头消息类型

"msgType":"CMSReaponseTurnOnOff"

7.7.2消息体内容

设备开关指令响应BODY结构见表11。

表11设备开关指令响应BODY结构

数据项父项字段类型是否必填说明

bodyCommonMsgJSONArray是数组

CMSReaponseTurnOnOffbodyJSONObject是开关屏指令后异步

返回的响应数据

deviceNoCMSReaponseTurnOnOffString是设备在路段上的编

码

返回码，

resultCMSReaponseTurnOnOffString是

-1:"异常";

0:"未知";

1:"正常";

2:"故障";

3:"通讯断开";

4:"未使用";

CMS设备属性全量上报数据

7.8.1消息头消息类型

"msgType":"CMSPropertyAll"

7.8.2消息体内容

设备属性全量上报BODY结构见表12。

10

DB13/T5719—2023

表12设备属性全量上报BODY结构

数据项父项字段类型是否必填说明

bodyCommonMsgJSONArray是数组

CMSPropertyAllbodyJSONObject是情报板设备属性

deviceNameCMSPropertyAllString是情报板名称

deviceNoCMSPropertyAllString是情报板在路段上的编码

安装方式：

cmsTypeCMSPropertyAllString是

1：门架安装

2：悬臂安装

3：立柱安装

4：吊装

所在场所：

deviceSiteCMSPropertyAllString是

1：收费站（雨棚屏和广场屏）

2：服务区（出入口悬臂/立柱情报板）

3：外场（被交道、及路段悬臂和路段门

架）

4：隧道（洞内屏和洞口门架）

widthCMSPropertyAllString是情报板宽度（像素）

heightCMSPropertyAllString是情报板高度（像素）

imgCMSPropertyAllString是是否支持图素显示,1：支持；0：不支持

kilometerCMSPropertyAllString是情报板桩号（千米）

meterCMSPropertyAllString是情报板桩号（米）

latCMSPropertyAllString是纬度

lngCMSPropertyAllString是经度

netConfigCMSPropertyAllString否情报板连接参数

情报板上下行：

positionCMSPropertyAllString是

1：上行；

2：下行；

3：双向

支持的特效

specialCMSPropertyAllString否

1:立即显示;

2:闪烁;

3:左移;

4:上移;

5:右移;

6:下移;

例1,2,3

支持的对齐方式:

alignCMSPropertyAllString否

1:居左

2:居中

3:居右

4:自定义

例1,2,3

11

DB13/T5719—2023

表12设备属性全量上报BODY结构（续）

数据项父项字段类型是否必填说明

支持的字体

fontCMSPropertyAllString否

1: