Setting up the Ingenico iPP3x0 for Serial or VCOM/USB

Table of Contents

1. Overview
2. Comm Type
3. Port
4. Baud Rate
5. Model Name
6. Serial Number
7. VCOM/USB Drivers
8. Configuring the ChipDNA config file
• Example Config
9. Common Errors
10. How To Access Maintenance Mode

Overview

The following article is to assist in setting up the Ingenico iPP3x0 with ChipDNA, and how to fill in the various ChipDNA Server settings when connecting via serial or VCOM/USB.

Comm Type

The iPP3x0 can be set-up to connect via a number of connection methods, notably RS-232 (serial), and VCOM/USB. For a successful connection, the iPP3x0 will have to be set to the correct connection method, and can be carried out in the following manner:

RAM:

1. Enter Maintenance Mode
2. Select RA1
3. Enter device password
4. Select the correct comm. method (RS-232 or VCOM/USB).

RBA:

1. Enter Maintenance Mode
2. Select TDA
3. Select Configuration
4. Select Communication
5. Select the correct comm. method (RS-232 or USB<>Serial Conv).

After you have setup the device for the correct comm. method, you will then need to modify the ChipDNA Server config Protocol section to the following:
<Protocol>serial<Protocol>

Port

To initiate a connection to the device via Serial, VCOM, or USB, you will need to specify what port the host machine has assigned to the device.

Serial:

VCOM/USB:

After you have confirmed what port the device has been assigned, you will need to modify the ChipDNA Server config Port section. In the example below, we're basing the COM11 port off of the VCOM/USB connection above:
<Port>COM11</Port>

Baud Rate

This is only relevant to serial connections, and not VCOM/USB. The baud rate of the device should be set to the highest recommended by the device distributor or manufacturer. Once confirmed, you can set the baud rate on the device in the following manner:

RAM:

1. Enter Maintenance Mode
2. Select RA1
3. Enter device password
4. Select the correct comm. speed.

RBA:

1. Enter Maintenance Mode
2. Select TDA
3. Select Configuration
4. Select Communication
5. Select Serial Settings
6. Select Baud Rate
7. Select the correct comm. speed.

Once the device comm. speed has been set on the device, you will need to modify the ChipDNA Server config Baud section to match. As an example, if the device is set to 115200, you would set the ChipDNA Config to the following:
<Baudrate>115200</Baudrate>

Model Name

NMI support two variants of the Ingenico iPP3x0 for each version:

iPP320:

• Ingenico-iPP320-RAM for European markets.
• Ingenico-iPP320-RBA for American markets.

iPP350:

• Ingenico-iPP350-RAM for European markets.
• Ingenico-iPP350-RBA for American markets.

If you are unsure which model of the iPP3x0 you have, it is always best to check with your device distributor, who will be able to confirm the exact model you have received.

Once you have confirmed the iPP3x0 model you are using, you will need to modify the ChipDNA Server config Model section to one of the following:
iPP320:
<Model>Ingenico-iPP320-RAM</Model>
<Model>Ingenico-iPP320-RBA</Model>

iPP350:
<Model>Ingenico-iPP350-RAM</Model>
<Model>Ingenico-iPP350-RBA</Model>

Serial Number

Checking the serial number differs for each iPP3x0 model, and will need to be obtained and set within the ChipDNA Server config before the device is able to connect. You can find the serial number in the following locations on the specified models:

The RAM variant of the iPP3x0 serial number can be seen on the idle information screen when the device first starts up:

In this instance, the Id section of the ChipDNA Server config file would read the following:
<Id>00800755567</Id>

The RBA variant serial number can be found on the rear of the device on a separate sticker:

In this instance, the Id section of the ChipDNA Server config file would read the following:
<Id>2213241PT011034</Id>

If the RBA device has not been injected with keys, the device serial number can be found on the rear of the device on the Ingenico certified sticker:

In this instance, the Id section of the ChipDNA Server config file would read the following:
<Id>80252787</Id>

VCOM/USB Drivers

If you are connecting the iPP3x0 via VCOM/USB on Windows, you will need to install the Ingenico USB device drivers. NMI cannot provide these drivers, and we would always recommend getting in contact with your device distributor or the device manufacturer to ensure you have the most recent and correct drivers for your device.

VCOM/USB support on Linux is heavily dependant on your chosen Linux distro's driver support, as Ingenico do not supply a Linux driver. It is typically recommended to use an RS-232 (serial) or Ethernet connection when using an iPP3x0 with Linux.

Configuring the ChipDNA config file

Please take note of the following changes within the ChipDNA config file:

• Add your Application Identifier.
• Add your Terminal ID and Transaction Key.
• Model tag needs to be updated to correctly reflect the Ingenico iPP3x0 model in-use:
  • Ingenico-iPP320-RBA
  • Ingenico-iPP320-RAM
  • Ingenico-iPP350-RBA
  • Ingenico-iPP350-RAM
• Add the ID of the Ingenico iPP3x0 (serial number) as documented in the Integration Guide.
  • More information on how to locate the serial number can be found in this article.
• Protocol tag needs to be set to serial.
• Port tag needs to be set to the value that matches the COM port assignment.
• Baudrate tag needs to be set to the highest recommended value by the device manufacturer.
• Parity tag should be left as default unless otherwise instructed by NMI support.
• Stopbits tag should be left as default unless otherwise instructed by NMI support.
• Databits tag should be left as default unless otherwise instructed by NMI support.
• If you are changing the config file over from Ethernet to Serial or VCOM/USB, the following tags are not needed: Address.
• Save the file.

Example config:

<?xml version="1.0" encoding="utf-8"?>
<ChipDnaServer version="1.0.0">
    <MachineName>localhost</MachineName>
    <ApplicationIdentifier>CHIPDNA</ApplicationIdentifier>
    <Socket>127.0.0.1:1869</Socket>
    <Terminals>
        <Terminal>
        <TerminalId>TERMINAL_ID</TerminalId>
        <TransactionKey>TRANSACTION_KEY</TransactionKey>
        <PaymentDevices>
            <PaymentDevice>
                <Model>Ingenico-iPP3x0-Model</Model>
                <Id>012345678</Id>
                <Protocol>serial</Protocol>
                <Port>COM11</Port>
                <Baudrate>115200</Baudrate>
                <Parity>none</Parity>
                <Stopbits>1</Stopbits>
                <Databits>8</Databits>
                <StandbyMessage>ChipDNA</StandbyMessage>
            </PaymentDevice>
        </Terminal>
    </Terminals>
    <Tms>
        <Servers>
            <Server>
                <Url>https://tms.cardeasexml.com</Url>
                <Timeout>45000</Timeout>
            </Server>
        </Servers>
    </Tms>
</ChipDnaServer>

Common Errors

The following connection-related errors are normally an indicator that either the Ingenico iPP3x0 or the ChipDNA Server config file has not been setup correctly. If you see these errors within the ChipDNA Server console window or log files, please review your ChipDNA Server config and device settings, and if the issues persist, please get in contact with our support team.

Date Time INFO ChipDNA [Ingenico-iPP3x0-Model, SerialNumber] [Disconnected] HeartBeatLoop Connection
Date Time INFO ChipDNA [Ingenico-iPP3x0-Model, SerialNumber] [#ggb, #yk] Connecting
Date Time WARN ChipDNA [Ingenico-iPP3x0-Model, SerialNumber] Connection Error: Error Code: UNABLE_TO_OPEN_CONNECTION

Date Time INFO ChipDNA [Ingenico-iPP3x0-Model, SerialNumber] [DeviceIngenico, #yk] Connecting
Date Time INFO ChipDNA [Ingenico-iPP3x0-Model, SerialNumber] [DeviceIngenico, #Fab] Sending command
Date Time INFO ChipDNA [Ingenico-iPP3x0-Model, SerialNumber] [DeviceIngenico, #C9] Link setup required
Date Time WARN ChipDNA [Ingenico-iPP3x0-Model, SerialNumber] [DeviceIngenico, #C9] Link setup NO ACK
Date Time WARN ChipDNA [Ingenico-iPP3x0-Model, SerialNumber] [DeviceIngenico, #C9] Link setup NO ACK
Date Time WARN ChipDNA [Ingenico-iPP3x0-Model, SerialNumber] [DeviceIngenico, #C9] Link setup NO ACK
Date Time WARN ChipDNA [Ingenico-iPP3x0-Model, SerialNumber] [DeviceIngenico, #C9] Link setup timeout

Date Time INFO  ChipDNA #lc.#kc: PaymentDeviceAvailabilityChangeEvent -> Parameters:
[ Key: PAYMENT_DEVICE_MODEL, Value: Ingenico-iPP3x0-Model],
[ Key: PAYMENT_DEVICE_IDENTIFIER, Value: WrongSerialNumber ],
[ Key: IS_AVAILABLE, Value: False ],
[ Key: AVAILABILITY_ERROR, Value: DeviceIdMismatch ]