...
If PC/SC Reader Drivers were selected in the Select Components dialog then the AVT Setup Program will proceed with the installation of each individual PC/SC Reader Driver, for example:
NOTE: You should cancel the installation of PC/SC Reader Drivers that are already installed on your PC
The installation shall resume with the following dialog confirms a successful installation of the AVT Software:
...
Settings
The agnos.ini file contains configuration parameters or options to configure the AVT Software
Some of these options may be modified at runtime from the TMS/Administrative.. Menu of the ACE-Client (ee TMS/Administrative Menu for more details about these options)
| Code Block |
|---|
[Agnos]
Path=./AGNOS/
Readers=pcsc.ini
Trace=0
Language=lang.ini
; MODE
; 1: Automation
; 2: SDK (ACE)
Mode=2
FileIntegrity=No
CL=Yes
DefaultLanguage=1
AccountSelection=No
APDULog=Yes
UIDisplay=Yes
Replay=No
IDMessageDisplay=No
TagDump=No
[Contactless]
KeyIn=Yes
Default9C=0
AlwaysReceipt=No
TransactionLooping=No
Signal=Yes
LegacyZIP=No
LegacyPayPass=Yes
LegacyAmex=No
LegacyJCB=No
LegacyCUP=No
LegacyDPAS=No
LegacyVISA=No
[COM]
Address=localhost
Port=5560
[Callback]
DE=Yes
EMVSelection=No
KernelSelection=No
LanguageSelection=No
AmountSelection=No
[AtmosSTUBee]
Port=1999 |
PC/SC Readers
The PC/SC Readers officially supported by the AVT Software are:
SCM SDI010
Identiv CLOUD 4700 F
Identiv uTrust 4701F
HID Omnikey 5321
HID Omnikey 5421
The pcsc.ini file contains the list of Readers to be recognized/used by the AVT
| Code Block |
|---|
[Settings]
; -- APDU Traces --
; 0: Disabled
; 1: Display APDU Traces
Traces=1
; -- Card Removal Option --
; 0: Disabled
; 1: Wait for Card Removal
Removal=1
; -- Polling Timeout --
; 0: Disabled (wait forever)
; 1 - 65535: Timeout in Seconds
Timeout=10
; -- Polling Technologies (Reader Type) --
; b8 b7 b6 b5 b4 b3 b2 b1
; - - - - - - - 1 1 = Contact
; - - - - - - 1 - 2 = Contactless
; Ex: 3 --> Contact and Contactless
Technos=3
[Readers]
;;; IMPORTANT: It is mandatory to keep the [SPACE] at the End of some Reader Names
;;; otherwise some Contactless Readers may be confused as Contact Readers
Reader01="Identive CLOUD 4700 F Contact Reader"
Reader02="Identive CLOUD 4700 F Contactless Reader"
Reader03="OMNIKEY CardMan 5x21 "
Reader04="OMNIKEY CardMan 5x21-CL"
Reader05="SCM Microsystems Inc. SDI010 Smart Card"
Reader06="SCM Microsystems Inc. SDI010 Contactless"
Reader07="SCM Microsystems Inc. SCR3310 USB"
Reader08="Identiv uTrust 4701 F Contact Reader"
Reader09="Identiv uTrust 4701 F CL Reader"
[Reader01]
; Identive CLOUD 4700 F Contact
Type=1
[Reader02]
; Identive CLOUD 4700 F Contactless
Type=2
FieldControl="Identiv"
[Reader03]
; OMNIKEY CardMan 5x21
Type=1
[Reader04]
; OMNIKEY CardMan 5x21-C
Type=2
FieldControl="Omnikey"
[Reader05]
; SCM Microsystems Inc. SDI010 Smart Card
Type=1
[Reader06]
; SCM Microsystems Inc. SDI010 Contactless
Type=2
FieldControl="Identiv"
[Reader07]
; SCM Microsystems Inc. SCR3310 USB
Type=1
[Reader08]
; Identiv uTrust 4701 F Contact Reader
Type=1
[Reader09]
; Identiv uTrust 4701 F CL Reader
Type=2
FieldControl="Identiv"
[Identiv]
Code=3500
On=9601
Off=9600
[Omnikey]
Code=3207
On=0300
Off=0301 |
New PC/SC Readers may be added in this file, however it is important to specify the FieldControl Escape Command for Contactless Readers (Type=2) for ensuring proper behavior of the Field On/Off of the NFC Antenna during L2 Certification testing
For example, the Control Code of Identiv Readers is 0x3207 and the Escape Command for turning the Antenna Field On is 0x03 0x00 and 0x03 0x01 for turning the Antenna Field Off
NOTE: Installation of the appropriate Reader Driver is generally required for gaining access to SCardControl() of a given PC/SC Reader
NOTE: A copy of the Drivers for the supported PC/SC Readers are located under C:\Amadis\AVT\Drivers\
AddCheck
The lang.ini file contains Strings displayed by the AVT
| Code Block |
|---|
[Language]
; Language at position 1 acts as Default
1=en
2=fr
[en]
Label=ENGLISH
; Standard Messages EMVCo Book IV, section 11.2
01=AMOUNT
02=AMOUNT OK?
03=APPROVED
04=CALL YOUR BANK
05=CANCEL OR ENTER
06=CARD ERROR
...
94=PASSCODE REQUIRED\\SEE MOBILE APP
95=TOO MANY TAPS
96=PAYMENT TYPE\\NOT ACCEPTED
97=PURCHASE
98=REFUND
99=TIMEOUT
check=CE89CA8D8FCFE2B6 |
Each Language Section (ex: [en]) end with check that is validated by the AVT during loading of the String Tables, if the check of a Language Section fails then the Language is not loaded.
The AddCheck.exe utility allows updating the check of each Language Section after adding a new Language or after Strings have been modified:
Usage: > AddCheck.exe lang.ini