Amadis
Installation
Contact our support team for more information about the AVT Software and how to get the AVT Setup Program
Requirements
PC running Windows 10 (64 bit) and later
PC/SC Reader
Software installation
Execution of the AVT Setup Program may require Admin Rights
On first installation, the Select Destination Location dialog will suggest C:\Amadis\AVT (strongly recommended):
The Select Components dialog offers three types of installations:
Basic installation: AVT only (i.e. no PC/SC Reader Driver)
Full installation: AVT and all PC/SC Reader Divers (recommended for first installation)
Custom installation: AVT and checked PC/SC Reader Drivers
NOTE: PC/SC Reader Drivers shall be installed only once
The Select Start Menu Folder dialog will suggest Amadis (strongly recommended),
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 (see TMS/Administrative for more details about these options)
[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
[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
[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