Readme

RBA Integration Kit for Telium2

IK-RBA-09.01

October 22, 2013

Ingenico Inc. 3025 Windward Plaza, Suite 600 Alpharetta, GA 30005

Tel: (678) 456-1200 Fax: (678) 456-1201 - ingenico@ingenico.com
Contents

1. Overview ____________________________________________________ 3

2. IK-RBA-09.01 Contents __________________________________________ 4

2.1. Ingenico Documents ___________________________________________________ 4

2.2. Telium RBA Terminal Application _________________________________________ 4

2.3. Telium RBA Parameters ________________________________________________ 5

2.4. Telium Utilities ________________________________________________________ 5

3. Telium Tools Setup Notes _______________________________________ 6

4. RBA Test App Setup Notes ______________________________________ 7

5. Loading Terminal Software Package ______________________________ 8

5.1. Setup Requirements ___________________________________________________ 8

5.2. LLT download ________________________________________________________ 9

5.3. USB Load ___________________________________________________________ 17

5.3.1. Creating USB Load Package ______________________________________________________17
5.3.2. Loading USB Load Package _____________________________________________________ 19

5.4. OGZ Load ___________________________________________________________ 20

5.5. Updating Communication file via file download ____________________________ 21

5.6. Enabling Contactless on Supported Device ________________________________ 21

5.7. Enabling P2PE (Point-to-Point Encryption) ________________________________ 22

Readme 2/22
1. Overview

IK-RBA-09.00 provides support for developing RBA application interfacing iPP350 device.

Please refer to the DIV350779 REV S Telium RBA Users Guide.pdf for a complete guide to the
Telium RBA application.

This release contains KP4 signed RBA code and shall only be used on terminal with KP4 key file
injected. Both LLT and OGZ load package is included in this release.

Readme 3/22
2. IK-RBA-09.01 Contents

Ingenicos RBA Integration Kit IK-RBA-09.01 contains the following software and documents.

2.1. Ingenico Documents

DIV350784 Rev A iPP300 Operation and Product Support Guide.pdf

DIV350783 Rev C iPP300 Installation and Quick Reference Guide.pdf

DIV350779 REV S Telium RBA Users Guide.pdf

DIV350774Rev B iSC350 Operation and Product Support Guide.pdf

DIV350773 Rev A iSC350 Installation and Quick Reference Guide.pdf

DIV350713 Rev E Telium Tools Installation Guide.pdf

DIV350823Rev A iSC250 Operation and Product Support Guide.pdf

DIV350824Rev B iSC250 Installation and Quick Reference Guide.pdf

ismp_user_guide_900004435_r11_000_04__296122409ad_eng.pdf

296115920AF User Guide IWL2xx.pdf

DIV350827 Rev E Telium Download.pdf

ReleaseNotes_TeliumRBA_5.0.1.pdf

ReleaseNotes_TeliumTools_5.0.1.pdf

2.2. Telium RBA Terminal Application

Package contains RBA App release 5.0.6 for the IPP350. These are production signed
software packages which can only be used on production profiled unit (Non-MOCKUP).
Package includes three downloadable formats; LLT, USB (iSCxxx only), and OGZ. Only KP4
packages are provided in this release:

IK-RBA-09.01\Telium RBA Terminal Application (KP4)

Please refer to ReleaseNotes_TeliumRBA_5.0.6.pdf for release notes.

Readme 4/22
2.3. Telium RBA Parameters
Sample forms, images, prompt files, Communication files, contactless parameter file, config.dfs
and supporting script to generate DAT file for IPP350.

Communication Parameters
Contactless Parameters
RBA Data and Parameters
Secure PGZ

2.4. Telium Utilities

Package contains Windows and Telium terminal supporting tools.
Telium Tools release 5.0.1.1
Windows utility for developing forms on supported Telium devices and. Please refer to
Telium Tools users guide for installation detail and users guide. Users guide can also be
found in the application CHM help file. Telium tools installed components includes;
Form Builder 5.01
Data Packaging Tool 5.01
SAT 1.5

Please refer to ReleaseNotes_TeliumTools_5.0.6.pdf for release notes.

Telium LLT (LOCAL DOWNLOAD) release 4.4.6

Download utility for Windows supporting local download of Telium software packages.

Telium USB-CDC Driver 1.1

Package contains a separate USB driver for Telium devices. It includes both the driver
files and an installer. Once installed, Windows will create a virtual RS232 COM port
when Telium device is connected. This driver is required if user intend to use the LLT
download utility or running the device set as USB-CDC.

Telium Jungo Driver 1.5

The Telium USB Jungo driver is intended to be used on cash register and it is not
compatible with Ingenico development software (due to known limitation of driver). In
order to use the development tools one has to use the Telium USB Driver 1.1.

Please refer to Ingenico_Driver_Installer_RN_1.5.pdf for installation and configuration

details.

RBA Test Application V5.0.0.1

Sample Host application to drive the RBA application.

Please refer to the DIV350779 REV S Telium RBA Users Guide.pdf for details.

Readme 5/22
3. Telium Tools Setup Notes

Setup_TeliumTools_5.0.1.1.exe installs Form Builder, Data Packaging Tool, Script Builder, and
SAT (If not presence). .Net Frameworks 3.5 is required. Setup checks this pre-requisite and
prompts for Web installation if not present in the host system. Please refer to DIV350840 Rev
E Telium Tools Install Guide.pdf for detail installation guide. Form Builder, Data Packaging
tool, and Script Builder help files are integrated in the installation and can be access via each
application help menu and icons.
To run these installed utilities:
Start->Program Files->Ingenico->Telium Tools

Readme 6/22
4. RBA Test App Setup Notes

SETUP_RBATestApp_5.0.0.1.exe installs the RBA Test Application.

Run the RBA Test Apps from the

Start->All Programs->Ingenico->RBA Test App

Make sure the device has been setup to communicate with the RBA Test App by configuring
both the terminal and the RBA Test App communication parameters. Please refer to the
DIV350779 REV S Telium RBA Users Guide.pdf for details.

Readme 7/22
5. Loading Terminal Software Package

5.1. Setup Requirements

Download host (PC) must meet the following requirements
Running Windows XP, Windows7 (32 and 64 Bit)
Have a minimum of LLT 4.3, 4.4, or 4.4.6 installed and Sagem device Port
configured to connect to Telium devices via USB port. Refer to LLT Users guide for
initial setup.

Device must meet the following requirements

NAR Profile [0248-014]

Software package can be can be downloaded into appropriate device either via LLT download
tools, RBAs File Write Request at runtime or external USB memory (ISC250and ISC350 Only).

Terminal software packages provided in this kit are intended only for production
profiled unit [0248-014]. This value appears briefly at the start of boot up sequence
if OS and Manager exist on terminal. Software packages are not intended for mock up profile
unit. Loading this software into a mockup unit will render the device unusable which must be
returned to Ingenico for factory reset. Mock up profile unit has an unmistaken flashing of the
warning sign as shown below

RBA terminal software packages are located in Telium UIA Terminal Application directory in the
kit.

IK-RBA-09.01\Telium RBA Terminal Application

Readme 8/22
5.2. LLT download

Download is triggered by LLT command line script. Make sure LLT has been installed and
configured correctly.

LLT_LOAD.BAT detects LLT installation path in the registry and will set the path accordingly.
The screen capture information of Part# and Device may change based on the current package
used.

The following table contains shortcut guide to putting the device in the desired mode.

IPP320/IPP350/IWL2XX ISC250/ISC350/ISC480 IMP35X

Functions Sequence
keypad keypad
Press and hold
down both
keys
Reboot # < - < - < simultaneously
until device
reboots.

Reboot and
hold down
appropriate
key while
LLT Mode F3 - F3 device boots
up. Device
screen will
display LLT

Readme 9/22
 Reboot and
hold down 4
key while
device boots
up. Release
USB Not Supported 4 Not Supported
when device
screen
displays USB
MASS
STORAGE

Readme 10/22
 1. Reboot
device.
2. Hold down
the first
key F1 or
1 while
device is
booting
up.
3. Release as
soon as
the first *
appears on
the screen,
and
Delete all
quickly
applications
press and
except
release the
system files.
rest of the
appropriat
IMPORTANT:
e keys
This
sequentiall
sequence
F1 F4 y.
MUST be
F1 F4 Down Up 1 3 4 6 F2 4. All four
used to load
F3 ****
all PK
must
packages
appears on
cleanly. Step
device
6 is required
screen in
in order to
order to
create the
complete
HOST
this task.
directory.
5. Terminal
screen
displays
LLT.
6. Reboot
the device
one more
time.
7. Screen
displays
LLT
8. Device is
ready for
local
download.

Readme 11/22
 Table 1 Device Function Keys

1. Connect the appropriate device to host PC using the supplied USB cable.

2. Prepare the device by doing a Delete all applications except system files steps as shown
in Table 1 above.

3. Reboot the device.

4. Go to LoadScripts directory within the selected device package and double click the
LLT_LOAD.BAT.

5. Enter COM Port when prompted and press enter. The PART NUMBER, DEVICE, and
SECURITY PROFILE may change as these values are based on the current package.

**********************************************************************************************
**********************************************************************************************

Part Number : PK-RGEN02-0506B3

Device : IPP350
Security Profile : PRODUCTION 0248-014

Package must be used only on IPP350 containing either

factory profile 4112-255 or the PRODUCTION 0248-014 profile.

A reboot is required following a delete all sequence: "1-3-4-6". This action creates the
HOST directory for the subsequent host specific data files download.

PK-RGEN02-0506B3 may require additional software package.

**********************************************************************************************
**********************************************************************************************

LATEST LLT DETECTED IN [ C:\Program Files\TELIUM Tools\LLT 4.4.6\ ]

ENTER COM PORT# or [ENTER] for COM1 :

6. Make sure device is in LLT mode.

Readme 12/22
**********************************************************************************************
**********************************************************************************************

Part Number : PK-RGEN02-0506B3

Device : IPP350
Security Profile : PRODUCTION 0248-014

Package must be used only on IPP350 containing either

factory profile 4112-255 or the PRODUCTION 0248-014 profile.

A reboot is required following a delete all sequence: "1-3-4-6". This action creates the
HOST directory for the subsequent host specific data files download.

PK-RGEN02-0506B3 may require additional software package.

**********************************************************************************************
**********************************************************************************************

LATEST LLT DETECTED IN [ C:\Program Files\TELIUM Tools\LLT 4.4.6\ ]

ENTER COM PORT# or [ENTER] for COM1 :21

MAKE SURE DEVICE IS SET TO "LLT" MODE

PRESS ENTER WHEN "LLT" IS DISPLAYED ON DEVICE SCREEN...

7. Press Enter to continue

**********************************************************************************************
**********************************************************************************************

Part Number : PK-RGEN02-0506B3

Device : IPP350
Security Profile : PRODUCTION 0248-014

Package must be used only on IPP350 containing either

factory profile 4112-255 or the PRODUCTION 0248-014 profile.

A reboot is required following a delete all sequence: "1-3-4-6". This action creates the
HOST directory for the subsequent host specific data files download.

PK-RGEN02-0506B3 may require additional software package.

**********************************************************************************************
**********************************************************************************************

LATEST LLT DETECTED IN [ C:\Program Files\TELIUM Tools\LLT 4.4.6\ ]

ENTER COM PORT# or [ENTER] for COM1 :21

MAKE SURE DEVICE IS SET TO "LLT" MODE

PRESS ENTER WHEN "LLT" IS DISPLAYED ON DEVICE SCREEN...

---------------------------------------------------------------------------------

PK-RGEN02-0506B3 LOADING IN PROGRESS. PLEASE WAIT...

---------------------------------------------------------------------------------

Readme 13/22
8. Info window pops up indicating progress and state of connection.

Readme 14/22
9. A sample of successful screen for ISC350 LLT load. Please note that IPP3XX requires a 2-
steps loading due insufficient SWAP size allocated on some of the terminals. Please follow
the prompt when loading IPP3XX terminal.

**********************************************************************************************
**********************************************************************************************

Part Number : PK-RGEN05-0501B3

Device : ISC350
Security Profile : PRODUCTION 0248-014

Package must be used only on ISC350 containing either

factory profile 4112-255 or the PRODUCTION 0248-014 profile.

A reboot is required following a delete all sequence: "1-3-4-6". This action creates the
HOST directory for the subsequent host specific data files download.

PK-RGEN05-0501B3 may require additional software package.

**********************************************************************************************
**********************************************************************************************

LATEST LLT DETECTED IN [ C:\Program Files\TELIUM Tools\LLT 4.4.6\ ]

ENTER COM PORT# or [ENTER] for COM1 :21

MAKE SURE DEVICE IS SET TO "LLT" MODE

PRESS ENTER WHEN "LLT" IS DISPLAYED ON DEVICE SCREEN...

---------------------------------------------------------------------------------

PK-RGEN02-0506B3LOADING IN PROGRESS. PLEASE WAIT...

---------------------------------------------------------------------------------

##################################################################################

PACKAGE PK-RGEN02-0506B3 SUCCESSFULLY LOADED

##################################################################################

Loading is completed
Press any key to continue . . .

10. This completes the LLT download. Press ENTER.

11. Device reboots to RBA Interface Application splash screen. This completes the download.

12. A download failure screen. Please refer to downloadlog.txt in the root directory for
details.

Readme 15/22
**********************************************************************************************
**********************************************************************************************

Part Number : PK-RGEN05-0501B3

Device : ISC350
Security Profile : PRODUCTION 0248-014

Package must be used only on ISC350 containing either

factory profile 4112-255 or the PRODUCTION 0248-014 profile.

A reboot is required following a delete all sequence: "1-3-4-6". This action creates the
HOST directory for the subsequent host specific data files download.

PK-RGEN05-0501B3 may require additional software package.

**********************************************************************************************
**********************************************************************************************

LATEST LLT DETECTED IN [ C:\Program Files\TELIUM Tools\LLT 4.4.6\ ]

ENTER COM PORT# or [ENTER] for COM1 :21

MAKE SURE DEVICE IS SET TO "LLT" MODE

PRESS ENTER WHEN "LLT" IS DISPLAYED ON DEVICE SCREEN...

---------------------------------------------------------------------------------

PK-RGEN02-0506B3LOADING IN PROGRESS. PLEASE WAIT...

---------------------------------------------------------------------------------

!!!!ErrorCode: -8!DOWNLOAD FAILED - PPP CONNECTION PROBLEM!!!!

-------------------------------------------------------------------------
****** ** ******* * ******** ******
* * * * * * * *
* * * * * * * *
***** ******** * * ***** * *
* * * * * * * *
* * * * * * * *
* * * ******* ******* ******** ******
-------------------------------------------------------------------------
Press any key to continue . . .

Readme 16/22
5.3. USB Load
ISCXXX devices are capable of handling software download via FAT16 or FAT32 formatted USB
flash memory. The USB package format is created by running the COPY_TO_USB.BAT which
can be found in the LoadScripts directory of supported device package. The batch script
generates downloadable software package into USB memory stick.

We highly recommend that the USB flash memory use in loading be kept for such
purpose and contains no other artifacts.

Please refer to Table1 keying guide to putting the device in the USB ready mode.

5.3.1. Creating USB Load Package

1. Double click COPY_TO_USB.BAT. Enter Windows assigned USB drive letter when
prompted.

**********************************************************************************************
**********************************************************************************************

Part Number : PK-RGEN05-0501B3

Device : ISC350
Security Profile : PRODUCTION 0248-014

Package must be used only on ISC350 containing either

factory profile 4112-255 or the PRODUCTION 0248-014 profile.

This script generates telium usb downloadable package on external usb

flash. Telium supports FAT16 or FAT32 formatted usb flash drive
drive. Please make sure USB memory has been properly formatted. we
recommend a separate USB memory flash for download purpose.

PK-RGEN05-0501B3may require additional software package.

**********************************************************************************************
**********************************************************************************************

ENTER WINDOWS ASSIGNED USB FLASH DRIVE LETTER:

Readme 17/22
2. USB load package gets generated automatically if the same package does not exist in the
flash drive. All relevant files will be copied over onto the USB flash and verified for integrity.

**********************************************************************************************
**********************************************************************************************

Part Number : PK-RGEN05-0501B3

Device : ISC350
Security Profile : PRODUCTION 0248-014

Package must be used only on ISC350 containing either

factory profile 4112-255 or the PRODUCTION 0248-014 profile.

This script generates telium usb downloadable package on external usb

flash. Telium supports FAT16 or FAT32 formatted usb flash drive
drive. Please make sure USB memory has been properly formatted. we
recommend a separate USB memory flash for download purpose.

PK-RGEN05-0501B3 may require additional software package.

**********************************************************************************************
**********************************************************************************************

ENTER WINDOWS ASSIGNED USB FLASH DRIVE LETTER: F

GENERATING "PK-RGEN05-0501B3" USB PACKAGE ...

SWAP FILES COPIED OK

HOST FILES COPIED Ok

VERIFY USB SWAP FILES...

VERIFY USB HOST FILES...

USB CONTENT VALIDATED :-)

SAFELY EJECT FLASH DRIVE

Press any key to continue . . .

Readme 18/22
3. Eject USB flash drive.

User will be prompted to exit or overwrite if similar package part# already exists on the
targeted USB flash drive.
PART number echoed on command screen reflects the current package. This may change.

**********************************************************************************************
**********************************************************************************************

Part Number : PK-RGEN05-0501B3

Device : ISC350
Security Profile : PRODUCTION 0248-014

Package must be used only on ISC350 containing either

factory profile 4112-255 or the PRODUCTION 0248-014 profile.

This script generates telium usb downloadable package on external usb

flash. Telium supports FAT16 or FAT32 formatted usb flash drive
drive. Please make sure USB memory has been properly formatted. we
recommend a separate USB memory flash for download purpose.

PK-RGEN05-0501B3may require additional software package.

**********************************************************************************************
**********************************************************************************************

ENTER WINDOWS ASSIGNED USB FLASH DRIVE LETTER: F

PK-RGEN05-0501B3 ALREADY EXIST ON USB DRIVE F

Press ENTER TO OVERWRITE or "Q" to quit :

5.3.2.Loading USB Load Package

4. Insert the USB flash drive into device USB host port.

5. On the device, do a Delete all applications except system files steps as shown in Table 1
above.

6. Reboot the device

7. Reboot and hold down 4 key while device boots up. Release when device screen displays

Readme 19/22
 USB MASS STORAGE

8. Device detects for valid USB formatted package and displays package name. Download
starts immediately if no other package is detected.

PK-RGEN05-0501B3

9. Software activation occurs at the end of the download. OK indicates successful validation
and completes the USB download.

PK-RGEN05-0501B3
Software Activate
OK

10. Device reboots to KIA INJECTION option screen and ready for serial number and key
injection.

11. Following a successful key injection, Telium manager goes through the initialization of the
MANAGER.PAR file and boots to RBA Interface Application splash Screen.

Device requires a reboot after Telium Manager successfully initializes contactless

settings in MANAGER.PAR. This is a one-time process.

5.4. OGZ Load

OGZ package is provided for the purpose of updating the existing unit with the newer RBA
package at runtime via RBA File Write Request command. OGZ content is similar to the PK
packages provided with the exception of MANAGER.PAR file and the KIA Application. OGZ
software packages for specific device can be found in Production Profile OGZ Package
directory within the kit. This download mode may take longer depending on the connection

Readme 20/22
type being used. Below is the steps to load OGZ package via the RBA Test App;

1. HOST Application or RBA Test app must first establish connection with the appropriate
terminal.

2. Send "File Write Request" or click on the "File Write Request button on RBA Test App.
Sets the following parameters: "Load 8 Bits" and select the device specific OGZ file in
Production Profile OGZ Package directory within the kit

3. Execute command or click on execute button on RBA Test App

4. Activation automatically initiated at the end of load.

5.5. Updating Communication file via file download

By default the unit is set to RS-232, 115200, N, 8, 1. User can change the device communication
setting manually (Refer to the developers guide for instruction) or use the sample
communication files provided in Communication Parameters directory.

The TDA.XML is by default configured as RS232. Edit the XML to change your communication
settings and package them into a TGZ format which can be loaded via File Write Request.
Please refer to the Telium Tools Data Packaging Tool application help file on how to package
into TGZ format. The kit includes SERIAL, ETHERNET, USB-CDC and USB-HID TGZ sample files.
Below are the steps to load TGZ communication parameter via the RBA Test App;

1. HOST Application or RBA Test app must first establish connection with the appropriate
terminal.

2. Send "File Write Request" or click on the "File Write Request button on RBA Test App.
Set "Load 8 Bits" and select the specific TGZ communication file from the Communication
Parameters directory. Execute command or click on execute button on RBA Test App

3. Activation automatically initiated at the end of load.

5.6. Enabling Contactless on Supported Device

A MANAGER.PAR enables contactless operation in the supported device. The downloadable
package is located in the Contactless Parameters directory.

To enable the contactless in the device

1. Run the LOAD_CLESS.BAT LLT script and follow prompts.

2. The top left LED on IPP320, ISMP350, and ISC250 (LED icon on ISC350) should blink at
interval if contactless is detected and enabled.

Readme 21/22
NOTE
Device requires a reboot following after Telium Manager initialized contactless settings in
MANAGER.PAR. This is a one-time process.

5.7. Enabling P2PE (Point-to-Point Encryption)

Please refer to DIV350779 REV S Telium RBA Users Guide.pdf for P2PE configuration.

1. To enable this functionality please load the specific signed SECURITY.PGZ located in the
P2PE Configuration directory via the LLT_LOAD.BAT. The following P2PE configurations are
supported;

Telium RBA Parameters\P2PE\Configuration\Mercury

Telium RBA Parameters\P2PE\Configuration\Monetra
Telium RBA Parameters\P2PE\Configuration\Voltage
Telium RBA Parameters\P2PE\Configuration\Transarmor
Telium RBA Parameters\P2PE\Configuration\RSA-OAEP
Telium RBA Parameters\P2PE\Configuration\EPS
Telium RBA Parameters\P2PE\Configuration\S1

Readme 22/22