Peripheral Devices

Prerequisites:
To manually modify configuration files, you need to log in to the operating system with a user account that has permission to edit files in the POS Client installation directory.

This chapter describes how to set up the connected peripheral devices.

Information on the following topics will be provided:

  • Configuring the Printer
  • Configuring the EFT Terminal
  • Configuring JavaPOS
  • Configuring the POS type
  • Configuring the keyboard
  • Configuring the Customer Display
  • Configuring the MICR
  • Configuring the MSR
  • Configuring the scanner
  • Configuring the drawer
  • Configuring the scale
  • Configuring the Adyen Terminal
  • Configuring the RFID
  • Configuring the Cash Recycler

General Information on Hardware Configuration

Note:
A device can only be used if a corresponding entry exists in the file jpos.xml .

The devices are enabled in the file hal.properties :

To enable a device, proceed as follows:

  1. Disable the unwanted device (enabled=false).
  2. Enable the desired device (enabled=true).
  3. Set the enabled device as the default device, if necessary (mappedTo=[id] ).

Initialization Order

The following described configurations must be applied to the file hal.properties .

To configure an explicit initialization order for the device categories the following list property must be used:

HalConfig.deviceInitializationConfig.initializationOrder

The configured device categories will be initialized first in the given order and afterwards the remaining categories in the order of the internal definition.

The default order is:

LINE_DISPLAY, CASH_DRAWER, MIC_CHEQUE_READER, SCANNER, MSR, PRINTER, FISCAL_PRINTER, TERMINAL, SCALE, KEYBOARD, GRAPHICAL_PRINTER, LIGHTS, CASH_RECYCLER, RFID_SCANNER, WEBCAM

The following example configuration defines that WEBCAM, PRINTER and CASH_DRAWER should be initialized as first categories:

HalConfig.deviceInitializationConfig.initializationOrder.0=WEBCAM 
HalConfig.deviceInitializationConfig.initializationOrder.1=PRINTER 
HalConfig.deviceInitializationConfig.initializationOrder.2=CASH_DRAWER

The resulting initialization order is as follows:

WEBCAM, PRINTER, CASH_DRAWER, LINE_DISPLAY, MIC_CHEQUE_READER, SCANNER, MSR, FISCAL_PRINTER, TERMINAL, SCALE, KEYBOARD, GRAPHICAL_PRINTER, LIGHTS, CASH_RECYCLER, RFID_SCANNER

Lazy Hardware Init

The lazy hardware init feature can be enabled for a particular device or for a whole device category.

The following described configurations must be applied to the file hal.properties .

Configuration for a Single Device

To activate/deactivate a single device for lazy init, set the following property for the specific device:

DeviceEntryTypes.PrinterXYZ.lazyInit=true | false

Configuration for Device Categories

To activate lazy init for whole device categories, the following property must be set:

HalConfig.deviceInitializationConfig.lazyInitialization.<idx>=<CATEGORY>

Example configuration that is used to set all Printers and all CashDrawers to lazy init:

HalConfig.deviceInitializationConfig.lazyInitialization.0=CASH_DRAWER

HalConfig.deviceInitializationConfig.lazyInitialization.1=PRINTER

The configuration for categories and single devices can be combined. E.g. the lazy init can be activated for a whole category and deactivated for a specific device.