Configuring the Keyboard

Configuration files
  • ..\parameter\client\hal.properties
  • ..\parameter\client\jpos.xml

To configure a keyboard, proceed as follows:

  1. Enable the keyboard in the configuration file hal.properties: 
    DeviceEntryTypes.WN_kb_ta85_113.id=WN_kb_ta85_113
DeviceEntryTypes.WN_kb_ta85_113.descriptionKey=Keyboard
DeviceEntryTypes.WN_kb_ta85_113.description=Keyboard
DeviceEntryTypes.WN_kb_ta85_113.deviceCategory=KEYBOARD
DeviceEntryTypes.WN_kb_ta85_113.enabled=true
DeviceEntryTypes.WN_kb_ta85_113.active=true
 DeviceEntryTypes.WN_kb_ta85_113.className=com.gk_software.pos.hal.device.keyboard.JPosKeyboard
  2. Set the keyboard as the default keyboard.
    DeviceMappingEntryTypes.DefaultKeyboard.id=DefaultKeyboard
 DeviceMappingEntryTypes.DefaultKeyboard.deviceCategory=KEYBOARD
 DeviceMappingEntryTypes.DefaultKeyboard.mappedTo=WN_kb_ta85_113
Note:
A corresponding entry must exist for the keyboard in the file jpos.xml. The logicalName corresponds to the id of the entry resulting from the file hal.properties.

For POS keyboards, the assignment between key codes submitted by the keyboard and corresponding GK/Retail codes must be configured as well.

<JposEntry logicalName="WN.KeyTranslation.TableTA85"> <creation factoryClass="&lt;none&gt;" serviceClass="&lt;none&gt;"/> <vendor name="WincorNixdorf" url="http://www.wincor-nixdorf.com"/> <jpos category="POSKeyboard" version="1.7"/> <product description="Reference Entry for regular entries" name="ReferenceEntry" url="&lt;none&gt;"/> <!--Other non JavaPOS required property (mostly vendor properties and bus specific properties i.e. RS232 )-->
<prop name="referenceEntryDescription" type="String" value="key table definition for TA85 (POSKeyboard)"/>
<prop name="referenceEntryDevCat" type="String" value="POSKeyboard"/>
<!-- ##### row 1 ##### -->
<prop name="1" type="String" value="0x30000b=0x0000041"/>
<prop name="2" type="String" value="0x310002=0x0000042"/>
<prop name="3" type="String" value="0x320003=0x0000043"/>
<prop name="4" type="String" value="0x330004=0x0000044"/>
<prop name="5" type="String" value="0x340005=0x0000045"/>
<prop name="6" type="String" value="0x350006=0x0000046"/>
<prop name="7" type="String" value="0x360007=0x0000047"/>
<prop name="8" type="String" value="0x370008=0x0000048"/>
<prop name="9" type="String" value="0x380009=0x0000049"/>
<prop name="10" type="String" value="0x540014=0x000004A"/>
<prop name="11" type="String" value="0x7a0057=0x000004B"/>
<prop name="12" type="String" value="0x7b0058=0x000004C"/>
...
</JposEntry>