平台与终端接口规范V1.3(实际需要实施部分).docVIP

接口规范功能及流程 本接口规范支持PDU短信、CDMA1X、ADSL等承载方式。 主终端登录前请求接入模块IP和端口 主终端/手机在登陆T8系统前，向分布式接入前置机请求获取主终端/手机接入模块IP和端口。 分布式接入前置机基于TCP/IP协议 端口： IP： 分布式接入前置机根据负载均衡算法，将较空闲的接入模块IP和端口发给申请连入T8平台的主终端或手机。 流程如下图所示： 终端获取安全码 在前置机获取到接入模块的IP和端口后，连接上接入模块，在登入之后需发送一条获取安全码的命令，以获取安全码与客户密码混合并加密，这个混合加密之后的密码是用于登陆鉴权。 流程如下图所示： 终端设备登录 主终端必须登录到T8平台，才能与T8平台进行数据交互，除非流程有特别说明，否则T8平台不接受没有登录的主终端业务请求。 主终端登录流程如下图所示。 1.主终端向平台发送登录请求。登录上报参数（参见“LOGIN_REQ包体定义”)。 2平台LOGIN_ACK包平台平台T8平台LOGOUT_REQ”），表示主终端暂时不提供服务，T8平台LOGOUT _ACK”包T8平台HEART_BEAT_REQ”包），表示处于工作状态，T8平台HEART_BEAT_ACK”包T8平台REPORT_CONFIG _REQ”）。T8平台收到请求后将配置数据写入数据库，并发回响应ACK（参见 “REPORT_CONFIG _ACK”）。 流程如下： 终端设备与行业应用平台间的数据透传 主终端可以经由平台向应用系统发送自身的采集数据。数据的传输采用TRANSPARENT_DATA_REQ及TRANSPARENT_DATA_ACK消息。此数据包即可由主终端发起，平台确认（主动上报数据）；也可能由T8平台发起，主终端确认（请求——应答模式）。在TRANSPARENT _DATA_REQ和TRANSPARENT_DATA_REQ中的包体数据对于平台是透明、不可或不需理解的业务流数据，T8平台只是数据进行路由转发。 注意：平台只是对数据进行存储转发。响应消息只是代表接收方已经收到数据，不代表接收方已经对这些数据进行了业务上的处理。 流程如下： 主终端设备告警故障上报 主终端在检查到自身发生异常时，将发起故障上报流程，将故障信息通过ALARM_REPORT_REQ（参见.“ALARM_REPORT_REQ”包ALARM_REPORT_ACK”包DOWNLOAD_INFO_ACK包体定义”）。 主终端如果需要升级其软件，则在其空闲时向第三方的升级服务器请求下载升级文件。 流程如下： 主终端上报软件升级信息 主终端如果进行了软件相关操作后，需要向T8平台上报软件操作的相关信息。通过SOFTWARE_REPORT_REQ（参见.“SOFTWARE_UPDATE_REPORT_REQ”包SOFTWARE_UPDATE_REPORT_ACK”包 接口定义 接口定义的消息目前有2种：Request和Response。Request是请求消息，Response是对请求的响应，Request和Response消息是一一对应的。 消息结构 消息头格式 字段 长度(字节) 备注 2 Integer 消息类型代码2 Integer Command ID 流水号 报文协议版本 保留字 2 Integer 取值始终为0 主终端16 Octet String 消息发送时刻 4 Integer 当前系统时间，从1970-1-1 00:00:00到当前的秒数。 状态 1 Integer Request消息：0代表不使用 Response消息：1代表成功，2代表失败,3代表报文协议版本不兼容。 其他的值根据具体的消息类型代码而定。 报文字段说明： 类型代码：标识该报文，如：远程配置、下载更新、数据采集等，即Command ID。 流水号：唯一标识发送方发出的每一次监控管理请求。接收方回复请求时，将该流水号原样返回。发送方各自维护自己的流水号(从00xFFFFFFFF)，每发出一次请求，该流水号自动加1。 报文协议版本：标识报文发送方使用的报文协议版本，接收方可根据该编号进行相应的处理或拒绝。 主终端编码：主终端设备的唯一标识，由平台统一分配。0x0208 Value部分的长度 用户账号 Octet String BEFORE_LOGIN _ACK包体定义 字段 长度 说明 数据 CRC32校验值 4 Integer 0x0201 Value部分的长度 主终端接入模块IP Octet String 0x0202 2 主终端接入模块端口 Integer 0x0