Wosa30测试工具使用手册.docx

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