Wosa3.0 测试工具使用手册
东方通信股份有限公司
金融事业部
前言.............................................................................................................................................. - 4 -1、测试前准备............................................................................................................................ - 4 -
1.1 启动WOSA服务............................................................................................................ - 4 -
1.2 确认WOSA服务名........................................................................................................ - 4 -
1.3 开启WOSA测试工具.................................................................................................... - 5 -
2、出钞模块的测试步骤............................................................................................................ - 6 -
2.1打开CDM300.exe.......................................................................................................... - 6 -
2.2获取设备状态................................................................................................................ - 7 -
2.3获取配钞算法.............................................................................................................. - 10 -
2.4加钞............................................................................................................................. - 10 -
2.5钞箱参考值................................................................................................................. - 13 -
2.6配钞............................................................................................................................. - 15 -
2.7挖钞............................................................................................................................. - 16 -
2.8送钞............................................................................................................................. - 17 -
2.9回收客户钞票............................................................................................................. - 18 -
2.10回收废钞................................................................................................................... - 19 -
2.11其他测试项................................................................................................................ - 20 -
3、存款模块的测试步骤.......................................................................................................... - 21 -
3.1打开CIM300.exe ......................................................................................................... - 21 -
3.2获取设备状态.............................................................................................................. - 22 -
3.3加钞............................................................................................................................. - 26 -
3.4复位............................................................................................................................. - 26 -
3.5存款操作..................................................................................................................... - 28 -
3.5.1激活存款模式................................................................................................... - 28 -
3.5.2打开钞口........................................................................................................... - 28 -
3.5.3关闭钞口........................................................................................................... - 30 -
3.5.4验钞................................................................................................................... - 30 -
3.5.5取未识别钞....................................................................................................... - 32 -
3.5.6入钞................................................................................................................... - 32 -
3.5.7退钞................................................................................................................... - 34 -
3.5.8关于结束存款模式........................................................................................... - 35 -
4、读卡器IDC测试内容....................................................................................................... - 35 -
4.1打开CDM300.exe ....................................................................................................... - 35 -
4.2获取状态...................................................................................................................... - 37 -
4.3读磁卡.......................................................................................................................... - 37 -
4.4写磁卡......................................................................................................................... - 39 -
4.5退卡............................................................................................................................. - 40 -
4.6吞卡............................................................................................................................. - 41 -
4.7清吞卡数..................................................................................................................... - 42 -
5、打印机PRT测试内容....................................................................................................... - 43 -
5.1打开PTR300.exe ......................................................................................................... - 43 -
5.2获取状态..................................................................................................................... - 44 -
5.3原始打印..................................................................................................................... - 45 -
5.4 FORM打印................................................................................................................... - 47 -
6、密码键盘PIN测试 ............................................................................................................. - 49 -
6.1打开PIN300.exe。.................................................................................................... - 49 -
6.2获取状态..................................................................................................................... - 49 -
6.3获取KEY列表............................................................................................................. - 50 -
6.4获取按键明文............................................................................................................. - 51 -
6.5初始化密码键盘......................................................................................................... - 53 -
6.6导入KEY...................................................................................................................... - 54 -
6.7 GetPIN、GetPINBlock .............................................................................................. - 58 -
6.7.1获取PIN： ....................................................................................................... - 58 -
6.7.1获取PINBlock.................................................................................................. - 60 -
6.8加解密......................................................................................................................... - 61 -
7、SIU测试 ............................................................................................................................ - 64 -
7.1打开SIU300 ................................................................................................................ - 64 -
7.2获取状态..................................................................................................................... - 64 -
7.3设置指示灯................................................................................................................. - 66 -
7.4设置导向灯................................................................................................................. - 67 -
7.5检测传感器................................................................................................................. - 69 -
8、TTU测试............................................................................................................................. - 70 -
8.1打开TTU300 ................................................................................................................. - 70 -
8.2获取状态..................................................................................................................... - 70 -
8.3控制指示灯................................................................................................................. - 71 -
8.4显示数据..................................................................................................................... - 72 -
8.5读取数据..................................................................................................................... - 73 -
8.6设置显示模式............................................................................................................. - 74 -总结............................................................................................................................................ - 75 -
前言
本文档基于WOSA3.O标准的测试工具操作指导。不同厂商和不同的部件只要装了WOSA3.0平台，通过该工具，就可以进行功能性的测试以及设备故障的初步定位。
1、测试前准备
1.1 启动WOSA服务
一般厂家，在调用WOSA服务设备时（如起WOSA工具），WOSA服务会自动调起，如东信（Potevio）的SP。
但也有厂家设备，在调WOSA设备前，要运行独立起WOSA服务程序，以下为Wincor的起各项SP3.0服务的案例：
start fwmain32 -e CDM30
start fwmain32 -e CIM30
start fwmain32 -e PRJ30
start fwmain32 -e PRR30
start fwmain32 -e TTU30
start fwmain32 -e IDC30
start fwmain32 -e PIN30
start fwmain32 -e SIU30
或 start fwmain32 -e CDM30 PRR30 PRJ30 TTU30 IDC30 PIN30 SIU30
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”，完成加钞。（关注下消息框，returned WFS_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其他测试项
其他：