TF-GSM协议_1.0.doc

TF-GSM卡通讯协议版本记录：日期版本说明2011-08-04V1.0初版说明：1，协议描述中所有的数字，均以0x开头。 2，没有以0x开头的所有字符（如：86、AB）均是字母。一， 发送信息指令格式1，简化发送：*#1(固定3字符) + A(固定1字符) + 信息序号(3字) + 内容(最多63字符)-信息序号有效范围为：000-399，总共可存储400条信息-本指令替代序号处的原有内容。信息按照默认选项显示(速度=3、特技=连续左移、分区=0，字库=自动根据0号分区的高度选择，颜色=黄)例：*#1A000欢迎使用GSM短信卡，现在更新的信息ID为0002，普通发送：*#1(固定3字符) + B(固定1字符) + 信息ID (3字) +追加总数(1字符) + 显示特技(1字) + 速度(1字) + 停留时间(1字) + 内容(最多59字符)-追加总数代表本条信息后续还要追加几次才完整，等于0时表示不需要追加。整条信 息只有追加完毕后才开始显示，追加总数的有效范围为0-2，一条信息最多可再追加2次，一条信息最多可存储230个汉字，如果超过将被截断-如果追加总数为A，则忽略具体内容，将指定位置的信息更新为一个表盘信息-如果追加总数为B，则忽略具体内容，将指定位置的信息更新为一个数字时钟-特技有效范围：数字0-9，小写字母a-z，大写字母A-I，具体含义请参照附表-其余选项按照默认值(速度=3、字库=自动，颜色=黄1：*#1B0020863这里是第001条信息，特技=下雨，速度=2，停留时间=1例2：*#1B001A008 (停留8秒的表盘信息)3，追加内容*#1(固定3字符) + C(固定1字符) + 信息ID(3字符) + 追加序号(1字符) +内容(最多62字符)-追加序号，代表第几次追加，值只能为1或者2.分2次发送的例子（追加1次）：1，主信息：*#1B0021210美国时间9月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核心提示：据英媒称，意大利政府正在向中国求援，希望中国购买相当大数量的意大利国债以帮助意大利早日走出金融危机。例2：需要追加2次的信息：主信息：*#1E00322301000按广州市废弃食用油脂管理办法(征求意见稿)规定，如果餐厅、食品生产企业在食品生产中使用废弃食用第一次追加：*#1C0031油脂加工食用油脂或者生产加工食品，食品经营单位如果销售用废弃食用油脂加工生产的食品，违法经营的食品货如果不足1万元， 第二次追加：*#1C0032处2000-50000元的罚款；如果货值金额超1万元，处罚金额则为5-10倍，情节严重的可吊销许可证。 例3(时间信息)：*#1E000B0081103 （注：此信息显示在分区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秒以此类推(字母从10秒开始，每个递增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字) 按照如下格式返回卡类型及版本：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级，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 亮度值为5 07:00-17:59 亮度值为F(最亮) 18:00-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=起始分钟，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扫(室内常规)，41=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=高度，中间用英文逗号分隔。要分几个区，就要有几个这样的数据格段，每个格式段必须有一个竖线结尾。例子，分左右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(固定3字) + NZAB(固定4字) + 标记(2字)- 将显示屏分为2个分区，分区1在左，固定为64点宽(适合显示文字时间)。分区0在右，占用显示屏剩余大小(适合显示普通内容)。- 标记第一个字符如果为“1”，则在设置完分区后，会自动清除原有所有信息。- 标记第二个字符如果为“1”，指令成功后，将自动在ID为000的位置插入一条属于分区1的文字时间信息。分区复位：*#1(固定3字) + OZRS(固定4字) - 复位后分区将设置为1个分区，默认整屏大小。分区复位：*#1(固定3字) + OPNL(固定4字) 设置回显等级*#1(固定3字) + PECH(固定4字) + 回显等级(1字) +蜂鸣器标志(1字)- 回显等级：(仅影响短信，使用串口通讯时，所有指令均会返回)0=不回显任何命令，即使发送回读指令，控制卡也不返回任何字符1=仅响应回读指令2=响应回读指令，设置类指令返回成功与否3=所有指令都返回成功与否（成功返回“OK” ，失败返回具体错误。）如果指令头部错误，或者号码属于非法号码，不会回复信息- 默认回显等级为3.- 蜂鸣器标志：0=蜂鸣器禁用。 1=每成功执行一条指令，蜂鸣器响一声（执行不成功不响），系统启动时蜂鸣器响一声。2=每收到一条可识别的指令(头部正确，并且属于绑定列表中)，蜂鸣器响一声（无论是否执行成功），系统启动时蜂鸣器响一声。3=每收到一条短信，蜂鸣器响一声，系统启动时蜂鸣器响一声。- 默认蜂鸣器标志为2例：*#1PECH30 设置为所有指令均返回是否成功，并且禁用蜂鸣器 *#1PECH12 设置回显等级为1，蜂鸣器标志为2状态回读*#1(固定3字) + QR(固定2字) +回读项目(1字)-回读项目含义：S：回读显示屏当前状态，包含当前正在播放哪条信息，当前亮度，当前开关状态P：回读当前屏参Z：回读分区情况B：回读绑定的手机号T：回读控制卡当前时间例：*#1QRZ，回读分区情况绑定手机号码*#1(固定3字) + SBDP (固定4字) +绑定标志(1字符)+号码1 + “|” + 号码2 + “|” 最多8个号码。 -如果绑定标志是“0”，则取消手机号码绑定。-如果绑定标志是“1”，则更新绑定号码列表。每个号码长度不得超过16字，如果是手机号码，必须带“+86”，每个号码之间用英文竖线分隔，整个列表最后必须有一个竖线作为结尾标志四， 指令返回1， 本节内容仅规定了指令返回的格式，但是收到指令后，是否回复短信，取决于回显等级。（注意：如果是用串口发送指令，则会一直返回，而忽略回显等级）2， 如果收到无法识别的短信，则自动丢弃，不返回任何内容。3， 指令返回内容代表的含义参见下表返回内容可能的原因OK指令执行成功E002无法识别，或不支持的指令E004指令参数错误，即指令格式完全正确，但是参数属于协议规定外的字符。（如更新信息时，输入的ID大于400）E005指令参数无法识别，如该出现数字的地方，出现字母等E007设置屏参时，宽度超出最大范围。E008设置屏参时，高度超出最大范围。E009设置屏参时，总点数超过控制卡所支持的最大点数。E010指令长度异常，如本来总长度应该是10个字符，确输入了9个或11个。E020设置分区时，分区太小(小于16*16)或太大(超过屏幕范围)。E021设置分区时，分区有重叠。E110追加信息时，顺序错误，或出现没有原始信息直接追加的情况。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,/从左向右展