炫蓝光计数计时LED控制卡升级和二次开发协议说明和举例

时计数控制卡通讯协议  v0.0
：协议中出现的普通数字，默认为 ASCII 码。如 1 代表 0x31。以 0x 开头的数字代表 16
进制数。
一，概述
1，  TF-CNT -x 系列控制卡可实现计时及计数功能，可通过外部按键、串口指令启动、停止
计时及控制计数值。
2，  控制卡最多可支持 8 个计数区、8 个计时区及 8 个自定义区，每组计数或计时占用控制
卡一个分区，每个分区使用一个序号来作为唯一标志。一个节目中的分区总数最多支持
16 个。
3，  秒表计时功能支持正、倒计时。支持开始、暂停、复位。正计时最大计时范围为 200 万
秒，可选按时、分、秒、百分之一秒等显示。可通过软件设置初始时间(最大 65535 秒)。
4，  计数功能支持增减调节及直接设置数值。有效范围正负 20 亿，可设置是否允许负数。
二，指令构成
[头部][屏 ID ][指令代码][指令范围][分隔符][指令内容]  [校验]
指令结构  长度  值含义
[头部]  2  固定为*#，所有指令必须以此 2 个字符开头
[屏 ID ]  1  默认为1，只有屏 ID 和控制卡实际 ID 相符才会执行指令。(0 为广播)
[指令代码]  4  详见第三部分指令描述
[指令范围]  0～8  要执行该指令的分区序号，允许输入多个，节目点播指令不需要该字段。
[分隔符]  0～1  固定为字符英文逗号，节目点播指令不需要该字段。
[指令内容]  变长  详见第三部分指令描述，部分指令没有指令内容。
[校验]  4  指令包中除校验码和结束标志之外的数据以 8bit 无符号数方式相加，并用
0xFFFF 减去相加之和，得到的 16bit 数。如 0x3A0 填为 03A0。
如果不要求高可靠性，可在发送指令时，直接将校验字节填充为 0，则控制卡
不会执行校验。
三，具体指令描述
：在以下指令描述中，仅描述指令代码和指令内容部分。示例包默认控制卡 ID 为 1
1，  时开始  TIMS
指令没有具体内容。
示例包：*#1TIMS12,FDB5
示例包解析：*#是指令头部；1 是屏 ID；TIMS 是开始计时指令；12,是分区序号及分隔
符；FDB5 是校验码(0x024A)；
示例包效果：序号为“1”和“2”的计时区开始计时。
2，  时暂停  TIMP
指令没有具体内容。
示例包：*#1TIMP1,0000
示例包解析：*#是指令头部；1 是屏 ID；TIMP 是暂停计时指令；1,是分区序号及分隔
符；0000 是校验码(不执行校验)；
示例包效果：序号为 1 的计时区暂停计时。
3，  时复位  TIMR
指令没有具体内容。
示例包：*#1TIMR1,0000  （序号为 1 的计时区停止计时，计时值恢复初始值）
4，  设置计数值  CNTS
指令内容格式:
字节 0: 设置方式 A=计数增加；D=计数减小；S=直接设置计数指
字节 1～n:要增减或设置的值.
字节 n+1:分隔符，固定为英文逗号
示例包：*#1CNTS12,A10,0000  （序号为 1、2 的计数区计数值增加 10）
示例包：*#1CNTS1,S2000,0000  （序号为 1 的计数区直接设置为 2000）
5，  设置 RAM 区文本内容    RAMT
指令内容格式:
字节 0:颜色1=红色;2=绿色;3=黄色
字节 1:字体大小 0=5x7;1=6x12;2=8x16;3=16x32;4=24x48;
字节 2:水平对齐方式 0=靠左；1=居中；2=靠右(要显示的文字超过一行时不起作用)
字节 3:垂直对齐方式0=靠上；1=居中；2=靠下(要显示的文字超过一行时不起作用)
字节 4~n:显示内容， 注意只支持标准 ASCII 码英文符号及字母， 不支持其他语言。 内容
不可超过 1 屏，超出将截断。
示例包：*#1RAMT1,3120Sample T ext0000
效果：序号为 1 的 RAM 区显示内容 Sample  T ext，字体为 6x12，颜色黄色，对齐方式
为靠右上
6，  定位节目  PRGC
指令内容格式:
字节 0: 定位方式 1=播放前一条；2=播放下一条；3=直接定位到指定的节目
字节 1～n:定位节目时需要播放的节目序号.
字节 n+1:分隔符，固定为英文逗号
注：定位节目时，节目序号从 0 开始计。即第一个节目的序号为 0，第二个为 1......
示例包：*#1PRGC10000  （播放下一个节目）
示例包：*#1PRGC35,0000  （播放第 6 个节目）
四，指令返回
1，如果发送的指令头部异常、ID 不符、或者校验码错误，均直接丢弃，控制卡无返回。
2，如果发送的指令能正常解析，将返回格式为“# 1E00”的数据包.  其中的 1 是屏 ID，E00
代表错误代码，具体的错误代码含义：
错误码  含义
00  执行成功
04  指令参数错误，如分区序号超过 8 等
05  指令基本结构异常
06  执行失败，如点播节目时，输入的节目序号超出范围等
0A  指令长度异常，不符合基本规则
3，在发送指令修改计时或计数值时，即使要设置的分区未显示，也会返回成功。即：假设
录入的分区序号为 1，但是设置序号为 2 的计数值，仍然会设置成功。但是屏幕显示不会有
变化。
4，如果发送时屏 ID 为 0，则为群发，所有连在同一条线上屏都将处理该指令，但只有 ID
为 1 的屏才会回复执行结果。
五，适用范围及其它
1，  本协议适用于深圳炫蓝光科技任意分区 LED 控制卡，必须使用固件版本大于 0.73 的控
制卡， 配合版本大于 2.73 节目编辑软件才能正常使用， 不同型号的控制卡对计时计数功
能的支持情况不同，具体请参照下表。
卡系列  支持的情况  型号举例
小卡  不支持  TF-AU，TF-S5U，TF-MU，TF-M2 等
大卡  支持 1 组  TF-M3U, TF-M5NUR,  TF-EU 等
专用卡  支持 8 组  TF-CNT -D, TF-CNT -F
2，  关电后卡中的计数值会归 0，如果将“用户数据 2”的 BIT0 改为 1，则会记住前 4 个计
数区的值，关电不会丢失。
3，  发送指令时，多个数据包之间的间隔不得小于 100ms。同一个数据包中每个字节之间的
间的不得超过 10ms
4，  因器件误差及指令接收延时， 控制卡计时功能中的时间值仅作参考， 不可作为工业用途。