TF-GSM协议_1.0.doc

1、TF-GSM 卡通讯协议版本记录：日期 版本 说明2011-08-04 V1.0 初版说明：1，协议描述中所有的数字，均以 0x 开头。2，没有以 0x 开头的所有字符（如：86、AB）均是字母。一， 发送信息指令格式1，简化发送：*#1(固定 3 字符) + A(固定 1 字符) + 信息序号(3 字) + 内容( 最多 63 字符)-信息序号有效范围为：000-399 ，总共可存储 400 条信息-本指令替代序号处的原有内容。信息按照默认选项显示( 速度=3、特技= 连续左移、分区=0，字库=自动根据 0 号分区的高度选择，颜色= 黄)例：*#1A000 欢迎使用 GSM 短信卡，现在更新

2、的信息 ID 为 0002，普通发送：*#1(固定 3 字符) + B(固定 1 字符) + 信息 ID (3 字) +追加总数(1 字符) + 显示特技(1 字) + 速度(1 字) + 停留时间(1 字) + 内容(最多 59 字符)-追加总数代表本条信息后续还要追加几次才完整，等于 0 时表示不需要追加。整条信 息只有追加完毕后才开始显示，追加总数的有效范围为 0-2，一条信息最多可再追加 2 次，一条信息最多可存储 230 个汉字，如果超过将被截断-如果追加总数为 A，则忽略具体内容，将指定位置的信息更新为一个表盘信息-如果追加总数为 B，则忽略具体内容，将指定位置的信息更新为一个数字

3、时钟-特技有效范围：数字 0-9，小写字母 a-z，大写字母 A-I，具体含义请参照附表-其余选项按照默认值(速度=3、字库=自动，颜色=黄)13017461692例 1：*#1B0020863 这里是第 001 条信息，特技=下雨，速度=2，停留时间=1例 2：*#1B001A008 (停留 8 秒的表盘信息)3，追加内容*#1(固定 3 字符) + C(固定 1 字符) + 信息 ID(3 字符) + 追加序号(1 字符) +内容(最多 62 字符)-追加序号，代表第几次追加，值只能为 1 或者 2.分 2 次发送的例子（追加 1 次）：1，主信息：*#1B0021210 美国时间 9 月

4、 24 日凌晨 3 时 16 分，美国宇航局证实报废的“高层大气研究卫星”于2，后续追加：*#1C0021 美东时间 23 日晚 11 时 23 分至 24 日凌晨 1 时零 9 分之间坠落大气层。4，完整发送*#1(固定 3 字符) + E(固定 1 字符) + 信息 ID (3 字) +追加总数(1 字符) + 显示特技(1 字) + 速度(1 字 ) + 停留时间(1 字) + 颜色(1 字) + 附加标志(1 字) + 字库类型 (1 字) + 边框类型(1 字) + 内容(最多 55 字符)例 1（不用追加）：*#1E00202101001 核心提示：据英媒称，意大利政府正在向中国求

5、援，希望中国购买“相当大数量 “的意大利国债以帮助意大利早日走出金融危机。例 2：需要追加 2 次的信息：主信息：*#1E00322301000 按广州市废弃食用油脂管理办法(征求意见稿) 规定，如果餐厅、食品生产企业在食品生产中使用废弃食用第一次追加：*#1C0031 油脂加工食用油脂或者生产加工食品，食品经营单位如果销售用废弃食用油脂加工生产的食品，违法经营的食品货如果不足 1 万元， 第二次追加：*#1C0032 处 2000-50000 元的罚款；如果货值金额超 1 万元，处罚金额则为 5-10 倍，情节严重的可吊销许可证。例 3(时间信息)：*#1E000B0081103 （注：此信

6、息显示在分区 1 中，只有在分两个区时，才能显示出来）二， 格式说明1， “*#1”：此为固定存在，每条合法的指令必须以这 3 个字母开头，否则被丢弃2， “信息 ID” ：有效范围 000-399，代表具体位置，最多可存 400 条信息3， “追加总数”：0=不追加。1-2 代表信息需要追加 1 或 2 次才完整。A/B 代表时间信息4， “显示特技” ：有效范围: 数字 0-9，小写字母 a-z，大写字母 A-I，具体含义请参照附表5， “速度” ：0-9，数字越大越慢6， “停留时间” ：0-9-X ，0-9 代表 0-9 秒，A=10 秒，B=15 秒，C=20 秒以此类推(字母从 1

7、0 秒开始，每个递增 5 秒)，最大为 X。 Y、Z 代表永久停留，只适用于特殊信息，请勿随便使用7， “颜色” ：1=红色，2= 绿色，3= 黄色7， “附加标志” ：对于分区卡，代表本信息显示在哪个分区8， “字库类型” ：对于 GSM-B21 型：1=16 点阵，2=32 点阵，3=48 点阵，4=64 点阵。对于 GSM-A21 型：1=16 点宋体，2=32 点宋体，3=16 点黑体，4=32 点黑体9， “边框类型” ：0=无边框，1-6=普通红色边框，7-c= 中速边框.( 见附表)三， 其他指令格式查询卡类型及版本：*#1(固定 3 字) + FVER(固定 4 字) 按照如下

8、格式返回卡类型及版本：VER:TF-GSM-A21 V0.0.1删除一条信息：*#1(固定 3 字) + GDEL(固定 4 字) + 信息 ID(3 字)删除全部信息：*#1(固定 3 字) + HALL(固定 4 字) + 999(固定 3 字)校时：*#1(固定 3 字) + ITIM(固定 4 字) + 年月日时分秒星期（15 字）- 如：201107181301385 代表 2011 年 7 月 18 日 13 时 01 分 38 秒星期五手动调亮度：*#1(固定 3 字) + JLIT(固定 4 字) + 亮度(1 字)- 亮度： 0-F，共 16 级亮度，0-9 代表 0 到 9

9、 级，A-F 代表 10-15 级，数字越大越亮 例：*#1JLIT5 设置亮度为 5 级例：*#1JLITF 设置亮度为最亮定时调亮度*#1(固定 3 字) + JLIA( 固定 4 字) + 定时段数(1 字) + :(英文冒号) + 定时数据(最多 4 个)- 定时段数：有效范围 1-4，最多允许分 4 个时间段定时调亮度。- 定时数据格式： “S,E,L|”,s=起始小时，e=结束小时，L=亮度值，每个段后面用英文竖线结尾。例子：*#1JLIA3:0,6,5|7,17,F|18,23,5| 含义为：00:00-06:59 亮度值为 507:00-17:59 亮度值为 F(最亮)18:0

10、0-23:59 亮度值为 5如果处于没有指定的时间段，则亮度默认为 F 最亮。如果设置的时间段有重叠，则在前的优先生效。注意：屏幕同一时间只能处于手动和定时两种模式中的一种。手动屏幕开关：*#1(固定 3 字) + KSLP(固定 4 字) + 开关状态(3 字)- 开关状态：000= 黑屏关机， 001=开机定时屏幕关机*#1(固定 3 字) + KSLA(固定 4 字) + 定时段数(1 字) + :(英文冒号) + 定时数据(最多 4个)- 定时段数：有效范围 1-4，最多允许分 4 个时间段设定关机时段。- 定时数据格式：“SH:SM,EH:EM| ”,sh=起始小时，sm=起始分钟，

11、eh=结束小时，em=结束分钟，每个段后面用英文竖线结尾。例子：*#1KSLA2:0:00,6:00|22:00,23:59|含义为：00:00-06:00 屏幕关机22:00-23:59 屏幕关机其余时间段，屏幕开机。注意：屏幕同一时间只能处于手动和定时两种模式中的一种。屏参设置：*#1(固定 3 字) + LSET(固定 4 字) + 屏宽点数(4 字 ) + x(小写,固定存在) + 屏高点数(3 字) + ,(固定存在) + 颜色类型(1 字 ) + 数据极性(1 字) + OE极性(1 字) + 扫描方式(2 字) + 行顺序(1 字) 扫描方式含义：00=16 扫(室内常规) ，4

12、1=4 扫(P10 单红常规)例：*#1LSET0128x016,101410 设置为 8 字条屏(128 点*16 点)，P10 单红扫描方式(4.1)，数据极性=0 ，OE 极性=1例：*#1LSET0128x016,200000 设置为 8 字条屏，室内 16 扫，数据和 OE 均为低分区设置：*#1(固定 3 字) + MZON(固定 4 字) + 分区数(1 字) + :(英文冒号，必须有) + 分区数据- 分区数：有效范围 1-4，最少要分一个区，最多允许分 4 个区。- 分区数据：格式为“x,y,w,h|” ，x=左起，y= 上起，w=宽度，h=高度，中间用英文逗号分隔。要分几个

13、区，就要有几个这样的数据格段，每个格式段必须有一个竖线结尾。例子，分左右 2 个区：*#1MZON2:0,0,64,16|64,0,64,16| 快速分区 1：*#1(固定 3 字) + NZAA(固定 4 字) + 标记(2 字)- 将显示屏分为 2 个分区，分区 1 在左，固定为正方形(适合显示表盘)。分区 0 在右，占用显示屏剩余大小(适合显示文字 )。- 标记第一个字符如果为“1” ，则在设置完分区后，会自动清除原有所有信息。- 标记第二字符如果为 “1”，指令成功后，将自动在 ID 为 000 的位置插入一条属于分区 1 的表盘信息。例：*#1NZAA11快速分区 2：*#1(固定

14、3 字) + NZAB(固定 4 字) + 标记(2 字)- 将显示屏分为 2 个分区，分区 1 在左，固定为 64 点宽 (适合显示文字时间)。分区 0在右，占用显示屏剩余大小(适合显示普通内容) 。- 标记第一个字符如果为“1” ，则在设置完分区后，会自动清除原有所有信息。- 标记第二个字符如果为 “1”，指令成功后，将自动在 ID 为 000 的位置插入一条属于分区 1 的文字时间信息。分区复位：*#1(固定 3 字) + OZRS(固定 4 字) - 复位后分区将设置为 1 个分区，默认整屏大小。分区复位：*#1(固定 3 字) + OPNL(固定 4 字) 设置回显等级*#1(固定

15、3 字) + PECH(固定 4 字) + 回显等级(1 字) +蜂鸣器标志(1 字)- 回显等级：(仅影响短信，使用串口通讯时，所有指令均会返回)0=不回显任何命令，即使发送回读指令，控制卡也不返回任何字符1=仅响应回读指令2=响应回读指令，设置类指令返回成功与否3=所有指令都返回成功与否（成功返回“OK” ，失败返回具体错误。 ）如果指令头部错误，或者号码属于非法号码，不会回复信息- 默认回显等级为 3.- 蜂鸣器标志：0=蜂鸣器禁用。1=每成功执行一条指令，蜂鸣器响一声（执行不成功不响） ，系统启动时蜂鸣器响一声。2=每收到一条可识别的指令( 头部正确，并且属于绑定列表中) ，蜂鸣器响一

16、声（无论是否执行成功） ，系统启动时蜂鸣器响一声。3=每收到一条短信，蜂鸣器响一声，系统启动时蜂鸣器响一声。- 默认蜂鸣器标志为 2例：*#1PECH30 设置为所有指令均返回是否成功，并且禁用蜂鸣器*#1PECH12 设置回显等级为 1，蜂鸣器标志为 2状态回读*#1(固定 3 字) + QR(固定 2 字) +回读项目(1 字)-回读项目含义：S：回读显示屏当前状态，包含当前正在播放哪条信息，当前亮度，当前开关状态P：回读当前屏参Z：回读分区情况B：回读绑定的手机号T：回读控制卡当前时间例：*#1QRZ，回读分区情况绑定手机号码*#1(固定 3 字) + SBDP (固定 4 字) +绑定

17、标志(1 字符)+号码 1 + “|” + 号码 2 + “|” 最多 8 个号码。-如果绑定标志是“0” ，则取消手机号码绑定。-如果绑定标志是“1” ，则更新绑定号码列表。每个号码长度不得超过 16 字，如果是手机号码，必须带“+86” ，每个号码之间用英文竖线分隔，整个列表最后必须有一个竖线作为结尾标志四，指令返回1， 本节内容仅规定了指令返回的格式，但是收到指令后，是否回复短信，取决于回显等级。 （注意：如果是用串口发送指令，则会一直返回，而忽略回显等级）2， 如果收到无法识别的短信，则自动丢弃，不返回任何内容。3， 指令返回内容代表的含义参见下表返回内容 可能的原因OK 指令执行成功

18、E002 无法识别，或不支持的指令E004 指令参数错误，即指令格式完全正确，但是参数属于协议规定外的字符。（如更新信息时，输入的 ID 大于 400）E005 指令参数无法识别，如该出现数字的地方，出现字母等E007 设置屏参时，宽度超出最大范围。E008 设置屏参时，高度超出最大范围。E009 设置屏参时，总点数超过控制卡所支持的最大点数。E010 指令长度异常，如本来总长度应该是 10 个字符，确输入了 9 个或 11 个。E020 设置分区时，分区太小(小于 16*16)或太大(超过屏幕范围)。E021 设置分区时，分区有重叠。E110 追加信息时，顺序错误，或出现没有原始信息直接追加

19、的情况。RX:xxx 回读指令返回的信息均以“RX:”开头五，特技列表 （注意：区分大小写）0 /随机1 , /立刻显示2 , /连续左移3 , /左移4 , /右移5 , /上移6 , /下移7 , /淡入8 , /下雨9 , /喷泉a , /亮灭闪b , /反白闪c , /卷轴展开d , /卷轴闭合e , /左镭射f , /右镭射g , /上镭射h , /下镭射i , /向左拉伸j , /向右拉伸k , /向上拉伸l , /向下拉伸m , /左下脚飞入n , /左上脚飞入o , /右下脚飞入p , /右上脚飞入q , /从左向右展开r , /从右向左展开s , /从上向下展开t , /从下向上展开u , /水平对开v , /水平闭合w , /垂直对开x , /垂直闭合y , /水平百叶窗z , /垂直百叶窗A , /上下交叉对进B , /左右交叉对进C , /上下交叉对展D , /左右交叉对展E , /马赛克F , /菱形扩散G , /菱形收缩H , /斜向下移I /斜向左展六，边框选项 （注意：区分大小写）1-6 快速，顺时钟，红色7-c 中速，逆时钟，红色d-i 慢速，闪 烁，红色j-o 快速，顺时钟，绿色p-u 中速，逆时针，绿色v-z 慢速，闪烁，绿色A-F 快速，顺时针，黄色G-L 中速，逆时针，黄色M-R 慢速，闪烁，黄色