文档介绍:
:(注,文档中灰色背景部分是修改前的原始内容 )
通讯波特率:57600, 8,N, 1
约定:
1,如未特别说明,所有出现的数字(如: 86、0x5A)均指二进制数字,而不
是ASCII码。
2,协议中所有长度大于 8bit的数字,均以小端格式存储(低字节在前,高 字节在后。)
第一部分:发送信息包总格式
所有下发的指令信息包,都符合如下所述的指令格式:
[16字节信息头部]+[32字节指令参数]+[指令扩展内容]+[4字节信息尾部]
信息头:
字节0: 信息头,固定0xA0
字节1-2 :整个信息包长度,低字节在前,高字节在后。
字节3-4 : 16bit屏ID,低字节在前,高字节在后, 0x0000代表广播信息
字节5-8 :流水号低32位,作为指令的临时唯一标识,服务器端可以以此 ID作为指令
的唯一标识。
字节9-12:流水号高32位,低字节在前,高字节在后。 (该字段暂时保留)
字节13:具体指令代码。详见第三部分具体描述。 (在终端回馈包中,该字段用于表示
错误代码)
字节14-15 :保留,填充为0.
指令参数:变长,至少32字节,少于32字节的用零填充到 32字节。具体含义详见第 三部分具体指令描述
指令扩展内容:可选段,最多1024字节,如果发送的指令不需要展信息,则没有该段。 信息尾部:
字节0-1 : 16bit校验和,将本字节之前所有字节相加,取低 16位。
字节2:保留
字节3: 1字节信息结束标志,固定为 0x50
注,每条指令总长度不超过 16+32+1024+4 = 1076字节,每条指令最短 16+32+4 = 52字节。
第二部分,终端回馈信息包总格式
所有回馈的信息包,均符合如下所述的格式:
[终端回馈包格式和下行包格式相同,只是将包头标志改为" 0xAF ”,结束标志改为
“0x5F ”。执行结果通过“指令代码”字段返回。具体错误代码参照 备注1.
注1, 除非特别说明,否则回馈信息一般不超过 52字节)
注2, 对于群发信息,无论执行成功于否,终端都不会返回
第三部分,具体指令代码描述
0x01 / 0x03、发送信息指令: (注:0x01为历史遗留指令,已经废除)
[信息头部(指令代码=0x03)] + [32字节选项块]+[信息内容]+[信息尾部]
信息头部:已在第一部分描述,以后不再列举。
选项块:
字节0-1 :信息序号:低字节在前,高字节在后,从 1开始,上限取决于控制板类型,
信息的序号就是信息存放的位置。播放时将按照序号从小到大轮流播放。
字节2:动画方式
0x00-随机
0x01-立刻显示
0x02-左移,
0x03-右移,
0x04-上移
0x05-下移,
0x06-从左向右展开,
0x07-从上向下展开,
0x08-从中间向2边展开,
0x09-水平百叶窗,
0x0A-垂直百叶窗
0x0B-上下交叉对进
0x0C-左右交叉对展
0x0D-连续左移(走马灯)
0x0E-菱形扩散
0x0F-斜向下移
0x10-斜向左展
0x11-马赛克
0x12-下雨
字节3:停留方式,低4位代表信息停留时是否闪烁 0x0-不闪烁,0x1-亮灭闪,0x2-反 白闪。【注:分区卡暂不支持停留闪】。高4位代表信息播放时是否伴随“环绕边框” ,bit4 :
是否有环绕边框(仁有,0=没有);bit5 : 4点环绕还是单点环绕(1=4点,0=单点);bit6:环 绕速度(1=慢速,0=快速)。注意:只有单色屏支持 4点的环绕边框。
0x1-有环绕闪烁,0x0-无环绕闪烁
字节4:移动速度和级别,低 4bit代表移动速度0x0-0xF,数字越大越快。高 4bit代表 速度级别,有效范围 0x1-0xF数字越大越慢。
字节5:页面停留时间:0x00-0xFF,秒数。比如屏幕可以显示 8个字,当前信息有 16
个字,那么前8个字移动完毕后,可以选择在屏幕上停留一会儿再显示后 8个字。(注意,
如果是位图信息,此字段的单位是 1/4秒),如果为0xFF,则一直显示,不再切换到下一条
信息。
字节6:闪烁间隔,有效范围 0x02-0xFF,秒数。指“亮灭闪”或“反白闪”闪烁的间
隔。间隔至少2秒。如果字节 3停留方式=0,则该字段被忽略。只有停留时间大于 2秒,
闪烁效果才能出来。
0)
字节7:连播次数,范围OxO1-OxFF , 0=1次、1=2次…,每条信息加载后,连续播放够
指定的次数,才加载下一条信息。
字节8-15:起播时间段,格式:[日][月][年][OxOO][秒][分][时][O