炫藍光計數(shù)計時LED控制卡升級和二次開發(fā)協(xié)議說明和舉例

時計數(shù)控制卡通訊協(xié)議  v0.0
：協(xié)議中出現(xiàn)的普通數(shù)字，默認(rèn)為 ASCII 碼。如 1 代表 0x31。以 0x 開頭的數(shù)字代表 16
進制數(shù)。
一，概述
1，  TF-CNT -x 系列控制卡可實現(xiàn)計時及計數(shù)功能，可通過外部按鍵、串口指令啟動、停止
計時及控制計數(shù)值。
2，  控制卡最多可支持 8 個計數(shù)區(qū)、8 個計時區(qū)及 8 個自定義區(qū)，每組計數(shù)或計時占用控制
卡一個分區(qū)，每個分區(qū)使用一個序號來作為唯一標(biāo)志。一個節(jié)目中的分區(qū)總數(shù)最多支持
16 個。
3，  秒表計時功能支持正、倒計時。支持開始、暫停、復(fù)位。正計時最大計時范圍為 200 萬
秒，可選按時、分、秒、百分之一秒等顯示?？赏ㄟ^軟件設(shè)置初始時間(最大 65535 秒)。
4，  計數(shù)功能支持增減調(diào)節(jié)及直接設(shè)置數(shù)值。有效范圍正負 20 億，可設(shè)置是否允許負數(shù)。
二，指令構(gòu)成
[頭部][屏 ID ][指令代碼][指令范圍][分隔符][指令內(nèi)容]  [校驗]
指令結(jié)構(gòu)  長度  值含義
[頭部]  2  固定為*#，所有指令必須以此 2 個字符開頭
[屏 ID ]  1  默認(rèn)為1，只有屏 ID 和控制卡實際 ID 相符才會執(zhí)行指令。(0 為廣播)
[指令代碼]  4  詳見第三部分指令描述
[指令范圍]  0～8  要執(zhí)行該指令的分區(qū)序號，允許輸入多個，節(jié)目點播指令不需要該字段。
[分隔符]  0～1  固定為字符英文逗號，節(jié)目點播指令不需要該字段。
[指令內(nèi)容]  變長  詳見第三部分指令描述，部分指令沒有指令內(nèi)容。
[校驗]  4  指令包中除校驗碼和結(jié)束標(biāo)志之外的數(shù)據(jù)以 8bit 無符號數(shù)方式相加，并用
0xFFFF 減去相加之和，得到的 16bit 數(shù)。如 0x3A0 填為 03A0。
如果不要求高可靠性，可在發(fā)送指令時，直接將校驗字節(jié)填充為 0，則控制卡
不會執(zhí)行校驗。
三，具體指令描述
：在以下指令描述中，僅描述指令代碼和指令內(nèi)容部分。示例包默認(rèn)控制卡 ID 為 1
1，  時開始  TIMS
指令沒有具體內(nèi)容。
示例包：*#1TIMS12,FDB5
示例包解析：*#是指令頭部；1 是屏 ID；TIMS 是開始計時指令；12,是分區(qū)序號及分隔
符；FDB5 是校驗碼(0x024A)；
示例包效果：序號為“1”和“2”的計時區(qū)開始計時。
2，  時暫停  TIMP
指令沒有具體內(nèi)容。
示例包：*#1TIMP1,0000
示例包解析：*#是指令頭部；1 是屏 ID；TIMP 是暫停計時指令；1,是分區(qū)序號及分隔
符；0000 是校驗碼(不執(zhí)行校驗)；
示例包效果：序號為 1 的計時區(qū)暫停計時。
3，  時復(fù)位  TIMR
指令沒有具體內(nèi)容。
示例包：*#1TIMR1,0000  （序號為 1 的計時區(qū)停止計時，計時值恢復(fù)初始值）
4，  設(shè)置計數(shù)值  CNTS
指令內(nèi)容格式:
字節(jié) 0: 設(shè)置方式 A=計數(shù)增加；D=計數(shù)減小；S=直接設(shè)置計數(shù)指
字節(jié) 1～n:要增減或設(shè)置的值.
字節(jié) n+1:分隔符，固定為英文逗號
示例包：*#1CNTS12,A10,0000  （序號為 1、2 的計數(shù)區(qū)計數(shù)值增加 10）
示例包：*#1CNTS1,S2000,0000  （序號為 1 的計數(shù)區(qū)直接設(shè)置為 2000）
5，  設(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 屏，超出將截斷。
示例包：*#1RAMT1,3120Sample T ext0000
效果：序號為 1 的 RAM 區(qū)顯示內(nèi)容 Sample  T ext，字體為 6x12，顏色黃色，對齊方式
為靠右上
6，  定位節(jié)目  PRGC
指令內(nèi)容格式:
字節(jié) 0: 定位方式 1=播放前一條；2=播放下一條；3=直接定位到指定的節(jié)目
字節(jié) 1～n:定位節(jié)目時需要播放的節(jié)目序號.
字節(jié) n+1:分隔符，固定為英文逗號
注：定位節(jié)目時，節(jié)目序號從 0 開始計。即第一個節(jié)目的序號為 0，第二個為 1......
示例包：*#1PRGC10000  （播放下一個節(jié)目）
示例包：*#1PRGC35,0000  （播放第 6 個節(jié)目）
四，指令返回
1，如果發(fā)送的指令頭部異常、ID 不符、或者校驗碼錯誤，均直接丟棄，控制卡無返回。
2，如果發(fā)送的指令能正常解析，將返回格式為“# 1E00”的數(shù)據(jù)包.  其中的 1 是屏 ID，E00
代表錯誤代碼，具體的錯誤代碼含義：
錯誤碼  含義
00  執(zhí)行成功
04  指令參數(shù)錯誤，如分區(qū)序號超過 8 等
05  指令基本結(jié)構(gòu)異常
06  執(zhí)行失敗，如點播節(jié)目時，輸入的節(jié)目序號超出范圍等
0A  指令長度異常，不符合基本規(guī)則
3，在發(fā)送指令修改計時或計數(shù)值時，即使要設(shè)置的分區(qū)未顯示，也會返回成功。即：假設(shè)
錄入的分區(qū)序號為 1，但是設(shè)置序號為 2 的計數(shù)值，仍然會設(shè)置成功。但是屏幕顯示不會有
變化。
4，如果發(fā)送時屏 ID 為 0，則為群發(fā)，所有連在同一條線上屏都將處理該指令，但只有 ID
為 1 的屏才會回復(fù)執(zhí)行結(jié)果。
五，適用范圍及其它
1，  本協(xié)議適用于深圳炫藍光科技任意分區(qū) LED 控制卡，必須使用固件版本大于 0.73 的控
制卡， 配合版本大于 2.73 節(jié)目編輯軟件才能正常使用， 不同型號的控制卡對計時計數(shù)功
能的支持情況不同，具體請參照下表。
卡系列  支持的情況  型號舉例
小卡  不支持  TF-AU，TF-S5U，TF-MU，TF-M2 等
大卡  支持 1 組  TF-M3U, TF-M5NUR,  TF-EU 等
專用卡  支持 8 組  TF-CNT -D, TF-CNT -F
2，  關(guān)電后卡中的計數(shù)值會歸 0，如果將“用戶數(shù)據(jù) 2”的 BIT0 改為 1，則會記住前 4 個計
數(shù)區(qū)的值，關(guān)電不會丟失。
3，  發(fā)送指令時，多個數(shù)據(jù)包之間的間隔不得小于 100ms。同一個數(shù)據(jù)包中每個字節(jié)之間的
間的不得超過 10ms
4，  因器件誤差及指令接收延時， 控制卡計時功能中的時間值僅作參考， 不可作為工業(yè)用途。