Amadis

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 8 Next »

Please feel free to 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 (ee TMS/Administrative Menu 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

  • No labels