IF-KXB系列可变信息板通讯协议1.31.doc

IF-KXB系列可变信息板通讯协议V1.31广州市丰海信息科技有限公司2013/4/1 目 录 1.文档历史记录12.文档简要功能及适用范围13.可变信息标志通信协议13.1.RS232接口13.2.以太网接口13.3.帧格式23.3.1.命令帧格式23.3.2.返回帧格式23.3.3.转义字符23.3.4.帧头33.3.5.地址域33.3.6.帧类型域33.3.7.帧数据33.3.8.联网用帧校验方式（CRC16）33.3.9.帧尾44.指令详解44.1.检测设备故障(01)44.2.设置设备的亮度调节方式(04)54.3.设置设备的当前显示亮度(05)54.4.获得当前亮度调节方式和显示亮度(06)54.5.从设备下载文件(09)64.6.向设备上传播放列表及其它文件(10)64.7.直接播放列表文件(1A)74.8.获得当前播放列表(97)84.9.显示预置播放列表(98)84.10.获得设备当前的配置信息表(51)94.11.设置设备配置信息(52)94.12.色彩校正(53)104.13.获得设备的温度、检测亮度值(54)104.14.设置显示板显示开关值(55)114.15.设备重新启动(56)114.16.盲点检测(58)114.17.主机对设备时钟同步(5A)124.18.获得设备最后启动情况(5H)124.19.文件系统【dir】命令(61)134.20.文件系统【delete】删除文件命令(65)134.21.文件系统初始化命令(67)144.22.文件系统总空间和剩余空间命令(69)144.23.可变限速标志显示限速值(20)144.24.获得可变限速标志当前限速值(21)154.25.可变限速标志参数整体设置(24)154.26.获得可变限速标志的温度、亮度、限速值等参数(57)164.27.其它165.播放列表格式175.1.表头175.2.播放动作数定义175.3.每条动作内容定义175.4.播放表举例19IF-KXB系列可变信息板通讯协议IF-KXB系列可变信息板通讯协议1. 文档历史记录序号日期版本备 注12011/8/25V1.0基本版本22011/11/29V1.2修改联网协议的CRC16校验方式32012/08/05V1.3增加部分指令42013/04/01V1.31增加节目不保存而直接显示命令2. 文档简要功能及适用范围本协议适用于RS232或以太网接口，为主-从结构的通信方式。监控中心计算机，手持单元或其它数据终端为主站，可变信息板或可变限速标志为从站。每个可变信息标志均有各自的地址编码。完成交通诱导信息的发布任务，诱导信息包括临时信息、中立信息、情报信息、限速信息等。3. 可变信息标志通信协议3.1. RS232接口标准RS232串行接口，异步通讯，全双工，波特率：9600 bps；数据位：8 bits，校验位：No parity；停止位：1 bit；所有数据的取值范围： 0x00 to 0xFF (0255)。3.2. 以太网接口使用 TCP/IP 通信，外部通过请求响应模式发送和获取数据。支持100Mbps。3.3. 帧格式设备间通信均由主站发出的信息帧来控制，每帧由帧起始符、设备地址、帧类型（即命令代码）、帧数据、校验码及帧结束符等6个部分组成。每部分由若干字节组成。3.3.1. 命令帧格式字段字节数描述帧头1STX(0x02)，表明一帧的开始，为接收方提供同步地址2设备地址，高位在前帧类型2表明此帧的功能，高字节在前帧数据不定长帧中携带的数据帧校验2供接收方判断所收帧的正确性，采用CRC16校验帧尾1ETX(0x03)，表明一帧的结束，为接收方提供同步3.3.2. 返回帧格式字段字节数描述帧头1STX(0x02)，表明一帧的开始，为接收方提供同步地址2设备地址，高位在前帧类型2表明此帧的功能，高字节在前帧数据不定长帧中携带的数据帧校验2供接收方判断所收帧的正确性，采用CRC16校验帧尾1ETX(0x03)，表明一帧的结束，为接收方提供同步3.3.3. 转义字符 转义符：ESC - 0x1B 发送一帧时，若帧头与帧尾之间有任意字节等于STX，ETX或ESC，则需要转义为：定义：w STX(0x02)帧头w ETX(0x03)帧尾w ESC(0x1B)转义符转义为：w STX 转成 ESC 和 0xE7 w ETX 转成 ESC 和 0xE8 w ESC 转成 ESC 和 0x003.3.4. 帧头STX 0x02： 标识一帧信息的开始，其值为0x02=00000010B，为接收方提供同步。3.3.5. 地址域地址域由2个字节构成。可以为监控中心通讯设备、可变信息板、可变限速标志等设备的设备编号，具体使用可由用户自行决定，范围0x00000xFFFF。3.3.6. 帧类型域帧类型域由2个字节构成，可以为监控中心发布信息或接收反馈信息的标示，范围为ASCII的0099。3.3.7. 帧数据帧数据域包括数据标识和数据等，其结构随帧类型域的功能而改变。3.3.8. 联网用帧校验方式（CRC16）2个字节，从帧起始符后开始到校验码之前的所有字节的CRC16的校验值。CRC16校验值的计算，按如下实现：unsigned int gen_crc(unsigned char *frame, unsigned short frame_len) unsigned char c, treat, bcrc; unsigned int wcrc = 0; short i, j; for (i = 0; i frame_len; i+) c = framei; for (j = 0; j 8; j+) treat = c & 0x80; c 8) & 0x80; wcrc 1）12倒数第3次启动的日期时间（如果启动次数2）12倒数第4次启动的日期时间（如果启动次数3）12倒数第5次启动的日期时间（如果启动次数=5）用于获得设备最后启动的日期和时间，以此判断设备的运行情况。4.19. 文件系统【dir】命令(61)帧类型：“61”的 ASCII 命令帧数据：无用于显示设备存储器中文件信息，类似于DOS系统的dir命令。返回帧数据格式：字节数描述不定长以文件名+空格+文件大小+，+n格式列举所有的文件信息4.20. 文件系统【delete】删除文件命令(65)帧类型：“65”的 ASCII 命令帧数据格式：字节数描述Max 12ASCII表示的文件名称，采用短文件名8+3结构1+的ASCII用于删除设备存储器中文件，类似于DOS系统的delete命令。返回帧数据格式：字节数描述10-命令执行成功，1-命令执行不成功如果文件删除成功则反馈0，文件不存在则反馈1。4.21. 文件系统初始化命令(67)帧类型：“67”的 ASCII 命令帧数据格式：字节数描述1F的ASCII1d的ASCII用于将设备中存储器格式化，使其能够正常文件操作，此过程根据存储器容量大小时间可能会比较长，约需要几十秒钟。返回帧数据格式：字节数描述10-命令执行成功，1-命令执行不成功如果文件系统初始化成功则反馈0，文件不存在则反馈1。4.22. 文件系统总空间和剩余空间命令(69)帧类型：“69”的 ASCII 命令帧数据：无用于或得设备存储器空间和剩余空间，便于上传文件管理。返回帧数据格式：字节数描述不定长ASCII表示的“总空间，剩余空间 ”4.23. 可变限速标志显示限速值(20)帧类型：“20”的 ASCII 命令帧数据格式：字节数描述3ASCII表示的限速值，范围“000”“205”，其它无效注：组帧时，将限速值转变成ASCII表示的数值，“000”“199”可以直接显示，200显示正在施工图片201显示前方车祸图片202显示注意安全图片203显示“雾”字204显示“慢”字205显示“停”字返回帧数据格式：字节数描述3ASCII表示的限速值，范围“000”“205”4.24. 获得可变限速标志当前限速值(21)帧类型：“21”的 ASCII 命令帧数据：无返回帧数据格式：字节数描述3ASCII表示的限速值，范围“000”“205”4.25. 可变限速标志参数整体设置(24)帧类型：“24”的 ASCII 命令帧数据格式：字节数描述3ASCII表示的限速值，范围“000”“205”，其它无效1限速值字体：0-Dutch801字体，1-黑体1红色外圈显示方式：0-不显示，1-固定显示外圈，2-外圈快速旋转，3-中速旋转，4-低速旋转1保留，不必关心1亮度调节方式，ASCII0-自动调光，1-手动调光2ASCII表示的亮度值，范围：0031，只有在手动调光模式此项才有用返回帧数据格式：字节数描述3ASCII表示的限速值，范围“000”“205”，其它无效1限速值字体：0-Dutch801字体，1-黑体1红色外圈显示方式：0-不显示，1-固定显示外圈，2-外圈快速旋转，3-中速旋转，4-低速旋转1保留，不必关心1亮度调节方式，ASCII0-自动调光，1-手动调光2ASCII表示的亮度值，范围：0031，只有在手动调光模式此项才有用4.26. 获得可变限速标志的温度、亮度、限速值等参数(57)帧类型：“57”的 ASCII 命令帧数据：无返回帧数据格式：字节数描述3ASCII表示的限速值，范围“000”“205”，其它无效1限速值字体：0-Dutch801字体，1-黑体1红色外圈显示方式：0-不显示，1-固定显示外圈，2-外圈快速旋转，3-中速旋转，4-低速旋转1保留，不必关心1亮度调节方式，ASCII0-自动调光，1-手动调光2ASCII表示的亮度值，范围：0031，只有在手动调光模式此项才有用2设备故障状态值，参见4.1.检测设备故障1设备温度值，范围-40+992设备检测到外界光线的参考值4.27. 其它设备（可变限速标志除外）除具备以上基本功能外，还支持用户自定义常用播放表，即设备已经内置一些常用的播放表，如“注意安全谨慎驾驶”、“请您系好安全带”等提示用语及常用图片如等，且能根据现场需要对播放表的文件名、文件内容等进行修改。5. 播放列表格式5.1. 表头playlist5.2. 播放动作数定义Item_No = XXX；XXX 为动作条数，范围 0-500，缺省为 0，为 0 时自动加上一条清屏命令。 5.3. 每条动作内容定义 ItemYYY = delay, transition, param, str； w YYY 为动作序号，依次从 0 至 (XXX-1)。 w delay 为动作执行完后的停留时间。单位为百分之一秒，范围 2-30000，缺省为 2。 w transition 为动作出现方式。范围 0-31，缺省为 0。 0: 清屏（全黑）1: 立即显示2: 上移3：下移4: 左移5: 右移6: 横百叶窗7: 竖百叶窗8: 上下合拢9: 上下展开10: 左右合拢11: 左右展开12: 中心合拢13: 中心展开25： 显示圆圈 （设备为可变限速标志时使用，默认为不显示圆圈） 30：滚屏显示(从右至左逐字显示) 当出字方式为 0 ， 1， 25 或 30 时，param 无用；当出字方式为 2-13 时，param 表速度，范围0-49，缺省为 0。其中 0 表示最快，即每幅画面停留 20 毫秒，param 每增加 1 停留时间就增加 20 毫秒。 w str 为此条动作所要显示的字符串，缺省为空串。字符串中可含有转义符，以字符 为标识。每个转义符的作用范围从其出现起开始至下一个同样的转义符出现止。 w 转义符定义 Cxxxyyy 图形或字符串显示的起始（左上角）坐标，xxx 和 yyy 的范围都是-99, 999，缺省值都是 0。注意可变情报板的左上角为原点，坐标值为 (0, 0)。 Bnnn 把当前目录下的 nnn.bmp 文件显示到 C 所规定的坐标。 Fnnnmm 把当前目录下的 nnn.flc 文件显示到 C 所规定的坐标，并循环播放 mm 遍，mm 的范围为 0-99。若 mm 为 0，则只显示 flic 动画的第一帧画面，而不是播放整个动画。 cRRRGGGBBBYYY 字符颜色，ct 为透明色，RRR、GGG、BBB、YYY 分别表示可变情报板红、绿、蓝、琥珀色像素管的亮度，范围为 0-255，缺省为 c255255000000（即黄色）。 bRRRGGGBBBYYY 字符背景颜色，bt 为透明色，RRR、GGG、BBB、YYY 的含义同上，缺省为 bt。 sRRRGGGBBBYYY 字符阴影颜色，st 为透明色，RRR、GGG、BBB、YYY 的含义同上，缺省为 st。 Sxx 字间距，xx 的范围为 -9, 99，缺省为 0。 fnHHWW 字体，n 为字体名称，常用的有： h 表黑体、 k 表楷体；s 宋体，f仿宋,HH 为字体高度，WW 为字体宽度，HH、WW 的范围都是 1- 64。 n 换行，即 C 中的 xxx 不变，yyy 加上 f 中的 HH。 表示字符 。 w 注意事项1）播放表中除转义符外，均大小写无关。 2）播放表的每一行都不得超过 1024 个字符，否则将自动截去超过的部分；对每条ItemYYY 来说，第三个逗号后的空格及一行最后的空格都将被滤去，不包括在str 中。 3）str 中若有转义符不符合规定，则将其当普通字符处理。 4）str 中若已有合乎规定的 F 转义，则后面的 F 转义当普通字符处理。 5）当出字方式为 0 时，str 无用；当出字方式为 20 或 21 时，str 中只有 N 和r 转义有用。 6）当出字方式为 18 或 19 时