通信接口协议2011年6月
修订控制页
目录
1.概述 (5)
1.1编写目的 (5)
1.2缩略语 (5)
1.3参考资料 (5)
1.4共享平台机具接口定义 (5)
1.5通信密钥 (6)
2协议包格式 (7)
2.1协议分层说明 (7)
2.2包格式 (7)
2.3校验字MAC码计算方法 (8)
3.接口报文格式 (9)
3.1业务应用类 (9)
3.1.1消费流水上传 (9)
3.1.2身份识别流水上传 (10)
3.1.3黑名单下发 (11)
3.1.4身份识别白名单下发 (12)
3.1.5客户代码下发 (13)
3.2设备管理类 (14)
3.2.1通信参数下发 (14)
3.2.2应用密钥下发 (14)
3.2.3时间同步下发 (15)
3.2.4心跳信号上传 (16)
3.2.5开机密钥下发 (16)
3.3门禁业务控制类 (18)
3.3.1下发节假日时段和星期节假日信息 (18)
3.3.2下发门设置信息（策略） (19)
3.3.3启动/停止实时上传 (20)
3.3.4远程强制控制门的开关 (21)
3.3.5门禁锁状态查询 (22)
3.3.6开门密码设置 (22)
3.3.7多卡开门设置 (23)
3.3.8协迫开门密码设置 (24)
3.4考勤业务控制类........................................ 错误!未定义书签。
3.5脱机消费业务控制类.................................... 错误!未定义书签。
3.5.1下发补贴名单 ................................................ 错误!未定义书签。
3.5.3下发消费类别参数 ............................................. 错误!未定义书签 3.5.4下发消费策略 ................................................. 错误!未定义书签 3.5.5限制策略下发 .................................................. 错误!未定义书签
3.6水控业务控制类 .......................................
3.6.1水控消费模式下发 .............................................
错误!未定义书签
错误!未定义书签
4.M1卡空间规划 ....................................... 校验位Luhn 算法 ...........................................
错误!未定义书签
错误!未定义书签
5.对于CPU 卡消费应用空间增加充值流水号记录文件
..... 错误!未定义书签
附表1.协议业务类型代码表 (25)
1.概述
1.1编写目的
本协议主要是用来规范共享平台与机具和或前置机之间数据通信的通信机制和通信数
据格式，以便共享平台统一高效地接入各类业务和型号的机具。
1.2缩略语
1.3参考资料
《中国电信翼支付产品（基础版）业务规范（试行）》
《中国电信翼支付业务账户管理办法（试行）》
《中国电信融合支付平台技术规范（试行）》
《中国电信融合支付平台技术规范—省平台功能分册》
《中国电信融合支付平台技术规范——社区平台（系统）》
1.4 共享平台机具接口定义
共享平台的接口如图1-1所示。共享平台通过该接口（B1）与前端用户侧的机具、前置机、应用系统进行交互，实现共享平台对机具设备管理、控制以及业务数据采集的功
申习申习申习申习申习申习申习
[I [ [ I [
[ I [ [ I [
[ I [ [ I [
[一I _ [ [一I _[ [一I _[ [一I _[ [一I _[ [一I _ [ [一I _[
翼翼B1
图1-1共享平台通信前置系统与机具的接口示意图
EMAP协议是采用TCP/IP和UDP通信方式，基于TCP通信采用短连接的方式，共享平
台作为IP服务端监听各厂家前置机，采用统一端口号接收消费流水数据和身份识别类流水数据，该端口号默认值为10001，可根据实际情况进行更改，地址更改后需要即时通知到
各机具。各厂家前置机作为IP服务端监听共享平台信息，采用独立的端口号接收共享平
台发布的信息，该监听端口号默认值为10001，在设备开能前可根据实际情况进行更改。
为保证平台对所有机具的在线监管，当机具没有进行数据通信的时间间隔超过某阀值
（该时间间隔阀值默认为60秒，参数可通过协议进行调整）时，机具必须发送心跳信号，服务端收到该心跳信号后，回信应答。
当发送方发送协议数据等待应答响应的时间超过某阀值（该时间阀值默认为6秒，参数
可通过协议进行调整）时，发送方需要重发该协议包，当重发次数超过某阀值（该重发次数阀值默认为3次，参数可通过协议进行调整）时，则协议通信的发起方需要保存未成功传输的数据内容及状态，并每间隔一定时间（该重发次数阀值默认为600秒，参数可通过协议进
行调整）重新发送数据。
1.5通信密钥
通信密钥由长度16字节的字符组成，各机具出厂时密钥统一设置为
“0000000000000000 （16个字符“ 0”），共享平台在设备开通时通过应用协议下发新的
通信密钥给各机具，机具按照平台分配的通信密钥进行安全通信。
異異異異異異