甘肃万维家校通终端接口规范V1.0.doc

甘肃电信家校通终端接口规范 CDMA家校通 甘肃万维信息技术有限公司 2012-3 目录 CDMA家校通 1 1 缩略语 4 2 协议描述 5 3 数据类型和格式定义 6 3.1 数据类型定义 6 3.2 包格式概述 6 3.3 包格式布局 6 3.4 包内容常见数据说明 6 3.5 包的最大长度 7 4 公话通信接口包格式定义 8 4.1 学生卡老师卡请求时长短信条数操作 8 4.1.1 学生卡老师卡请求时长短信条数语法(由公话发给Server端) [01] 8 4.1.2 学生卡老师卡请求时长短信条数应答语法(由Server发给公话) [01] 9 4.2 学生卡读取短信留言操作 9 4.2.1 学生卡读取留言请求语法(由公话发给Server端) [02] 9 4.2.2 学生卡读取留言请求应答语法(由Server端发给公话) [02] 10 4.3 报警信息处理操作 11 4.3.1 传报警信息语法(由公话发给Server端) [03] 11 4.3.2 传报警信息应答语法(由Server发给公话) [03] 11 4.4 修改服务器IP地址端口号操作 12 4.4.1 修改服务器IP地址端口号语法(由server发给公话端) [04] 12 4.4.2 修改服务器IP地址端口号应答语法(由公话发给服务器端) [04] 13 4.5 上传话单操作 14 4.5.1 上传话单语法(由公话发给Server端) [05] 14 4.5.2 上传话单应答语法(由server端发给公话) [05] 14 4.6 上传进出校信息操作 15 4.6.1 上传进出校信息语法(由公话发给server端) [08] 15 4.6.2 上传进出校信息应答语法(由server端发给公话) [08] 16 4.7 报警信息发送时间间隔下载 16 4.7.1 报警信息发送时间间隔语法(由server端发给终端) [09] 16 4.7.2 报警信息发送时间间隔下载应答语法(由公话发给server端) [09] 17 4.8 查询终端话机状态 17 4.8.1 查询终端话机状态语法(由server端发给终端) [0A] 17 4.8.2 查询终端话机状态回应语法(由公话发给server端) [0A] 17 4.9 时间校验 18 4.9.1 时间校验语法(由公话发给server端) [0C] 18 4.9.2 时间校验语法(由server端发给公话) [0C] 18 4.10 学号登录 19 4.10.1 学号登录语法(由公话发给server端) [0D] 19 4.10.2 学号登录应答语法(由server端发给公话) [0D] 19 4.11 心跳包 20 4.11.1 心跳包语法(由公话发给server端)[10] 20 4.11.2 心跳包应答语法(由server端发给公话)[10] 20 5 功能号总表 21 缩略语 SC (Service Center)：服务中心 CCST (Child-caring System Teminal)：亲情电话公话终端，又称家校通终端 CCS（Child-caring System）：亲情电话系统，又称家校通平台 CCSCP（Child-caring System: Communication Protocol）：亲情电话系统通讯协议，又称家校通平台通讯协议 SRFC (Student RF Card)：学生、老师等专用的RF卡 协议描述 亲情电话公话接口采用1X协议与电信SC进行数据通讯。本质上是基于TCP/IP协议之上的应用层协议，以TCP协议进行数据传输，采用请求/应答的同步通讯模型实现。 SC使用公网地址，在某个端口侦听亲情电话公话连接，使用认证方式建立连接。 注：数据包包由终端发出后未收到响应，或终端发送不成功，终端应该间阁T秒后重发，重新发送N-1次后放弃，建议T=30，N=3。 数据类型和格式定义 数据类型定义 类型 说明 String 仅限于0~9 和大写的A~Z 包格式概述 包格式 头 体 较验和 同步帧 序号 机器号 包长度 功能号 包内容 (功能号+包内容) 3 4 18 4 2 N 2 包格式布局 下面是一个完整包格式的布局： 包格式 域 长度 类型 说明 头 同步帧 3 String CCST上传：同步帧=TPJ SC下传： 同步帧=JTP 序号 4 String 此域表示一个序列号，使用在异步通信模式下，由消息发起者设定，应答者对应给回此序列号。 序列号范围：0000－ffff，循环使用。 同步方式下该域保留。 体 机器号 18 String 亲情电话公话终端ID 包长度 4 String 2＋N （ASCII表示的16进制数 例 2+N=10