VF DOC ADC 1301 VF Service Release Notes Rev.A17

Guide No.
1301
Document Number Classification

VF-DOC-ADC-1301 Confidential
Rev.
Verifone
A17
VF-Service for X990 Release Notes
Page 1 / 25
Guide No.1301
Revision History
Rev. Date Author Change Description
A00 2021-04-13 Simon Liu

A01 May-6, 2021 Simon Liu New release of 3.6.4, 2.23.3, 2.23.2
A02 Jun-4, 2021 Simon Liu New release of version 3.10.0.0004,
2.30.0.0008, 2.23.4
A03 Jun-16, 2021 Simon Liu New release of version 3.6.2.5 which fixed from
3.6.2
A04 Jun-25, 2021 Simon Liu New release of Version 3.10.1.

A05 July-15, 2021 Simon Liu New release 3.6.5 fixed from 3.6.4
A06 July-21, 2021 Simon Liu New release 3.10.2 from 3.10.1
A07 Aug-3, 2021 Simon Liu New release 2.30.1 from 2.30.0.0008 ONLY for
none-DUKPT VIP since there’s issue
while using DUKPT
A08 Aug-20, 2021 Simon Liu New release 3.10.3 from 3.10.2
A09 Sep-3, 2021 Simon Liu New Release 3.10.4 from 3.10.3
A10 Sep-15, 2021 Simon Liu New Release 3.10.5 from 3.10.4.
Add Annex A FAQ, 1. Permission on or
permission off.
NOTES: we’re focusing on Version 3.x now.
Version 2.x will be frozen by the end of this
year. Please upgrade your project.
A11 Sep-24, 2021 Simon Liu New Release 3.10.6 from 3.10.5
A12 Nov-5, 2021 Simon Liu Release Hotfix 3.10.3.1 from 3.10.3.
A13 Nov-22, 2021 Simon Liu New Release 3.11.0 from 3.10.6.
A14 Nov-29, 2021 Simon Liu Release 3.11.0 for Brazil.
A15 Dec-20, 2021 Simon Liu New Release 3.11.1 from 3.11.0
A16 Jan-17, 2021 Simon Liu New Release 3.11.2 from 3.11.1
A17 Jan-20, 2021 Simon Liu Hotfix 3.11.2.1 from 3.11.2
Page 2 / 25
Guide No.1301
Table of contents
Table of contents ...................................................................................................................................................................... 3

1. Introduction .............................................................................................................................................................. 5
2. Relates Packages & Versions .............................................................................................................................. 6
2.1 Highlight features. .................................................................................................................................................. 6
2.2 Others ......................................................................................................................................................................... 6
2.2.1. ROM .................................................................................................................................................................... 6
2.2.2. Security Driver ................................................................................................................................................. 6
3. Installation and Upgrade ...................................................................................................................................... 7
3.1 Release portal........................................................................................................................................................... 7
3.1.1. Teams ................................................................................................................................................................. 7
3.1.2. Confluence........................................................................................................................................................ 7
3.1.3. Redmine ............................................................................................................................................................ 7
3.1.4. Verifone OneDrive ......................................................................................................................................... 7
3.2 how to install or upgrade ..................................................................................................................................... 7
4. Release notes and Change history of V3 ........................................................................................................ 8
4.1 Version 3.11.2 ........................................................................................................................................................... 8
4.1.1 Hotfix 3.11.2.1 .................................................................................................................................................. 9
4.2 Version 3.11.1 ........................................................................................................................................................... 9
4.3 Version 3.11.0 ......................................................................................................................................................... 10
4.4 Version 3.10.6 ......................................................................................................................................................... 11
4.5 Version 3.10.5 ......................................................................................................................................................... 11
4.6 Version 3.10.4 ......................................................................................................................................................... 12
4.7 Version 3.10.3 ......................................................................................................................................................... 12
4.7.1 Hotfix Version 3.10.3.1................................................................................................................................ 12
4.8 Version 3.10.2 ......................................................................................................................................................... 13
4.9 Version 3.6.5 ........................................................................................................................................................... 13
4.10 Version 3.10.1 ......................................................................................................................................................... 14
4.11 Version 3.6.2.5 ........................................................................................................................................................ 14
4.12 Version 3.10.0.0004 .............................................................................................................................................. 15
4.13 Version 3.6.4 ........................................................................................................................................................... 15
Page 3 / 25
Guide No.1301
4.14 Version 3.6.2 ........................................................................................................................................................... 16

4.15 Version 3.5.2 ........................................................................................................................................................... 16
4.16 Version 3.1.0 ........................................................................................................................................................... 17
4.17 Version 3.0.2 ........................................................................................................................................................... 17
5. Release notes and Change history of V2 ...................................................................................................... 19
5.1 Version 2.30.1 ......................................................................................................................................................... 19
5.2 Version 2.30.0.0008 .............................................................................................................................................. 19
5.3 Version 2.23.4 ......................................................................................................................................................... 20
5.4 Version 2.23.3 ......................................................................................................................................................... 20
5.5 Version 2.23.2 ......................................................................................................................................................... 20
5.6 Version 2.22.3 ......................................................................................................................................................... 21
5.7 Version 2.21.0 ......................................................................................................................................................... 21
5.8 Version 2.20.6 ......................................................................................................................................................... 21
5.9 Version 2.20.5 ......................................................................................................................................................... 21
5.10 Version 2.20.3 ......................................................................................................................................................... 22
5.11 More version........................................................................................................................................................... 23
Annex A. FAQ ................................................................................................................................................................... 25
1 Permission Off or Permission ON .................................................................................................................... 25
Page 4 / 25
Guide No.1301
1. Introduction
This is the release notes of VF-Service for X990.
The guide is released on Teams channel Published, so, you could find the latest
version on the folder.
There’re 2 major branches currently, Version 2.x and Version 3.x
NOTES:
Now we’re focusing on Version 3.x.
And Version 2.x will be frozen by the end of this year (2021).
Please upgrade your project to use the Version 3.x, thanks.
Page 5 / 25
Guide No.1301
2. Relates Packages & Versions
2.1 Highlight features.
VF-Service usually requires new security driver for new features.

There’s HTML guide archived in the release package.
About EMV workflow, Tags and Values, there is another guide No.1102 about the details.
You could find Guide no.1102 from teams channel X990 Public Projects/VF-Service, folder Published
2.2 Others
2.2.1. ROM
Both Android 5 and Android 7 are support. Usually, there is no require on the ROM version.
And supports Android 10 from Version 3.10.5.
2.2.2. Security Driver
The Security Driver to handle / manage the device about the transaction, such as card readers, printer, etc.
Also crypto is included in the security driver.
Page 6 / 25
Guide No.1301
3. Installation and Upgrade
3.1 Release portal
3.1.1. Teams
https://teams.microsoft.com/l/channel/19%3a01451b8e9c3240e899a63057ffa03f45%40thread.tacv2/VF-
Service?groupId=e19f5c97-3f19-4dfe-b745-fb2172cd3d27&tenantId=611a22d6-8c40-4958-84e3-
ce47d8205d98
3.1.2. Confluence
https://confluence.verifone.com:8443/display/ASPACPM/SDK+for+X990+and+Demos
Updated to version 3.6.2 & 2.22.3 and stop update more due to development team cannot edit / access the
package due to restrict permission was launched.
3.1.3. Redmine
https://redmine.verifone.cn/redmine/projects/devhome/wiki/2-Develop-SDK
Version updated to 3.6.4 & 2.23.3
3.1.4. Verifone OneDrive
Verifone OneDrive Folder:

https://verifone365-my.sharepoint.com/:f:/g/personal/chaol2_verifone_com/EjQIDlbqhxlDmy-
OeYfuVLoBbSVnouGF6e0KNS0EGkb_RA?e=Cko3Ea
3.2 how to install or upgrade
VF-Service released without signed, So, need you signed the APK with your USB Key before installing it to
production terminals.
For Debug terminal, APK without signed can be install by using the adb command.
Page 7 / 25
Guide No.1301
4. Release notes and Change history of V3

The latest version on the top.
4.1 Version 3.11.2
Version 3.11.2 from 3.11.1

Release date Jan-17, 2021
Revision Fixed issues:
#1. Fixed the issue that cannot detect the CTLS card on the latest V4 sample devices.
#2, Fixed the issue that cannot get the correct card type while using
ISmartCardReaderEx::search(). And fixed the issue that failed on write(). And fixed the issue
that powerUp() cannot tell the correct status. And fixed the issue about card cannot be
used after removed the card before powerDown().
#3, Fixed the issue that API ISerialPort::close() return false always.
#4, Fixed the issue which found on VCCS-pure certificating.
#5, Fixed the issue about printer cannot work as expected while calling startPrint()
continuous without waiting print finished. The second startPrint will be blocking and not
be started until the first one finished.
Enhancements:
#1, Supports change 9F15 while onConfirmCardInfo().
#2, Supports read DF42 on DKV cards.
Comment Known issues:

Some cards cannot be detected by API IMagCardReader::searchCard(), error code 100 got
for some cards on some devices. But those cards works with API IEMV::checkCard().
Affect on VF-Service 3.11.1 & 3.11.2.
Will fix the issue on next release.
Download Verifone access:
link X990Service_PermissionOff_3.11.2_220117_141620.zip
X990Service_PermissionOn_3.11.2_220117_145303.zip
Package for Brazil:

To be released soon.
Page 8 / 25
Guide No.1301
4.1.1 Hotfix 3.11.2.1
Version 3.11.2.1 from 3.11.2

#1. Fixed the issue that API IMagCardReader::searchCard() cannot detect some cards
which mentioned on last release.
Enhancements:
N/A
Comment Known issues:

N/A
Download Verifone access:
link X990Service_PermissionOff_3.11.2.1_220119_152623.zip
X990Service_PermissionOn_3.11.2.1_220119_153230.zip
Package for Brazil:
To be released soon.
4.2 Version 3.11.1

Release date Dec-20, 2021
Revision Fixed Issues:
#1. Fixed the issue that cannot use the Serial port on C680 Dongle correctly.
#2, Fixed the issue that VF-Service takes much storage in case of calling API
UpdateAID() or UpdateRID() from multi-threads parallelly.
#3, Fixed the issue that API getFirmwareVersion() cannot tell the Firmware correctly
on X990 V4 (Android 10).
New Features:
#1, New API Bundle getDeviceInfoEx(in Bundle extrend) from IDeviceInfo to read the
BootVersion (Aboot version)
#2, API getCardInfo() from IRFCardReader.aidl returns Bundle included ATQA.

Comment Feature #1, set Bundle with key bootVer to get the Boot version, please refer the doc
for more details
Download link Verifone access (same package were sent via different path due there’s access
Page 9 / 25
Guide No.1301
rule changed from IT):

X990Service_PermissionOff_3.11.1_211220_095953.zip or
X990Service_PermissionOff_3.11.1_211220_095953.zip
X990Service_PermissionOn_3.11.1_211220_100415.zip or
Package for Brazil:

X990Service_PermissionOn_3.11.1_211220_100415_BR.zip or
X990Service_PermissionOn_3.11.1_211220_100415_BR.zip
4.3 Version 3.11.0

Release date Nov-22, 2021
#1. Fixed the issue that iPinpad.calcMACWithCalType give the Dukpt Response while
setting dukptRequest=true. Issue was included from Version 3.10.3. Suggesting using
the API defined from IDUKPT to use the DUKPT.
#2, Fixed the issue that crash happened while calling updateRID / updateAID in EMV
working follow.
New Features:
#1, Supports keep disable taskbar even after power cycle once call the API
setSystemFunction with STATUSBARKEY=false for single time. In another words, the
configuration will be kept by the ROM till there’s a new configuration be set.
#2, setSystemFunction() includes new bundle INSTALLERAUTOSTART definition for :

true(default) : UsbAppInstaller app run automatically when OTG is connected;
false : UsbAppInstaller not pop-up when OTG is connected. The configuration will
be kept by the UsbAppInstaller till there’s a new configuration be set.
#3, Supports more UltraLight Cards on new definition:

aidl.card_reader.IUltraLightCard; IUltraLightCardEV1; IUltraLightCardC;
IUltraLightCardNano;
#4, Supports change the TAC for Contact Card. Please using the same way to set it as
for Contactless Card.
#5, Disable the traffic request to http://lib.vfcnserv.com/library/trans

http://libtest.verifone.cn:8081/library/trans which function is not supported on
Oversea branch.
Page 10 / 25
Guide No.1301
Comment Feature #1, #2 request ROM upgrade to 20201115 or higher.

Feature #3 requests SP upgrade to 1.0.11 or higher.
Download link Verifone access:
Package for Brazil:
X990Service_PermissionOn_3.11.0_211122_100204_Br.zip
4.4 Version 3.10.6

Release date Sep-24, 2021
Revision #1. Fixed the issue that Mifare DESFire card cannot exchange APDU on the SP
released recently.
#2, Fixed the issue that PSAM card cannot work after some exchange or got other
error.
#3, Fixed the issue about IDeviceInfo.getDeviceInfo() takes more time on some
sample Android 10 units due to some model doesn’t have MEID on the version
3.10.5.
Comment
4.5 Version 3.10.5

Revision #1. Fixed the issue that search card failed on Security version 1.8.2 or early.
#2. Extend the API IDeviceService.getSerialPort() to support get new devices (usb to
serial) with given driver type, support get device by slot or Production name in case
of same VID & PID devices attached. Please refer doc or the comment on AIDL for
more details.
#3. New API ISerialPort.writeEx() for SDLC communication.
#4. Using String instead of java.lang.String on AIDL files due to need to change the
gradle to accept java.lang.String.
Comment
Page 11 / 25
Guide No.1301
NOTES:
This is the version ready for Android 10.
Known issue on Android 10:
1#, IDeviceInfo.getDeviceInfo() takes more time on some sample Android 10 units due to some model doesn’t
have MEID. The issue will be fixed on next version.
4.6 Version 3.10.4

Revision #1. Fixed the issue that inject VRK payload failed while type is DUKPT slot other than
0.
Comment
X990Service_PermissionOff_3.10.4_210902.zip
4.7 Version 3.10.3

Release date Aug-20, 2021
Revision #1. Short the time of showing the PinPad
#2. Fixed the unexpected error code if start PinPad without key injected.
#3. Fixed the issue cannot get the correct KSN on Security Driver 1.8.2 or lower
version.
#4. Fixed the issue that KSN may not be increased after VRK key injection.
#5. Fixed the issue that SerialPort write data blocked.
#6. Fixed the issue that EMV card was recognized as M1 card while EMV transaction.
#7. Fixed the issue that cannot Check/Read some of the IC card/PSAM card issue.
Comment
X990Service_PermissionOn_3.10.3_210820.zip
4.7.1 Hotfix Version 3.10.3.1
NOTE:
This is a hotfix version for Brazil partner.
Version 3.10.3.1 from 3.10.3
Page 12 / 25
Guide No.1301
Revision #1. Fixed the issue that crash happened while calling UpdateRID() in EMV callback
onConfirmCardInfo()
Comment
X990Service_PermissionOn_3.10.3.1_211105_BR.7z
4.8 Version 3.10.2

Release date July-21, 2021
Revision #1. Fixed the issue that does not support Usb2Serial (Such as 680Dongle, Z-Tek, etc.)
well.
#2, Fixed the issue that hard to detect magnetic card on Security Driver 1.77.
#3. Fixed the issue that DUKPT was changed to auto-increase from manually after
key injected on version 3.10.1.
#4, Fixed the issue about initDUKPT() returns -1 and need reinject the DUKPT. This
issue happened randomly after key was injected and doing search card immediately
after that.
#5, Fixed the issue that cannot get the correct KSN in some cases.
#6, Fixed the issue that VF-service keeps crashing in case of one of configuration file
is damaged. Issue maybe caused by upgrading VF-Service while it is writing the file.
Comment
X990Service_PermissionOn_3.10.2_210721.zip
4.9 Version 3.6.5
Version 3.6.5 fixed from 3.6.4

Revision #1. Fixed that getting card number error when swipe 19 digits card on K21 2.0.4
Comment

Page 13 / 25
Guide No.1301
4.10Version 3.10.1
Version 3.10.1 from 3.10.0.0004, merge new features & fixed on 3.6.2.5
Release date Jun-25, 2021
Revision #1. New feature to load XML to select/change the EMV Kernel.
#2, Fixed the issue that get incorrect KSN when K21 was updated from 192 to 2.04 or
higher.
#3. Fixed that getting card number error when swipe 19 digits card on K21 2.0.4
#4, Add error message (0xFF, Other error) while using PinPad but Pin Key is not
injected.
#5, Supports X990 V2 2nd source component.
#6, New API to get the EMV Kernel version. getCtlsSpecVer defined in IEMV.aidl
#7, New feature supports Ultra-Light card, IUltraLightCard for more details.
#8, New feature support RSA, IRSA for more details.
Comment
More about #1,
Save and copy the following file to /sdcard/verifone/VFService/CTLSKernelCfg.xml
<?xml version="1.0" encoding="utf-8"?>
<CTLSKernel>

<MASTER>0</MASTER>

<AMEX>1</AMEX>

<JCB>0</JCB>
</CTLSKernel>
To change the kernel version.

VF-Service saves a copy of the file in its own memory. So, remove the file
/sdcard/verifone/VFService/CTLSKernelCfg.xml cannot change the version since it was
read.

4.11Version 3.6.2.5
Version 3.6.2.5 from 3.6.2

Page 14 / 25
Guide No.1301
Revision #1. Compatibility of DUKPT key, fix KSN get incorrect when K21 update from 192 to
2.04 or higher.
#2. Fixed that getting card number error when swipe 19 digits card on K21 2.0.4
#3. Add an error message when POS doesn’t exist PIN key
Comment

X990Service_PermissionOff_3.6.2.5.zip
4.12Version 3.10.0.0004
Version 3.10.0.0004 which modified on 3.6.4

Revision Supports X990 V2 2nd source component
nd
Comment There’s no other changes but support the 2 source component.
The security driver version format changed from 2 versions to 1 version.
String getK21Version(). You could find the version from the Settings
X990Service_PermissionOff_3.10.0.0004_210604_debug_v1v2.apk
4.13Version 3.6.4

Release date Apr-30, 2021
Revision #1. New configuration to config the card type (disable M1 card) while calling the
emv.checkcard()
#2. Fix problems with Indian certification cases. It's about the UPI.DEV.P.023 - PIN of
12 digits
Comment From this version, there's new configuration file included to configure some features.
Such as disable M1 card while emv.checkcard(), save the following to
/sdcard/verifone/VFService/VFServiceCfg.xml
<?xml version="1.0" encoding="utf-8"?>
<VFService>
<package pkgName="default">

<default>
Page 15 / 25
Guide No.1301



<emv>
<checkcard>
<autoMode>true</autoMode>
</checkcard>
</emv>
</default>
</package>
</VFService>
You could config the file to Verifone.zip and use the installer to install it.
Download link Verifone OneDrive:

4.14Version 3.6.2
Version 3.6.2
Release date Mar-10, 2021
Revision #1.Fixed key loss caused by upgrading Service
Comment
Compatibility issue was fixed on K21 2.04, So, while using ROM 2019, please
upgrade the K21 to 2.04 or higher.
There's the packages archived the K21 version 2.04 in the shared folder
Download link Verifone OneDrive:
X990Service_PermissionOff_3.6.2-With-K21-2.04.7z
X990Service_PermissionOn_3.6.2-With-K21-2.04.7z.7z
4.15Version 3.5.2
Version 3.5.2
Page 16 / 25
Guide No.1301
Release date Feb-2, 2021

Revision 1. Add beep frequency setting function
2. Failed to add keystoretr34payload, return value
3. Atrcheck. ATR check can be turned off before the card is powered on
4. Add IKLD.aidl Tr34 key loading
Comment &
Notes
Download link
4.16Version 3.1.0
Version 3.1.0
Revision #1. Scanner, add API to support custom UI function
#2. Fixed the issue about serial RS232 that reading or writing failed in case of
connect/disconnect for many times
Comment & or custom UI of the scanner, pleaser refer the development guide for more details,
Notes
void com.vfi.smartpos.deviceservice.aidl.IScanner.scannerInit ( in Bundle param )
Custom UI by customers.
Parameters
param
customUI(boolean) default value is false
x1(int) vertex coordinates x1, default is 0
y1(int) vertex coordinates y1, default is 0
width(int) if customUI is true, default is full screen
height(int) if customUI is true, default is full screen
Download link
4.17Version 3.0.2
Version 3.0.2
Revision #1. Add get vrksn interface
#2. Dukpt slots up to 100 -- K21 should upgrade to version 2.0.4 or higher
Page 17 / 25
Guide No.1301
Comment & Synced from Version 2.21.0

Notes
for getting VRKSN, using the following API
getDeviceInfo()
Bundle com.vfi.smartpos.deviceservice.aidl.IDeviceInfo.getDeviceInfo ( )
Get all of infomation about device.
Returns
bundle
SN(String) Serial No
PN(String) Product No
IMSI(String) International Mobile Subscriber Identity
IMEI(String) International Mobile Equipment Identity
MEID(String) Mobile Equipment Identifier
manufacture(String) get manufature message
deviceModel(String) get device model
androidOsVer(String) get android OS version
androidKernalVer(String) get android kernel version
romVer(String) get rom version
firmwareVer(String) get firmware version
hardwareVer(String) get hardware version
k21Ver(String) get k21 version
VFSerivceVer(String) get VFService version
VRKSn(String) get VRK sn
SponsorID(String) get sponsor id
Download link
Page 18 / 25
Guide No.1301
5. Release notes and Change history of V2
NOTES:
The version 2.x will be frozen by the end of this year.
Please upgrade you project using the Version 3.x, thanks.
The latest version on the top.
5.1 Version 2.30.1
Version 2.30.1 from 2.30.0.0008

Revision #1. Fixed the issue that crash while scanning QR code.
#2. Fixed the issue that does not support Usb2Serial (Such as 680Dongle, Z-Tek, etc.)
well.
#3, Fixed the issue that cannot change the CTLS AID of JCB before startEMV.
#4, Fixed the issue that crash while using beeper randomly.
#5, Fixed the issue Mifare card failed randomly.
Comment There’re some issues while using DUKPT more than 1 slot, So please do not release
the version to those VIP who using DUKPT.
X990Service_PermissionOff_2.30.1.zip
5.2 Version 2.30.0.0008
Version 2.30.0.0008 which modified on 2.23.4

Revision Supports X990 V2 2nd source component
nd
Comment There’s no other changes but support the 2 source component.
The security driver version format changed from 2 versions to 1 version.
String getK21Version(). You could find the version from the Settings
X990Service_PermissionOff_2.30.0.0008_210604_debug_v1v2.apk
Page 19 / 25
Guide No.1301
5.3 Version 2.23.4

Revision #1. Fix visa Cash transaction failure problem
#2. Internal logic of SetSystemFunction interface, you can set HomeKey and status bar
separately
Comment
Redmine,
https://redmine.verifone.cn/redmine/projects/devhome/wiki/2-Develop-SDK
5.4 Version 2.23.3
Version 2.23.3
Revision #1. fix the problem of printing on x990-T. Printing is very light while using the previous
version.
Comment
Redmine,
5.5 Version 2.23.2
Version 2.23.2
Revision 1.EMV parameter add interface UpdateGroupParam
2. Add UseMaxResolution and StartPreview
3. Support bypass all PIN (if there are two off-line pins, if the first one is passed, then
the second one will bypass),SetIsByPassAllPin (), getIsByPassAllPin ()
4. PinPad add parameter PinFormatType which supports Format1, 2, 3 algorithms
5. Support for selecting the kernel spec version
Comment
Download link Redmine
Page 20 / 25
Guide No.1301
5.6 Version 2.22.3
Version 2.22.3
Revision #1. Fixed the problem of getting KSN all 0 after modifying pinpad encryption
#2. Modifying dukpt to get internal logic of KSN
Comment
Download link
5.7 Version 2.21.0
Version 2.21.0
Release date Now-25, 2020
Revision #1. Fixed the issue that in some case Debug version no EMV log dumped
#2. Update the official SDK version
#3. Merge the screenshot printing function branch
#4. Fixed the issue that receive serial port data timeout happend while data be found
#5. Update open source serial port library AAR driver to support more RS232 devices
#6. Fixed the issue of dukpt keyId hard code to 1 when get dukptKSN.
Comment Once the security driver (K21) upgrade to upgrade 193 & 046, need upgrade the VF-
Service to the version 2.21.0 or higher.
Download link
5.8 Version 2.20.6
Version 2.20.6
Revision #1. fix the cache to print
Comment
Download link
5.9 Version 2.20.5
Version 2.20.5
Page 21 / 25
Guide No.1301
Release date Oct-21, 2020

Revision #1. fixed Visa Card Collision with Wallet
#2. mask some EMV sensitive information on release version
#3. fixed bug of dukpt.setDukptCFG() interface
#4, Fixed RS232 receive data timeout issue
Comment
Download link
5.10Version 2.20.3
Version 2.20.3
Revision #1. EMV check card add M1 card error type: M1_CARD_UNSUPPORT_EMV_ERROR(7)
in CheckCardListener onError
#2. Serial port supports more usb2rs232 device, refer getSerialPort for more details
#3. Support India RuPay kernel,
#4. Scanner supports Honeywell library, but need you charge of the feature.
#5, Update EMV Kernel

Comment EMV Kernel versions update to:
"SmartEMV", "v0.0.1.0"
"Visa", "v0.0.1.0"
"MasterCard", "v0.0.1.1"
"JCB", "v0.0.2.0"
"AMEX", "v0.0.2.0"
"Discover", "v0.0.1.0"
"QuickPass", "v0.0.1.0"
"GemaltoPure", "v0.0.1.0"
"RuPay", "v0.0.1.0"
-----
Versions before update:
"SmartEMV", "v1.0.0"
"Visa", "v1.00"
"MasterCard", "v1.0"
"JCB", "v1.00"
"AMEX", "v1.0.0"
"Discover", "v1.0.1"
"QuickPass", "EMV4.3e-V1.0.0"
"GemaltoPure", "2.1.8"
Page 22 / 25
Guide No.1301
Download link
5.11More version
Date Release notes Comment

Version
03 Jul 2020 #1, fixed the issue that occurs while reset CT card
2.15.112
twice
#2, Add some error code about the CTLS error

CTLS_ISSUERUPDATE_APPROVE(209) - Second tap,
issuer update approve
CTLS_CARD_BLOCK(210) - 6A81 error card block
CTLS_SEL_FILE_INVALID(211) - 6283 error Selected
file invalidated
Please refer aidl.EMVHandler or VfiServiceDoc for
more detail
2020-04-07 1.Fixed issue that get error value of AMEX 9F6E
2.15.107
2020-03-13 1.Fixed issue that get error value of Tag50
2.15.105
2020-03-13 1.Fixed the get Tag50 issue
2.15.5
2020-02-21 1.From version 2.15.4
2.15.104
2.Upgrade Master Kernel to V0.0.1.0
2020-02-20 BRA rom set default printGray=6, others = 4
2.15.4
2020-02-19 1#, update CTLS Kernel(ClssKernel 2.5.7 Beta)
2.15.3
2#, update SDK
3#, modify proguard-rules
2020-01-14 1#, fixed some bugs when select application
2.15.2
2019-12-19 1#, master(debit) to getting 9F17 between 1GAC
2.15.1
form 2GAC cause transaction fault.
2#, fixed bug of isCanOutPut() interface that in
LogOutPutUtil
3#, fixed issue that about pinpad sm4 paramater set
error
4#, update CTKS Kernel (V2.04 release)
5#, update sdk version(20190925b01)
2019-09-23 1#, update sdk to 20190918b02 The API of Henywell
(2.15.0)
2#, set sdk loglevel = 3(debug) scanner only support:
3#, PinPad set notificatePinLenError = true,
Page 23 / 25
Guide No.1301
notification password is not long enough when

"honeywell-qr" for qr,
press confirm key.
4#, add k21 version and service version output "honeywell-passport"
when create pbocManager. for passport,
5#, update debug sdk(20190906b01) More format support
6#, Fixed error message of checkCheckListener on version 2.16.0.9 or
7#, iemv.aidl add checkCardMs interface. later
8#, import Honeywell scanner library.
2019-08-28 1#, repair idukpt.calcuteData's algorithmModel
(2.14.0.0)
parameter misjudgement.
2#, update latest sdk, if the version of service is
debug then turn on sdk log output, if is release
version then turn off
3#, convert AMEX get value of SERVICE_CODE &
EXPIRED_DATE from bcd->ascii
4#, convert AMEX track2 data from bcd->ascii
5#, loadMaster set is TMS Master parameter is true
6#, update CTLS kernel(ClssKernel V2.03 Beta)
7#, update CTLS kernel, JCB return code
205(errorCode:-70019)
8#, Close Magnetic module in stopCheckCard()
9#, Close k21 command init operate
add API to close CTLS reader
(2.13.0.0)
1.Upgrade SDK to reduce the time while searching
(2.12.0.0)
card
2.add API ledControl in LED
update CTLS kernel version(V2.04)
2.11.2
X990 VFService release version
2.11.1
version 2.11.0.4
Remove log dump while in EMV on Release version
Page 24 / 25
Guide No.1301
Annex A. FAQ
1 Permission Off or Permission ON
For the Permission Off package, application can use all the devices provided by the VF-Service.
But for the Permission On package; application needs to be signed with the USB key assigned a permission
description list file.
So, one app signed with permission printer or other devices described in AIDL file can only use the signed-
device and cannot use the other devices.
Other apps need to be signed with all devices in case the app needs to use all devices.
Page 25 / 25

VF DOC ADC 1301 VF Service Release Notes Rev.A17

Uploaded by

Document Information

Original Description:

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

VF DOC ADC 1301 VF Service Release Notes Rev.A17

Uploaded by

Copyright:

Available Formats

Guide No.

Document Number Classification

VF-Service for X990 Release Notes

A00 2021-04-13 Simon Liu

A04 Jun-25, 2021 Simon Liu New release of Version 3.10.1.

A14 Nov-29, 2021 Simon Liu Release 3.11.0 for Brazil.

A17 Jan-20, 2021 Simon Liu Hotfix 3.11.2.1 from 3.11.2

Table of contents ...................................................................................................................................................................... 3

4.14 Version 3.6.2 ........................................................................................................................................................... 16

This is the release notes of VF-Service for X990.

version on the folder.

There’re 2 major branches currently, Version 2.x and Version 3.x

Now we’re focusing on Version 3.x.

Please upgrade your project to use the Version 3.x, thanks.

2. Relates Packages & Versions

2.1 Highlight features.

VF-Service usually requires new security driver for new features.

2.2.2. Security Driver

3. Installation and Upgrade

3.1 Release portal

3.1.4. Verifone OneDrive

Verifone OneDrive Folder:

3.2 how to install or upgrade

4. Release notes and Change history of V3

4.1 Version 3.11.2

Version 3.11.2 from 3.11.1

#4, Fixed the issue which found on VCCS-pure certificating.

#2, Supports read DF42 on DKV cards.

Comment Known issues:

Package for Brazil:

4.1.1 Hotfix 3.11.2.1

Version 3.11.2.1 from 3.11.2

Comment Known issues:

4.2 Version 3.11.1

Version 3.11.1 from 3.11.0

#2, API getCardInfo() from IRFCardReader.aidl returns Bundle included ATQA.

rule changed from IT):

Package for Brazil:

4.3 Version 3.11.0

Version 3.11.0 from 3.10.6

#2, setSystemFunction() includes new bundle INSTALLERAUTOSTART definition for :

#3, Supports more UltraLight Cards on new definition:

#5, Disable the traffic request to http://lib.vfcnserv.com/library/trans

Comment Feature #1, #2 request ROM upgrade to 20201115 or higher.

4.4 Version 3.10.6

Version 3.10.6 from 3.10.5

4.5 Version 3.10.5

Version 3.10.5 from 3.10.4

4.6 Version 3.10.4

Version 3.10.4 from 3.10.3

4.7 Version 3.10.3

Version 3.10.3 from 3.10.2

4.7.1 Hotfix Version 3.10.3.1

4.8 Version 3.10.2

Version 3.10.2 from 3.10.1

4.9 Version 3.6.5

Version 3.6.5 fixed from 3.6.4

Download link Verifone access:

To change the kernel version.

Download link Verifone access:

Version 3.6.2.5 from 3.6.2

Download link Verifone access: