# Key Loader Installation

### Pre-installation

Topics covered:

* Defining the type of Key Loader
* Modifying the Key Loader configuration files
* Preparing the Key Loading Software
* Signing the Key Loader bundle

#### Type of Key Loader

The Key Loader supports multiple key loading configurations. Define the desired type in the pkg.config\appconfig.ini file.

#### Modifying Key Loader Configuration Files

Supported commands and configuration are available and can be modified in **pkg.config\appconfig.ini**.

#### Preparing Key Loading Software

Download and install the Key Loading Software you will use.

#### Signing Key Loader Bundle

After modifying configuration files, sign the bundle.

### Installation

Before you start, ensure to clear the terminal of old bundles to remove any previously installed Key Loader applications.

Refer to the Release Notes for the minimum required OS / ADK bundle for the Key Loader application.

> NOTE: For e280 device, ADK MAC version is required to install, in order to display the virtual keyboard.

The following topics are covered in this section:

* Installing the Key Loader application to the device
* Configuring the communication setting of the Key Loading Software
* Installing Keys
* Completing the installation

#### Installing Key Loader Application

Follow these steps for direct installation.

{% stepper %}
{% step %}

### Establish connection

Establish a connection between your workstation and the terminal.
{% endstep %}

{% step %}

### Download installer

Download the Key Loader application to the terminal. The installer filename is *KeyLoader.tgz*.
{% endstep %}

{% step %}

### Launch

The Key Loader application automatically launches after installation.

On the application's screen, two options are displayed:

* Start — initiates the key loading process.
* Comms Settings — displays the communication settings (default COM1 / 9600). Adjust when necessary.
  {% endstep %}

{% step %}

### Begin key loading

To initiate key loading, select Start.
{% endstep %}
{% endstepper %}

> NOTE: In some terminals, you have to press **1** for Start, **2** for Comms Settings.

If the status message “READY” is displayed, the terminal is waiting for commands.

#### Configuring Communication Setting

Serial communication is the recommended medium.

Recommended settings:

* Baud rate: 9600
* Data: 8 bits
* Parity: None
* Stop bit: 1

Messages must follow standard protocol framing with and require messages to be ACK’d or NAK’d accordingly.

#### Installing Keys

Install keys using your Key Loading Software. Ensure the Key Loader application is in a ready state to accept key injection.

#### Completing Installation

On the terminal, press the Cancel/Annul or the red “X” key to terminate the Key Loader application.

If the message “FINISHED” is displayed, the installation is done.

### Post Installation

Topics covered:

* Installing the CXPI application
* Installing the Key Map

#### Installing CXPI Application

Before you start, set these variables in CAMCORE.INI:

* MACMODE=1
* PINSEC=INTERAC

The CXPI application must be installed after keys are injected.

To install CXPI, download the XPI bundle and the CFG bundle to the terminal.

> NOTE:
>
> * Installing the CXPI application automatically removes the Key Loader application from the device (to avoid interference).
> * The client may opt to remove the Key Loader application manually before installing CXPI.

![](/files/6c1dfb8386110ec474a43fab5226ec2ba5dadf12)

#### Installing Key Map

The key map specific to the Key Loader used must be installed after installing the CXPI application. The CXPI bundle removes files including keymap files and the VSO during installation.

Installing the Key Map preserves the keymap and the VSO script used by the keyloader after installing CXPI. If the keymap is not installed, Interac Debit commands (S66, S67, etc.) will not work.

Key map files are in a separate bundle released with the Key Loader application.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.verifone.com/xpi/tbd-documentation/keyloader/new_xpi_generic_keyloader_userguide_vers1.0e/key-loader-installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.