1、 南宁市 交警支队 交通 诱导屏 通讯协议 技术要求 V1.1 2015 年 05 月 诱导二期工程可变情报板 通讯协议 技术要求 第 2 页 /共 23 页 2 目 录 南宁市交警支队交通诱导屏 .1 通讯协议技术要求 V1.1 .1 1 通讯协议设计说明 .4 1.1 物理链路说明 . 4 1.2 应用协议帧格式 . 4 1.3 通讯方式说明 . 5 2 指令详解 .5 2.1 查询设备状态 . 5 2.2 测试控制 . 6 2.3 控制开关屏 . 6 2.4 亮度控制 . 6 2.5 设置日期时间 . 6 2.6 坏点检测 . 7 2.7 设备复位 . 7 2.8 文件下发(播放列表、彩
2、屏图形) . 7 2.9 设置环境控制参数 . 7 2.10 设置亮度控制参数 . 8 2.11 设置基本参数 . 8 2.12 指定 显示列表 . 8 2.13 停止紧急播放 . 9 2.14 恢复出厂设置 . 9 2.15 查询版本信息 . 9 2.16 控制屏体电源开关 . 9 2.17 查询基本参数 . 9 2.18 查询环境参数 . 10 2.19 查询亮度参数 . 10 2.20 查询当前播放内容 . 10 2.21 设置紧急播放内容 . 10 2.22 设计插播内容 . 11 2.23 查询电流电压 . 11 2.24 读取坏点信息 . 11 2.25 上位机收到坏点信息的回应命
3、令 . 12 2.26 设备收到上位机时间段控制播放列表命令 . 13 2.27 设备收到上位机时间段控制亮度参数命令 . 14 2.28 设备收到上位机设置路段参数控制命令(嵌入式 LED 路网屏专用) . 14 2.29 设备收到上位机查询路段参数命令(嵌入式 LED 路网屏专用) . 15 2.30 设备收到上位机设置亮度参数命令(嵌入式 LED 路网屏专用) . 15 2.31 设备收到上位机查询亮度参数命令(嵌入式 LED 路网屏专用) . 16 2.32 查询停车诱导屏信息(停车诱导屏专用) . 16 诱导二期工程可变情报板 通讯协议 技术要求 第 3 页 /共 23 页 3 2.
4、33 设 置停车诱导屏信息(停车诱导屏专用) . 16 附一: 16 位 CRC 计算方法 . 18 附二:播放列表文件说明 . 19 附三:彩图文件说明 . 22 附四:缓存文件说明 . 23 诱导二期工程可变情报板 通讯协议 技术要求 第 4 页 /共 23 页 4 1 通讯协议 设计说明 本设计针对 CMS 与上位机或便携机 相互交换信息 的方式和格式进行说明 。 1.1 物理链 路 说明 CMS 与外界进行通讯支持网络和串 行 两种方式 , 其中串行 通讯 方式支持 232、485 两 种方式 , 便携机与上位机的 通讯方式相同。 CMS 设备 同时支持 网络和串口两种通讯方式。 各缺
5、省配置 如下: 网络方式: 支持 UDP 通讯方式 。 缺省参数: 本机 IP: 192.168.1.222 UDP 接收端口 : 5000 子网掩码: 255.255.255.0 网关: 0.0.0.0 上位机 IP: 192.168.1.100 UDP 接收端口: 6000 串口方式: 通讯方式由 环境 配置 情况 决定 , CMS 设备 在处理串行通讯时按 485控制方式 进行控制 。 缺省参数:串口 1,波特率:由 DIP 开关设置。数据位: 8;停止位: 1;流控制:无;校验位:无。 1.2 应用 协议 帧 格式 协议帧格式采用面向字节的连接帧 。 数据帧格式如下: 起始符 设备地址
6、 指 令码 数据域 结束符 校验 码 起始符: 1 字节,固定为 0xAA。 表示 帧开始。 设备地址: 2字节 , 范围: 0-65535, 其中地址 0 保留, 65535 表示广播地址。 指 令码: 1 字节。 范围: 1-255。 不同的 值 代表不同的功能 的指令 。 数据域: 多字节。 随 指令码 不同 其长度 变化 ,可能 无该域 。 结束符: 1 字节 , 固定为 0xCC。 表示帧结束。 校验 码 : 2 字节。 16位 CRC 校验 。 所有数据转义后,包括起始符、结束符在内的所有数据校验。 按 低位在前,高位在后存储。 诱导二期工程可变情报板 通讯协议 技术要求 第 5
7、页 /共 23 页 5 说明: 1、 帧内数据如采用 2 字节或 4 字节表示整数,均采用低位在前,高位在后的存储方式。 如: 设备 地址 计算方法: 第 1字节 =地址值 除 256 的余数。 第 2字节 = 地址值 整除 256。 设备 地址 354 的表示为 98 (0x62) 1 (0x01) 2、 若帧 起始符和帧结束符 之间的任意字节等于 0xAA 或 0xCC 或 0xEE,则必须进行 转义: 0xAA -0xEE 0x0A 0xCC-0xEE 0x0C 0xEE -0xEE 0x0E 1.3 通讯方式说明 上位机 与 CMS 设备 通讯, 在串行 方式下, 支持两种: 点对点、
8、点对多点。 点对点方式表示 CMS设备可以主动上报数据。 点对多点方式 一般用于 485连接方式 ,CMS 设备不主动上报数据,所有数据均需 上位机查询 。 通讯超时 为 20 秒 。 2 指令详解 以下 针对 指令码 和数据 域 进行说明, 实际使用应增加帧起始符、设备地址、帧结束符和校验。 如 指令码后无说明 内容 , 则表示 没有 数据域 。 (下文描述中 1B 表示 1字节 , B-Byte) 2.1 查询设备状态 上位机发送: 指令码 0x01 设备回应: 指令码 0x02 数 据 内容 如下: 内容 字节数 备注 日期 4 年、月、日次序,年 2字节,月、日各 1字节 时间 3 时
9、、分、秒次序,各 1字节 门状态 1 1-打开 2-关闭 屏体电源 1 1-供电 2-断电 开关屏标记 1 1-开屏 2-人工关屏 3-温度过高关 4-坏点过多关 当前温度符号 1 1-表示正数 2-表示负数 采集温度 1 当前温度值 保留字节 1 固定值: 0 诱导二期工程可变情报板 通讯协议 技术要求 第 6 页 /共 23 页 6 保留字节 1 固定值: 0 保留字节 1 固定值: 0 采集亮度 1 当前温度值 亮度控制方式 1 1-自动 2-手动 亮度级别 1 1-255 注:该回应 在 允许主动上报时,状态变化 时将 主动上报。 2.2 测试 控制 上位机发送: 指令码 0x03 数
10、据内容为测试模式( 1 字节),说明如下: 内容 备注 0x00 退出测试模式 0x01 竖条切换 0x02 横条切换 0x03 红屏、黑屏交替 0x04 绿屏、黑屏交替 0x05 全屏、黑屏交替 0x06 全红 0x07 全绿 设备回应:指令码 0x04 执行情况( 1B 1-成功 0-失败) 2.3 控制开关屏 上位机发送: 指令码 0x05 控制内容( 1B 1-开屏 2-关屏 ) 设备回应: 指令码 0x06 执行情况( 1B 1-成功 0-失败) 2.4 亮度控制 上位机发送: 指令码 0x07 亮度控制 方式( 1B 1-自动 2-手动 ) 手动亮度级别( 1B 1-255)。 设
11、备回应: 指令码 0x08 执行情况( 1B 1-成功 0-失败) 2.5 设置日期时间 上位机发送: 指令码 0x09 年 (2B) 月 (1B) 日 (1B) 时 (1B) 分 (1B) 秒 (1B) 设备回应: 指令码 0x0A 执行情况( 1B 1-成功 0-失败) 诱导二期工程可变情报板 通讯协议 技术要求 第 7 页 /共 23 页 7 2.6 坏点检测 上位机发送: 指令码 0x0B 设备回应: 指令码 0x0C 执行情况( 1B 1-成功 0-失败) 坏点总数( 2B) 2.7 设备复位 上位机发送: 指令码 0x0D 设备回应: 指令码 0x0E 执行情况( 1B 1-成功
12、0-失败) 注:该指令可能由于设备复位较快,不会返回回应。 2.8 文件下发 (播放列表、彩屏图形) 上位机发送:指令码 0x11 块大小 (2B) 文件名 ( nB 内容见下) 。 设备回应 : 指令码 0x12 执行情况( 1B 1-成功 0-失败) 上位机发送:指令码 0x13 块号( 2B) 数据内容( nB 字节 数据为块大小 ) 设备回应 : 指令码 0x14 块 号( 2B) 执行情况( 1B 1-成功 0-失败) 注: 1.指令 0x11 中的块大小表 示下发文件内容时的 0x13 中数据内容的长度, 该块大小 可根据 网络和串行通讯物理连接情况 进行调整,但最大不能超过 1K
13、。 这样,对于物理连接较好时,可以将小于 1K 的文件一次性下发。 2.指令 0x11 中的 文件名只允许: playXXX.lst、 imgXXX.bmp 两种文件 名 。 playXXX.lst 文件的 XXX 取值范围是 001-100, imgXXX.bmp 文件的 XXX 取值范围是 101-200。 其中 playxxx.lst文件为播放列表文件 , imgxxx.bmp 文件为彩图文件。 3.块号是从文件读出数据块 ( 指定 的块大小 ) 的顺序号 , 编号从 1 开始 连续编号 。 数据内容固定长度为 指定 的 块大小 ,当 控制器 收到一个小于 指定的块大小 的包时,认为文件
14、下发完成,如果 文件长度可被 指定的块大小 整除,则必须下发一个 无数据内容 的帧。 4.文件下发时,先使用 0x11 命令下发文件名,收到 0x12 命令时,如果返回 成功,再使用0x13 命令下发文件内容 ,收到 0x14 的成功回应时,认为该块下发成功,否则需要重发该块,直到发完整个文件 。 5.指 令 码 0x12 返回失败,可能的原因 为: 文件名 不正确 、 控制器建立文件错 或指定块大小超过 1K。 指令码 0x14 返回失败,可能的原因为 :块号不连续 、 写文件失败 或未指定下发文件 。 2.9 设置环境控制参数 上位机发送: 指令码 0x15 数据内容如下: 内容 字节数
15、备注 保留字节 1 固定值: 0 诱导二期工程可变情报板 通讯协议 技术要求 第 8 页 /共 23 页 8 保留字节 1 固定值: 0 保留字节 1 固定值: 0 保留字节 1 固定值: 0 保留字节 1 固定值: 0 报警关屏温度 1 正数 0 表示不进行关屏处理。 设备回应:指令码 0x16 执行情况( 1B 1-成功 0-失败) 2.10 设置亮度控制参数 上位机发送: 指令码 0x17 数据内容如下: 内容 字节数 备注 1级亮度 值 1 采集的亮度值 1级彩屏亮度 1 控制彩屏的亮度值 1级 基色 屏亮度 1 控制基色屏的亮度值 共 8级 ,其它级别内容同上。 全部内容为 24 个
16、字节 。 设备回应: 指令码 0x18 执行情况( 1B 1-成功 0-失败) 2.11 设置基本参数 上位机发送: 指令码 0x19 数据内容如下: 内容 字节数 备注 屏编号 2 本机 IP 地址 4 以整数表示的 IPV4 格式 本机 UDP 端口 2 子网掩码 4 以整数表示的 IPV4 格式 网关 4 上位机 IP 地址 4 上位机端口 2 上报 设置 1 0-不主动上报 1-主动 上报 坏点关屏比率 1 以百分数表示, 0-表示不关屏。 串口波特率 1 1: 2400 2: 4800 3: 9600 4: 19200 特效步长 1 0: 1列 /行 1: 2列 /行 2: 4列 /
17、行 3: 8列 /行 4: 16 列 /行 5: 32列 /行 设备回应: 指令码 0x1A 执行情况( 1B 1-成功 0-失败) 注:使用该命令控制后,必须复位控制器,再次启动后生效。 2.12 指定显示列表 上位机发送: 指令码 0x1B 列表编号 ( 1B) 设备回应: 指令码 0x1C 执行情况( 1B 1-成功 0-失败) 诱导二期工程可变情报板 通讯协议 技术要求 第 9 页 /共 23 页 9 2.13 停止紧急播放 上位机发送: 指令码 0x1F 设备回应: 指令码 0x20 执行情况( 1B 1-成功 0-失败) 2.14 恢复出厂 设置 上位机发送: 指令码 0x21 设
18、备回应:指令码 0x22 执行情况( 1B 1-成功 0-失败) 2.15 查询版本信息 上位机发送: 指令码 0x23 设备回应:指令码 0x24 版本信息 ( 3B VER1, VER2, VER3) 注:版本格式: 1.3.5( VER1 = 1,VER2 = 3,VER3 = 5) 。 2.16 控制屏 体电源开关 上位机发送: 指令码 0x25 控制内容( 1B 1-打开 2-关闭 ) 设备回应: 指令码 0x26 执行情况( 1B 1-成功 0-失败) 2.17 查询基本参数 上位机发送: 指令码 0x27 设备回应:指令码 0x28 数据内容 如 下 内容 字节数 备注 屏编号
19、2 本机 IP 地址 4 以整数表示的 IPV4 格式 本机 UDP 端口 2 子网掩码 4 以整数表示的 IPV4 格式 网关 4 上位机 IP 地址 4 上位机端口 2 上报设置 1 0-不主动上报 1-主动上报 坏点关屏比率 1 以百分数表示, 0-表示不关屏。 串口波特率 1 1: 2400 2: 4800 3: 9600 4: 19200 5: 38400 特效步长 1 0: 1列 /行 1: 2列 /行 2: 4列 /行 3: 8列 /行 4: 16 列 /行 5: 32列 /行 诱导二期工程可变情报板 通讯协议 技术要求 第 10 页 /共 23 页 10 2.18 查询环境参数
20、 上位机发送: 指令码 0x29 设备回应:指令码 0x2A 数据内容如下 内容 字节数 备注 保留字节 1 固定值: 0 保留字节 1 固定值: 0 保留字节 1 固定值: 0 保留字节 1 固定值: 0 保留字节 1 固定值: 0 报警关屏温度 1 正数 0 表示不进行关屏处理。 2.19 查询亮度参数 上位机发送: 指令码 0x2B 设备回应:指令码 0x2C 数据内容如下 内容 字节数 备注 1级亮度值 1 采集的亮度值 1级彩屏亮度 1 控制彩屏的亮度值 1级基色屏亮度 1 控制基色屏的亮度值 共 8级,其它级别内容同上。全部内容为 24 个字节。 2.20 查询当前播放内容 上位机发送: 指令码 0x2d 设备回应: 指令码 0x2e 数据内容 如下 内容 字节数 备注 开关屏标志 1 1-表示开屏 2-表示关屏,关屏时以下内容无效 播放类型标志 1 1-列表播放 2-紧急播放 3-测试 播放列表号 1 当前播放的列表编号或测试编号 内容 头 8 固定为 itemrn 当前播放内容 n 参见附二 播放文件列表说明 注:该回应在允许主动上报时,状态变化时将主动上报。 2.21 设置紧急播放内容 上位机发送: 指令码 0x30 数据内容如下 内容 字节数 备注 播放时长 2 以秒为单位, 0表示一直播放 内容头 8 固定为 itemrn