企业自助服务终端设备软件接口需求.docx

企业自助服务终端设备软件接口需求.docx

《企业自助服务终端设备软件接口需求.docx》由会员分享，可在线阅读，更多相关《企业自助服务终端设备软件接口需求.docx（9页珍藏版）》请在冰豆网上搜索。

企业自助服务终端设备软件接口需求

附件：

企业自助服务终端设备软件接口需求

中国建设银行股份有限公司四川省分行

2012年7月

目录

一、设备监控查询接口需求1

二、打印纸槽设定接口需求2

三、RF卡读卡接口需求2

四、磁条卡读卡接口需求3

五、打印情况反馈接口需求4

六、密码键盘输入接口需求6

七、接口需求说明7

一、设备监控查询接口需求

为了方便系统管理人员即时了解各网点部署的自助设备的运行情况，自助设备必须提供一个软件接口供应用程序调用，能够实时获取机器各部件的运行状况。

接口以dll文件形式发布。

具体要求如下：

（1）dll文件名：

Recp_Monitor.dll

（2）dll函数定义：

intGet_Info（char*Data,char*errmsg）

参数说明：

（a）Data：

保存返回的结果信息，按’|’分割的字符串，如50|30|1|1|0|010|

第1栏：

CPU使用率

第2栏：

内存使用率

第3栏：

打印机工作状态（0正常1卡纸2缺油墨3其他故障）

第4栏：

射频卡读卡器是否工作正常（0：

正常，1：

不正常）

第5栏：

磁条卡读卡器是否工作正常（0：

正常，1：

不正常）

第6栏：

打印机某个纸槽剩余纸张状态。

由3个字符组成，0表示有纸，1表示无纸，2表示少纸，如012表示第1个纸槽有纸，第二个纸槽无纸，第三个纸槽少纸。

（b）Errmsg：

当函数内部发生错误时，用于保存错误信息

（3）函数返回值：

0——调用成功

非0——调用不成功，同时在Errmsg参数中保存错误信息

二、打印纸槽设定接口需求

1.接口功能：

自助设备只需提供一个基于dll的api函数用于指定当前使用的纸槽。

打印模块由我行开发的ocx控件主控，打印前先调用该api函数指定纸槽，再调用windows标准打印接口进行打印。

2.打印纸槽设定api需求：

（1）dll文件名：

Recp_setprinter.dll

（2）dll函数定义：

intsetprinter（intpaper_type，char*errmsg）

参数说明：

paper_type：

指定需要使用的纸槽

1——1号纸槽（小号回单纸,尺寸定为1/3张A4纸）

2——2号纸槽（尺寸同A4纸）

3——3号纸槽（尺寸同A4纸）

（3）函数返回值：

0——设置成功

非0——置不成功，同时在Errmsg参数中保存错误信息

三、RF卡读卡接口需求

1.接口功能：

自助设备需要提供一个基于dll的api函数用于读取rf卡的卡号

2.RF卡读卡api需求：

（1）dll文件名：

Recp_readcard.dll

（2）dll函数定义：

intgetcardno（char*Data，char*errmsg）

参数说明：

Data：

存放读入的卡号，供调用者使用

Errmsg：

出错时存放错误信息

（3）函数返回值：

0——读取成功

非0——读取失败，同时在Errmsg参数中保存错误信息

（4）要求：

只有在读卡状态下才开启蜂鸣声。

四、磁条卡读卡接口需求

1.接口功能：

自助设备需要提供一个基于dll的api函数用于读取磁条卡内的信息。

2.磁条卡读卡api需求：

◆打开串口

（1）dll文件名：

Recp_readcard_mg.dll

（2）dll函数定义：

intopencomm（char*errmsg）

（3）函数返回值：

0打开串口成功

非0打开串口失败

◆设置磁条卡读卡器允许进卡

（1）dll文件名：

Recp_readcard_mg.dll

（2）dll函数定义：

intInitCardReader（）

（3）函数返回值：

0——初始化成功

非0——初始化失败

◆读卡

（1）dll文件名：

Recp_readcard_mg.dll

（2）dll函数定义：

intgetcardno（intnTrack，char*Data，char*errmsg）

参数说明：

nTrack：

磁道数

（3）函数返回信息：

Data：

存放读入的卡号，供调用者使用

Errmsg：

出错时存放错误信息

函数返回值：

0——读取成功

非0——读取失败，同时在Errmsg参数中保存错误信息

◆弹出卡

（1）dll文件名：

Recp_readcard_mg.dll

（2）dll函数定义：

intRejectCard（）

（3）函数返回值：

0——弹出卡成功

非0——弹出卡失败

◆吞卡

（1）dll文件名：

Recp_readcard_mg.dll

（2）dll函数定义:

intswallowcard（char*errmsg）

（3）函数返回值：

0——吞卡成功

1——吞卡失败（需要吞卡，但吞卡失败）

2——无需吞卡

◆关闭磁卡入口

（1）dll文件名：

Recp_readcard_mg.dll

（2）dll函数定义:

intclosemgentry（char*errmsg）

（3）函数返回信息：

Errmsg：

出错时存放错误信息

返回值：

1关闭磁卡入口成功

非0关闭磁卡入口失败

◆获取磁卡位置

（1）dll文件名：

Recp_readcard_mg.dll

（2）dll函数定义:

intcheckcardposition（int&position,char*errmsg）

（3）函数返回信息：

position1：

无卡

2：

腹部

3：

前端夹卡位置

4：

前端不夹卡位置（不作强制要求）

5：

其他

Errmsg：

出错时存放错误信息

备注：

如果不能区分3，4;3，4就合并为前端

返回值：

0：

正确

非0：

失败

◆关闭串口

（1）dll文件名：

Recp_readcard_mg.dll

（2）dll函数定义:

intclosecomm（char*errmsg）

（3）函数返回信息：

返回值：

0关闭串口成功

非0关闭串口失败

五、打印情况反馈接口需求

1.接口功能：

自助设备需要提供一个基于dll的api函数用于获取最近一次打印的情况。

2.api需求：

◆初始化成功张数

（1）dll文件名：

Recp_getprinterinfo.dll

（2）dll函数定义：

intstart（）

（3）函数返回值：

0——表示初始化成功

－1——函数内部出错

◆统计成功张数

（1）dll文件名：

Recp_getprinterinfo.dll

（2）dll函数定义：

intget_success_counts（char*errmsg）

参数说明：

Errmsg：

出错时存放错误信息

（3）函数返回值：

整数——表示成功打印的张数

－1——函数内部出错

◆清除打印队列

（1）dll文件名：

Recp_getprinterinfo.dll

（2）dll函数定义：

intclear_list（char*errmsg）

参数说明：

Errmsg：

出错时存放错误信息

（3）函数返回值：

0——清除成功

－1——函数内部出错

◆预热打印机

（1）dll文件名：

Recp_getprinterinfo.dll

（2）dll函数定义：

intprepare_printer（char*errmsg）

参数说明：

Errmsg：

出错时存放错误信息

（3）函数返回值：

0——预热成功

－1——函数内部出错

六、密码键盘输入接口需求

1.接口功能：

系统提供的密码键盘需要按照我行的加密要求实现硬件加密。

2.密码键盘接口需求：

◆密码长度获取接口

（1）dll函数定义：

intGetCurrentChars（char*errmsg）

（2）函数返回值：

>=0——调用成功，返回当前输入的字符数

-1——调用失败

（3）备注：

该接口的目的是为了获得当前已经输入了多少个字符，如用户键盘点击了1,2,3调用接口则返回3，点击“清除”键后，调用该接口返回2。

◆取消输入

（1）dll函数定义：

intabortgetpassword（char*errmsg）

（2）函数返回值：

0——调用成功

-1——调用失败

（3）备注：

终止当前键盘输入，之前约定调用getpassword处于阻塞的状态，如果调用abortgetpassword函数后，需将getpassword直接返回,返回值为空串。

◆密码键盘模式切换

（1）Dll函数定义intsetnormalbord（char*errmsg）

（2）函数返回值：

0：

调用成功-1：

调用失败（3）备注：

errmsg:

出错信息

七、接口需求说明

以上是目前系统运行所需接口需求，随着后期项目进一步推进，将可能要求设备厂商提供更多接口支持，设备厂商应保证相关技术人员配备，具备完成后续相关接口开放调试的能力。

申明：

本资料仅供各设备供应商了解此次采购需求，未经我行同意，不得将本资料中信息泄露给任何第三方或用于其他目的，否则，我行将追究其法律责任。