前言:
写给ATM硬件和软件人员的无言歌。
希望对工作有所帮助,能够少花些时间在解决相关问题上,多些时间做自己喜欢做的事情。
一定意义上来讲,任何ATM从业人员都应该看下这篇文章。
正文:
随着符合WOSA/XFS规范的跨平台ATMC软件日益铺开,确实有很多人需要稍微深入的知道一些相关概念,但没有这样的文章来介绍,并且可能在很长的时间内,都不会有这种文章,所以就出现了这篇你现在所看到文章。
该如何组织内容,其实是个比较难办的问题,只能走到哪是哪了,希望能在文中捡到一些珍珠,如果有的话。
我们先从WOSA/XFS的历史来简单的看一下,搞清楚WOSA/XFS的历史也有助于理解它。
WOSA/XFS规范目前使用广泛的版本有1.0、1.11、2.0、3.0、3.01、3.02、3.03一共7个版本,其中常说谁的 SP(Service Provider)符合WOSA/XFS2.0还是3.0规范,就是指上面提到的WOSA/XFS本身的规范版本。如果你见到某些厂家的SP版本并没有上 面提到的几个版本,那说明厂家的SP版本是自己厂家内部定的版本号,与WOSA/XFS规范的版本没有必然联系,但是厂家的SP版本一定可以对应到符合上 面几个版本中的一个版本。目前最新的是WOSA/XFS 3.03规范。
对于WOSA/XFS,XFS Manager是一定要提到的。我们简单看看WOSA/XFS的架构,这个大家应该都比较熟悉了。中间是XFS Manager,上面是ATMC,下面是SP,其中XFS Manager对上面有API(Application Programming Interface)接口,对下面有SPI(Service Provider Interface)接口。
XFS Manager是WOSA/XFS规范的核心,它规定了API和SPI接口,从而达到统一上面的ATMC和下面的SP的功能,ATM软件能够实现所谓的跨平台是靠它来主要实现的。
XFS Manager实际上是三个DLL组成,在系统目录\Windows\System32下面,分别是MSXFS.DLL(基本的XFS API and SPI函数,在Include目录下的XFSAPI.H和XFSSPI.H中定义)、XFS_SUPP.DLL(一些支持函数,在Include目录下的 XFSADMIN.H中定义)、XFS_CONF.DLL(配置函数,在Include目录下的Xfsconf.h中定义)。
我们上面提到的7个版本,可以通过找到MSXFS.DLL文件,然后右键查看其文件属性,里面有个版本号,从而就知道某台机器运行的SP符合哪个版本的WOSA/XFS规范,这是个判断WOSA/XFS版本的一个有效办法。
XFS Manager的这三个DLL是公开免费使用的,在WOSA/XFS 2.0以前,XFS Manager是由微软公司开发的,从WOSA/XFS 3.0以后转到CEN/XFS来开发,实际上是NEXUS公司做为主导在维护开发。如果是CEN/XFS的会员,则可以获得XFS Manager的源代码,目前几大厂商都是会员,所以基本都有XFS Manager的源代码。
我们总是在说WOSA/XFS,那到底它包含什么内容?
一、 一组文档,可以认为是个软件概要设计说明书,只是设计,没有代码实现
二、 上面提到的XFS Manager的三个DLL
三、 每个厂商按照文档实现的一组DLL,叫过SP
前两个先不管,我们看第三个,这个是我们常见的。WOSA/XFS规定SP必须是基于DLL形式的,不管你做成什么样子,对于XFS Manager向下看,必须是看到导出SPI接口的SP DLL。
下面看看跟WOSA/XFS有关的注册表配置,对于WOSA/XFS2.0,所有的配置在HKEY_CLASSES_ROOT\WOSA /XFS_ROOT,对于WOSA/XFS3.0,配置分到两个地方,HKEY_LOCAL_MACHINE\SOFTWARE\XFS和 HKEY_USERS\.DEFAULT\XFS。WOSA/XFS3.0把注册表分为两个部分,是考虑安全性,不同的登录用户看到的设备可能是不一样 的。
不管版本的差别,注册表主要的内容有三项,一项是XFS_MANAGER,属于XFS Manager本身的配置项;一项是LOGICAL_SERVICES,是给ATMC应用用的,区别每种设备;一项是 SERVICE_PROVIDERS,具体对应到某个硬件设备;另外一般有PHYSICAL_SERVICES,存放厂商的硬件配置。对于具体的每一项的 说明,请参考文档《cwa14050-01-2000-Nov.pdf》的22页到25页内容。建议看看这份文档,对于从事ATM工作有很大帮助,它的细 节可以不用管,只要知道一些大概的概念即可。
一般一个厂家的SP,只需要十几个文件即可,内容比较少,但是象NCR、Diebold等的SP,安装起来会花上一些时间,因为里面包含了硬件诊断工具、配置工具等实际上跟SP没有关系的东西。
因为SP的接口是统一的,所以我们会看到很多厂家提供的有XFS测试工具,能够测试多个厂家的SP,比如Wincor的WosaTest,Diebold的XTG等,这些工具可以互换使用的,反正接口都是符合一个标准的。
因为很多硬件工程师可能需要用到这些SP测试工具,这里简单说一下怎样使用这些工具,当然,如果想完全使用该工具的每个功能,不仅仅需要测试工具本身的说明,熟悉WOSA/XFS的规范是必要的,所以基本上能操作即可。
一个完整的SP测试操作如下(下面的操作一般可以在SP测试工具的菜单或者工具栏中直接找到,一些步骤中出现的参数选择,基本可以采用默认的参数即可):
一、 在SP测试工具中调用WFSStartUp, 目的是把整个SP的环境启起来,包括把XFS Manager装载到测试工具的进程空间中。
二、 在SP测试工具中调用WFSOpen,目的是打开某个硬件模块,SP测试工具一般一次只能打开一种类型的硬件设备。其中要注意的是有个参数叫过 Logical Name“逻辑名”,这个一定要填对,一般的厂家都有固定的习惯,比如Diebold会叫NT_IDC、NT_CDM等,打开哪个设备就填上对应的名字。 所有可能的名字在上面提到的注册表项LOGICAL_SERVICES下面,如果不清楚,你可以看看哪个名字象你要测试的设备,填上这个名字一般错不了。
三、 在SP测试工具中调用WFSRegister,目的是注册一下,以便能够接收到SP传上来的事件。
四、 在SP测试工具中调用WFSLock,这步基本可以省略。目的是锁定设备,主要是防止同时还有其他程序在访问该设备,达到独占设备的目的。
五、 然后调用WFSGetInfo来获取设备的信息,相当于Read设备;也可以调用WFSExecute来对设备发命令,相当于Write设备,这两个是一 个对应。基本所有的命令都是通过这两个接口来完成的,其他步骤都是准备工作而已。对于WFSGetInfo和WFSExecute是各自包含一组命令,可 以选择单独的命令来执行。至于每个命令的意思,要看WOSA/XFS的那些规范文档了,每个命令都有详细的描述。
六、 所有测试完成后,调用WFSUnLock,用来解锁,如果第四步有锁定设备。
七、 在SP测试工具中调用WFSUnRegister,目的是反注册一下,表明不再接收SP传上来的事件了。
八、 在SP测试工具中调用WFSClose,目的是关闭设备,比如关闭串口通讯等。
九、 在SP测试工具中调用WFSCleanUp,目的是释放整个SP的运行环境,把使用的相关文件和资源全部恢复。
至此,一个完整的SP测试流程已经完成了,可以经过这几步对设备进行测试,多熟悉下一个SP测试工具,就会明白每个命令是干什么的了。对于硬件工程师,如 果在知道厂商硬件诊断工具之外,再知道怎样操作这个,对于诊断系统的问题也是有很大帮助的,尤其是在运行跨平台软件的机器上。目前最好的SP测试工具应该 是Wincor的测试工具,使用的比较广泛,其他厂商的各有特点。
下面讲讲WOSA/XFS规范文档的内容结构。WOSA/XFS3.0规范文档大概分为四十多个pdf文档,都可以免费下载到,下载地址在本文附录中提到。
其中第一份文档最重要,是讲整个WOSA/XFS的架构、配置信息、API/SPI、内存管理等内容,稍微难懂了些,如果能看看则对整个WOSA/XFS有所了解。介于阅读英文的规范对于中国人比较难,所以会有一定的障碍。
第二份文档讲WOSA/XFS规范都涉及到了哪些模块等信息,对每个模块进行了简单的综述。
从第三份文档开始,依次介绍每种设备的命令,其实都是在讲WFSGetInfo和WFSExecute,只是参数不同。每份文档的结构大同小异,先是讲 WFSGetInfo的各个命令及其参数、注意事项等;接着讲WFSExecute的各个命令及其参数、注意事项等;接着讲该设备可能发生的 Events;最后是C语言的头文件。
从大概第16份文档开始,是讲怎样从WOSA/XFS2.0规范迁移到WOSA/XFS3.0规范,主要是提供给旧版本的SP用的,可以不看它们。
从大概第29份文档开始,是讲关于SNMP监控的,目前可以不看它们。
那么目前只看前十五份文档即可。
WOSA/XFS规范文档目前没有中文的,并且也不要指望CEN/XFS会出中文文档,因为翻译过程中会丢掉很多重要信息,毕竟是一个严密的规范,不是小 说,漏掉点内容问题不大,这个翻译错了,就会有误解。但是,也不是不可能翻译成中文版的,前提是必须非常熟悉WOSA/XFS规范,才能高屋建瓴的来翻译 这些文档。国内也有几个厂家翻译过WOSA/XFS规范,只是没有对外公开其翻译的内容。
当你看到了这么多文档后,就会理解为什么不同的厂家对WOSA/XFS规范会有不同的理解。因为硬件是多样性的,能够在一份规范中把所有硬件都统一进来是 非常不容易的事情。可能有些细节是没有考虑到的,但是我们看到WOSA/XFS规范也是在不断的进步和完善,不断随着市场的变化推出新的规范版本。
WOSA/XFS规范不久会因为微软推出.NET平台受到一些影响,但是其本质上是不会改变的,至多是XFS Manager和SP的代码会重写,那些关于ATM硬件的命令是暂时不会过时的。
附录:
在网址http://www.cenorm.be/cenorm/businessdomains/businessdomains/isss/cwa/banking+peripherals.asp
为有关WOSA/XFS的文档下载地址,其中"CWA 13449"为WOSA/XFS的2.0版本,"CWA 14050"为WOSA/XFS的3.03版本。
写给ATM硬件和软件人员的无言歌。
希望对工作有所帮助,能够少花些时间在解决相关问题上,多些时间做自己喜欢做的事情。
一定意义上来讲,任何ATM从业人员都应该看下这篇文章。
正文:
随着符合WOSA/XFS规范的跨平台ATMC软件日益铺开,确实有很多人需要稍微深入的知道一些相关概念,但没有这样的文章来介绍,并且可能在很长的时间内,都不会有这种文章,所以就出现了这篇你现在所看到文章。
该如何组织内容,其实是个比较难办的问题,只能走到哪是哪了,希望能在文中捡到一些珍珠,如果有的话。
我们先从WOSA/XFS的历史来简单的看一下,搞清楚WOSA/XFS的历史也有助于理解它。
WOSA/XFS规范目前使用广泛的版本有1.0、1.11、2.0、3.0、3.01、3.02、3.03一共7个版本,其中常说谁的 SP(Service Provider)符合WOSA/XFS2.0还是3.0规范,就是指上面提到的WOSA/XFS本身的规范版本。如果你见到某些厂家的SP版本并没有上 面提到的几个版本,那说明厂家的SP版本是自己厂家内部定的版本号,与WOSA/XFS规范的版本没有必然联系,但是厂家的SP版本一定可以对应到符合上 面几个版本中的一个版本。目前最新的是WOSA/XFS 3.03规范。
对于WOSA/XFS,XFS Manager是一定要提到的。我们简单看看WOSA/XFS的架构,这个大家应该都比较熟悉了。中间是XFS Manager,上面是ATMC,下面是SP,其中XFS Manager对上面有API(Application Programming Interface)接口,对下面有SPI(Service Provider Interface)接口。
XFS Manager是WOSA/XFS规范的核心,它规定了API和SPI接口,从而达到统一上面的ATMC和下面的SP的功能,ATM软件能够实现所谓的跨平台是靠它来主要实现的。
XFS Manager实际上是三个DLL组成,在系统目录\Windows\System32下面,分别是MSXFS.DLL(基本的XFS API and SPI函数,在Include目录下的XFSAPI.H和XFSSPI.H中定义)、XFS_SUPP.DLL(一些支持函数,在Include目录下的 XFSADMIN.H中定义)、XFS_CONF.DLL(配置函数,在Include目录下的Xfsconf.h中定义)。
我们上面提到的7个版本,可以通过找到MSXFS.DLL文件,然后右键查看其文件属性,里面有个版本号,从而就知道某台机器运行的SP符合哪个版本的WOSA/XFS规范,这是个判断WOSA/XFS版本的一个有效办法。
XFS Manager的这三个DLL是公开免费使用的,在WOSA/XFS 2.0以前,XFS Manager是由微软公司开发的,从WOSA/XFS 3.0以后转到CEN/XFS来开发,实际上是NEXUS公司做为主导在维护开发。如果是CEN/XFS的会员,则可以获得XFS Manager的源代码,目前几大厂商都是会员,所以基本都有XFS Manager的源代码。
我们总是在说WOSA/XFS,那到底它包含什么内容?
一、 一组文档,可以认为是个软件概要设计说明书,只是设计,没有代码实现
二、 上面提到的XFS Manager的三个DLL
三、 每个厂商按照文档实现的一组DLL,叫过SP
前两个先不管,我们看第三个,这个是我们常见的。WOSA/XFS规定SP必须是基于DLL形式的,不管你做成什么样子,对于XFS Manager向下看,必须是看到导出SPI接口的SP DLL。
下面看看跟WOSA/XFS有关的注册表配置,对于WOSA/XFS2.0,所有的配置在HKEY_CLASSES_ROOT\WOSA /XFS_ROOT,对于WOSA/XFS3.0,配置分到两个地方,HKEY_LOCAL_MACHINE\SOFTWARE\XFS和 HKEY_USERS\.DEFAULT\XFS。WOSA/XFS3.0把注册表分为两个部分,是考虑安全性,不同的登录用户看到的设备可能是不一样 的。
不管版本的差别,注册表主要的内容有三项,一项是XFS_MANAGER,属于XFS Manager本身的配置项;一项是LOGICAL_SERVICES,是给ATMC应用用的,区别每种设备;一项是 SERVICE_PROVIDERS,具体对应到某个硬件设备;另外一般有PHYSICAL_SERVICES,存放厂商的硬件配置。对于具体的每一项的 说明,请参考文档《cwa14050-01-2000-Nov.pdf》的22页到25页内容。建议看看这份文档,对于从事ATM工作有很大帮助,它的细 节可以不用管,只要知道一些大概的概念即可。
一般一个厂家的SP,只需要十几个文件即可,内容比较少,但是象NCR、Diebold等的SP,安装起来会花上一些时间,因为里面包含了硬件诊断工具、配置工具等实际上跟SP没有关系的东西。
因为SP的接口是统一的,所以我们会看到很多厂家提供的有XFS测试工具,能够测试多个厂家的SP,比如Wincor的WosaTest,Diebold的XTG等,这些工具可以互换使用的,反正接口都是符合一个标准的。
因为很多硬件工程师可能需要用到这些SP测试工具,这里简单说一下怎样使用这些工具,当然,如果想完全使用该工具的每个功能,不仅仅需要测试工具本身的说明,熟悉WOSA/XFS的规范是必要的,所以基本上能操作即可。
一个完整的SP测试操作如下(下面的操作一般可以在SP测试工具的菜单或者工具栏中直接找到,一些步骤中出现的参数选择,基本可以采用默认的参数即可):
一、 在SP测试工具中调用WFSStartUp, 目的是把整个SP的环境启起来,包括把XFS Manager装载到测试工具的进程空间中。
二、 在SP测试工具中调用WFSOpen,目的是打开某个硬件模块,SP测试工具一般一次只能打开一种类型的硬件设备。其中要注意的是有个参数叫过 Logical Name“逻辑名”,这个一定要填对,一般的厂家都有固定的习惯,比如Diebold会叫NT_IDC、NT_CDM等,打开哪个设备就填上对应的名字。 所有可能的名字在上面提到的注册表项LOGICAL_SERVICES下面,如果不清楚,你可以看看哪个名字象你要测试的设备,填上这个名字一般错不了。
三、 在SP测试工具中调用WFSRegister,目的是注册一下,以便能够接收到SP传上来的事件。
四、 在SP测试工具中调用WFSLock,这步基本可以省略。目的是锁定设备,主要是防止同时还有其他程序在访问该设备,达到独占设备的目的。
五、 然后调用WFSGetInfo来获取设备的信息,相当于Read设备;也可以调用WFSExecute来对设备发命令,相当于Write设备,这两个是一 个对应。基本所有的命令都是通过这两个接口来完成的,其他步骤都是准备工作而已。对于WFSGetInfo和WFSExecute是各自包含一组命令,可 以选择单独的命令来执行。至于每个命令的意思,要看WOSA/XFS的那些规范文档了,每个命令都有详细的描述。
六、 所有测试完成后,调用WFSUnLock,用来解锁,如果第四步有锁定设备。
七、 在SP测试工具中调用WFSUnRegister,目的是反注册一下,表明不再接收SP传上来的事件了。
八、 在SP测试工具中调用WFSClose,目的是关闭设备,比如关闭串口通讯等。
九、 在SP测试工具中调用WFSCleanUp,目的是释放整个SP的运行环境,把使用的相关文件和资源全部恢复。
至此,一个完整的SP测试流程已经完成了,可以经过这几步对设备进行测试,多熟悉下一个SP测试工具,就会明白每个命令是干什么的了。对于硬件工程师,如 果在知道厂商硬件诊断工具之外,再知道怎样操作这个,对于诊断系统的问题也是有很大帮助的,尤其是在运行跨平台软件的机器上。目前最好的SP测试工具应该 是Wincor的测试工具,使用的比较广泛,其他厂商的各有特点。
下面讲讲WOSA/XFS规范文档的内容结构。WOSA/XFS3.0规范文档大概分为四十多个pdf文档,都可以免费下载到,下载地址在本文附录中提到。
其中第一份文档最重要,是讲整个WOSA/XFS的架构、配置信息、API/SPI、内存管理等内容,稍微难懂了些,如果能看看则对整个WOSA/XFS有所了解。介于阅读英文的规范对于中国人比较难,所以会有一定的障碍。
第二份文档讲WOSA/XFS规范都涉及到了哪些模块等信息,对每个模块进行了简单的综述。
从第三份文档开始,依次介绍每种设备的命令,其实都是在讲WFSGetInfo和WFSExecute,只是参数不同。每份文档的结构大同小异,先是讲 WFSGetInfo的各个命令及其参数、注意事项等;接着讲WFSExecute的各个命令及其参数、注意事项等;接着讲该设备可能发生的 Events;最后是C语言的头文件。
从大概第16份文档开始,是讲怎样从WOSA/XFS2.0规范迁移到WOSA/XFS3.0规范,主要是提供给旧版本的SP用的,可以不看它们。
从大概第29份文档开始,是讲关于SNMP监控的,目前可以不看它们。
那么目前只看前十五份文档即可。
WOSA/XFS规范文档目前没有中文的,并且也不要指望CEN/XFS会出中文文档,因为翻译过程中会丢掉很多重要信息,毕竟是一个严密的规范,不是小 说,漏掉点内容问题不大,这个翻译错了,就会有误解。但是,也不是不可能翻译成中文版的,前提是必须非常熟悉WOSA/XFS规范,才能高屋建瓴的来翻译 这些文档。国内也有几个厂家翻译过WOSA/XFS规范,只是没有对外公开其翻译的内容。
当你看到了这么多文档后,就会理解为什么不同的厂家对WOSA/XFS规范会有不同的理解。因为硬件是多样性的,能够在一份规范中把所有硬件都统一进来是 非常不容易的事情。可能有些细节是没有考虑到的,但是我们看到WOSA/XFS规范也是在不断的进步和完善,不断随着市场的变化推出新的规范版本。
WOSA/XFS规范不久会因为微软推出.NET平台受到一些影响,但是其本质上是不会改变的,至多是XFS Manager和SP的代码会重写,那些关于ATM硬件的命令是暂时不会过时的。
附录:
在网址http://www.cenorm.be/cenorm/businessdomains/businessdomains/isss/cwa/banking+peripherals.asp
为有关WOSA/XFS的文档下载地址,其中"CWA 13449"为WOSA/XFS的2.0版本,"CWA 14050"为WOSA/XFS的3.03版本。