PREH POS Keyboards
Preh JavaPOS Keyboard Driver for Linux (i386)
Installation Notes - Release 1.6.0.66
Version January 15 2004
Overview
This package contains all files needed to install the Preh JavaPOS
driver for Linux. The Preh JavaPOS driver enables easy access the
Preh keyboards and its integrated modules via Java applications.
The software has been released under the term of the Preh LICENCE,
which has been included in this package.
Note on Preh PS/2 keyboards:
To use a Preh keyboard being connected via PS/2 interface
the Preh PS/2 Keyboard driver has to be installed first. To install
and use this loadable PS/2 keyboard driver module a modification in the
Linux kernel source and a recompile of the Linux kernel is necessary.
Details you can find in README_PS2.html
Note on Preh USB keyboards:
If your Preh keyboard is connected via USB to your computer there
is usually no need to install a special keyboard driver and also no
need to modify the Linux kernel. Details you can find
in README_USB.html
Features
The Preh JavaPOS driver has been developed to provide simple access to the Preh keyboards and their internal modules (like MSR, Keylock, PosKeys) and supports
the following devices:
- POSKeyboard
- Keylock
- MSR
- ToneIndicator
Supported Keyboard Interfaces:
- Standard Keyboard Interface (PS/2).
- USB.
System requirements
- Preh Keyboard connected via PS2 keyboard interface or via USB.
- Linux Kernel 2.4.18 or above
- Java2 Runtime Environment (Version 1.3.x or above required).
- For specific information on USB and PS2 please refer to the
appropriate Readme:
README_PS2.html
README_USB.html
- The keyboard's modules MSR, Keylock, etc. must be correctly programmed
with the Preh OPOS headers and terminators. For doing this please use
the Preh WinProgrammer and select "OPOS Headers". Then download this
keytable file into your keyboard.
Version History
- 01/15/2004 PrehJavaPOS.1.6.66.tar.gz - Improved DemoApps, new PS/2 driver, new USB JNI
- 10/31/2003 PrehJavaPOS.1.6.65.tar.gz - MSR and TCO improved (new PS/2 linux driver 0.1.5
- 09/24/2003 PrehJavaPOS.1.6.64.tar.gz
- 06/10/2003 PrehJavaPOS.1.6.62.tar.gz - first internal release.
Package Contents
This package contains the following files
- ./PrehJavaPOS.1.6.xx/ - Directory containing all the following:
- README.html (this file) - Instructions on driver installation and usage.
- PrehJPOS.jar - JAR package of Preh JavaPOS classes.
- jpos.xml - JavaPOS registry file.
- LICENCE - Software license for the Preh JavaPOS driver.
- PrehPOSKeyboardDemo.sh - script to start POSKeyboard demo application.
- PrehKeylockDemo.sh - script to start Keylock demo application.
- PrehMSR.sh - script to start MSR demo application.
- PrehToneIndicator - script to start ToneIndicator
demo application.
- setto_ps2.sh - Script to change Preh JavaPOS default interface.
- setto_usb.sh - Script to change Preh JavaPOS default interface.
- Subdir .../lib - Directory containing necessary JAR packages.
- .../lib/jcl_editor.jar - JavaPOS registry editor package.
- .../lib/jpos16.jar - JavaPOS common control object package.
- .../lib/xerces.jar - Package to access JavaPOS registry.
- Subdir .../ps2 - Directory containing JNI library to
support PS/2 keyboard interface.
- .../ps2/libPrehJPOS.so.0.1.1.ps2 - JNI library to access the Preh keyboards
via PS/2 interface.
- Subdir .../usb - Directory containing JNI library
to support USB interface.
- .../usb/libPrehJPOS.so.0.2.usb - JNI library to access the Preh keyboards
via USB interface.
- Subdir .../res - Directory containing files for JavaPOS
registry manipulation.
- .../res/jcl.dtd - DTD file for XML syntax of JavaPOS registry
files (e.g. jpos.xml).
- Subdir .../setup - Directory containing setup tools and
Readme files for USB and PS/2
- .../setup/README_PS2.html - Instructions on PS/2 driver installation
and usage.
- .../setup/README_USB.html - Instructions on USB driver installation
and usage.
- .../setup/setup - Script for automatic PS2 and USB driver installation.
- .../setup/diag - Script for system diagnostic.
- .../setup/jpos_std.xml - JavaPOS registry file for Preh standard keyboard.
- .../setup/jpos_133uq.xml - JavaPOS registry file for 133UQ keyboard.
- .../setup/diag - Script for system diagnostic.
- .../setup/ps2/prehdrv.0.1.6.tar.gz - Preh PS2 Keyboard driver package.
- .../setup/ps2/sh_install - script for Preh PS2 keyboard invoked by setup.
- .../setup/usb/sh_install - script for USB environment invoked
by setup.
Installation Procedure
To install the Preh JavaPOS driver under Linux, please follow this procedure precisely.
A. Extract the Preh JavaPOS driver package
- Unpack the driver to the directory of your choice
(e.g. /home/user1):
cd /home/user1
tar -xzvf PrehJavaPOS.1.6.0.xx.tar.gz
- Change to the driver's directory:
cd PrehJavaPOS.1.6.0.xx
B. Install the Preh PS2 Keyboard driver
The Preh PS2 Keyboard driver expands the standard Linux to access the Preh keyboards via standard keyboard interface (PS/2). You will find this driver package in the subdirectory 'setup/ps2' of the Preh JavaPOS package. You can find all details about installation in README_PS2.html.
Then continue with step D.
C. Set up the USB environment for Preh USB keyboard usage under Linux
If your Preh USB Keyboard is connected via USB to your computer, basically no special driver is needed, nor the kernel has to be modified. Here you can find all details
in README_USB.html. Continue with step D.
D. Run the setup script
Basically if all the necessary steps of the Readme were executed:
cd PrehJavaPOS.1.6.0.xx/setup
run the setup script
./setup
Follow the setup script instructions.
Testing
To be able to run the Demo applications, you must have installed a
proper Java2 runtime environment. Furthermore the executable java
must be in the search path. To check if the Java2 environment was set
up correctly, execute the following command - the J2RE should then report
it's version:
java -version
Note: The path to the JRE executable java is is usually
added in one of the following configuration files:
- /etc/profiles for all users
- ~/.profile for the individual user.
To display the version of the Preh JavaPOS package:
After installation all devices can be tested by running the
Preh JavaPOS demo applications. This is done by starting the
script files in the PrehJavaPOS directory:
- Preh POSKeyboard demo: ./PrehPOSKeyboardDemo.sh
- Preh Keylock demo: ./PrehKeylockDemo.sh
- Preh MSR demo: ./PrehMSRDemo.sh
- Preh ToneIndicator demo: ./PrehToneIndicatorDemo.sh
Usage
The Preh JavaPOS devices can be accessed by the following device names:
- com.preh.POSKeyboard - Preh POSKeyboard device
- com.preh.Keylock - Preh Keylock device
- com.preh.MSR - Preh MSR device
- com.preh.ToneIndicator - Preh ToneIndicator device
Important Note - JNI and default interface:
We have two different Preh java native interface library versions: One for PS/2 and one for USB. The appropriate files are located in the PrehJavaPOS subdirectories:
- ps2/libPrehJPOS.so
- usb/libPrehJPOS.so.
The default interface used by the Preh JavaPOS demo applications is
also resolved by a symbolic link, which is always located in the
PrehJavaPOS base directory:
Use the scripts to configure the default interface for the Preh
JavaPOS Demo applications to modify this symbolic link:
- ./setto_ps2.sh - Preh JavaPOS default interface PS/2.
- ./setto_usb.sh - Preh JavaPOS default interface USB.
To run your own JavaPOS applications you need:
- in java class path:
- PrehJPOS.jar - Preh JavaPOS service classes.
- in library path:
- libPrehJPOS.so - Preh java native interface library.
If you should have any problems on installing and using these drivers
we of course will like to help you. Also if you have any comments or
suggestions to improve our drivers and installation scripts please email to:
tech-support@preh.de.
Further informations and latest drivers you can find in the internet at
www.preh.com