DIN CWA 14050-21-2001 en 2333 Extensions for Financial Services (XFS) interface specification - Release 3 0 - Part 21 Depository device class interface Migration from Version 2 0 (.pdf

1、April 2001Extensions for Financial Services (XFS) interface specification Release 3.0 Part 21: Depository Device Class Interface Migration from Version 2.0 (see CWA 13449) to Version 3.0(this CWA) Programmers ReferenceCWA 14050-21Englische Fassung CWA 14050-21:2000ICS 35.200; 35.240.40Erweiterungen

2、fr die Schnittstellenspezifikation fr Finanzdienst-leistungen (XFS) Version 3.0 Teil 21: Schnittstelle fr die Gerteklasse “Depositgerte“ Migration von Version 2.0 (siehe CWA 13449) zu Version 3.0(dieses CWA) ProgrammierhandbuchNationales VorwortDieses CEN Workshop Agreement CWA 14050-21, das vom CEN

3、/ISSS XFS Workshop erarbeitet wurde,wird ausschlielich in englischer Sprache zur Verfgung gestellt.CEN Workshop Agreements werden im Rahmen eines Konsortiums entwickelt. Sie unterscheiden sich vonEuropischen Normen dadurch, dass sie grundstzlich kein ffentliches Einspruchsverfahren durchlaufenund da

4、ss auch keine nationale Meinungsbildung stattfindet. Im Gegensatz zu Europischen Normen, dieden Konsens aller interessierten Kreise darstellen, haben CEN Workshop Agreements lediglich dieZustimmung der unmittelbar beteiligten Mitglieder des Konsortiums gefunden.Fr den Inhalt sind ausschlielich die M

5、itglieder des Konsortiums verantwortlich (siehe ergnzendeHinweise im CWA-Vorwort). Weder das CEN-Zentralsekretariat, noch die CEN-Mitglieder haben den Inhaltauf eventuelle Fehler oder Widersprche zu Normen und Rechtsvorschriften geprft.Fortsetzung 19 Seiten CWA Beuth Verlag GmbH, 2001 .Jede Art der

6、Vervielfltigung, auch auszugsweise, Ref. Nr. DIN CWA 14050-21:2001-04nur mit Genehmigung des Beuth Verlages gestattet. RW DIN CWA Preisgr. 04Alleinverkauf der Normen durch Beuth Verlag GmbH, 10772 BerlinB55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Leerseite B55EB1B3E14C22109E

7、918E8EA43EDB30F09CC9B7EF8DD9NormCD - 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 EUROPEN DE NORMALISATION EUROPISCHES KOMITEE FR NORMUNG WORKSHOPCWA 14050-21AGREEMENTNovember 2000ICS 35.200; 35.240.40Extens

8、ions for Financial Services (XFS) interface specification -Release 3.0 - Part 21: Depository Device Class Interface - Migration fromVersion 2.0 (see CWA 13449) to Version 3.0 (this CWA) - ProgrammersReference 2000 CEN All rights of exploitation in any form and by any means reserved world-wide forCEN

9、 National MembersRef. No CWA 14050-21:2000 EThis CEN Workshop Agreement can in no way be held as being an official standardas developed by CEN National Members.B55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Page 2CWA 14050-21:2000Table of ContentsForeword31. General.52. New Cha

10、pter 52.1 References 53. New Info Commands.54. Changes to existing Info Commands 54.1 WFS_INF_DEP_STATUS . 54.2 WFS_INF_DEP_CAPABILITIES. 75. New Execute Commands95.1 WFS_CMD_DEP_RESET . 96. Execute Commands removed 106.1 WFS_CMD_DEP_CLEAR_TRANSPORT. 107. Changes to existing Execute Commands.107.1 W

11、FS_CMD_DEP_ENTRY . 107.2 WFS_CMD_DEP_DISPENSE . 117.3 WFS_CMD_DEP_RETRACT 127.4 WFS_CMD_DEP_RESET_COUNT 138. New Events 138.1 WFS_SRVE_DEP_ENVINSERTED 138.2 WFS_SRVE_DEP_MEDIADETECTED. 139. Changes to existing Events .149.1 WFS_USRE_DEP_DEPTHRESHOLD 149.2 WFS_USRE_DEP_TONERTHRESHOLD 149.3 WFS_USRE_D

12、EP_ENVTHRESHOLD 1510. Changes to C-Header file.16B55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Page 3CWA 14050-21:2000ForewordThis CWA is revision 3.0 of the XFS interface specification.The move from an XFS 2.0 specification (CWA 13449) to a 3.0 specification has been prompted

13、 by a series offactors.Initially, there has been a technical imperative to extend the scope of the existing specification of the XFS Managerto include new devices, such as the Card Embossing Unit.Similarly, there has also been pressure, through implementation experience and the advance of the Micros

14、ofttechnology, to extend the functionality and capabilities of the existing 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 is nowover 2 years old. Increasing market acceptance and the need to meet th

15、is demand is driving the Workshop towardsthis release.The clear direction of the CEN/ISSS XFS Workshop, therefore, is the delivery of a new Release 3.0 specificationbased on a C API. It will be delivered with the promise of the protection of technical investment for existingapplications and the desi

16、gn to safeguard future developments.The CEN/ISSS XFS Workshop gathers suppliers as well as banks and other financial service companies. A list ofcompanies participating in this Workshop and in support of this CWA is available from the CEN/ISSS Secretariat.This CWA was formally approved by the XFS Wo

17、rkshop meeting on 2000-10-18. The specification is continuouslyreviewed and commented in the CEN/ISSS Workshop on XFS. It is therefore expected that an update of thespecification will be published in due time as a CWA, superseding this revision 3.0.The CWA is published as a multi-part document, cons

18、isting of:Part 1: Application Programming Interface (API) - Service Provider Interface (SPI); Programmers ReferencePart 2: Service Classes Definition; Programmers ReferencePart 3: Printer Device Class Interface - Programmers ReferencePart 4: Identification Card Device Class Interface - Programmers R

19、eferencePart 5: Cash Dispenser Device Class Interface - Programmers ReferencePart 6: PIN Keypad Device Class Interface - Programmers ReferencePart 7: Check Reader/Scanner Device Class Interface - Programmers ReferencePart 8: Depository Device Class Interface - Programmers ReferencePart 9: Text Termi

20、nal Unit Device Class Interface - Programmers ReferencePart 10: Sensors and Indicators Unit Device Class Interface - Programmers ReferencePart 11: Vendor Dependent Mode Device Class Interface - Programmers ReferencePart 12: Camera Device Class Interface - Programmers ReferencePart 13: Alarm Device C

21、lass Interface - Programmers ReferencePart 14: Card Embossing Unit Class Interface - Programmers ReferencePart 15: Cash In Module Device Class Interface- Programmers ReferencePart 16: Application Programming Interface (API) - Service Provider Interface (SPI) - Migration from Version 2.0(see CWA 1344

22、9) 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 (this CWA) -Programmers ReferencePart 18: Identification Card Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0(thi

23、s CWA) - Programmers ReferenceB55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Page 4CWA 14050-21:2000Part 19: Cash Dispenser Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0 (thisCWA) - Programmers ReferencePart 20: PIN Keypad Device Class Inter

24、face - 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 Interface - Migration fro

25、m Version 2.0 (see CWA 13449) to Version 3.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 - Migration from Version 2.0 (

26、see CWA 13449) to Version 3.0 (this CWA)- Programmers ReferencePart 25: Identification Card Device Class Interface - PC/SC Integration GuidelinesIn addition to these Programmers Reference specifications, the reader of this CWA is also referred to acomplementary document, called Release Notes. The Re

27、lease Notes contain clarifications and explanations on theCWA specifications, which are not requiring functional changes. The current version of the Release Notes isavailable online from http:/www.cenorm.be/isss/Workshop/XFS.The information in this document represents the Workshops current views on

28、the issues discussed as of the date ofpublication. It is furnished for informational purposes only and is subject to change without notice. CEN/ISSSmakes no warranty, express or implied, with respect to this document.B55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Page 5CWA 1405

29、0-21:20001. GeneralA reset command (replacing the CLEAR_TRANSPORT command which is no longer present), new envelopeinserted and media detected events, threshold event for the ENTRY and RETRACT commands, new status valuesfor container and envelope supply status, and UNICODE support for FieldValues ha

30、ve been added.2. New Chapter2.1 References1. XFS Application Programming Interface (API)/Service Provider Interface ( SPI), Programmers ReferenceRevision 3.0, October 18, 20003. New Info CommandsNone.4. Changes to existing Info Commands4.1 WFS_INF_DEP_STATUSDescription This command reports the full

31、range of information available, including the information that isprovided by the service provider.Input Param None.Output Param LPWFSDEPSTATUS lpStatus;typedef struct _wfs_dep_statusWORD fwDevice;WORD fwDepContainer;WORD fwDepTransport;WORD fwEnvSupply;WORD fwEnvDispenser;WORD fwPrinter;WORD fwToner

32、;WORD fwShutter;WORD wNumOfDeposits;LPSTR lpszExtra; WFSDEPSTATUS, * LPWFSDEPSTATUS;fwDeviceSpecifies the state of the Depository device as one of the following flags:Value MeaningWFS_DEP_DEVONLINE The device is online (i.e., powered on and operable).WFS_DEP_DEVOFFLINE The device is off-line (e.g. t

33、he operator has takenthe device offline by turning a switch or pulling outthe device.WFS_DEP_DEVPOWEROFF The device is powered off or physically notconnected.WFS_DEP_DEVNODEVICE There is no device intended to be there; e.g. thistype of self service machine does not contain such adevice or it is inte

34、rnally not configured.B55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Page 6CWA 14050-21:2000WFS_DEP_DEVHWERROR The device is inoperable due to a hardware error.The device is present but a hardware fault preventsit from being used.WFS_DEP_DEVUSERERROR The device is present but a

35、 person is preventingproper operation. The application should suspendthe device operation or remove the device fromservice until the service provider generates a devicestate change event indicating the condition of thedevice has changed i.e. the error is removed(WFS_DEP_DEVONLINE) or a permanent err

36、orcondition has occurred(WFS_DEP_DEVHWERROR).WFS_DEP_DEVBUSY The device is busy and not able to process anExecute command at this time.fwDepContainerSpecifies the state of the deposit container that contains the deposited envelopes or bags as oneof the following flags:Value MeaningWFS_DEP_DEPOK The

37、deposit container is in a good state.WFS_DEP_DEPHIGH The deposit container is almost full (threshold).WFS_DEP_DEPFULL The deposit container is full.WFS_DEP_DEPINOP The deposit container is inoperable.WFS_DEP_DEPMISSING The deposit container is missing.WFS_DEP_DEPUNKNOWN Due to a hardware error or ot

38、her condition, the stateof the deposit container cannot be determined.WFS_DEP_DEPNOTSUPP The physical device is not able to determine thestatus of the deposit container.fwDepTransportSpecifies the state of the deposit transport mechanism that transports the envelope into thedeposit container. Specif

39、ied as one of the following flags:Value MeaningWFS_DEP_DEPOK The deposit transport is in a good state.WFS_DEP_DEPINOP The deposit transport is inoperative due to ahardware failure or media jam.WFS_DEP_DEPUNKNOWN Due to a hardware error or other condition, the stateof the deposit transport cannot be

40、determined.WFS_DEP_DEPNOTSUPP The physical device has no deposit transport.fwEnvSupplySpecifies the state of the envelope supply unit as one of the following flags:Value MeaningWFS_DEP_ENVOK The envelope supply unit is in a good state (andlocked).WFS_DEP_ENVLOW The envelope supply unit is present bu

41、t low.WFS_DEP_ENVEMPTY The envelope supply unit is present but empty. Noenvelopes can be dispensed.WFS_DEP_ENVINOP The envelope supply unit is in an inoperable state.No envelopes can be dispensed.WFS_DEP_ENVMISSING The envelope supply unit is missing.WFS_DEP_ENVNOTSUPP The physical device has no env

42、elope supply.WFS_DEP_ENVUNLOCKED The envelope supply unit is unlocked.WFS_DEP_ENVUNKNOWN Due to a hardware error or other condition, the stateof the envelope supply cannot be determined.fwEnvDispenserSpecifies the state of the envelope dispenser. Specified as one of the following flags.Value Meaning

43、WFS_DEP_ENVOK The envelope dispenser is present and in a goodstate.B55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Page 7CWA 14050-21:2000WFS_DEP_ENVINOP The envelope dispenser is present but in aninoperable state. No envelopes can be dispensed.WFS_DEP_ENVUNKNOWN Due to a hardwa

44、re error or other condition, the stateof the envelope dispenser cannot be determined.WFS_DEP_ENVNOTSUPP The physical device has no envelope dispenser.fwPrinterSpecifies the state of the printer. Specified as one of the following flags:Value MeaningWFS_DEP_PTROK The printer is present and in a good s

45、tate.WFS_DEP_PTRINOP The printer is inoperative.WFS_DEP_PTRUNKNOWN Due to a hardware error or other condition, the stateof the printer cannot be determined.WFS_DEP_PTRNOTSUPP The physical device has no printer.fwTonerSpecifies the state of the toner (or ink) for the printer. Specified as one of the following flags:Value MeaningWFS_DEP_TONOK The toner cassette is full.WFS_DEP_TONERFULL The toner cassette is full.WFS_DEP_TONLOW