Wosa30测试工具使用手册.docx
- 文档编号:12660417
- 上传时间:2023-04-21
- 格式:DOCX
- 页数:71
- 大小:2.07MB
Wosa30测试工具使用手册.docx
《Wosa30测试工具使用手册.docx》由会员分享,可在线阅读,更多相关《Wosa30测试工具使用手册.docx(71页珍藏版)》请在冰豆网上搜索。
Wosa30测试工具使用手册
Wosa3.0测试工具使用手册
文件状态:
[√]草稿
[]正式发布
[]正在修改
文件类型:
指导类
文件名称:
Wosa3.0测试工具使用手册.doc
文件编号:
当前版本:
V0.1
完成日期:
2015-9-21
文档密级:
一般
东方通信股份有限公司
金融事业部
前言
本文档基于WOSA3.O标准的测试工具操作指导。
不同厂商和不同的部件只要装了WOSA3.0平台,通过该工具,就可以进行功能性的测试以及设备故障的初步定位。
1、测试前准备
1.1启动WOSA服务
一般厂家,在调用WOSA服务设备时(如起WOSA工具),WOSA服务会自动调起,如东信(Potevio)的SP。
但也有厂家设备,在调WOSA设备前,要运行独立起WOSA服务程序,以下为Wincor的起各项SP3.0服务的案例:
startfwmain32-eCDM30
startfwmain32-eCIM30
startfwmain32-ePRJ30
startfwmain32-ePRR30
startfwmain32-eTTU30
startfwmain32-eIDC30
startfwmain32-ePIN30
startfwmain32-eSIU30
或startfwmain32-eCDM30PRR30PRJ30TTU30IDC30PIN30SIU30
1.2确认WOSA服务名
一般WOSA服务名注册表路径:
HKEY_USERS\.DEFAULT\XFS\LOGICAL_SERVICES。
Wincor注册表例图
各单元模块(servicename)各厂家命名可能有所不一样,但主要以英文缩写或全名为主,以下为各常用单元模块的缩写简介:
SIU:
传感器和指示器单元(其他英文服务名:
Doors、Indicators、Sensors、GuideLights)
PIN:
加密键盘设备单元(其他英文服务名:
Encryptor)
TTU:
文本终端单元设备单元、维护面板(其他英文服务名:
OperatorPanel)
CDM:
出钞模块设备单元(其他英文服务名:
CashDispenser)
CIM:
存款模块设备单元(其他英文服务名:
CashAcceptor)
PRR:
凭条打印机设备单元(其他英文服务名:
ReceiptPrinter)
PRJ:
日志打印机设备单元(其他英文服务名:
JournalPrinter)
IDC:
读卡器单元(其他英文服务名:
CardReader)
ICC:
非接单元(其他英文服务名:
CashAcceptor)
备注:
1)关于SIU,有的厂家没有做成集成的模块,在运行Wincor提供的WOSA工具时,
只有设置其中一项服务名即可,如把服务名设成Doors或Sensors....;
2)其中,PRR、PRJ执行PTR的执行文件,IDC、ICC执行IDC执行文件,只要设
置好针对的服务名即可。
3)存款机或者循环机,CDM和CIM状态会有一定的交互。
1.3开启WOSA测试工具
以WINCOR机型为PTR300.exe文件为例,执行WOSA操作大致操作如下:
1)先运行对应设备的测试文件,运行ptr300.exe文件;
2)设置服务名,测凭条打印机:
Servcie——>Setting——>ServcieName;
3)运行“Service-->Open+Register”。
2、出钞模块的测试步骤
2.1打开CDM300.exe
将Dialogs打勾(没鼠标,就将焦点移到相应菜单敲“回车”),后面操作信息会以列框的形式,方便查看内容:
设置服务名:
将服务名设成“CDM30”并确认:
点击“Service/Open+Register”:
以下为WOSA设备打开后的信息:
2.2获取设备状态
•执行GetInfo/status获取设备状态,再szExtra中包含了每个厂商的重要信息。
每个厂商的特性信息,可以通过这个接口传出来。
状态信息:
其中:
fwDevice:
WFS_CDM_DEVONLINE,说明该设备正常。
fwSafeDoor:
WFS_CDM_DOORCLOSED,说明保险柜门关,
WINCOR机芯特别处:
机芯保险柜门机芯控制,也只有门关才能出钞。
fwPosition:
WFS_CDM_POSFRONT,只指的是出钞口打开位置,
个别存款机,在ExecuteAdmin-->openshutter/closeshutter需要指定
szExtra:
是各厂家自由定义的扩展信息,其中WINCOR定义的SCOD指定是出钞模块数码关的信息如SCOD=00说明这时出钞模块物理状态正常,可出钞。
关于fwDevice,CDM的状态将会是下:
WFS_CDM_DEVONLINE设备在线。
当取款机存在并操作时被返回。
WFS_CDM_DEVOFFLINE设备离线。
(例如管理员按动开关或拉出设备使设备脱机)
WFS_CDM_DEVPOWEROFF设备电源关闭或实际上未接通电源。
WFS_CDM_DEVNODEVICE无此设备。
比如,该类型的自助银行不包含这样的设备或内
部没有配置这样的设备
WFS_CDM_DEVHWERROR由于硬件错误导致设备无法运行。
WFS_CDM_DEVUSERERROR设备存在,但人为阻止了设备运行。
WFS_CDM_DEVBUSY设备繁忙,此时无法处理执行命令。
WFS_CDM_DEVFRAUDATTEMPT设备存在,但已侦测到一个欺骗尝试。
后面各模块均有此状态值,不再细数。
获取钞箱信息:
•执行GetInfo/CashUnitInfo获取钞箱状态
如果
已打勾,会弹出下面信息框。
2.3获取配钞算法
当现金模块的出钞存在不同面值(如有100元和50元)时:
根据出钞的金额,需要通过指定的配钞算法来分别从各个钞箱挖出不同的张数;各钞箱的张数和面额相乘,累加起来正好为要出钞的金额。
执行GetInfo/CashUnitInfo。
以下为WINCOR的Probase的案例:
该案例中,只支持最小张数出钞(MINMUN)和均衡出钞(EQUAL)。
2.4加钞
首先执行ExecuteAdmin/startexchange选择加钞钞箱
会弹出:
此处继续点击“OK”(一般参数默认),继续弹出钞箱信息:
继续点击“OK”,即完成开始加钞。
然后执行ExecuteAdmin/Endexchange,参数详细参考WOSA技术手册
下图是开始时的面板
WINCOR机芯,“BILL”为出钞钞箱,状态“Status”如为“NREF”没做钱币参考值。
上图如果点击“Assign”可以重新分配钞箱,以下为两种分配钞箱方式。
拆分钞箱(多个出钞物理钞箱可能被合成一个逻辑钞箱,对此拆成逻辑和物理一对一):
合并钞箱(出钞钞箱逻辑和物理一对一,多个物理钞箱将被合成一个逻辑钞箱):
假如点击“OK”后,就会只剩一个BILL钞箱,如下图:
点击“OK”,完成加钞。
(关注下消息框,returnedWFS_SUCCESS代表加钞成功)。
2.5钞箱参考值
执行ExecutAdmin/CalibrateCashUnit进行钞箱参考值设置(仅Wincor机型有此设置)
上图操作完后就弹出下图中的参数输入框,从第一个钞箱出八张来做参考值
如图示,物理出钞钞箱,在所有钞箱中,逻辑第三个起(WOSA3.0的情况);(NumOfBills)张数不用填,硬件会根据钱币成色自动出八张钱(如新旧不均可能是12张或16张或者20张)下例图为8张的情况。
出完钞后就会弹出上图,说明出钞完毕了,点“OK”参考值设置完毕。
以下图是执行回收命令的,最后把出的钞票回收到回收钞箱。
2.6配钞
执行Execut/Deminate进行配钞,参数详细参考WOSA技术手册
进入配钞页面:
上图为1000元,点“OK”后:
完成配钞。
2.7挖钞
挖钞指的的是钱从钞箱挖出,送到出钞通道;但此时钞口没打开,客户拿不到钱这个过程(Wincor机芯必须保险柜门关上才能此操作)。
执行Execute/Dispense出钞。
参数详细参考WOSA技术手册
点击后进入:
关于上图,其他参数和配钞差不多;新增fwPosition:
WFS_CDM_POSNULL(缺省,默认都支持),WFS_CDM_POSFRONT这个值是根据GetInfo/status,获得。
有存取款功能的设备有部分机型要特别对应区分。
在点击“OK”后,出钞。
2.8送钞
送钞就是先打开钞口,将挖好的钞票送到客户能拿到的区域。
2.9回收客户钞票
注意:
钞票只有送到钞口位置,钞门打开,才能做Retract动作;其他钞位只能做Reject。
选定回收到的区域,一般为拒收箱(每种机芯不同的SP性能,回收位置不一样,有的支持回收到通道STACKER)。
点“OK”完成拒收。
2.10回收废钞
先挖钞票,不执行送钞“Present”命令;
输入金额200。
挖钞成功;
执行开始回收。
2.11其他测试项
其他:
•执行GetInfo/Capabities获取出钞模块性能(如最大出钞张数,回收支持的存放区域)
•执行ExecuteAdmin/SetCashUnitInfo设置钞箱数据(有的厂家不支持)
•执行ExecuteAdmin/TestCashUnits出钞测试(每个钞箱挖一张,有的厂家不支持)
3、存款模块的测试步骤
3.1打开CIM300.exe
将Dialogs打勾(没鼠标,就焦点移到直接敲“回车”;后面操作信息会以列框的形式,方便查看内容):
设置服务名:
Service—>Settings—>ServiceName。
以H3842为例,将服务名设成“CIM30”并确认:
运行“Service—>Open+Register”打开现金模块:
3.2获取设备状态
•执行GetInfo/status获取设备状态,在szExtra中包含了每个厂商的重要信息。
每个厂商的关键数据,但是非标准的数据可以通过这个接口传出来。
状态信息:
其中:
fwPosition:
WFS_CIM_POSINRIGHT,只指的是存款口打开位置。
szExtr:
扩展信息,各厂家定义不同,基本可以从ErrCode确定具体报错原因。
获取设备性能信息:
•执行GetInfo/Capabities获取设备性能。
弹出信息如下:
其中:
wMaxCashItems:
单次最大张数;
fwRetractAreas:
支持回收的位置。
关于存款设备钞箱信息特殊性:
•执行GetInfo/CashUnitInfo获取钞箱状态
获得钞箱信息如下:
存款机钞箱,取款箱和存款箱具有交互性,有的钞箱可以共用。
此时从CDM方面看钞箱信息:
钞箱状态规律如下:
1)如果钞箱被定义成单存(CIN)或者单取(BILL):
在另一方的“Type”为“RCYC”,并且“Status”为“MISS”。
2)只有钞箱被设成循环钞箱(RCYC):
从CDM和CIM看到的“Type”信息一致。
3)HCM3842支持修改钞箱面值和钞箱性质,CIM和CDM都要设置,可以通过“ExecuteAdmin”—>“startexchange/Endexchange”,但在Endexchange钞箱类型必须遵循上述规律。
3.3加钞
通过“ExecuteAdmin”—>“startexchange/Endexchange”过程和CDM基本相同,参考CDM部分。
3.4复位
当设备故障时,执行复位动作(ExecutAdmine/Reset)。
进“Reset”后:
以下点“OK”后,运行成功的信息:
3.5存款操作
3.5.1激活存款模式
执行Execute/CashInStart。
点完后会弹出:
默认即可,点“OK”开启存款模式。
以下为打开成功信息:
3.5.2打开钞口
•执行ExecuteAdmin/OpenShutter或者Execute/OpenShutter打开钞口。
点击后会出现:
注意,如果选择的项不对,有些设备可能无法存款,(如HCM3842,放钞和出钞是分别打开钞口,内分割挡板所在位置不一样):
1)WFS_CIM_POSINXXXXXX:
放钞时打开;
2)WFS_CIM_POSOUTXXXXXX:
出钞或者退钞时打开。
钱放进后,会有一个一个“EventWFS_SRVE_CIM_ITEMSINSERTED”事件,执行成功信息,如下图:
3.5.3关闭钞口
•放钞后执行ExecuteAdmin/CloseShutter或者Execute/CloseShutter关闭钞口(可以跳过,直接到验钞)。
会弹出:
默认,直接点“OK”,关闭钞口。
3.5.4验钞
验钞:
将钞口的钞进行检测,合格的钱放到缓存;不合格的钱退回到出钞口。
执行Execute/CashIn。
如未激活存款模式,会弹出:
此时要补做一次“Execute/CashInStart”。
如机芯正常,会进入验钞。
验钞结束,会弹出验钞信息:
1)无废钞案例
2)有废钞案例
上面信息为:
a.有无效钞:
(WFS_CIM_INVALIDBILL)WOSA工具无法看到无效张数
b.已识别钞:
1种(usNumOfNoteNumbers)
c.已识别钱币号(usNoteID)3;张数8(CNY100)
3)存款缓存满案例
3.5.5取未识别钞
当出现有未识别超和没识别完(缓存满)的钞时,先要把钞口的钱取出来,才能做“入钞”。
•取出不识别钞执行ExecuteAdmin/OpenShutter或Execute/OpenShutter打开钞口。
这时HCM3842推荐点“WFS_CIM_POSOUTRIGHT”,当然点默认位置可能可以:
钞口打开并拿走拒钞后会有一个“EventWFS_SRVE_CIM_ITEMSTAKEN”事件,下图为执行成功情况:
3.5.6入钞
入钞箱执行Execut/CashInEnd。
失败案例:
如果拒钞没拿走会报:
这时需要先排除故障,后做复位(ExecutAdmine/Reset)再重新从Execute/CashInStart)重新开始
成功案例:
如果执行成功后,会弹出入钞信息:
3.5.7退钞
前提条件,缓存内必有钞:
1)先执行激活钞箱,
2)再执行Openshutter
3)放入钞
4)执行验钞Execute/CashIn
5)缓存有钞
可执行退钞Execut/CashInRollback。
成功案例:
使用OpenShutter/CloseShutter,拿走退钞。
失败案例(存款未激活):
3.5.8关于结束存款模式
一旦执行Execute/CashInStart后,有三种情况结束存款模式:
1)设备报错;
2)执行完退钞;
3)执行完入钞。
出现以上三种情况后,本次存款结束。
必须重新执行CashInStart,才能继续存款操作。
4、读卡器IDC测试内容
4.1打开CDM300.exe
1)将Options/Dialogs打勾;
2)Servcie—>Setting—>ServcieName设置服务名(ICD30);
3)运行“Service-->Open+Register”。
设备打开后:
4.2获取状态
•执行GetInfo/status
读到读卡器的状态
这里,吞卡数(uCards)为1.
4.3读磁卡
执行Execut/ReadRawData.
点下后,弹出对话框选择读那几条磁道的数据,
其中:
WFS_IDC_CHIP读取IC芯片的数据。
WFS_IDC_FLUXINACTIVE关闭预读磁头(如受理纯IC卡)
这里只选择了一、二、三磁道。
磁道信息被读出来了。
4.4写磁卡
写磁卡数据Execut/WriteRawData
三条磁道信息数据写入(欧姆龙读卡仅支持低密卡写入,三洋读卡器不支持)。
4.5退卡
•退卡(Reject)
退卡成功
4.6吞卡
•吞卡(Retain)
吞卡一张
4.7清吞卡数
清除吞卡计数(ReSetCount)
清卡后读一下状态,以下的usCards是吞卡数现在是零张了就是说清零了
注意:
当吞卡逻辑计数满时,读卡器将停止工作(WINCOR为40张,东信为30张)。
5、打印机PRT测试内容
5.1打开PTR300.exe
选择运行脚本,这里点“取消”
这里以凭条打印机为例。
在执行open之前需要Service/Setting/ServiceName下设置凭条打印(否则open失败)
打开设备PRR30。
插卡状态:
5.2获取状态
获取“Status”状态信息如下:
其中:
WFS_PTR_SUPPLYUPPER代表供纸状态;
WFS_PTR_PAPERFULL纸满。
5.3原始打印
原始打印数据Execute/RawData:
输入所要打印的数据
打印完执行Execute/Controlmidia:
具体控制项打勾:
其中:
WFS_PTR_CTRLEJECT:
送纸。
WFS_PTR_CTRLCUT:
切纸。
点“OK”后,送纸和切纸。
关于不同打印机:
1)个别凭条打印机,纸取走会有各纸(PAPERTAKEN)拿走事件
2)有的打印机支持回收凭条
纸拿走事件:
一.
5.4FORM打印
关于FORM打印:
是一种比原始打印灵活丰富的打印方式,由FORM和MEDIA两块定义组成,可以粗略地理解(具体查阅文档):
1)MEDIA列表,为不同风格尺寸的框架;
2)FORM列表,具体打印的内容。
获取FORM。
以下为列表案例:
执行(Execute/PrintForm)
打印FRM(PrintForm)
这里,szFields和szUNICODEFields都要打勾,不然“OK”键不会激活。
无法打印
6、密码键盘PIN测试
6.1打开PIN300.exe。
运行PIN300,设好服务名:
PIN30后:
6.2获取状态
选择第一个Status
获取状态,加密键盘已经准备好了。
6.3获取KEY列表
获取加密键盘中的key具体信息。
把Allkeys选上就是获取所有key的信息
以下就是获取到的所有key的信息
6.4获取按键明文
即获取按键的明文值(比如小数点的定义,左右功能键的排序);执行Execute/GetData:
进入后会弹出:
其中:
usMaxlen:
最大长度(默认值0,为长度不限制);
bAutoEnd:
长度到自动结束(如打勾);
ulActiveFDKs:
激活左右功能键;
ulActiveKeys:
激活密码键盘按键(双零占两个长度);
ulTerminateFDKs:
按后终止测试的左右功能键;
ulTerminateKeys:
按后终止测试的密码键盘按键;
下为案例:
通过这个功能可以测试密码键盘、左右功能键各按键的好坏;判断是否符合应用程序的要求(特别是跨平台的功能按键值,各厂家不一样)。
6.5初始化密码键盘
初始化(INITIALIZATION):
情况一、都不打勾,直接点“OK”,如下图:
仅仅做个硬件初始化正常返回,不清空硬件数据:
硬件有问题的情况:
这是设备未就绪的情况。
情况二、打勾后,直接点“OK”,如下图:
初始化后返回的结果,数据被清空,用GetInfo/KeyDetail找不到KEY:
6.6导入KEY
执行Execute/ImportKey。
LocalMasterKey例:
lpsKey="LocalMasterKey"
lpsEncKey=NULL
lpxIdent=NULL
lpxValue
lpbData3031323334353637
fwUseWFS_PIN_USEKEYENCKEY、WFS_PIN_USECRYPT
执行“OK”后:
PinKey例:
执行结果:
MacKey例:
运行结果:
导完KEY后,再用用GetInfo/KeyDetail看:
6.7GetPIN、GetPINBlock
这两个命令是对应的,执行了一次GetPIN后才能执行一次GetPINBlock。
6.7.1获取PIN:
执行Execute/GetPIN:
按图示例来选择参数
按“OK”后,输完6个数字按钮后:
这里表示:
输完6个数字,显示的都是密文,自动结束。
6.7.1获取PINBlock
执行GetPINBlock用来得到PinBlock的值
进入后输入参数,设好KEY:
以下是得到加密过的PinBlock值(bData):
6.8加解密
执行Execute/Crypt:
以下输入要加密的数据,用LocalMasterKey来加密:
关于参数解释:
wMode
说明是否需要加密或解密,值为如下之一:
ValueMeaning
WFS_PIN_MODEENCRYPT加密
WFS_PIN_MODEDECRYPT解密
WFS_PIN_MODERANDOM将返回一个8字节随机值(这种情况下其他参数将被忽略)。
此参数不适用MACing。
lpsKey
说明存储的密钥名称。
如果wMode等于WFS_PIN_MODERANDOM,此值将被忽略。
.
lpxKeyEncKey
如果为空,lpsKey将直接用于加密/解密。
然而,lpsKey用于解密(EBC模式)通过lpxKeyEncKey传过来的
加密密钥并且结果用于加密/解密。
这种规格的用户在使用3倍DES时必须和本地规则紧密连接。
如果
wMode为WFS_PIN_MODERANDOM,此值将被忽略。
wAlgorithm
说明加密算法。
在WFS_INF_PIN_CAPABILITIES中描述的可能值。
如果wMode为
WFS_PIN_MODERANDOM,此值将被忽略。
lpsStartValueKey
说明存储的密钥(用于解密lpxStartValue以接收初始化向量)名称。
如果此参数为空,lpxStartValue作为初
始化向量。
如果wMode为WFS_PIN_MODERANDOM,此值将被忽略。
lpxStartValu
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- Wosa30 测试 工具 使用手册