1、April 2001Extensions for Financial Services (XFS) interface specification Release 3.0 Part 22: Text Terminal Unit Device ClassInterface Migration from Version 2.0 (see CWA 13449) toVersion 3.0 (this CWA) Programmers ReferenceCWA 14050-22Englische Fassung CWA 14050-22:2000ICS 35.200; 35.240.40Erweite
2、rungen fr die Schnittstellenspezifikation fr Finanzdienst-leistungen (XFS) Version 3.0 Teil 22: Schnittstelle fr die Gerteklasse “Textterminals“ Migration von Version 2.0 (siehe CWA 13449) zu Version 3.0(dieses CWA) ProgrammierhandbuchNationales VorwortDieses CEN Workshop Agreement CWA 14050-22, das
3、 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 durchlauf
4、enund 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 ausschlieli
5、ch 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 28 Seiten CWA Beuth Verlag GmbH, 2001 .Jede
6、Art der Vervielfltigung, auch auszugsweise, Ref. Nr. DIN CWA 14050-22:2001-04nur mit Genehmigung des Beuth Verlages gestattet. RW DIN CWA Preisgr. 05Alleinverkauf der Normen durch Beuth Verlag GmbH, 10772 BerlinB55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Leerseite B55EB1B3E1
7、4C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - 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-22AGREEMENTNovember 2000ICS 35.200; 35.240.
8、40Extensions for Financial Services (XFS) interface specification -Release 3.0 - Part 22: Text Terminal Unit 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 reserved w
9、orld-wide forCEN National MembersRef. No CWA 14050-22: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-22:2000Table of ContentsForeword 31. Ge
10、neral 52. New Chapters 52.1 References . 52.2 XFS form/media definition files in multi-vendor environments 53. New Info Commands 53.1 WFS_INF_TTU_KEY_DETAIL . 54. Changes to existing Info Commands . 74.1 WFS_INF_TTU_STATUS . 74.2 WFS_INF_TTU_CAPABILITIES. 94.3 WFS_INF_TTU_QUERY_FORM 104.4 WFS_INF_TT
11、U_QUERY_FIELD 115. New Execute Commands. 125.1 WFS_CMD_TTU_RESET . 126. Changes to existing Execute Commands 136.1 WFS_CMD_TTU_CLEARSCREEN 136.2 WFS_CMD_TTU_WRITE_FORM (former WFS_CMD_TTU_DISPLAY_FORM) . 136.3 WFS_CMD_TTU_READ_FORM 146.4 WFS_CMD_TTU_WRITE . 156.5 WFS_CMD_TTU_READ. 167. New Events .
12、197.1 WFS_EXEE_TTU_FIELDERROR 197.2 WFS_EXEE_TTU_FIELDWARNING 207.3 WFS_EXEE_TTU_KEY 208. Changes to existing Events. 219. Changes to Form and Field Definitions . 219.1 Definition Syntax . 219.2 Field Definition . 2210. Changes to C - Header file. 23B55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9Norm
13、CD - Stand 2007-03 Page 3CWA 14050-22: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 by a series of factors.Initially, there has been a technical imperative to extend the scope of the
14、 existing specification of the XFS Manager toinclude 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
15、 specification.Finally, it is also clear that our customers and the market are asking for an update to a specification, which is now over 2years old. Increasing market acceptance and the need to meet this demand is driving the Workshop towards this release.The clear direction of the CEN/ISSS XFS Wor
16、kshop, therefore, is the delivery of a new Release 3.0 specification basedon a C API. It will be delivered with the promise of the protection of technical investment for existing applications andthe design to safeguard future developments.The CEN/ISSS XFS Workshop gathers suppliers as well as banks
17、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 Workshop meeting on 2000-10-18. The specification is continuouslyreviewed and commented in the CEN/
18、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, consisting of:Part 1: Application Programming Interface (API) - Service Provider Interface (SPI); Pro
19、grammers ReferencePart 2: Service Classes Definition; 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 D
20、evice Class Interface - Programmers ReferencePart 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 Devic
21、e Class Interface - Programmers ReferencePart 11: 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
22、ReferencePart 15: Cash In Module Device Class Interface- Programmers ReferencePart 16: Application Programming Interface (API) - Service Provider Interface (SPI) - Migration from Version 2.0 (seeCWA 13449) to Version 3.0 (this CWA) - Programmers ReferencePart 17: Printer Device Class Interface - Mig
23、ration from Version 2.0 (see CWA 13449) to Version 3.0 (this CWA) -Programmers ReferenceB55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Page 4CWA 14050-22:2000Part 18: Identification Card Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0 (thisCWA
24、) - Programmers ReferencePart 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 - Migration from Version 2.0 (see CWA 13449) to Version 3.0 (this CWA)- Programmers Referenc
25、ePart 21: Depository Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0 (this CWA) -Programmers ReferencePart 22: Text Terminal Unit Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version 3.0 (thisCWA) - Programmers ReferencePart 23: Sensors an
26、d Indicators Unit Device Class Interface - Migration from Version 2.0 (see CWA 13449) to Version3.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 Devic
27、e Class Interface - PC/SC Integration GuidelinesIn addition to these Programmers Reference specifications, the reader of this CWA is also referred to a complementarydocument, called Release Notes. The Release Notes contain clarifications and explanations on the CWA specifications,which are not requi
28、ring functional changes. The current version of the Release Notes is available online fromhttp:/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 onl
29、y and is subject to change without notice. CEN/ISSS makesno warranty, express or implied, with respect to this document.B55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Page 5CWA 14050-22:20001. GeneralUNICODE support for field values, key stroke events during text entry and a fe
30、w clarifications have been added.For all commands, the error code and event sections have been amended to explicitly mention that the generic valuesfrom the API document can also be returned.2. New Chapters2.1 References1. XFS Application Programming Interface (API)/Service Provider Interface ( SPI)
31、, Programmers ReferenceRevision 3.0, October 18, 20002.2 XFS form/media definition files in multi-vendor environmentsAlthough for most Service Providers directory location and extension of XFS form/media definition files areconfigurable through the registry, the capabilities of Service Providers and
32、 or actual hardware may vary. Therefore thefollowing considerations should be taken into account when applications use XFS form definition files with the purposeof running in a multi-vendor environment:- Physical display area dimensions may vary from one text terminal to another- Just-in-time form l
33、oading may not be supported by all Service Providers, which makes it impossible to createdynamic form files just before displaying them (which in return means that only the display data of the forms can bechanged, not the -layout data such as field positions)- Some form/media definition keywords may
34、 not be supported due to limitations of the hardware or software3. New Info Commands3.1 WFS_INF_TTU_KEY_DETAILDescription This command returns information about the Keys (buttons) supported by the device.This command should be issued to determine which Keys are available.Input Param None.Output Para
35、m LPWFSTTUKEYDETAIL lpKeyDetail;typedef struct _wfs_ttu_key_detailLPSTR lpszKeys;LPWSTR lpwszUNICODEKeys;LPWORD lpwCommandKeys; WFSTTUKEYDETAIL, * LPWFSTTUKEYDETAIL;lpszKeysString which holds the printable characters (numeric and alphanumeric keys) on the Text TerminalUnit, e.g. “0123456789ABCabc ”
36、if those text terminal input keys are present. This string is aNULL pointer if capability fwCharSupport equals WFS_TTU_UNICODE or if no keys of this typeare present on the device.lpwszUNICODEKeysString which holds the numeric and alphanumeric keys on the Text Terminal Unit like lpszKeys butB55EB1B3E
37、14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Page 6CWA 14050-22:2000in UNICODE format. This string is a NULL pointer if capability fwCharSupport equalsWFS_TTU_ASCII or if no keys of this type are present on the device.lpwCommandKeysArray of command keys on the Text Terminal Unit. The
38、array is terminated with a zero value. Thisarray is a NULL pointer if no keys of this type are present on the device.WFS_TTU_CK_ENTERWFS_TTU_CK_CANCELWFS_TTU_CK_CLEARWFS_TTU_CK_BACKSPACEWFS_TTU_CK_HELPWFS_TTU_CK_00WFS_TTU_CK_000WFS_TTU_CK_ARROWUPWFS_TTU_CK_ARROWDOWNWFS_TTU_CK_ARROWLEFTWFS_TTU_CK_ARR
39、OWRIGHTThe following values may be used as vendor dependent keys.WFS_TTU_CK_OEM1WFS_TTU_CK_OEM2WFS_TTU_CK_OEM3WFS_TTU_CK_OEM4WFS_TTU_CK_OEM5WFS_TTU_CK_OEM6WFS_TTU_CK_OEM7WFS_TTU_CK_OEM8WFS_TTU_CK_OEM9WFS_TTU_CK_OEM10WFS_TTU_CK_OEM11WFS_TTU_CK_OEM12The following keys are used for Function Descriptor
40、Keys.WFS_TTU_CK_FDK01WFS_TTU_CK_FDK02WFS_TTU_CK_FDK03WFS_TTU_CK_FDK04WFS_TTU_CK_FDK05WFS_TTU_CK_FDK06WFS_TTU_CK_FDK07WFS_TTU_CK_FDK08WFS_TTU_CK_FDK09B55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Page 7CWA 14050-22:2000WFS_TTU_CK_FDK10WFS_TTU_CK_FDK11WFS_TTU_CK_FDK12WFS_TTU_CK_
41、FDK13WFS_TTU_CK_FDK14WFS_TTU_CK_FDK15WFS_TTU_CK_FDK16WFS_TTU_CK_FDK17WFS_TTU_CK_FDK18WFS_TTU_CK_FDK19WFS_TTU_CK_FDK20WFS_TTU_CK_FDK21WFS_TTU_CK_FDK22WFS_TTU_CK_FDK23WFS_TTU_CK_FDK24WFS_TTU_CK_FDK25WFS_TTU_CK_FDK26WFS_TTU_CK_FDK27WFS_TTU_CK_FDK28WFS_TTU_CK_FDK29WFS_TTU_CK_FDK30WFS_TTU_CK_FDK31WFS_TTU
42、_CK_FDK32Error Codes Only the generic error codes defined in Ref. 1 can be generated by this command.Comments None.4. Changes to existing Info Commands4.1 WFS_INF_TTU_STATUSDescription This command reports the full range of information available, including the information that isprovided by the serv
43、ice provider.Input Param None.Output Param LPWFSTTUSTATUS lpStatus;B55EB1B3E14C22109E918E8EA43EDB30F09CC9B7EF8DD9NormCD - Stand 2007-03 Page 8CWA 14050-22:2000typedef struct _wfs_ttu_statusWORD fwDevice;WORD wKeyboard;WORD wKeyLock;WORD wLEDsWFS_TTU_LEDS_MAX;WORD wDisplaySizeX;WORD wDisplaySizeY;LPS
44、TR lpszExtra; WFSTTUSTATUS, * LPWFSTTUSTATUS;fwDeviceSpecifies the state of the text terminal unit as one of the following flags:Value MeaningWFS_TTU_DEVONLINE The device is on-line (i.e., powered on and operable).WFS_TTU_DEVOFFLINE The device is off-line (e.g., the operator has taken the deviceoffline by turning a switch or pulling out the device).WFS_TTU_DEVPOWEROFF The device is powered off or physically not connected.WFS_TTU_DEVBUSY The device is busy and unable to process an executecommand at this time.WFS_TTU_DEVNODEVICE There is no device intended to be there; e.g. this type
