DIN CWA 14050-24-2001 Extensions for Financial Services (XFS) interface specification - Release 3 0 - Part 24 Camera device class interface Migration from Version 2 0 (see CWA 1344.pdf

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

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

3、EN/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

4、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 ausschlielich die

5、 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 13 Seiten CWA Beuth Verlag GmbH, 2001 .Jede Art de

6、r Vervielfltigung, auch auszugsweise, Ref. Nr. DIN CWA 14050-24:2001-04nur mit Genehmigung des Beuth Verlages gestattet. RW DIN CWA Preisgr. 01Alleinverkauf der Normen durch Beuth Verlag GmbH, 10772 Berlin Leerseite Rue de Stassart, 36 B-1050 BruxellesTel : +32 2 550 08 11 Fax : +32 2 550 08 19EUROP

7、EAN COMMITTEE FOR STANDARDIZATION COMIT EUROPEN DE NORMALISATION EUROPISCHES KOMITEE FR NORMUNG WORKSHOPCWA 14050-24AGREEMENTNovember 2000ICS 33.160.40; 35.200; 35.240.40Extensions for Financial Services (XFS) interface specification -Release 3.0 - Part 24: Camera Device Class Interface - Migration

8、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 National MembersRef. No CWA 14050-24:2000 EThis CEN Workshop Agreement can in no way be held as being an official standardas de

9、veloped by CEN National Members.Page 2CWA 14050-24:2000Table of ContentsForeword31. General.52. New Chapter 52.1 References 53. New Info Commands.54. Changes to existing Info Commands 54.1 WFS_INF_CAM_STATUS. 54.2 WFS_INF_CAM_CAPABILITIES 75. New Execute Commands95.1 WFS_CMD_CAM_RESET. 96. Changes t

10、o existing Execute Commands.96.1 WFS_CMD_CAM_TAKE_PICTURE. 97. New Events 108. Changes to existing Events .108.1 WFS_USRE_CAM_MEDIATHRESHOLD. 109. Changes to C-Header file11Page 3CWA 14050-24:2000ForewordThis CWA is revision 3.0 of the XFS interface specification.The move from an XFS 2.0 specificati

11、on (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 include new devices, such as the Card Embossing Unit.Similarly, there has also been pressure, through

12、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 our customers and the market are asking for an update to a specification, which is nowover 2 years ol

13、d. 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 Release 3.0 specificationbased on a C API. It will be delivered with the promise of the protection of tec

14、hnical 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 ofcompanies participating in this Workshop and in support of this CWA is available from the CEN/ISSS S

15、ecretariat.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 that an update of thespecification will be published in due time as a CWA, superseding this revision

16、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 Definition; Programmers ReferencePart 3: Printer Device Class Interface - Programmers ReferencePart 4: Ide

17、ntification 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 Interface - Programmers ReferencePart 8: Depository Device Cl

18、ass 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 Interface - Programmers ReferencePart 12: Camera Device Class I

19、nterface - 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: Application Programming Interface (API) - Service Provider In

20、terface (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 Version 3.0 (this CWA) -Programmers ReferencePart 18: Identification Card Device Class Interface - Migrat

21、ion from Version 2.0 (see CWA 13449) to Version 3.0(this CWA) - Programmers ReferencePage 4CWA 14050-24: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 Interface - Migrati

22、on 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 from Version 2.0

23、(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 (see CWA 13449)

24、 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 Release Notes co

25、ntain 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 the issues dis

26、cussed 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.Page 5CWA 14050-24:20001. GeneralA new reset command, a new media threshold event parameter, indi

27、vidual status values for each camera, andUNICODE support for exposure text data have been added. In addition, the meanings of the various device statusvalues have been clarified.2. New Chapter2.1 References1. XFS Application Programming Interface (API)/Service Provider Interface ( SPI), Programmers

28、ReferenceRevision 3.0, October 18, 20003. New Info CommandsNone.4. Changes to existing Info Commands4.1 WFS_INF_CAM_STATUSDescription This command reports the full range of information available, including the information that isprovided by the service provider.Input Param None.Output Param LPWFSCAM

29、STATUS lpStatus;typedef struct _wfs_cam_statusWORD fwDevice;WORD fwMediaWFS_CAM_CAMERAS_SIZE;WORD fwCamerasWFS_CAM_CAMERAS_SIZE;USHORT usPicturesWFS_CAM_CAMERAS_SIZE;LPSTR lpszExtra; WFSCAMSTATUS, * LPWFSCAMSTATUS;fwDeviceSpecifies the state of the Camera device as one of the following flags:Value M

30、eaningWFS_CAM_DEVONLINE The device is online (i.e., powered on and operable).WFS_CAM_DEVOFFLINE The device is offline (e.g., the operator has taken thedevice offline by turning a switch or pulling out thedevice).WFS_CAM_DEVPOWEROFF The device is powered off or physically notconnected.WFS_CAM_DEVNODE

31、VICE There is no device intended to be there; e.g. thistype of self service machine does not contain such adevice or it is internally not configured.WFS_CAM_DEVHWERROR The device is inoperable due to a hardware error.WFS_CAM_DEVUSERERROR The device is inoperable because a person ispreventing proper

32、operation.WFS_CAM_DEVBUSY The device is busy and not able to process anExecute command at this time.Page 6CWA 14050-24:2000fwMedia Specifies the state of the recording media of the cameras. A number of indexes are definedbelow. The maximum fwMedia index is WFS_CAM_CAMERAS_MAX.fwMediaWFS_CAM_ROOMSpec

33、ifies the state of the recording media of the camera that monitors the whole self-servicearea. Specified as one of the following flags:Value MeaningWFS_CAM_MEDIAOK The media is in a good state.WFS_CAM_MEDIAHIGH The media is almost full (threshold).WFS_CAM_MEDIAFULL The media is full.WFS_CAM_MEDIANOT

34、SUPP The device does not support sensing the medialevel.WFS_CAM_MEDIAUNKNOWN Due to a hardware error or other condition, the stateof the media cannot be determined.fwMediaWFS_CAM_PERSONSpecifies the state of the recording media of the camera that monitors the person standing infront of the self-serv

35、ice machine. Specified as one of the following flags:Value MeaningWFS_CAM_MEDIAOK The media is in a good state.WFS_CAM_MEDIAHIGH The media is almost full (threshold).WFS_CAM_MEDIAFULL The media is full.WFS_CAM_MEDIANOTSUPP The device does not support sensing the medialevel.WFS_CAM_MEDIAUNKNOWN Due t

36、o a hardware error or other condition, the stateof the media cannot be determined.fwMediaWFS_CAM_EXITSLOTSpecifies the state of the recording media of the camera that monitors the exit slot(s) of the self-service machine. Specified as one of the following flags:Value MeaningWFS_CAM_MEDIAOK The media

37、 is in a good state.WFS_CAM_MEDIAHIGH The media is almost full (threshold).WFS_CAM_MEDIAFULL The media is full.WFS_CAM_MEDIANOTSUPP The device does not support sensing the medialevel.WFS_CAM_MEDIAUNKNOWN Due to a hardware error or other condition, the stateof the media cannot be determined.fwCameras

38、.Specifies the state of the cameras. A number of cameras are defined below. The maximumcamera index is WFS_CAM_CAMERAS_MAX.fwCamerasWFS_CAM_ROOMSpecifies the state of the camera that monitors the whole self-service area. Specified as one ofthe following flags:Value MeaningWFS_CAM_CAMNOTSUPP The came

39、ra is not supported.WFS_CAM_CAMOK The camera is in a good state.WFS_CAM_CAMINOP The camera is inoperative.WFS_CAM_CAMUNKNOWN Due to a hardware error or other condition, the stateof the camera cannot be determined.fwCamerasWFS_CAM_PERSONSpecifies the state of the camera that monitors the person stand

40、ing in front of the self-servicemachine. Specified as one of the following flags:Value MeaningWFS_CAM_CAMNOTSUPP The camera is not supported.WFS_CAM_CAMOK The camera is in a good state.WFS_CAM_CAMINOP The camera is inoperative.Page 7CWA 14050-24:2000WFS_CAM_CAMUNKNOWN Due to a hardware error or othe

41、r condition, the stateof the camera cannot be determined.fwCamerasWFS_CAM_EXITSLOTSpecifies the state of the camera that monitors the exit slot(s) of the self-service machine.Specified as one of the following flags:Value MeaningWFS_CAM_CAMNOTSUPP The camera is not supported.WFS_CAM_CAMOK The camera

42、is in a good state.WFS_CAM_CAMINOP The camera is inoperative.WFS_CAM_CAMUNKNOWN Due to a hardware error or other condition, the stateof the camera cannot be determined.usPicturesSpecifies the number of pictures stored on the recording media of the cameras.A number of indexes are defined below. The m

43、aximum usPictures index isWFS_CAM_CAMERAS_MAX.Index MeaningWFS_CAM_ROOM The camera that monitors the whole self-service area.WFS_CAM_PERSON The camera that monitors the person standing in front ofthe self-service machineWFS_CAM_EXITSLOT The camera that monitors the exit slot(s) of the self-service m

44、achine.lpszExtraSpecifies a list of vendor-specific, or any other extended, information. The information isreturned as a series of “key=value“ strings so that it is easily extensible by service providers.Each string will be null-terminated, with the final string terminating with two null characters.

45、Error Codes Only the generic error codes defined in Ref. 1 can be generated by this command.Comments Applications which require or expect specific information to be present in the lpszExtra parametermay not be device or vendor-independent.4.2 WFS_INF_CAM_CAPABILITIESDescription This command is used

46、to retrieve the capabilities of the Camera SystemInput Param None.Output Param LPWFSCAMCAPS lpCaps;typedef struct _wfs_cam_capsWORD wClass;WORD fwType;WORD fwCamerasWFS_CAM_CAMERAS_SIZE;USHORT usMaxPictures;WORD fwCamData;USHORT usMaxDataLength;WORD fwCharSupport;LPSTR lpszExtra; WFSCAMCAPS, * LPWFS

47、CAMCAPS;wClassSpecifies the logical service class, value is:WFS_SERVICE_CLASS_CAMfwTypeSpecifies the type of the camera device; only current value is:Value MeaningWFS_CAM_TYPE_CAM Camera systemPage 8CWA 14050-24:2000fwCameras.Specifies which cameras are available. A number of cameras are defined bel

48、ow. The maximumcamera index is WFS_CAM_CAMERAS_MAX.fwCamerasWFS_CAM_ROOMSpecifies whether the camera that monitors the whole self-service area is available. Specified asone of the following flags:Value MeaningWFS_CAM_NOT_AVAILABLE This camera is not available.WFS_CAM_AVAILABLE This camera is availab

49、le.fwCamerasWFS_CAM_PERSONSpecifies whether the camera that monitors the person standing in front of the self-servicemachine is available. Specified as one of the following flags:Value MeaningWFS_CAM_NOT_AVAILABLE This camera is not available.WFS_CAM_AVAILABLE This camera is available.fwCamerasWFS_CAM_EXITSLOTSpecifies whether the camera that monitors the exit slot(s) of the self-service machine isavailable. Specified as one of the following flags:Value MeaningWFS_CAM_NOT_AVAILABLE T