DIN CWA 14050-18-2001 en 5216 Extensions for Financial Services (XFS) interface specification - Release 3 0 - Part 18 Identification card device class interface Migration from Vers.pdf

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

2、terungen fr die Schnittstellenspezifikation fr Finanzdienst-leistungen (XFS) Version 3.0 Teil 18: Schnittstelle fr die Gerteklasse “ID-Kartengerte“ Migrationvon Version 2.0 (siehe CWA 13449) zu Version 3.0 (dieses CWA) ProgrammierhandbuchNationales VorwortDieses CEN Workshop Agreement CWA 14050-18,

3、das vom CEN/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 durchl

4、aufenund dass 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 ausschli

5、elich die Mitglieder 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 25 Seiten CWA Beuth Verlag GmbH, 2001 .Je

6、de Art der Vervielfltigung, auch auszugsweise, Ref. Nr. DIN CWA 14050-18: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 B55EB1B

7、3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - 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-18AGREEMENTNovember 2000ICS 35.200; 35.2

8、40.15Extensions for Financial Services (XFS) interface specification -Release 3.0 - Part 18: Identification Card Device Class Interface -Migration from Version 2.0 (see CWA 13449) to Version 3.0 (this CWA) -Programmers Reference 2000 CEN All rights of exploitation in any form and by any means reserv

9、ed world-wide forCEN National MembersRef. No CWA 14050-18: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-18:2000Table of ContentsForeword31.

10、 New Chapters 51.1. Relation with PC/SC. 51.2. References 52. New Info Commands.53. Changes to Existing Info Commands63.1. WFS_INF_IDC_STATUS. 63.2. WFS_INF_IDC_CAPABILITIES 84. New Execute Commands104.1. WFS_CMD_IDC _RESET . 104.2. WFS_CMD_IDC_CHIP_POWER 114.3. WFS_CMD_IDC_PARSE_DATA 115. Changes t

11、o existing Execute Commands.125.1. WFS_CMD_IDC_READ_TRACK 125.2. WFS_CMD_IDC_WRITE_TRACK 135.3. WFS_CMD_IDC_EJECT_CARD. 155.4. WFS_CMD_IDC_RETAIN_CARD. 155.5. WFS_CMD_IDC_SETKEY 155.6. WFS_CMD_IDC_READ_RAW_DATA 165.7. WFS_CMD_IDC_WRITE_RAW_DATA 185.8. WFS_CMD_IDC_CHIP_IO 196. New Events 196.1. WFS_E

12、XEE_IDC_MEDIARETAINED . 196.2. WFS_EXEE_IDC_MEDIADETECTED 197. Changes to existing Events .207.1. WFS_USRE_IDC_RETAINBINTHRESHOLD. 208. Changes to Form Description Section 209. Changes to C-Header file21B55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Page 3CWA 14050-18:2000Forew

13、ordThis 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 by a series offactors.Initially, there has been a technical imperative to extend the scope of the existing specification of the XFS Managerto inc

14、lude 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 existing devices covered by the specification.Finally, it is also clear that ou

15、r 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 this demand is driving the Workshop towardsthis release.The clear direction of the CEN/ISSS XFS Workshop, therefore, is the delivery of a new Releas

16、e 3.0 specificationbased on a C API. It will be delivered with the promise of the protection of technical investment for existingapplications and the design to safeguard future developments.The CEN/ISSS XFS Workshop gathers suppliers as well as banks and other financial service companies. A list ofc

17、ompanies 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 Workshop meeting on 2000-10-18. The specification is continuouslyreviewed and commented in the CEN/ISSS Workshop on XFS. It is therefore expected th

18、at 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, consisting of:Part 1: Application Programming Interface (API) - Service Provider Interface (SPI); Programmers ReferencePart 2: Service Classes Definit

19、ion; Programmers ReferencePart 3: Printer 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

20、 7: Check Reader/Scanner Device Class Interface - 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:

21、 Vendor Dependent Mode Device Class Interface - 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 Int

22、erface- Programmers ReferencePart 16: Application Programming Interface (API) - Service Provider Interface (SPI) - Migration from Version 2.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 Versio

23、n 3.0 (this CWA) -Programmers ReferencePart 18: Identification Card Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0(this CWA) - Programmers ReferenceB55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Page 4CWA 14050-18:2000Part 19: Cash Dispenser

24、Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0 (thisCWA) - Programmers ReferencePart 20: PIN Keypad Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0 (thisCWA) - Programmers ReferencePart 21: Depository Device Class Interface - Mig

25、ration from Version 2.0 (see CWA 13449) to Version 3.0 (thisCWA) - Programmers ReferencePart 22: Text Terminal Unit Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0(this CWA) - Programmers ReferencePart 23: Sensors and Indicators Unit Device Class Interface - Migrat

26、ion from Version 2.0 (see CWA 13449) toVersion 3.0 (this CWA) - Programmers ReferencePart 24: Camera Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0 (this CWA)- Programmers ReferencePart 25: Identification Card Device Class Interface - PC/SC Integration GuidelinesI

27、n addition to these Programmers Reference specifications, the reader of this CWA is also referred to acomplementary document, called Release Notes. The Release Notes contain clarifications and explanations on theCWA specifications, which are not requiring functional changes. The current version of t

28、he Release Notes isavailable online from http:/www.cenorm.be/isss/Workshop/XFS.The information in this document represents the Workshops current views on the issues discussed as of the date ofpublication. It is furnished for informational purposes only and is subject to change without notice. CEN/IS

29、SSmakes no warranty, express or implied, with respect to this document.B55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Page 5CWA 14050-18:20001. New Chapters1.1. Relation with PC/SCThe PC/SC (Personal Computer / Smart Card) Workgroup was formed in May 1996 in partnership with ma

30、jor PCand smart card companies. The main focus of the workgroup has been to develop specifications that ensureinteroperability among smart cards, smart card readers, and computers made by different manufacturers:Interoperability Specification for Integrated Circuit Cards (ICC) and Personal Computer

31、SystemsVersion 1.0 of these specifications were released in December 1997. There are available on the Web at:http:/The related document PC/SC Integration Guidelines describes the relation between XFS and PC/SC and providesguidelines to manage PC/SC compliant readers from the XFS subsystem.In order t

32、o make integration of PC/SC compliant smart cards easier, the following principles have been defined toadd new chip capabilities to the IDC Device Class Interface:A new set of chip capabilities is made of new queries and commands which should be consistent.An associated COM-based interface definitio

33、n reflects these new queries and commands.This COM-based interface definition and its associated GUID are published part of this specification, to allowits implementation in PC/SC ICC service providers.These principles allow the IDC service provider for a PC/SC compliant reader to be a wrapper for I

34、CC commands,which are handled in the PC/SC subsystem by the corresponding PC/SC ICC service provider.The following international standard was also taken into account in the IDC 3.0 document :-Watermark (Sweden)1.2. References1. XFS Application Programming Interface (API)/Service Provider Interface (

35、 SPI), Programmers ReferenceRevision 3.0, October 18, 20002. New Info CommandsThere are no new Info Commands.B55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Page 6CWA 14050-18:20003. Changes to Existing Info Commands3.1. WFS_INF_IDC_STATUS. . .Output Param WFSIDCSTATUS lpStatus;

36、typedef struct _wfs_idc_statusWORD fwDevice;WORD fwMedia;WORD fwRetainBin;WORD fwSecurity;USHORT usCards;WORD fwChipPower;LPSTR lpszExtra; WFSIDCSTATUS, * LPWFSIDCSTATUS;fwDeviceSpecifies the state of the ID card device as one of the following flags:Value MeaningWFS_IDC_DEVONLINE The device is prese

37、nt, powered on and online (i.e.,operational, not busy processing a request and not in anerror state).WFS_IDC_DEVOFFLINE The device is offline (e.g., the operator has taken thedevice offline by turning a switch or pulling out thedevice).WFS_IDC_DEVPOWEROFF The device is powered off or physically not

38、connected.WFS_IDC_DEVNODEVICE There is no device intended to be there; e.g. this type ofself service machine does not contain such a device orit is internally not configured.WFS_IDC_DEVHWERROR The device is present but inoperable due to a hardwarefault that prevents it from being used.WFS_IDC_DEVUSE

39、RERROR The device is present but a person is preventing properdevice operation. The application should suspend thedevice operation or remove the device from serviceuntil the service provider generates a device statechange event indicating the condition of the device haschanged e.g. the error is remo

40、ved(WFS_IDC_DEVONLINE) or a permanent errorcondition has occurred (WFS_IDC_DEVHWERROR).WFS_IDC_DEVBUSY The device is busy and unable to process an Executecommand at this time.fwMediaSpecifies the state of the ID card unit as one of the following flags:Value MeaningWFS_IDC_MEDIAPRESENT Media is prese

41、nt in the device, not in the enteringposition and not jammed.WFS_IDC_MEDIANOTPRESENT Media is not present in the device and not at theentering position.WFS_IDC_MEDIAJAMMED Media is jammed in the device; operator intervention isrequired.WFS_IDC_MEDIANOTSUPP Capability to report media position is not

42、supported bythe device (e.g., a typical swipe reader).WFS_IDC_MEDIAUNKNOWN The media state cannot be determined with the devicein its current state (e.g., the value of fwDevice isWFS_IDC_DEVNODEVICE,WFS_IDC_DEVPOWEROFF,WFS_IDC_DEVOFFLINE, orWFS_IDC_DEVHWERROR).WFS_IDC_MEDIAENTERING Media is at the e

43、ntry/exit slot of a motorized device.B55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Page 7CWA 14050-18:2000fwRetainBinSpecifies the state of the ID card unit retain bin as one of the following flags:Value MeaningWFS_IDC_RETAINBINOK The retain bin of the ID card unit is not full

44、.WFS_IDC_RETAINBINFULL The retain bin of the ID card unit is full.WFS_IDC_RETAINBINHIGH The retain bin of the ID card unit is nearly full.WFS_IDC_RETAINNOTSUPP The ID card unit does not support retain capability.fwSecuritySpecifies the state of the security unit as one of the following flags:Value M

45、eaningWFS_IDC_SECOPEN The security module is open and ready to processcards.WFS_IDC_SECNOTREADY The security module is not ready to process cards.WFS_IDC_SECNOTSUPP No security module is available.usCardsThe number of cards retained; applicable only to motor driven ID card units for non-motorizedcard units this value is 0. This value is persistent it is reset to zero by theWFS_CMD_IDC_RESET_COUNT command.fwChipPowerSpecifies the