Amadis
VCAS Module
- Seyhmus Cacina (Unlicensed)
- Frederic Solecki
- Frederic Solecki (Unlicensed)
- Olivier Chauvineau (Unlicensed)
Visa Cross-testing Automation Specification or VCAS module pilots ACE-Client automatically:
Configurations are modified and sent to acceptance system.
TMS/Administrative settings are modified and sent to acceptance system.
Transactions are started on acceptance device
signals are updated during the transactions
During the execution of Automated tests, it is better to not manipulate ACE-Client. Between the tests, ACE-Client is fully available.
VCAS tests the integration of the software in the hardware. It implies a huge constraint on transaction overall duration (see Polling timeout below).
Settings
Field | Comment | Value |
|---|---|---|
Port | Listening Port | IP port between 50000 and 65535 |
Update port button | Validate a new value in the Port field |
|
Start/Stop button | Start or stop the VCAS server un ACE-Client. If Start is displayed, the server is stopped and clicking on the button starts the server If Stop is displayed, the server is running and clicking on the button stops the server |
|
Automatic Start | Activate/Deactivate the VCAS server start when ACE-Client is started | 0 or 1 |
Prepare button | Send the default TERMINAL configuration and the CAKeys to the Acceptance System. |
|
TTQ | Default value of the TTQ in the configurations | any valid TTQ value |
Online only | Defines if the Acceptance System is online only | 1 for online only 0 otherwise |
Agnos v3.3 | Defines if the Acceptance System uses the framework 3.3. Note: using Kizis (versus KizisSP) with the framework 3.5 has the same behavior as framework 3.3. | 1 for framework 3.3 or Kizis+FMW3.5 0 otherwise |
Activate log | Activate/Deactivate the logs and the display in Transaction Page. If support is needed, must be activated. During the normal session, must be deactivated. | 0 or 1 |
Troubleshooting
If you need us to investigate anything related to VCAS, perform the test/transaction then:
use the File > Export mechanism to create an export zip
get the TTQ value from Setup > Visa Cross-testing Automation System
get the Administrative value from Setup > Visa Cross-testing Automation System
Send us the export, the TTQ and Administrative values.
Reset Device
Device shall power off and on and be ready to receive another command
The function gpiReset is called by this command. It shall implement a reboot of the device and restart the software after the reboot.
Polling timeout
The test VCAS.C.005.00 in VCAS validation tool sets the polling timeout to 2s and expects the whole transaction to take no more than 5s.
t1 is the duration of VCAS StartTransaction request transmission. It depends on the medium (cable or Wi-Fi…)
t2 is the duration of the request’s processing in ACE-Client. It depends on the performance of the computer.
t3 is the duration of transaction request transmission from ACE-Client to the terminal. It depends on the medium and may be longer if there is an adapter between ACE-Client and the terminal
t4 is the duration of the transaction itself
t5 is the duration of transaction response transmission from the terminal to ACE-Client. It depends on the medium and may be longer if there is an adapter between ACE-Client and the terminal
t6 is the duration of the request’s processing in ACE-Client. It depends on the performance of the computer.
t7 is the duration of VCAS StartTransaction response transmission. It depends on the medium (cable or Wi-Fi…)
The sum of all the durations must be less than 5s.
ACE-Client can compute (text in orange):
t2, it is around 30 ms
t3+t4+t5 as the transaction “duration”. This is the duration from ACE-Client point of view and it includes the transmission time.
t6 it is around 20 ms
Empty DebugLog
The test VCAS.C.009.00 - ClearLogs fails with empty Debug logs, if the APDU are not sent to ACE-Client.
FAQ
Is VCAS module started ?
If the button Start/Stop at the right of button 'Update Port' displays 'Stop', VCAS module is up. If it displays 'Start', the module is down.
How to change the listening port
if ACE-Client runs:
change the value in the field
click on Update Port button
click on Stop button
click on Start button (same as Stop)
Starting from version 3.3.34, if ACE-Client is stopped
edit “vcas.ini” in installation directory
change “listeningPort” value
What does SetConfigToDefault do
send the CAKeys to acceptance system
change TERMINAL configuration and send it to acceptance system
change PROCESSING configuration and send it to acceptance system
change ENTRY_POINT configuration and send it to acceptance system
What does PrepareTransaction do
change the TMS/Administrative settings in acceptance system. The values in the table below are set/modified:
Field | Forced Value |
|---|---|
Contactless | 1 |
Trace Depth | 6 for APDU log delay |
Key In | 0 |
Signal | 1 |
Polling timeout | VCAS tool gives the value of the polling timeout |
APDU Log | 0 if Agnos v3.3 is ticked 1 for the other frameworks |
PayPass Legacy | 0 |
Amex Legacy | 0 |
JCB Legacy | 0 |
CUP Legacy | 0 |
DPAS Legacy | 0 |
Visa Legacy | 1 |
Digital Signals | 1 |
The other values may depend on the ICS.
Is StopCurrentTransaction supported?
No.The StopCurrentTransaction() function is conditional only if pre-defined timeout (Tag: 0x24) can be set correctly via the SetConfig() function. The pre-defined timeout is modified through the TMS/Administrative and PrepareTransaction. For performance reasons (transaction duration), StopCurrentTransaction is not supported.
Is StartTransactionAsync supported?
Yes.
As only StopCurrentTransaction is optional and not supported, StartTransactionAsync starts a transaction like StartTransaction.
Where is the executable to stop VCAS
Please use shutdown-ACE-Client.bat in C:\Amadis\ACE-Client to shutdown ACE-Client and VCAS module.
If you want to manually stop the VCAS please use the Start/Stop button.
VCAS.C.002.00 is failing
For 'Online only' terminals, the test VCAS.C.002.00 is failing.
In order to achieve the ‘online only’ functionality, the Contactless Floor Limit (VCAS tag C007) default value is set to 0x00 00 00 00 00 00 instead of 0x00 00 00 00 80 00.
First Transaction with the robot
The Device may initiate a communication towards ACE-Client before using the robot. If ACE-Client is stopped then started again by the robot, the previous communication from the device to ACE-Client is lost. Then the first communication attempt from the device to ACE-Client might fail and cause a timeout.