Wosa3.0 测试工具使用手册.doc

Wosa3.0 测试工具使用手册 Wosa3.0 测试工具使用手册文件状态： 草稿 正式发布 正在修改文件类型：指导类文件名称：Wosa3.0 测试工具使用手册.doc文件编号：当前版本：V0.1完成日期：2015-9-21文档密级：一般东方通信股份有限公司金融事业部前言- 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测试内容- 44 -5.1打开PTR300.exe- 44 -5.2获取状态- 44 -5.3原始打印- 45 -5.4 FORM打印- 48 -6、密码键盘PIN测试- 50 -6.1打开PIN300.exe。- 50 -6.2获取状态- 50 -6.3获取KEY列表- 51 -6.4获取按键明文- 52 -6.5初始化密码键盘- 54 -6.6导入KEY- 55 -6.7 GetPIN、GetPINBlock- 59 -6.7.1获取PIN：- 59 -6.7.1获取PINBlock- 61 -6.8加解密- 62 -7、 SIU测试- 65 -7.1打开SIU300- 65 -7.2获取状态- 65 -7.3设置指示灯- 67 -7.4设置导向灯- 68 -7.5检测传感器- 70 -8、TTU测试- 71 -8.1打开TTU300- 71 -8.2获取状态- 71 -8.3控制指示灯- 72 -8.4显示数据- 73 -8.5读取数据- 74 -8.6设置显示模式- 75 -总结- 76 -前言 本文档基于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 PRJ30start fwmain32 -e PRR30start fwmain32 -e TTU30start fwmain32 -e IDC30start fwmain32 -e PIN30start fwmain32 -e SIU30或 start fwmain32 -e CDM30 PRR30 PRJ30 TTU30 IDC30 PIN30 SIU30 1.2 确认WOSA服务名一般WOSA服务名注册表路径：HKEY_USERS.DEFAULTXFSLOGICAL_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其他测试项其他：执行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：出钞或者退钞时打开。钱放进后，会有一个一个“Event WFS_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（CNY 100）3）存款缓存满案例3.5.5取未识别钞当出现有未识别超和没识别完（缓存满）的钞时，先要把钞口的钱取出来，才能做“入钞”。取出不识别钞 执行ExecuteAdmin/OpenShutter 或 Execute/OpenShutter打开钞口。这时HCM3842推荐点“WFS_CIM_POSOUTRIGHT”,当然点默认位置可能可以：钞口打开并拿走拒钞后会有一个“Event WFS_SRVE_CIM_ITEMSTAKEN”事件，下图为执行成功情况：3.5.6入钞入钞箱执行Execut/CashInEnd。失败案例：如果拒钞没拿走会报：这时需要先排除故障，后做复位（ExecutAdmine/Reset）再重新从 Execute/CashInStart )重新开始成功案例：如果执行成功后，会弹出入钞信息：3.5.7退钞前提条件，缓存内必有钞：1） 先执行 激活钞箱，2） 再执行Open shutter 3） 放入钞4） 执行验钞Execute/CashIn 5） 缓存有钞可执行退钞Execut/CashInRollback。成功案例：使用OpenShutter/CloseShutter，拿走退钞。失败案例（存款未激活）：3.5.8关于结束存款模式一旦执行Execute/CashInStart后，有三种情况结束存款模式：1） 设备报错；2） 执行完退钞；3） 执行完入钞。出现以上三种情况后，本次存款结束。必须重新执行CashInStart，才能继续存款操作。 4、 读卡器IDC测试内容4.1打开CDM300.exe1） 将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） 个别凭条打印机，纸取走会有各纸（PAPER TAKEN）拿走事件2） 有的打印机支持回收凭条纸拿走事件：一5.4 FORM打印关于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具体信息。把All keys选上就是获取所有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 = LocalMasterKeylpsEncKey = NULLlpxIdent = NULLlpxValuelpbData 30 31 32 33 34 35 36 37fwUse WFS_PIN_USEKEYENCKEY、WFS_PIN_USECRYPT执行“OK”后：PinKey例：执行结果：MacKey例：运行结果：导完KEY后，再用用GetInfo/KeyDetail看：6.7 GetPIN、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说明是否需要加密或解密，值为如下之一：Value MeaningWFS_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，此值将被忽略。lpxStartValueCBC/CFB加密和MACing时DES和3倍的初始化向量。如果此参数为空，CBC / CFB / MAC的默认值为16个16进制数据0x0。如果wMode为WFS_PIN_MODERANDOM，此值将被忽略。bPadding说明填充字符。填充字符为一个整