=========================================== PREH JavaPOS Driver for Windows V1.12.086 =========================================== If you are using notepad you will need to activate "word wrap" to display the text properly 0. System Requirements ====================== Operating systems supported: Windows9x, WindowsNT, Windows 2000, XP / Vista / Windows7 (32bit) We recommend Java runtime environment version 1.4 or above. It is strongly recommended that you exit all Windows programs before running this Setup Program. Furthermore you should have Administrator rights for a proper installation. For a proper installation of the Preh DriverPack on WinNT and Win9x systems with rather old VisualC Runtime components you have to abort installation and update your system first! Search for "vcredist.exe" on the Microsoft web site and install the matching package first. Installation of Java virtual machine required, which must be installed first. The Java virtual machine executable "Javaw.exe" must be in the search path for the PREH JavaPOS demo application icons to be set up properly. The Preh keyboard's modules (MSR, Keylock, POSKeys, etc.) must be programmed with OPOS settings. Configurating the OPOS settings is easily done by using the Preh WinProgrammer, and enabling the option "OPOS settings" when creating a new keyboard layout. 1. Installation =============== Double click on the Installation file, then just follow the installation wizard. The installation of the "Preh DriverPack" is also necessary. The "Preh DriverPack" installation package is included into the Setup file. It will prompt up automatically after the installation of the Preh JavaPOS only if the DriverPack version is newer than a version previously installed. If the version is same or older you should not install the driver pack again - except: see 5. Troubleshooting. If an rather old version of Preh OPOS/JavaPOS was previously installed, some settings might be overwritten by default values during the DriverPack installation. We recommend to uninstall all older Preh OPOS/JavaPOS packages which did not contain any Preh DriverPack before continuing (e.g. Preh OPOS Driver V1.4.46). You need to have administrator rights to replace the Keyboard Driver within Windows NT and Windows2000/XP. 2. Usage/Testing ================ 2.1 Basic Information ===================== The Preh JavaPOS devices can be accessed by the following default 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 To run your own JavaPOS applications you need: * in java class path: PrehJPOS.jar - Preh JavaPOS service classes. * in library path/Windows search path: PrehJPOS.dll - Preh java native interface library. The keyboard interface setting for JavaPOS/Windows is configured in the Windows Registry (see chapter 3). 2.2 Preh JavaPOS Demo Applications ================================== Preh JavaPOS demo programs will also be installed. To start the demo programs, please click "Start - Programs - Preh JavaPOS" and select a demo program(PrehKeylockDemo, PrehMSRDemo, PrehPOSKeyDemo, PrehToneIndicatorDemo). When one of these demo programs start for the first time, you might need to set their properties, so the Preh Device is recognize by the JVM. As an example, for the keylock, please click on "File - Editor..." and select "com.preh.Keylock". Launch the "Bus Properties", tab and click the "Edit" button. From the "Device Bus" drop down menu please select "Unknown" and click the "OK" button. Save all changes and close the JavaEditor at "File - SaveJposRegistry" and "File - Exit". Important note - Changed in Release 1.6.0.64: The Preh JavaPOS demo applications will now evaluate error events. In case of an error event being recorded, the demo applications will display a dialogue box. Please select how you want to procede and press 'OK'. 2.2.1 com.preh.TestKeylock -------------------------- To display the actual keylock position: - "Open" - "DeviceEnable" Click on "getKeyPosition" and the actual keylock position will be displayed. When the postion of the keylock changes, the position on the Demo program will be displayed and updated. 2.2.2 com.preh.TestMSR ----------------------- For displaying MSR data: - "Open" - "Claim" - "DeviceEnable" If "DataEventEnabled" box is enabled, then the MSR Data will be displayed automatically after a card has been swiped. You can also swipe a card without having checked "DataEventEnabled". The data will not be displayed, it will be keep in a buffer until you activate "DataEventEnabled", then the data will be displayed. 2.2.3 com.preh.TestPOSKeyboard ------------------------------- For displaying POSKey data: - "Open" - "Claim" - "DeviceEnable" If you check "DataEventEnabled", POSKey Data will displayed automatically after a keystroke. You can also hit POSKeys without checked "DataEventEnabled". The data will not be displayed, it will be keep in a buffer until you activate "DataEventEnabled", then the data will be displayed For reading TCO data, the device has to be opened and claimed. 2.2.4 com.preh.TestToneIndicator -------------------------------- The standard settings for the ToneIndicator device does not support CapPitch and CapVolume. If you have a Preh Keyboard which has an extended ToneIndicator built-in (e.g. 133UQ) you will need to set up the properties before operation, as shown in the follow instructions: Please click on "File - Editor..." and select "com.preh.Toneindicator". Launch the "Vendor Properties" tab and click the "Edit", then "Add" and fill in the following data: - Property Name: ToneDeviceType - Property Value: 1 - Property Type: Integer Click "OK" button. Save all changes and close the JavaEditor by "File - SaveJposRegistry" and "File - Exit". To use the ToneIndicator: - "Open" - "DeviceEnable" After, the ToneIndicator device is ready to operate. 3. Interface Settings ===================== The Keyboard interface setting is located in the Windows registry. For changing the interface setting, you need to change the registry key. This can be easily done by importing "regkeys". The registry key for the interface is located at: HKEY_LOCAL_MACHINE\SOFTWARE\PREH\Keyboard\INTERFACE 0x00000000 = PS/2 Interface 0xffffffff = USB Interface 3.1 LowLevel Keyhook for PS2 ============================ This feature was added in Driver Pack V1.1.0.0 It is only available for Windows NT4.0(SP3)/Windows 2000/Windows XP. 3.1.1 Manually starting the server ---------------------------------- The Preh Keyboard Server for PS2 can be started manually by running "PrehKeySrv.exe". "PrehKeySrv.exe" is installed in DriverPack subfolder "...Preh\DriverPack\ps2" An active server application is indicated by a Preh icon in the Windows Systray. Tip: Starting the Preh Keyboard Server for PS2 during Windows startup: This can be configured by the usual Windows constructions: * Either placing a shortcut to PrehKeySrv.exe in the Windows' Startup folder -or by- * Using the following "Run" entry (REG_SZ) in the Windows Registry: SOFTWARE\Microsoft\Windows\CurrentVersion\Run "Preh PS2 Keyboard Server" = "C:\Program Files\Preh\DriverPack\ps2\PrehKeySrv.exe" 3.1.2 Automatic start/stop via JavaPOS -------------------------------------- In addition for JavaPOS the PS2 LowLevel Keyhook start/stop can be configured via the Registry: [HKEY_LOCAL_MACHINE\SOFTWARE\PREH\Keyboard\PS2] "LLKeyhook"=dword:00000001 -> LowLevel keyhook is started/ended automatically. or "LLKeyhook"=dword:00000000 -> LowLevel keyhook is not nicht started/ended automatically. Note: Automatic starting/ending of the server application is only available for the package Preh JavaPOS. 4. Uninstall ============ 4.1 Uninstall the Preh JavaPOS driver using Windows Control Panel -> Add/Remove Applications. 4.2 If the "Preh DriverPack" is no longer needed, you can also remove this package by using the same procedure as in 4.1. Attention: If other Preh programs (like Preh OPOS, etc.) still on the computer and they still use them, you must not(!) uninstall the Preh DriverPack! 5. Troubleshoting ================= 5.1 Message: PREH 'keyhook.dll' not found ----------------------------------------- Obviously you have installed/removed an older software package (e.g. Preh OPOS Driver V1.4.46) after installing the driver pack. Several Windows registry settings were removed, which are required for the functionality of the PREH system files "keyhook.dll". => Solution: (Re)Install the latest version of the Preh DriverPack. 6. Installed files ================== During installation the following files will be installed: Preh JavaPOS .\Readme.txt This file. .\Auto_install.txt Description of automated package (un)installation. .\PrehJPOS.jar Preh JavaPOS service objects and demo applications .\PrehJPOS.dll Preh JavaPOS JNI library .\PrehMSRDemo.bat Sample Batch to run the Preh JavaPOS MSR demo application .\Version.bat Batch to identify the version of PrehJPOS.jar and installed Java environment .\jpos.xml Preh JavaPOS Configuration file .\jpos_std.xml cfg file for Preh standard keyboard types .\jpos_133uq.xml cfg file for Preh keyboard type 133UQ/AU If necessary, copy and overwrite the appropriate cfg file to "jpos.xml". .\res\jcl.dtd .\res\jpos.properties .\res\PrehJPOS.ico .\res\Preh_256.ico Standard JAR packages to run Preh JavaPOS .\lib\jcl_editor.jar .\lib\xerces.jar .\lib\jpos1122.jar Utilities to configure the Interface .\util\setusb.reg Configures to USB interface .\util\setps2.reg Configures to PS/2 interface You also can use the appropriate icons in the start menu subfolder "Utility". .\util\LLKeyhook_on.reg Enables automatic start/stop of LowLevel keyhook (PS/2 only) .\util\LLKeyhook_off.reg Disables automatic start/stop of LowLevel keyhook (PS/2 only) Wise Uninstall files - do NOT delete or modify. .\INSTALL.LOG .\UNWISE.EXE Additionally, The included Driver Pack (or newer version) must be installed. It includes all necessary components for communicating with our keyboards: * Keyhook interface for PS/2 and RS232 * Keyhook interface for USB * Preh PS/2 keyboard driver - necessary for NT/2000/XP etc.: - if the Preh keyboard is connected via PS/2 - if you want to send data/commands towards a Preh PS/2 keyboard Included in this installation package is Preh DriverPack V1.4.0.0 7. Unattended installation ========================== For detailled informations please refer to the file "Auto_install.txt". 8. Version History: =================== 1.12.0.86 Release 2009 Sep. 23 * Improved keylock handling for "no hardware present" Preh JavaPOS JAR archive updated: .\PrehJPOS.jar 1.12.086 (20090821.63) * Readme.txt updated and information added. 1.12.0.85 Release 2009 July 30 * Services are now JavaPOS 1.12 compliant, including various bugfixes. Preh JavaPOS JAR archive updated: .\PrehJPOS.jar 1.12.085 (20090729.56) Preh JavaPOS JNI library updated: .\PrehJPOS.dll 1.12.0.79 (20090430) * DriverPack 1.4.0.0 * Readme.txt updated and information added. 1.6.0.70 Release: 2005 March 03 * JavaPOS now supports the LowLevel Keyhook for PS2: Preh JavaPOS JAR archive updated: .\PrehJPOS.jar 1.6.070 (20050216.7) Preh JavaPOS JNI library updated: .\PrehJPOS.dll 1.12.0.79 (Build 30041005) * DriverPack 1.1.0.1 * Readme.txt updated and information added. 1.6.0.65 Release: 2003 October 30 * Readme.txt updated and information added. * Preh JavaPOS Driver Package updated: .\PrehJPOS.jar V1.6.065 * Preh JavaPOS JNI library updated: .\PrehJPOS.dll V1.4.0.65 1.6.0.64 Release: 2003 September 17 * Readme.txt updated and information added. * Preh JavaPOS demo applications now evaluate error events. * MSR parsing routines and sample application improved. * Preh JavaPOS Driver Package updated: .\PrehJPOS.jar 1.6.064 * Preh JavaPOS JNI library updated: .\PrehJPOS.dll V1.4.0.64 1.6.0.62_1 Release: 2003 Aug 12 * Readme.txt updated and information added. * Installation script improvements * Version.bat (displays the Preh JavaPOS version information) * Now includes Preh DriverPack V1.0.0.1 * Preh JavaPOS JNI library updated: .\PrehJPOS.dll V1.4.0.60 1.6.0.62 Release: 2003 June 27 ====================================================================== Annex ====================================================================== Copyright © Copyright PrehKeyTec GmbH 2009 Published by PrehKeyTec GmbH. PrehKeyTec GmbH reserves the right to update or change the products described in this document as well as the document itself, without prior notice. This document may not be reproduced, processed or translated into electronic form or other languages without the prior written permission of PrehKeyTec GmbH. Trademarks Brands and product names mentioned in this document are trademarks or registered trademarks of their owner. e.g: Windows: Trademark of Microsoft Corporation Help and Support Any questions or suggestions to improve our products are welcome. Please contact our technical support team: support@prehkeytec.de PrehKeyTec GmbH Scheinbergweg 10 97638 Mellrichstadt Germany Email: support@prehkeytec.de Web: www.prehkeytec.com