炫蓝光控制卡所有六代卡开发协议，RAM区更新内容可供二次开发协议

1， 指令结构

[头部]  [屏ID ]  [指令代码]  [指令范围]  [分隔符]  [指令内容]  [校验

指令结构	长度	值含义
[头部	2	固定为*#，所有指令必须以此2个字符开头
[屏	1	默认为 1，只有屏ID和控制卡实际ID相符才会执行指令。(0为广播)
[指令代码	4	详见第二部分指令描述
[指令范围	0～8	要执行该指令的分区序号，允许输入多个，节目点播指令不需要该字段。
[分隔符	0～1	固定为字符英文逗号，节目点播指令不需要该字段。
[指令内容	变长	详见第2部分指令描述，部分指令没有指令内容。
[校验	4	指令包中除校验码和结束标志之外的数据以8bit无符号数方式相加，并用0xFFFF减去相加之和，得到的16bit数。如0x3A0填为03A0。 如果不要求高可靠性，可在发送指令时，直接将校验字节填充为0，则控制卡不会执行校验。

2， 设置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 Text0000  

效果：序号为1的RAM区显示内容Sample Text，字体为6x12，颜色黄色，对齐方式为靠右上

操作步骤：

1、 打开PowerlLed软件（版本为2.73或以上），正常连接控制卡，设置好屏参，进入菜单栏：编辑——添加特殊区——自定义区，如下图，

注意：自定义区只能显示字母或数字，不能显示中文；且只能显示一屏内容，直接显示，无任何特技

其他固定的要显示的中文，可以添加一个文本，固定显示，这些频繁更新的字母或数字显示在自定义区，即可 如下图：

  

2、 打开串口调试助手，发送上述示例包：如下图所示

点击发送，正常返回“# 1E00”

指令返回

1，如果发送的指令头部异常、ID不符、或者校验码错误，均直接丢弃，控制卡无返回。

2，如果发送的指令能正常解析，将返回格式为“# 1E00”的数据包. 其中的1是屏ID，E00代表错误代码，具体的错误代码含义：

错误码	含义
00	执行成功
04	指令参数错误，如分区序号超过8等
05	指令基本结构异常
06	执行失败，如点播节目时，输入的节目序号超出范围等
0A	指令长度异常，不符合基本规则

适用范围及其它

1， 本协议适用于深圳炫蓝光科技任意分区LED控制卡，必须使用固件版本大于0.73的控制卡，配合版本大于2.73节目编辑软件才能正常使用，不同型号的控制卡对计时计数功能的支持情况不同，具体请参照下表。

卡系列	功能	型号举例
小卡	不支持	TF-SU,TF-S5U,TF-S5UR,TF-AU,TF-A5U,TF-A5UR,TF-M2,TF-MU S5H,A5H，
大卡	支持1组	TF-M5NUR, TF-M3U, TF-C3U，TF-C5NUR，TF-D3U，TF-E3U，TF-FU，TF-FNU  WIFI系列支持SW以上所有卡
专用卡	支持8组	TF-CNT-D, TF-CNT-F

2， 关电后卡中的计数值会归0，如果将“用户数据2”的BIT0改为1，则会记住前4个计数区的值，关电不会丢失。

3， 发送指令时，多个数据包之间的间隔不得小于100ms。同一个数据包中每个字节之间的间的不得超过10ms

因器件差及指令接收延时，控制卡计时功能中的时间值仅作参考，不可作为工业用途