企业自助服务终端设备软件接口需求.docx
《企业自助服务终端设备软件接口需求.docx》由会员分享,可在线阅读,更多相关《企业自助服务终端设备软件接口需求.docx(9页珍藏版)》请在冰豆网上搜索。
![企业自助服务终端设备软件接口需求.docx](https://file1.bdocx.com/fileroot1/2023-2/3/fe1ddbcb-b963-4dde-bda6-4907319dfa8c/fe1ddbcb-b963-4dde-bda6-4907319dfa8c1.gif)
企业自助服务终端设备软件接口需求
附件:
企业自助服务终端设备软件接口需求
中国建设银行股份有限公司四川省分行
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:
出错信息
七、接口需求说明
以上是目前系统运行所需接口需求,随着后期项目进一步推进,将可能要求设备厂商提供更多接口支持,设备厂商应保证相关技术人员配备,具备完成后续相关接口开放调试的能力。
申明:
本资料仅供各设备供应商了解此次采购需求,未经我行同意,不得将本资料中信息泄露给任何第三方或用于其他目的,否则,我行将追究其法律责任。