《中国电信家校翼通专用终端平台接口规范.doc》由会员分享，可在线阅读，更多相关《中国电信家校翼通专用终端平台接口规范.doc（47页珍藏版）》请在金锄头文库上搜索。
1、中国电信家校翼通专用终端平台接口规范(讨论稿)中国电信集团公司2011年3月目 录1缩略语52协议描述63数据类型和格式定义73.1数据类型定义73.2包格式概述73.3包格式布局73.4包内容常见数据说明73.5包的最大长度84考勤机参数配置接口包格式定义94.1报警信息处理操作94.1.1上传报警信息语法(由考勤机发给Server端) 0394.1.2上传报警信息应答语法(由Server发给考勤机) 0394.2报警信息发送时间间隔下载104.2.1报警信息发送时间间隔语法(由server端发给考勤机) 09104.2.2报警信息发送时间间隔下载应答语法(由考勤机发给server端) 09
2、104.3修改服务器IP地址端口号操作114.3.1修改服务器IP地址端口号语法(由server发给考勤机端) 04114.3.2修改服务器IP地址端口号应答语法(由考勤机发给服务器端) 04124.4心跳包124.4.1心跳包语法(由考勤机发给server端)10124.4.2心跳包应答语法(由server端发给考勤机)10134.5查询考勤机状态134.5.1查询考勤机状态语法(由server端发给考勤机) 0A134.5.2查询考勤机状态回应语法(由考勤机发给server端) 0A134.6时间校验144.6.1时间校验语法(由考勤机发给server端) 0C144.6.2时间校验语法(
3、由server端发给考勤机) 0C145考勤机平安短信接口包格式定义155.1上传进出校信息操作155.1.1上传进出校信息语法(由考勤机发给server端) 08155.1.2上传进出校信息应答语法(由server端发给考勤机) 08156考勤机扩展功能接口包格式定义（可选）166.1请求更新本机参数操作166.1.1下传更新本机参数请求语法(由考勤机发给server端) 17166.1.2下传更新本机参数应答语法(由server端发给考勤机) 17166.2请求班级列表操作176.2.1下传班级列表请求语法(由考勤机发给server端) 18176.2.2下传班级列表应答语法(由serve
4、r端发给考勤机) 18176.3上传考勤机数量和状态186.3.1上传考勤机数量和状态请求语法(由考勤机发给server端) 21186.3.2上传考勤机数量和状态应答语法(由server端发给考勤机) 21186.4终端参数配置下发196.4.1终端参数配置下发语法(由server端发给考勤机) 22196.4.2终端参数配置下发语法(由考勤机发给server端) 22216.5终端软件升级程序下载226.5.1终端软件升级程序下载语法(由server端发给考勤机) 1F226.5.2终端软件升级程序下载语法应答(由考勤机发给server端) 1F227考勤机亲情电话接口包格式定义（可选）2
5、47.1学生卡老师卡请求时长短信条数操作247.1.1学生卡老师卡请求时长短信条数语法(由考勤机发给Server端) 01247.1.2学生卡老师卡请求时长短信条数应答语法(由Server发给考勤机) 01257.2上传话单操作267.2.1上传话单语法(由考勤机发给Server端) 05267.2.2上传话单应答语法(由server端发给考勤机) 05267.3上学时段下发277.3.1上学时段下发语法(由server端发给考勤机) 0F277.3.2上学时段下发语法(由考勤机发给server端) 0F277.3.3考勤时段下发语法(由考勤机发给server端) 20287.4卡亲情信息更新
6、数据发送11287.4.1卡亲情信息更新数据发送请求语法(由Server发给考勤机)287.4.2卡亲情信息更新数据发送应答语法(由考勤机发给Server)297.5卡亲情信息删除（全部删除）12307.5.1卡信息删除请求语法(由Server发给考勤机)307.5.2卡信息删除应答语法(由考勤机发给Server)307.6卡属性应答操作307.6.1上传卡属性请求语法(由考勤机发给server端) 14307.6.2上传卡属性应答语法(由server端发给考勤机) 14317.7学号登录317.7.1学号登录语法(由考勤机发给server端) 0D317.7.2学号登录应答语法(由serve
7、r端发给考勤机) 0D327.8请求学生列表操作327.8.1下传学生列表请求语法(由考勤机发给server端) 19327.8.2下传学生列表应答语法(由server端发给考勤机) 19337.9考勤时段下发347.9.1考勤时段下发语法(由server端发给考勤机) 20347.10下传免费电话号码信息357.10.1下传免费电话号码请求语法(由server端发给考勤机) 1D357.11下传离线老师所在班级列表操作367.11.1下传离线老师所在班级列表请求语法(由server端发给考勤机) 1A367.11.2下传离线班级列表请求语法(由考勤机发给server端) 1A367.12下传
8、删除离线老师所在班级列表操作377.12.1下传删除离线老师所在班级列表请求语法(由server端发给考勤机) 1B377.12.2下传删除离线老师所在班级列表请求语法(由考勤机发给server端) 1B387.12.3下传免费电话号码应答语法(由考勤机发给server端) 1D388考勤机短信留言接口包格式定义（可选）408.1学生卡读取短信留言操作408.1.1学生卡读取留言请求语法(由考勤机发给Server端) 02408.1.2学生卡读取留言请求应答语法(由Server端发给考勤机) 02418.2常用短语内容下载操作418.2.1短信常用短语内容下载语法(由Server发给考勤机端)
9、 06418.2.2短信常用短语内容下载应答语法(由考勤机发给服务器端) 06428.3常用短语类名下载操作438.3.1短信常用短语类名下载语法(由server端发给考勤机) 07438.3.2常用短语类名下载应答语法(由考勤机发给server端) 07448.4考勤机发短信448.4.1考勤机发短信语法(由考勤机发给server端) 0B448.4.2考勤机发短信回应语法(由server端发给考勤机) 0B448.5下载公告458.5.1下载公告信息语法(由server端发给考勤机)1E458.5.2下载公告信息应答语法(由考勤机发给server端)1E469功能号总表471 缩略语l S
10、C (Service Center)：服务中心l CCST (Child-caring System Teminal)：考勤机终端，又称家校翼通终端l CCS（Child-caring System）：平安短信系统，又称家校翼通平台l CCSCP（Child-caring System: Communication Protocol）：平安短信系统通讯协议，又称家校翼通平台通讯协议l SRFC (Student RF Card)：学生、老师等专用的RF卡2 协议描述l 平安短信系统接口采用1X协议与电信SC进行数据通讯。本质上是基于TCP/IP协议之上的应用层协议，以TCP协议进行数据传输，采
11、用请求/应答的同步通讯模型实现。l SC使用公网地址，在某个端口侦听考勤机连接，使用认证方式建立连接。注：数据包包由终端发出后未收到响应，或终端发送不成功，终端应该间阁T秒后重发，重新发送N-1次后放弃，建议T=30，N=3。3 数据类型和格式定义3.1 数据类型定义类型说明String仅限于09 和大写的AZ3.2 包格式概述包格式头体较验和同步帧序号机器号包长度功能号包内容(功能号+包内容)341842N23.3 包格式布局下面是一个完整包格式的布局：包格式 域长度类型说明头同步帧3String1、 CCST上传：同步帧=TPJ2、 SC下传： 同步帧=JTP序号4String此域表示一个
12、序列号，使用在异步通信模式下，由消息发起者设定，应答者对应给回此序列号。序列号范围：0000ffff，循环使用。同步方式下该域保留。体机器号18String考勤机终端ID包长度4String2N （ASCII表示的16进制数 例 2+N=10 L=000A）功能号2String包内容NString较验和(功能号+包内容)2String功能号+包内容的和取低位两个字节(ASCII表示的16进制数)3.4 包内容常见数据说明数据名称数据类型数据长度说明可通话时长 String6HHMMSS ASCII表示的16进制数电话号码String16TELNUM每个号码为16字节,不足16字节用空格(0x2
13、0)补足日期String6YYMMDD 时间String6HHMMSS汉字编码StringN规定长度为N,不足N字节用0X20（空格）补足常用语编号String6BBSSNN BB表示大类 (0009) SS 表示小类(0009)NN 表示N个常用语(0009)例 生日祝福 BB 老师类 SS 老师您辛苦了祝您生日快乐! NN 3.5 包的最大长度最大包长：发送一包信息的最大长度小于1024字节位数不足的情况：左对齐，用空格（0X20）补足。4 考勤机参数配置接口包格式定义4.1 报警信息处理操作4.1.1 上传报警信息语法(由考勤机发给Server端) 03序号域名长度类型描述1同步帧3StringTPJ2序号4流水号3机器号18考勤机ID4包长度45功能号203传报警信息6包内容SIM 卡卡号16TELNUM第1类警情2机门打开 有警情时发85无警情时发55第2类警情2手柄断开 有警情时发85无警情时发55第3类警情2读卡头读卡失败有警情时发85无警情时发55第4类警情2供电状态外电供电85电池供电55电池电压底00第5类警
