炫藍(lán)光控制卡所有六代卡開發(fā)協(xié)議，RAM區(qū)更新內(nèi)容可供二次開發(fā)協(xié)議

1， 指令結(jié)構(gòu)

[頭部]  [屏ID ]  [指令代碼]  [指令范圍]  [分隔符]  [指令內(nèi)容]  [校驗(yàn)

指令結(jié)構(gòu)	長度	值含義
[頭部	2	固定為*#，所有指令必須以此2個字符開頭
[屏	1	默認(rèn)為 1，只有屏ID和控制卡實(shí)際ID相符才會執(zhí)行指令。(0為廣播)
[指令代碼	4	詳見第二部分指令描述
[指令范圍	0～8	要執(zhí)行該指令的分區(qū)序號，允許輸入多個，節(jié)目點(diǎn)播指令不需要該字段。
[分隔符	0～1	固定為字符英文逗號，節(jié)目點(diǎn)播指令不需要該字段。
[指令內(nèi)容	變長	詳見第2部分指令描述，部分指令沒有指令內(nèi)容。
[校驗(yàn)	4	指令包中除校驗(yàn)碼和結(jié)束標(biāo)志之外的數(shù)據(jù)以8bit無符號數(shù)方式相加，并用0xFFFF減去相加之和，得到的16bit數(shù)。如0x3A0填為03A0。 如果不要求高可靠性，可在發(fā)送指令時，直接將校驗(yàn)字節(jié)填充為0，則控制卡不會執(zhí)行校驗(yàn)。

2， 設(shè)置RAM區(qū)文本內(nèi)容  RAMT

指令內(nèi)容格式:

字節(jié)0:顏色 1=紅色;2=綠色;3=黃色

字節(jié)1:字體大小0=5x7;1=6x12;2=8x16;3=16x32;4=24x48;

字節(jié)2:水平對齊方式0=靠左；1=居中；2=靠右 (要顯示的文字超過一行時不起作用)

字節(jié)3:垂直對齊方式 0=靠上；1=居中；2=靠下(要顯示的文字超過一行時不起作用)

字節(jié)4~n:顯示內(nèi)容，注意只支持標(biāo)準(zhǔn)ASCII碼英文符號及字母，不支持其他語言。內(nèi)容不可超過1屏，超出將截?cái)唷?/div>

示例包：*#1RAMT1,3120Sample Text0000  

效果：序號為1的RAM區(qū)顯示內(nèi)容Sample Text，字體為6x12，顏色黃色，對齊方式為靠右上

操作步驟：

1、 打開PowerlLed軟件（版本為2.73或以上），正常連接控制卡，設(shè)置好屏參，進(jìn)入菜單欄：編輯——添加特殊區(qū)——自定義區(qū)，如下圖，

注意：自定義區(qū)只能顯示字母或數(shù)字，不能顯示中文；且只能顯示一屏內(nèi)容，直接顯示，無任何特技

其他固定的要顯示的中文，可以添加一個文本，固定顯示，這些頻繁更新的字母或數(shù)字顯示在自定義區(qū)，即可 如下圖：

  

2、 打開串口調(diào)試助手，發(fā)送上述示例包：如下圖所示

點(diǎn)擊發(fā)送，正常返回“# 1E00”

指令返回

1，如果發(fā)送的指令頭部異常、ID不符、或者校驗(yàn)碼錯誤，均直接丟棄，控制卡無返回。

2，如果發(fā)送的指令能正常解析，將返回格式為“# 1E00”的數(shù)據(jù)包. 其中的1是屏ID，E00代表錯誤代碼，具體的錯誤代碼含義：

錯誤碼	含義
00	執(zhí)行成功
04	指令參數(shù)錯誤，如分區(qū)序號超過8等
05	指令基本結(jié)構(gòu)異常
06	執(zhí)行失敗，如點(diǎn)播節(jié)目時，輸入的節(jié)目序號超出范圍等
0A	指令長度異常，不符合基本規(guī)則

適用范圍及其它

1， 本協(xié)議適用于深圳炫藍(lán)光科技任意分區(qū)LED控制卡，必須使用固件版本大于0.73的控制卡，配合版本大于2.73節(jié)目編輯軟件才能正常使用，不同型號的控制卡對計(jì)時計(jì)數(shù)功能的支持情況不同，具體請參照下表。

卡系列	功能	型號舉例
小卡	不支持	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， 關(guān)電后卡中的計(jì)數(shù)值會歸0，如果將“用戶數(shù)據(jù)2”的BIT0改為1，則會記住前4個計(jì)數(shù)區(qū)的值，關(guān)電不會丟失。

3， 發(fā)送指令時，多個數(shù)據(jù)包之間的間隔不得小于100ms。同一個數(shù)據(jù)包中每個字節(jié)之間的間的不得超過10ms

因器件差及指令接收延時，控制卡計(jì)時功能中的時間值僅作參考，不可作為工業(yè)用途