DIN CWA 14050-10-2002 Extensions for Financial Services (XFS) interface specification - Release 3 01 - Part 10 Sensors and indicators unit device class interface English version CW.pdf

1、Englische Fassung CWA 14050-10:2002ICS 35.200; 35.240.40Schnittstellenspezifikation fr die Extensions for Financial Services (XFS) Version 3.01 Teil 10: Schnittstelle fr die Gerteklasse Sensoren undIndikatorenCWA 14050-10 Beuth Verlag GmbH, 2002 Jede Art der Vervielfltigung, auch auszugsweise,nur mi

2、t Genehmigung des Beuth Verlages gestattet.Alleinverkauf durch Beuth Verlag GmbH, 10772 BerlinRef. Nr. DIN CWA 14050-10:2002-08RW DIN CWA Preisgr. 07August 2002Extensions for Financial Services (XFS) interfacespecification Release 3.01 Part 10: Sensors andIndicators Unit Device Class InterfaceFortse

3、tzung 49 Seiten CWANationales VorwortDieses CEN Workshop Agreement CWA 14050-10, das vom CEN/ISSS XFS Workshop erarbeitet wurde, wirdausschlielich in englischer Sprache zur Verfgung gestellt.CEN Workshop Agreements werden im Rahmen eines Konsortiums entwickelt. Sie unterscheiden sich vonEuropischen

4、Normen dadurch, dass sie grundstzlich kein ffentliches Einspruchsverfahren durchlaufen unddass auch keine nationale Meinungsbildung stattfindet. Im Gegensatz zu Europischen Normen, die denKonsens aller interessierten Kreise darstellen, haben CEN Workshop Agreements lediglich die Zustimmung derunmitt

5、elbar beteiligten Mitglieder des Konsortiums gefunden.Fr den Inhalt sind ausschlielich die Mitglieder des Konsortiums verantwortlich (siehe ergnzende Hinweise imCWA-Vorwort). Weder das CEN-Zentralsekretariat noch die CEN-Mitglieder haben den Inhalt auf eventuelleFehler oder Widersprche zu Normen und

6、 Rechtsvorschriften geprft.B55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Leerseite B55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Rue de Stassart, 36 B-1050 BruxellesTel : +32 2 550 08 11 Fax : +32 2 550 08 19EUROPEAN COMMITTEE FOR STANDARDIZATION COMIT E

7、UROPEN DE NORMALISATION EUROPISCHES KOMITEE FR NORMUNG WORKSHOPCWA 14050-10AGREEMENTMarch 2002ICS 35.200; 35.240.40 Supersedes CWA 14050-10:2000Extensions for Financial Services (XFS) interface specification -Release 3.01 - Part 10: Sensors and Indicators Unit Device ClassInterface 2002 CEN All righ

8、ts of exploitation in any form and by any means reserved world-wide forCEN National MembersRef. No CWA 14050-10:2002 EThis CEN Workshop Agreement can in no way be held as being an official standardas developed by CEN National Members.B55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-

9、03 CWA 14050-10:2002 (E)2Table of ContentspageFOREWORD .31. INTRODUCTION .51.1 Background to Release 3.051.2 WOSA/XFS Service-Specific Programming52. SENSORS AND INDICATORS UNIT 73. REFERENCES.124. INFO COMMANDS134.1 WFS_INF_SIU_STATUS134.2 WFS_INF_SIU_CAPABILITIES .185. EXECUTE COMMANDS245.1 WFS_CM

10、D_SIU_ENABLE_EVENTS.245.2 WFS_CMD_SIU_SET_PORTS 295.3 WFS_CMD_SIU_SET_DOOR335.4 WFS_CMD_SIU_SET_INDICATOR.345.5 WFS_CMD_SIU_SET_AUXILIARY .355.6 WFS_CMD_SIU_SET_GUIDLIGHT.375.7 WFS_CMD_SIU_RESET386. EVENTS.396.1 WFS_SRVE_SIU_PORT_STATUS396.2 WFS_EXEE_SIU_PORT_ERROR .407. C - HEADER FILE43B55EB1B3E14

11、C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 CWA 14050-10:2002 (E)3ForewordThis CWA is revision 3.01 of the XFS interface specification.The CEN/ISSS XFS Workshop gathers suppliers as well as banks and other financial service companies. A listof companies participating in this Workshop a

12、nd in support of this CWA is available from the CEN/ISSSSecretariat.This CWA was formally approved by the XFS Workshop meeting on 2001-11-16. The specification iscontinuously reviewed and commented in the CEN/ISSS Workshop on XFS. It is therefore expected that anupdate of the specification will be p

13、ublished in due time as a CWA, superseding this revision 3.01.The CWA is published as a multi-part document, consisting of:Part 1: Application Programming Interface (API) - Service Provider Interface (SPI); Programmers ReferencePart 2: Service Classes Definition; Programmers ReferencePart 3: Printer

14、 Device Class Interface - Programmers ReferencePart 4: Identification Card Device Class Interface - Programmers ReferencePart 5: Cash Dispenser Device Class Interface - Programmers ReferencePart 6: PIN Keypad Device Class Interface - Programmers ReferencePart 7: Check Reader/Scanner Device Class Int

15、erface - Programmers ReferencePart 8: Depository Device Class Interface - Programmers ReferencePart 9: Text Terminal Unit Device Class Interface - Programmers ReferencePart 10: Sensors and Indicators Unit Device Class Interface - Programmers ReferencePart 11: Vendor Dependent Mode Device Class Inter

16、face - Programmers ReferencePart 12: Camera Device Class Interface - Programmers ReferencePart 13: Alarm Device Class Interface - Programmers ReferencePart 14: Card Embossing Unit Class Interface - Programmers ReferencePart 15: Cash In Module Device Class Interface- Programmers ReferencePart 16: App

17、lication Programming Interface (API) - Service Provider Interface (SPI) - Migration from Version2.0 (see CWA 13449) to Version 3.0 (this CWA) - Programmers ReferencePart 17: Printer Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0 (thisCWA) - Programmers ReferencePa

18、rt 18: Identification Card Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version3.0 (this CWA) - Programmers ReferencePart 19: Cash Dispenser Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0(this CWA) - Programmers ReferencePart 20: PIN Keyp

19、ad Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0 (thisCWA) - Programmers ReferencePart 21: Depository Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0 (thisCWA) - Programmers ReferencePart 22: Text Terminal Unit Device Class Inte

20、rface - Migration from Version 2.0 (see CWA 13449) to Version3.0 (this CWA) - Programmers ReferencePart 23: Sensors and Indicators Unit Device Class Interface - Migration from Version 2.0 (see CWA 13449) toVersion 3.0 (this CWA) - Programmers ReferencePart 24: Camera Device Class Interface - Migrati

21、on from Version 2.0 (see CWA 13449) to Version 3.0 (thisCWA) - Programmers ReferencePart 25: Identification Card Device Class Interface - PC/SC Integration GuidelinesB55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 CWA 14050-10:2002 (E)4In addition to these Programmers Reference

22、specifications, the reader of this CWA is also referred to acomplementary document, called Release Notes. The Release Notes contain clarifications and explanations onthe CWA specifications, which are not requiring functional changes. The current version of the Release Notes isavailable online from h

23、ttp:/www.cenorm.be/isss/Workshop/XFS.The information in this document represents the Workshops current views on the issues discussed as of the dateof publication. It is furnished for informational purposes only and is subject to change without notice.CEN/ISSS makes no warranty, express or implied, w

24、ith respect to this document.Revision History:1.0 May 24, 1993 Initial release of API and SPI specification1.11 February 3, 1995 Separation of specification into separate documents forAPI/SPI and service class definitions2.00 November 11, 1996 Update release encompassing the self-service environment

25、3.00 October 18, 2000 Addition of the reset command.Addition of the auxiliariesWFS_SIU_REMOTE_STATUS_MONITOR andWFS_SIU_AUDIBLE_ALARMAddition of WFS_SIU_SCANNER,WFS_SIU_DOCUMENTPRINTER andWFS_SIU_COINACCEPTOR guidance lights.For a detailed description see CWA 14050-23SIU Migration from Version 2.00

26、to Version 3.00,Revision 1.00, October 18, 2000.3.01 November 16, 2001 Addition of an enhanced audio device. Required forsupport of American Disabilities Act.B55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 CWA 14050-10:2002 (E)51. Introduction1.1 Background to Release 3.01The CE

27、N XFS Workshop is a continuation of the Banking Solution Vendors Council workshop and maintains atechnical commitment to the Win 32 API. However, the XFS Workshop has extended the franchise of multivendor software by encouraging the participation of both banks and vendors to take part in the deliber

28、ations ofthe creation of an industry standard. This move towards opening the participation beyond the BSVCs originalmembership has been very succesful with a current membership level of more than 20 companies.The fundamental aims of the XFS Workshop are to promote a clear and unambiguous specificati

29、on for bothservice providers and application developers. This has been achieved to date by sub groups workingelectronically and quarterly meetings.The move from an XFS 2.0 specification to a 3.01 specification has been prompted by a series of factors.Initially, there has been a technical imperative

30、to extend the scope of the existing specification of the XFSManager to include new devices, such as the Card Embossing Unit.Similarly, there has also been pressure, through implementation experience and the advance of the Microsofttechnology, to extend the functionality and capabilities of the exist

31、ing devices covered by the specification.Finally, it is also clear that our customers and the market are asking for an update to a specification, which isnow over 2 years old. Increasing market acceptance and the need to meet this demand is driving the Workshoptowards this release.The clear directio

32、n of the XFS Workshop, therefore, is the delivery of a new Release 3.01 specification based ona C API. It will be delivered with the promise of the protection of technical investment for existing applicationsand the design to safeguard future developments.1.2 WOSA/XFS Service-Specific ProgrammingThe

33、 service classes are defined by their service-specific commands and the associated data structures, errorcodes, messages, etc. These commands are used to request functions that are specific to one or more classes ofservice providers, but not all of them, and therefore are not included in the common

34、API for basic oradministration functions.When a service-specific command is common among two or more classes of service providers, the syntax of thecommand is as similar as possible across all services, since a major objective of the WOSA Extensions forFinancial Services is to standardize command co

35、des and structures for the broadest variety of services. Forexample, using the WFSExecute function, the commands to read data from various services are as similar aspossible to each other in their syntax and data structures.In general, the specific command set for a service class is defined as the u

36、nion of the specific capabilities likelyto be provided by the developers of the services of that class; thus any particular device will normally supportonly a subset of the defined command set.B55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 CWA 14050-10:2002 (E)6There are three

37、cases in which a service provider may receive a service-specific command that it does notsupport:The requested capability is defined for the class of service providers by the WOSA/XFS specification, theparticular vendor implementation of that service does not support it, and the unsupported capabili

38、ty is notconsidered to be fundamental to the service. In this case, the service provider returns a successfulcompletion, but does no operation. An example would be a request from an application to turn on a controlindicator on a passbook printer; the service provider recognizes the command, but sinc

39、e the passbookprinter it is managing does not include that indicator, the service provider does no operation and returns asuccessful completion to the application.The requested capability is defined for the class of service providers by the WOSA/XFS specification, theparticular vendor implementation

40、 of that service does not support it, and the unsupported capability isconsidered to be fundamental to the service. In this case, a WFS_UNSUPP_COMMAND error is returnedto the calling application. An example would be a request from an application to a cash dispenser todispense coins; the service prov

41、ider recognizes the command but, since the cash dispenser it is managingdispenses only notes, returns this error.The requested capability is not defined for the class of service providers by the WOSA/XFS specification.In this case, a WFS_ERR_INVALID_COMMAND error is returned to the calling applicati

42、on.This design allows implementation of applications that can be used with a range of services that providediffering subsets of the functionalities that are defined for their service class. Applications may use theWFSGetInfo and WFSAsyncGetInfo commands to inquire about the capabilities of the servi

43、ce they are aboutto use, and modify their behavior accordingly, or they may use functions and then deal withWFS_ERR_UNSUPP_COMMAND error returns to make decisions as to how to use the service.B55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 CWA 14050-10:2002 (E)72. Sensors and In

44、dicators UnitThis specification describes the functionality of the services provided by the Sensors and Indicators Unit (SIU)services under WOSA/XFS, by defining the service-specific commands that can be issued, using theWFSGetInfo, WFSAsyncGetInfo, WFSExecute and WFSAsyncExecute functions.This sect

45、ion describes the functions provided by a generic Sensors and Indicators Unit service. This serviceallows for the operation of the following categories of ports:Door sensors, such as cabinet, safe or vandal shield doors;Alarm sensors, such as tamper, seismic or heat sensors;Generic sensors, such as proximity or ambient light sensors;Key switch sensors, such as the ATM operator switch;Lamp/sign indicators, such as fascia light or audio indicators;Auxiliary indi