炫蓝光计数计时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 区显示内容 SampleT 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，因器件误差及指令接收延时， 控制卡计时功能中的时间值仅作参考， 不可作为工业用途。
页:
[1]