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

1、中国建设银行China ConsUuctian Bank附件:企业自助服务终端设备软件接口需求中国建设银行股份有限公司四JI省分行2012年7月1、 设备监控查询接口需求1.2、 打印纸槽设定接口需求2.3、 RF 卡读卡接口需求2.4、 磁条卡读卡接口需求3.5、 打印情况反馈接口需求6.6、 密码键盘输入接口需求8.7、 接口需求说明9.一、设备监控查询接口需求为了方便系统管理人员即时了解各网点部署的自助设备的运行情况，自助设备必须提供一个软件接口供应用程序调用，能够实时获取机器各部件的运行状况。接口以 dll 文件形式发布。具体要求如下：（ 1 ） dll 文件名：Recp_Monito

2、r.dll（ 2） dll 函数定义：int Get_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 个纸

3、槽有纸，第二个纸槽无纸，第三个纸槽少纸。（ b ） Errmsg ： 当函数内部发生错误时，用于保存错误信息（ 3）函数返回值：0 调用成功非 0 调用不成功，同时在 Errmsg 参数中保存错误信息2、 打印纸槽设定接口需求1. 接口功能：自助设备只需提供一个基于dll 的 api 函数用于指定当前使用的纸槽。打印模块由我行开发的ocx 控件主控，打印前先调用该api 函数指定纸槽，再调用windows 标准打印接口进行打印。2. 打印纸槽设定api 需求：3. 1 ） dll 文件名：Recp_setprinter.dll4. 2 ） dll 函数定义：int setprinter（int

4、 paper_type ， char*errmsg）参数说明：paper_type ：指定需要使用的纸槽1 1 号纸槽（小号回单纸,尺寸定为1/3 张 A4 纸）22 号纸槽（尺寸同A4 纸）33 号纸槽（尺寸同A4 纸）5. 3）函数返回值：6. 设置成功7. 0置不成功，同时在Errmsg 参数中保存错误信息3、 RF 卡读卡接口需求1. 接口功能：自助设备需要提供一个基于dll 的 api 函数用于读取 rf 卡的卡号2. RF 卡读卡 api 需求：（ 1 ） dll 文件名：Recp_readcard.dll（ 2 ） dll 函数定义：int getcardno（char *Dat

5、a ， char*errmsg）参数说明：Data ：存放读入的卡号，供调用者使用Errmsg ：出错时存放错误信息（ 3）函数返回值：0 读取成功非0读取失败，同时在Errmsg 参数中保存错误信息（ 4）要求：只有在读卡状态下才开启蜂鸣声。4、 磁条卡读卡接口需求1. 接口功能：自助设备需要提供一个基于dll 的 api 函数用于读取磁条卡内的信息。2. 磁条卡读卡api 需求：打开串口3. 1 ） dll 文件名：Recp_readcard_mg.dll4. 2 ）dll 函数定义：int opencomm（char * errmsg）5. 3 ）函数返回值：0打开串口成功非 0打开串口

6、失败设置磁条卡读卡器允许进卡（ 1 ） dll 文件名：Recp_readcard_mg.dll（ 2 ）dll 函数定义：int InitCardReader（）（ 3 ）函数返回值：0 初始化成功非 0初始化失败读卡（ 1 ） dll 文件名：Recp_readcard_mg.dll（ 2 ）dll 函数定义：int getcardno（int nTrack ， char *Data ，char *errmsg）参数说明：nTrack:磁道数（ 3 ）函数返回信息：Data ：存放读入的卡号，供调用者使用Errmsg ：出错时存放错误信息函数返回值：0 读取成功非 0 读取失败，同时在 E

7、rrmsg 参数中保存错误信息弹出卡（ 1 ） dll 文件名：Recp_readcard_mg.dll（ 2 ） dll 函数定义：int RejectCard （）（ 3 ）函数返回值：0弹出卡成功非 0弹出卡失败吞卡（ 1 ） dll 文件名：Recp_readcard_mg.dll（ 2 ） dll 函数定义: int swallowcard（char * errmsg）（ 3 ）函数返回值：0吞卡成功6. 吞卡失败（需要吞卡，但吞卡失败）2无需吞卡关闭磁卡入口（ 1 ） dll 文件名：Recp_readcard_mg.dll（ 2 ） dll 函数定义: int closemgen

8、try（char *errmsg）（ 3 ）函数返回信息：Errmsg:出错时存放错误信息返回值：0关闭磁卡入口成功非 0 关闭磁卡入口失败获取磁卡位置（ 1 ） dll 文件名：Recp_readcard_mg.dll（2 ） dll 函 数 定 义 : int checkcardposition（int&position,char *errmsg)3 ）函数返回信息：position 1：无卡2：腹部3：前端夹卡位置4：前端不夹卡位置（不作强制要求）5：其他Errmsg:出错时存放错误信息备注：如果不能区分3， 4;3， 4就合并为前端返回值：0：正确非 0：失败关闭串口（ 1 ）

9、 dll 文件名：Recp_readcard_mg.dll（ 2 ） dll 函数定义: int closecomm （char *errmsg）（ 3 ）函数返回信息：返回值：0关闭串口成功非 0关闭串口失败5、 打印情况反馈接口需求1. 接口功能：自助设备需要提供一个基于dll 的 api 函数用于获取最近一次打印的情况。2. api 需求：初 始化成功张数1 ) dll 文件名：Recp_getprinterinfo.dll2 ) dll 函数定义：int start()3)函数返回值：0表示初始化成功 1 函数内部出错统 计成功张数1 ) dll 文件名：Recp_getprinter

10、info.dll2 ) dll 函数定义：int get_success_counts(char *errmsg)参数说明：Errmsg ：出错时存放错误信息3)函数返回值：整数表示成功打印的张数 1 函数内部出错清 除打印队列1 ) dll 文件名：Recp_getprinterinfo.dll2 ) dll 函数定义：int clear_list(char *errmsg)参数说明：Errmsg ：出错时存放错误信息3)函数返回值：0清除成功函数内部出错预 热打印机（ 1 ） dll 文件名：Recp_getprinterinfo.dll（ 2 ） dll 函数定义：int prepare

11、_printer（char *errmsg）参数说明：Errmsg ：出错时存放错误信息（ 3）函数返回值：0预热成功 1 函数内部出错6、 密码键盘输入接口需求1. 接口功能：系统提供的密码键盘需要按照我行的加密要求实现硬件加密。2. 密码键盘接口需求：密 码长度获取接口（ 1 ） dll 函数定义：int GetCurrentChars（char * errmsg）（ 2）函数返回值：- =0 调用成功，返回当前输入的字符数- 1 调用失败（ 3）备注：该接口的目的是为了获得当前已经输入了多少个字符， 如用户键盘点击了1,2,3 调用接口则返回3， 点击 “清除” 键后，调用该接口返回2。取 消输入（ 1 ） dll 函数定义：int abortgetpassword （char * errmsg）（ 2）函数返回值：0调用成功- 1 调用失败（ 3 ）备注： 终止当前键盘输入，之前约定调用getpassword处于阻塞的状态，如果调用abortgetpassword 函数后，需将getpassword 直接返回,返回值为空串。密 码键盘模式切换（ 1 ） Dll 函数定义int setnormalbord（char *errmsg）（ 2）函数返回值：0 ：调用成功- 1