Manual
IDTECHXpressReaderUserManual
1
USERMANUAL
XpressReader
VersionV1.00
IDTECHXpressReaderUserManual
2
Warning
Caution:Theuseriscautionedthatchangesandmodificationsmadetotheequipmentwithoutthe
Approvalofmanufacturercouldvoidtheuser’sauthoritytooperatethisequipment.
Notes:ThisequipmenthasbeentestedandfoundtocomplywiththelimitsforaClassBdigitaldevice,
pursuantto part15 of the FCC Rules. These limitsare designedto provide reasonableprotection
against harmful interference in a residential installation. This equipment generates, uses and can
radiateradiofrequencyenergyand,ifnotinstalledandusedinaccordancewiththeinstructions,may
cause harmful interference to radio communications. However, there is no guarantee that
interference will not occur in a particular installation. If this equipment does cause harmful
interferencetoradioortelevisionreception,whichcanbedeterminedbyturningtheequipmentoff
and on. the user is encouraged to trytocorrect the interference by one or more of the following
measures:
—Reorientorrelocatethereceivingantenna.
—Increasetheseparationbetweentheequipmentandreceiver.
—Connect the equipment into an outlet on a circuit different from that to which the receiver is
connected.
—Consultthedealeroranexperiencedradio/TVtechnicianforhelp.
FCCWarning:
Thisdevicecomplieswithpart15oftheFCCRules.Operationissubjecttothefollowing
twoconditions:(1)Thisdevicemaynotcauseharmfulinterference,and(2)thisdevice
mustacceptanyinterferencereceived,includinginterferencethatmaycauseundesired
operation.
LimitedWarranty
IDTECH warrantsthisproducttobeingoodworkingorderforaperiodofoneyearfromthedateof
purchase.Ifthisproductisnotingoodworkingorderaswarrantedabove,orshouldthisproductfail to
beingoodworkingorderatanytimeduringthewarrantyperiod,repairorreplacementshallbe
providedby IDTECH.
Thiswarrantydoesnotcoverincidentalorconsequentialdamagesincurredbyconsumermisuse,or
modificationofsaidproduct.Forlimitedwarrantyserviceduringthewarrantyperiod,pleasecontact
IDTECH toobtainanRMAnumberandinstructionsforreturningtheproduct.
©2008InternationalTechnologies&SystemsCorporation.Theinformationcontainedhereinis
providedtotheuserasaconvenience.Whileeveryefforthasbeenmadetoensureaccuracy,ID
TECHisnotresponsiblefor damagesthatmightoccurbecauseoferrorsoromissions,includingany
lossofprofitorothercommercialdamage.Thespecificationsdescribedhereinwerecurrentatthe
timeofpublication,butaresubjecttochangeatanytimewithoutpriornotice.
IDTECH isaregisteredtrademarkofInternationalTechnologies&SystemsCorporation.Spectrum
and ValuethroughInnovationaretrademarksofInternationalTechnologies&SystemsCorporation.
IDTECH
10721WalkerStreet
Cypress,CA906304720
IDTECHXpressReaderUserManual
3
(714)7616368
www.idtechproducts.com
IDTECHXpressReaderUserManual
4
TableofContents
Section1.Introduction
Description
Section2.Installation
RS232interface
Section3.Definitions
CommonTermsandAbbreviations
RelatedDocuments
RelatedLinks
Section4.ConfigurationParameters
Commandprotocol
Command Set
IDTECHXpressReaderUserManual
5
Section1
INTRODUCTION
Description
Xpressreaderhasachoiceofcommunicationinterfacestoahost.Communicationsarethrough
aninterfacecable.Thecablecanexitfromtheendorfromthebottomofthebase.Aslotor
channelinthebaseprovidesforinfieldorientationofthecableexitdirectionandprovidesastrain
relieffunction.Compatibility:ThereaderoperateswithmajorPOSandECRterminalsoldornew,
providingtheterminalshaveacompatibleinterfacewiththereaderandathirdpartyprovidesa
softwareapplicationandcommunicationprotocollayertoaccomplishtherequiredoperations.
XpressreaderaddressesseveralretailapplicationsforISO14443compliantidentification
technology.Thereadersupportsmajorfinancialcontactlessprograms,suchasPaypass
Magstripe,VisaMSD.Thereaderreadsdatafromavarietyofcontactlesssources,including
creditcards,keyfobs,andmustsupporttheRFrequirementsforISO/IEC14443A,ISO/IEC
14443Basoutlined.Inparticular,thereadershallmeettheMasterCard,PayPassISO/IEC
14443ImplementationSpecification.Inaddition,thereadershallbecompatiblewithPOS
applications.Thereaderhastheoperability&functionalitydefinedinthePayPassImplementation
Specification.ThereadershallbecertifiedbyaPayPassqualifiedtestlab;thereadermustmeet
thecriteriato"FunctionProperly"andpassthetestprocess.
Inaddition,thereadersupportsreadingandwritingtoMifarecards.Mifarecardssupportedare
Standard,Classic,&UltraLite.Thissupportisintendedforaccesscontrolapplications,including
transportation.
Environmentally,thereaderisdesignedtofunctionattemperaturesrangingfrom0ºto50ºCin
humidityupto95%noncondensing.Itcanbestoredorshippedatmoreextremetemperatures
rangingfrom40ºto70ºC.
IDTECHXpressReaderUserManual
6
Section2
INSTALLATION
Thecoilhas4circlepowercable,thecoilpartnumber: HFB160093300
IDTECHXpressReaderUserManual
7
TheRs232coilhasonecircleofRs232cable,thecoilpartnumber:
HFB160093300
RS232Interface
Aswithastandardserialinterface,thehostmustbeconfiguredtoacceptthe
dataandperformtheappropriateprocessing.FortheRS232interfacedevice,
theenduserneedscarethatthehostapplication'sRS232parameters(baud
rate,databits,Start/Stopcharacters,parity,)matchthoseexpectedbythe
reader.
DefaultRS232parametersare“38400,8,1,None”.Togetmoreinformation,
pleaseseeRS232configurecommandpart.
Section3
DEFINITIONS
Thefollowingaredefinitionsofcommontermsandabbreviationsused
throughoutthismanual.
CFT ConsumerfacingTerminal
ISO InternationalOrganizationforStandardization
PCD PayPassCouplingDevice
PICC PayPassIntegratedCircuitCard
USB UniversalSerialBus
HOST APersonalComputerorSimilarComputingDevice
IDTECHXpressReaderUserManual
8
PayPassTerminalQualityManagement–Process[PPA/GEN/T01].
PayPassTerminalQualityManagement–Requirements[PPA/GEN/T02]
ISO/IEC14443Identificationcards,PhysicalCharacteristic
ISO/IEC14443–Identificationcards,Contactlessintegratedcircuit(s)
cards/Proximitycards
PayPass–ISO/IEC14443ImplementationSpecification
Mifare–Philips’ContactlessMifare®SmartCardICs&operations
Section4
CONFIGURATIONPARAMETERS
I.Commandprotocol
Hosttodevice:STXLenLLenHCommandDataLrc1Lrc2ETX
STX:0x02.1byte.
LenL+LenH:sizeof(CommandData).2bytes.
CommandData:maincommandstring.Severalbytesneeded.
Lrc1:ExclusiveorofCommandData.1byte.
Lrc2:SumofCommandData.1byte.
ETX: 0x03. 1byte.
E.g.Turnapplicationoffcommandis:0x020x020x000x780x160x000x6E
0x8E0x03.
Devicetohost:STXLenLLenHResponseDataLrc1Lrc2ETX
STX:0x02.1byte.
LenL+LenH:sizeof(ResponseData).2bytes.
ResponseData:mainresponsestring.Severalbytesneeded.
Lrc1:ExclusiveorofResponseData.1byte.
Lrc2:SumofResponseData.1byte.
ETX: 0x03. 1byte.
II.Hosttodevicecommandset
1.Testusecommands.
IDTECHXpressReaderUserManual
9
Tousethesecommands,theapplicationmustbeoff(Usecommand
APPLICATION_CONTROLin35).
11. CARRIER
COMMAND: <0xFD><0x01><ON/OFF>.
Makethedevicetoemit.
PARAMETERS:
<0xFD><0x01>isthecommandhead.
<ON/OFF>ON(0x01)meansturnoncarrier,OFF(0x00)meansturnoff
carrier.
RETURN:
Success:<ACK>.
Fail:Thisoperationwillsucceedalways.
12. POLLING
COMMAND:<0xFD><0x02><PollingCount>.
Makethedevicetopollforonecard.
PARAMETERS:
<0xFD><0x02>isthecommandhead.
<PollingCount>isthepollingtimes.1byte.0x00meansforever.
RETURN:
Success:<ACK>.
Fail:Thisoperationwillsucceedalways.
13. RESET
COMMAND:<0xFD><0x03><0x00>
Makethedevicetoresetthecarrier.
PARAMETERS:
<0xFD><0x03><0x00>isthecommandhead.
RETURN:
Success:<ACK>.
Fail:Thisoperationwillsucceedalways.
14. REQA
COMMAND:<0xFD><0x14><0x01>.
InformthedevicetosendcommandrequesttotypeAcard.
PARAMETERS:
<0xFD><0x14><0x01>isthecommandhead.
RETURN:
Success:<ACK><Allcommandsandtheirresponses>.
Fail:Thisoperationwillsucceedalways.
15. WUPA
COMMAND:<0xFD><0x14><0x00>.
InformthedevicetosendcommandwakeuptotypeAcard.
IDTECHXpressReaderUserManual
10
PARAMETERS:
<0xFD><0x14><0x00>isthecommandhead.
RETURN:
Success:<ACK><Allcommandsandtheirresponses>.
Fail:Thisoperationwillsucceedalways.
16. HALTA
COMMAND:<0xFD><0x16><0x00>.
InformthedevicetosendcommandhalttypeAcard.
PARAMETERS:
<0xFD><0x16><0x00>isthecommandhead.
RETURN:
Success:<ACK><Allcommandsandtheirresponses>.
Fail:Thisoperationwillsucceedalways.
17. ACTIVEA
COMMAND:<0xFD><0x18><0x00>.
InformthedevicetosendcommandsactivetypeAcard.
PARAMETERS:
<0xFD><0x18><0x00>isthecommandhead.3bytes.
RETURN:
Success:<ACK><Allcommandsandtheirresponses>.
Fail:Thisoperationwillsucceedalways.
18. REQB
COMMAND:<0xFD><0x25><0x01>.
InformthedevicetosendcommandrequesttotypeBcard.
PARAMETERS:
<0xFD><0x25><0x01>isthecommandhead.3bytes.
RETURN:
Success:<ACK><Allcommandsandtheirresponses>.
Fail:Thisoperationwillsucceedalways.
19. WUPB
COMMAND:<0xFD><0x25><0x00>
InformthedevicetosendcommandwakeuptotypeBcard.
PARAMETERS:
<0xFD><0x25><0x00>isthecommandhead.3bytes.
RETURN:
Success:<ACK><Allcommandsandtheirresponses>.
Fail:Thisoperationwillsucceedalways.
110. HALTB
COMMAND:<0xFD><0x27><0x00>
IDTECHXpressReaderUserManual
11
InformthedevicetosendcommandhalttypeBcard.
PARAMETERS:
<0xFD><0x27><0x00>isthecommandhead.3bytes.
RETURN:
Success:<ACK><Allcommandsandtheirresponses>.
Fail:Thisoperationwillsucceedalways..
111. ACTIVEB
COMMAND:<0xFD><0x29><0x00>
InformthedevicetosendcommandsactivetypeBcard.
PARAMETERS:
<0xFD><0x29><0x00>isthecommandhead.3bytes.
RETURN:
Success:<ACK><Allcommandsandtheirresponses>.
Fail:Thisoperationwillsucceedalways.
112. APPCOMMAND
COMMAND:<0xFD><0x32><CPDU>
Informthedevicetosendcommandstotheactivecard.
PARAMETERS:
<0xFD><0x32>isthecommandhead.2bytes.
<CPDU>isthecommandsendtothecard.
RETURN:
Success:<ACK><R_APDU>
Fail:Thisoperationwillsucceedalways.
113. APP_TEST_START
COMMAND:<0xFD><0x41>
Informthedevicetostartdigitaltest.
PARAMETERS:
<0xFD><0x41>isthecommandhead.2bytes.
RETURN:
Success:<ACK>.
Fail:Thisoperationwillsucceedalways.
114. APP_TEST_STOP
COMMAND:<0xFD><0x42>
Informthedevicetostopdigitaltest.
PARAMETERS:
<0xFD><0x42>isthecommandhead.2bytes.
RETURN:
Success:<ACK>.
Fail:Thisoperationwillsucceedalways.
IDTECHXpressReaderUserManual
12
Note:Commandsandtheirresponsesformat:ClencommandRlenresponse
ClencommandRlenResponse...
2.Serialportcontrolcommandset
Thedefaultparametersare:38400baudrate,8databits,1stopbit,no
parity,nohandshaking.
21.SET_BAUDRATE
COMMAND:<0x70><0x01><NewBaudrate>.
Setthedevice'sbaudrate.
PARAMETERS:
<0x70><0x01>isthecommandhead.2bytes.
<NewBaudrate>istherequiredserialportcommunicationbaudrate.1
byte:0x01for1200,0x02for2400,0x03for4800,0x04for9600,0x05for
14400,0x06for19200,0x07for38400,0x08for57600,0x09for115200.
RETURN:
Success:<ACK><OldBaudrate(1byte)>.
OldBaudrateistheoldbaudrate.
Fail:<NAK><Errorcode>.
22 SET_STOPBITS
COMMAND:<0x70><0x02><NewStopBits>.
Thiscommandisusedtosetthedevice'sstopbits.
Thetotallengthis3bytes
PARAMETERS:
<0x70><0x02>isthecommandhead.
<NewStopBits>istherequiredserialportcommunicationstopbits.1
byte:0x01for1stopbit,0x02for2stopbits,0x03for1.5stopbits.
RETURN:
Success:<ACK><OldStopBits(1byte)>.
OldStopBitsistheoldstopbits.
Fail:<NAK><Errorcode>.
23. SET_PARITY
COMMAND:<0x70><0x03><NewParity>.
Setthedevice'sparitystyle.
PARAMETERS:
<0x70><0x03>isthecommandhead.
<NewParity>istherequiredserialportcommunicationparity.1byte:
0x00fornoparity,0x01foroddparity,0x02forevenparity,0x03formark
parity,0x04forspaceparity.
RETURN:
Success:<ACK><OldParity.(1byte)>.
OldParityistheoldparity.
Fail:<NAK><Errorcode>.
IDTECHXpressReaderUserManual
13
3.Systemcommandset
31. GET_VERSION
COMMAND:<0x78><0x01>.
Getthesystem'sversion.
PARAMETERS:
<0x78><0x01>isthecommand.
RETURN:
Success:<ACK><versionstring(42bytes)>.
Fail:Thisoperationwillsucceedalways.
32. BEEP
COMMAND:<0x78><0x04><Duration>
Makethesystem'sbeepertobeepforadesignatedtime.
PARAMETERS:
<0x78><0x04>isthecommandheader.
<Duration>isthebeeper'sbeeplasttimein0.1second.
RETURN:
Success:<ACK>.
Fail:Thisoperationwillsucceedalways.
33. LED_CONTROL
COMMAND:<0x78><0x05><LED><ON/OFF>.
Controlthesystem'sled.
PARAMETERS:
<0x78><0x05>isthecommandheader.
<LED>istheled'sid.0x000x07isacceptable.
<ON/OFF>:0x01(ON)meansletledtolightonand0x00(OFF)meanslet
ledtolightoff.
RETURN:
Success:<ACK>.
Fail:Thisoperationwillsucceedalways.
34. APPLICATION_CONTROL
COMMAND:<0x78><0x16><APPON/OFF>.
ControltheAPPLICATION'sonoroff.
PARAMETERS:
<0x78><0x16>isthecommandheader.
<ON/OFF>:0x01(ON)meanslettheapplicationonand0x00(OFF)
meanslettheapplicationoff.
RETURN:
Success:<ACK>.
IDTECHXpressReaderUserManual
14
Fail:Thisoperationwillsucceedalways.
4.Applicationrelatedcommands
41. APP_FLUSH_DATA
COMMAND:<0x7E><0x01>.
Flushtheunreadreaddata.
PARAMETERS:
<0x7E><0x01>isthecommandheader.
RETURN:
Success:<ACK>.
Fail:Thisoperationwillsucceedalways.
42. APP_GET_DATA
COMMAND:<0x7E><0x02><IsFlushData>
Gettheunreadreaddata.Thiscommandwillresetthereaderinto
bufferedmode.
PARAMETERS:
<0x7E><0x02>isthecommandheader.
<IsFlushData>:0x00isnot,othersyes.
RETURN:
Success:<ACK><data>.
Fail:<NAK><ERROR_NO_DATA_AVAILABLE>
43. APP_SET_AUTOSENDMODE
COMMAND:<0x7E><0x04><MODE>.
Setdatasendmode.
PARAMETERS:
<0x7E><0x04>isthecommandheader.
<MODE>:0x00meansbufferedmodeand0x01meansautosendmode.
RETURN:
Success:<ACK>.
Fail:Thisoperationwillsucceedalways.
44. APP_SET_DATETIME
COMMAND:<0x7E><0x08><DATE(YYYYMMDDHHMMSS)>.
Setthedateandtimeinthesystem.
PARAMETERS:
<0x7E><0x08>isthecommandheader.
DATE(YYYYMMDDHHMMSS)isthedateandtime.Eg.0x320x300x30
0x360x300x310x300x320x310x360x330x300x320x35means
2006010216:30:25.
RETURN:
Success:<ACK>.
Fail:Thisoperationwillsucceedalways.
IDTECHXpressReaderUserManual
15
45. APP_GET_TVR
COMMAND:<0x7E><0x20>.
Getthelastterminalverificationresult.
PARAMETERS:
<0x7E><0x20>.isthecommandheader.
RETURN:
Success:<ACK><TVR>
Fail:<NAK><ERROR_NO_DATA_AVAILABLE>
46. APP_GET_TSI
COMMAND:<0x7E><0x22>.
Getthelasttransactionstatusinformation.
PARAMETERS:
<0x7E><0x22>isthecommandhead.
RETURN:
Success:<ACK><TSL>
Fail: <NAK><ERROR_NO_DATA_AVAILABLE>
47. APP_GET_TVRTSI
COMMAND:<0x7E><0x24>.
Getthelastterminalverificationresultandtransactionstatusinformation.
PARAMETERS:
<0x7E><0x24>isthecommandhead.
RETURN:
Success:<ACK><TVR><TSL>
Fail: <NAK><ERROR_NO_DATA_AVAILABLE>
47. APP_GET_TRAN_RESULT
COMMAND:<0x7E><0x26>
Getthelasttransactionresultinformation.
PARAMETERS:
<0x7E><0x26>isthecommandhead.
RETURN:
Success:<ACK><Result>
<Result>is1byte,seebelowdefinition.
#TRANSACTION_TWOCARDS 0x7A
#TRANSACTION_TERMINATE 0x7E
#TRANSACTION_DECLINE 0x81
#TRANSACTION_ACCEPT_OFFLINE 0x82
#TRANSACTION_GO_ONLINE 0x84
#TRANSACTION_COMPLETE 0x80
Fail: <NAK><ERROR_NO_DATA_AVAILABLE>
IDTECHXpressReaderUserManual
16
48. APP_GET_CVMRESULT
COMMAND:<0x7E><0x28>.
GetthelastterminalverificationCVMresult.
PARAMETERS:
<0x7E><0x28>isthecommandhead.
RETURN:
Success:<ACK><CVMResult>
Fail: <NAK><ERROR_NO_DATA_AVAILABLE>
49. APP_GET_DATETIME
COMMAND:<0x7E><0x18>
Getdateandtime.
PARAMETERS:
<0x7E><0x18>isthecommandhead.
RETURN:
Success:<ACK><DATE(YYYYMMDDHHMMSS)>Eg.0x320x300x30
0x360x300x310x300x320x310x360x330x300x320x35means
2006010216:30:25.
Fail:Thisoperationwillsucceedalways.
410. APP_GET_TRANSACTION_COUNT
COMMAND:<0x7E><0x30>
Getthetransactioncount.
PARAMETERS:
<0x7E><0x30>isthecommandhead.
RETURN:
Success:<ACK><Transactioncount(4bytes)>
Fail:Thisoperationwillsucceedalways.
Dataformat:Applicationtype(1byte)track1track2.
track1isencapsuledbystartsentinel'%'andendsentinel'?'.
track2isencapsuledbystartsentinel';'andendsentinel'?'.
AutosendmodedatawillnotbecapsuledbySTXandETX.
Applicationtype:
MASTER_APPLICATION 0x01
VISA_APPLICATION 0x02
EXPRESS_APPLICATION0x03
5.Datasettingcommands.
Tousethesecommands,theapplicationmustbeoff.
51. RETRIEVE_TERMINAL_DATA
IDTECHXpressReaderUserManual
17
COMMAND:<0x7E><0xF0><0x01><Tag>.
Retrievetheterminal'sdataelement.
PARAMETERS:
<0x7E><0xF0><0x01>isthecommandhead.
<Tag>isthedesireddataelement'stag.1or2bytes
Note:Actioncode'stagiscodedas'0x01'.
RETURN:
Success:<ACK><Requesteddataelement(TLV)>
Fail:Thisoperationwillsucceedalways.
52. UPDATE_TERMINAL_DATA
COMMAND:<0x7E><0xF0><0x02><Dataelement(TLV)>.
Updatetheterminal'sdataelementtemporary.
PARAMETERS:
<0x7E><0xF0><0x02>isthecommandhead..
<Dataelement(TLV)>:TLVformatdata
RETURN:
Success:<ACK><Statuscode(1byte)>.
Fail:Thisoperationwillsucceedalways.
53. UPDATE_TERMINAL_DATA_SAVE
COMMAND:<0x7E><0xF0><0x03><Dataelement(TLV).>
Updatetheterminal'sdataelement.
PARAMETERS:
<0x7E><0xF0><0x03>isthecommandhead.
<Dataelement(TLV)>:TLVformatdata
RETURN:
Success:<ACK><Statuscode(1byte)>
Fail:Thisoperationwillsucceedalways.
54. SELECT_TERMINAL_APPLICATION
COMMAND:<0x7E><0xF0><0x05><Applicationtype>.
Selecttheterminal’sapplication,usedfortestonly.
PARAMETERS:
<0x7E><0xF0><0x05>isthecommandhead.
Applicationtype:1byte.
RETURN:
Success:<ACK><Oldapplicationtype(1byte)>.
Fail:Thisoperationwillsucceedalways.
55. RETRIEVE_PUBLIC_KEY
COMMAND:<0x7E><0xF1><0x01><RID(5BYTES)><Index(1byte)>.
Retrievetheterminal'sSAVEDpublickeyofaspecialRIDanditsindex.
IDTECHXpressReaderUserManual
18
PARAMETERS:
<0x7E><0xF1><0x01>isthecommandhead.
<RID(5BYTES)>istheapplications’sRID.
<Index(1byte)>isthekeyindex.
RETURN:
Success:<ACK><RID(5)><Index(1)><HashIndicator(1)><Algorithm
Indicator(1)><Exponent(4)><KeyModuleLength(1)><KeyHash(20)><Module
Data(var)>.
56. REVOKE_PUBLIC_KEY
COMMAND:<0x7E><0xF1><0x02><RID(5BYTES)><Index(1byte)>.
Revoketheterminal'sSAVEDpublickeyofaspecialRIDanditsindex.
PARAMETERS:
<0x7E><0xF1><0x02>isthecommandhead.
<RID(5BYTES)>istheapplications’sRID.
<Index(1byte)>isthekeyindex.
RETURN:
Success:<ACK>
Fail:Thisoperationwillsucceedalways.
57. INVOKE_PUBLIC_KEY
COMMAND:<0x7E><0xF1><0x04><DATA>.
InvokeapublickeyofaspecialRIDanditsindexintheterminal.
PARAMETERS:
<0x7E><0xF1><0x04>isthecommandhead.
<DATA>:RID(5)Index(1)HashIndicator(1)AlgorithmIndicator(1)
Exponent(4)KeyModuleLength(1)KeyHash(20)Pad(29)ModuleData(var).
RETURN:
Success:<ACK>
Fail:Thisoperationwillsucceedalways.
58. RETRIVE_PUBLIC_KEY_COUNT
COMMAND:<0x7E><0xF1><0x08><RID(5BYTES)>
Retrievethecountoftheterminal'sSAVEDpublickeyofaspecialRID.
PARAMETERS:
<0x7E><0xF1><0x08>isthecommandhead.
<RID(5BYTES)>
RETURN:
Success:<ACK><Count(1byte)>.
Fail:Thisoperationwillsucceedalways.
6.Devicedirectcontrolcommands.
Commandheader:0xFE.Tousethesecommands,theapplication
mustbeoff(UsecommandAPPLICATION_CONTROLin35).
IDTECHXpressReaderUserManual
19
61. SEARCHCARDS
COMMAND:<0xFE><0x01><A/B><AFI>
Detectcardsinthefield.
PARAMETERS:
<0xFE><0x01>isthecommandhead..
<A/B>iscardtype:0fortypeAandtypeB,1fortypeAand2fortypeB.
1byte.
<AFI>isapplicationfamilyidentifierfortypeB.0fortypeA.1byte.
RETURN:
Success:
<ACK><CardCount>[<CardType><UIDLen><UID>][<CardType><
UIDLen><UID>]...
<CardCount>isthe countoffoundcardsinthefield.
[<CardType><UIDLen><UID>]willhappen<CardCount>times.
<CardType>isthecard'stype:1fortypeAand2fortypeB.
<UIDLen>isthefollowingUID'slength.
<UID>isthefoundcard'sUID(fortypeAcard)orPUID(fortypeB
card).
Fail:<ACK><0x00>.
62. SELECTONECARD
COMMAND:<0xFE><0x02><CardType><LenOfUID/PUID><UID/PUPI>
Selectonecard.
PARAMETERS:
<0xFE><0x02>isthecommandhead.
<CardType>isthecard'stype:1fortypeAand2fortypeB.1byte.
<LenOfUID/PUID>isthelengthoftheselectedUIDfortypeAorPUPI
fortypeB.1byte.
<UID/PUPI>:UIDfortypeA.PUPIfortypeB.
RETURN:
Success:<ACK><CardHandle>
<CardHandle>istheselectedcard'shandle,itwillbeusedbyother
commandstocommunicatewithaspecifiedcard.
Fail:<ACK><0x00>
63. DELETEONECARD
COMMAND:<0xFE><0x03><CardHandle>.
Deleteonecardfromthesystem.
PARAMETERS:
<0xFE><0x03>isthecommandhead.
<CardHandle>istheCard'shandlereturnedbySELECTONECARD
command.
RETURN:
Success:<ACK><Freeslotsavailable>
IDTECHXpressReaderUserManual
20
Fail:Thisoperationwillsucceedalways.
64. DELETEALLCARDS
COMMAND:<0xFE><0x04>
Deleteallcardsfromthesystem.
PARAMETERS:
<0xFE><0x04>isthecommandhead.
RETURN:
Success:<ACK><Freeslotsavailable>.2bytes
Fail:Thisoperationwillsucceedalways.
65. GETUSINGCARDSCOUNT
COMMAND:<0xFE><0x05>
Getthecardscountusingbythedevicesystem.
PARAMETERS:
<0xFE><0x05>isthecommandhead.
RETURN:
Success:<ACK><Usingcardscountbythedevice>.2bytes
Fail:Thisoperationwillsucceedalways.
66. GETFREESLOTS
COMMAND:<0xFE><0x06>.
Getthefreeslotsavailableinthedevicesystem.
PARAMETERS:
<0xFE><0x06>isthecommandhead.
RETURN:
Success:<ACK><Freeslotsavailable>.2bytes
Fail:Thisoperationwillsucceedalways.
67. GETCARDCID
COMMAND:<0xFE><0x07><CardHandle>.
Retrieveonecard’scurrentCIDusedinthedevicesystem.
PARAMETERS:
<0xFE><0x07>isthecommandhead.
<CardHandle>istheCard'shandlereturnedbySELECTONECARD
command.
RETURN:<ACK><Card'sCID>ifavailable.CIDisbetween1and14.
Thisoperationwillreturn<NAK><ERROR_INVALID_CID_RETURNED>if
failed.
68. DISABLECARDCID
COMMAND:<0xFE><0x08><CardHandle>
Informthedevicedonotusecard’sCIDinthesystem.
PARAMETERS:
IDTECHXpressReaderUserManual
21
<0xFE><0x08>isthecommandhead.
<CardHandle>istheCard'shandlereturnedbySELECTONECARD
command.
RETURN:
Success:<ACK>.
Fail:Thisoperationwillsucceedalways.
69. DISABLECARDNAD
COMMAND:<0xFE><0x09><CardHandle>
Informthedevicedonotusecard’sNADinthesystem.
PARAMETERS:
<0xFE><0x09>isthecommandhead.
<CardHandle>istheCard'shandlereturnedbySELECTONECARD
command.
RETURN:
Success:<ACK>.
Fail:Thisoperationwillsucceedalways.
610. SENDCOMMANDTOCARD
COMMAND:<0xFE><0x0A><CardHandle><CommandBlock>
Makethedeviceto communicatewiththecardinthesystem.
PARAMETERS:
<0xFE><0x0A>isthecommandhead.
<CardHandle>istheCard'shandlereturnedbySELECTONECARD
command.
<CommandBlock>istheinputcommand.
RETURN:
Success:<ACK><Cardreturneddata>
Fail:<NAK><Errorcode>
IDTECHXpressReaderUserManual
22
AppendixA
STATUSCODETABLE
ReturnStatusandExplanations
Errorcode Description
0xE1 ERROR_PARAMETER
0xE2 ERROR_LOWOUTBUFFER
0xE3 ERROR_CARD_NOT_FOUND
0xE4 ERROR_COLLISION_CARD_EXIST
0xE5 ERROR_TOOMANY_CARDS_EXIST
0xE8 ERROR_NO_DATA_AVAILABLE
0xE9 ERROR_INVALID_CID_RETURNED
0xEA ERROR_INVALID_CARD_EXIST
0xEC ERROR_COMMAND_UNSUPPORTED
0xED ERROR_COMMAND_PROCESS
0xEE ERROR_INVALID_COMMAND
IDTECHXpressReaderUserManual
23
AppendixC
FUNCTIONIDTABLE
CARRIER<0xFD><0x01><ON/OFF>.
POLLING<0xFD><0x02><PollingCount>.
RESET <0xFD><0x03><0x00>
REQA <0xFD><0x14><0x01>.
WUPA <0xFD><0x14><0x00>.
HALTA <0xFD><0x16><0x00>.
ACTIVEA<0xFD><0x18><0x00>
REQB<0xFD><0x25><0x01>.
WUPB<0xFD><0x25><0x00>
HALTB <0xFD><0x27><0x00>
ACTIVEB<0xFD><0x29><0x00>
APPCOMMAND<0xFD><0x32><CPDU>
APP_TEST_START<0xFD><0x41>
APP_TEST_STOP<0xFD><0x42>
SET_BAUDRATE <0x70><0x01><NewBaudrate>.
SET_STOPBITS <0x70><0x02><NewStopBits>.
SET_PARITY <0x70><0x03><NewParity>.
GET_VERSION <0x78><0x01>.
BEEP <0x78><0x04><Duration>
LED_CONTROL <0x78><0x05><LED><ON/OFF>
APPLICATION_CONTROL <0x78><0x16><APPON/OFF>.
IDTECHXpressReaderUserManual
24
APP_FLUSH_DATA <0x7E><0x01>
APP_GET_DATA <0x7E><0x02><IsFlushData>
APP_SET_AUTOSENDMODE <0x7E><0x04><MODE>
APP_SET_DATETIME <0x7E><0x08><DATE(YYYYMMDDHHMMSS)>.
APP_GET_TVR <0x7E><0x20>.
APP_GET_TSI <0x7E><0x22>.
APP_GET_TVRTSI <0x7E><0x24>.
APP_GET_TRAN_RESULT<0x7E><0x26>
APP_GET_CVMRESULT <0x7E><0x28>
APP_GET_DATETIME <0x7E><0x18>
APP_GET_TRANSACTION_COUNT <0x7E><0x30>
RETRIEVE_TERMINAL_DATA <0x7E><0xF0><0x01><Tag>.
UPDATE_TERMINAL_DATA <0x7E><0xF0><0x02><Dataelement(TLV)>
UPDATE_TERMINAL_DATA_SAVE <0x7E><0xF0><0x03><Dataelement(TLV).>
SELECT_TERMINAL_APPLICATION <0x7E><0xF0><0x05><Applicationtype>.
RETRIEVE_PUBLIC_KEY <0x7E><0xF1><0x01><RID(5BYTES)><Index(1byte)>.
REVOKE_PUBLIC_KEY <0x7E><0xF1><0x02><RID(5BYTES)><Index(1byte)>.
INVOKE_PUBLIC_KEY <0x7E><0xF1><0x04><DATA>.
RETRIVE_PUBLIC_KEY_COUNT <0x7E><0xF1><0x08><RID(5BYTES)>
SEARCHCARDS <0xFE><0x01><A/B><AFI>
SELECTONECARD <0xFE><0x02><CardType><LenOfUID/PUID><UID/PUPI>
DELETEONECARD <0xFE><0x03><CardHandle>
DELETEALLCARDS <0xFE><0x04>
GETUSINGCARDSCOUNT <0xFE><0x05>
GETFREESLOTS<0xFE><0x06>.
GETCARDCID <0xFE><0x07><CardHandle>.
DISABLECARDCID<0xFE><0x08><CardHandle>
DISABLECARDNAD <0xFE><0x09><CardHandle>
SENDCOMMANDTOCARD<0xFE><0x0A><CardHandle><CommandBlock>
IDTECHXpressReaderUserManual
25