============================================ PrehKeyTec OPOS Driver 1.10.007.18343 ============================================ When using notepad you should activate "word wrap" for correct view of this file. 0. System Requirements ====================== Operating systems supported: WindowsNT, Windows 2000 / XP / Vista / 7 or newer (for PS/2 only 32bit OS) The OPOS Common Control Objects (CCOs) must also be installed in addition. Please Note: For the PrehKeyTec OPOS driver demo applications it's recommended to have installed the CCOs version 1.10 or higher. PrehKeyTec keyboard or module configured to "OPOS settings" - see chapter 2. 1. Installation =============== Just follow the installation wizard. The installation of the "PrehKeyTec Driver Pack" is recommended. This package is included and will be started automatically at the end of PrehKeyTec OPOS Driver setup procedure, if the included DriverPack version is newer than the installed one. If the version is same or older you should not install the driver pack again - except: see 6. Troubleshooting. If one of the older PrehKeyTec packages OPOS/JavaPOS previously was 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 DriverPack before continuing (e.g. Preh OPOS Driver V1.4.46). You need to have administrator rights to replace the PS2 keyboard driver within WindowsNT, 2000 and higher. 2. Configuring the Keyboard using the WinProgrammer =================================================== To use OPOS driver you need do configure keyboard's modules to OPOS settings, if not already done. The PrehKeyTec keyboard's modules (MSR, Keylock, POSKeys, etc.) must be programmed using the Opos headers. This is done in the PrehKeyTec WinProgrammer by enabling the option "OPOS settings" when creating a new keyboard layout. The PosKeys are programmed using the Macros {POSKey001} ... {POSKey128} - usually on StdKey-Layer with Autorepeat OFF. Finally this keytable configuration must be downloaded into the keyboard. Notes: For common PrehKeyTec keyboard types you can find some ready-to use sample keytables in the PrehKeyTec WinProgrammer: Please use the appropriate configuration from WinProgrammer's subdirectory .\Keytables\OposJavaPOS. 3. Usage / OPOS Demo Applications ================================= For each supported OPOS device you can find a sample program to demonstrate the capabilities. Please start the sample application using the appropriate start menu icon. Then just use the usual steps (Open / Claim etc.). The default Device Names for PrehKeyTec keyboard's modules are: * "PREH POSKeyboard" * "PREH MSR" * "Preh Keylock" * "PREH Tone Indicator" * "PREH HSMSR" for RS232 msr module * "PREH Line Display" for old LCD module of MWX and MC/WX keyboards * "PREH Scanner" for scanner module of MWX and MC/WX keyboards The Names of OPOS Devices are set in Windows Registry: HKEY_LOCAL_MACHINE\SOFTWARE\OLEforRetail\ServiceOPOS\ Please Note: Behaviour of demo applications for MSR and PosKeyboard was changed in version 1.10: Activated option "Automatic Enable" causes the demo app to always re-enable DataEventEnabled after DataEvent. The MSR demo application behaviour was changed in version 1.4.0.50: Now the application does not automatically execute "GetTrackData" in case of an error event being recorded. To retrieve the data of the "healthy tracks" in case of an error event, click onto the track fields in the dialogue. 4. Special System Configuration =============================== 4.1 Interface Settings ====================== The Keyboard interface setting is located in the Windows registry. For changing the interface you have 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 For special older keyboards with RS232 interface also: 0x00000001 = RS232 Schnittstelle COM 1 0x00000002 = RS232 Schnittstelle COM 2 0x00000003 = RS232 Schnittstelle COM 3 0x00000004 = RS232 Schnittstelle COM 4 4.2 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. The automatic starting/closing of the server application using Registry Key "LLKeyhook" is only supported by package PrehKeyTec JavaPOS. The Preh Keyboard Server for PS2 can also 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: Automatically start the Preh Keyboard Server for PS2 during Windows startup: * 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" In the Preh OPOS installer V1.4.0.52 a dialogue "LowLevel Keyhook" was added. If selected, such Run key is automatically added to the registry. Note: When using unattended installation such registry key is not automatically generated. 4.3 POSKeyboard Translation =========================== The DataEvents result codes can be translated into user defined codes. This is a requirement of the OPOS standard (please see OPOS documentation). The appropriate registry keys are located here: [HKEY_LOCAL_MACHINE\SOFTWARE\OLEforRetail\ServiceOPOS\POSKeyboard\PREH POSKeyboard] "POSKey001"=dword:00000001 ... "POSKey128"=dword:00000080 In previous packages this keys could be added manuall or using some Registry files: .\util\PosKey_128.reg .\util\PosKey_default.reg In the Preh OPOS installer V1.4.0.56 a dialogue was added to configure the POSKeyboard: The first option activates a translation table for the Preh POSKeyboard which results in continuous codes matching the programmed keyboard macros {POSKey001} .. {POSKey128}. The second option does not modify the translation table. Basically you will get hardware specific non-continuous codes. For unattended installation this is configurable using the option "KB_TRANSLATE". For details please refer to "Auto_install.txt". 5. Uninstall ============ 5.1 Uninstall the PrehKeyTec OPOS driver using Windows Control Panel -> Add/Remove Applications. 5.2 If no more needed, you also can remove the package "PrehKeyTec Driver Pack" the same way. Attention: If other packages are installed on this computer which still use this drivers (like PrehKeyTec JavaPOS, etc.) you must not(!) uninstall the PrehKeyTec Driver Pack! 6. Troubleshoting ================= 6.1 Message: 'keyhook.dll' not found ----------------------------------------- Obviously you have installed/removed a older software package (e.g. Preh OPOS Driver V1.4.46) after installing the driver pack. By doing so, several Windows registry settings were removed, which are required for the functionality of the PrehKeyTec system files "keyhook.dll". => Solution: (Re)Install the latest version of the PrehKeyTec DriverPack. 6.2 The codes for POSKeyboard data event are not continuous ----------------------------------------- You should use POSKeyboard Translation as described in chapter 4.3. 7. Installed files ================== During installation the following files will be installed: PrehKeyTec OPOS documentation: PrehOPOS.chm Auto_install.txt Readme.txt PrehKeyTec OPOS Service Object DLLs: PrehPOSKeyboardSO.dll 1.10.0.7 Preh POSKeyboard SO PrehKeylockSO.dll 1.10.0.7 Preh Keylock SO PrehMSRSO.dll 1.10.0.7 Preh MSR SO PrehToneIndicatorSO.dll 1.10.0.7 Preh Tone Indicator SO PrehHSMSRSO.dll 1.4.0.56 Preh RS232-MSR SO (only 1.4 compliant, not registered per default) PrehLineDisplaySO.dll 1.4.0.56 Preh Line Display SO (only 1.4 compliant, not registered per default) PrehScannerSO.dll 1.4.0.56 Preh Scanner (only 1.4 compliant, not registered per default) PrehKeyTec OPOS Demo applications POPOSKBD.exe 1.10.0.7 Preh OPOS POSKeyboard sample POPOSKL.exe 1.10.0.7 Preh OPOS Keylock sample POPOSMSR.exe 1.10.0.7 Preh OPOS MSR sample (used for "MSR" and RS232-type "HSMSR") POPOSTI.exe 1.10.0.7 Preh OPOS Tone Indicator sample POPOSLD.exe 1.4.0.53 Preh OPOS Line Display sample (not installed per default) POPOSSC.exe 1.4.0.53 Preh OPOS Scanner sample (not installed per default) Utilities to switch PrehKeyTec default interface: .\util\setusb.reg RegFile for configuring to USB interface .\util\setps2.reg RegFile for configuring to PS/2 interface Utilities to configure PrehKeyTec OPOS configuration: .\util\PosKey_default.reg RegFile for POSKeyboard without translation .\util\PosKey_128.reg RegFile for POSKeyboard with translation to 1..128 .\util\Keylock_4Pos.reg RegFile for 4 position keylock type .\util\Keylock_5Pos.reg RegFile for 5 position keylock type Wise Uninstall files - do NOT delete or modify. .\INSTALL.LOG .\UNWISE.EXE Additionally the included PrehKeyTec Driver Pack (or newer version) must be installed. It includes all needed components for communicating with the PrehKeyTec keyboards: * Keyhook interface for PS/2 and RS232 * Keyhook interface for USB * PrehKeyTec PS/2 keyboard driver - required for WindowsNT or Windows2000/XP: - if the PrehKeyTec keyboard is connected via PS/2 - if you want to send data/commands towards a PrehKeyTec PS/2 keyboard Included in this installation package is PrehKeyTec DriverPack V1.6.0.18282 8. Unattended installation ========================== For detailled informations please refer to the file "Auto_install.txt". 9. Version History: =================== Service objects for MSR, POSKeyboard, Keylock and Tone Indicator are now UPOS 1.10 compliant. 1.10.007.18343 Release: 2018 Aug.22 * DriverPack 1.6.0.18282 included (containing USB keyhook.dll V1.0.0.34) * Installation script improvements. * Readme.txt and Auto_Install.txt updated. 1.10.007b Release: 2008 Aug.22 * DriverPack 1.4.0.0 included (containing USB keyhook.dll V1.0.0.26) 1.10.007a Release: 2007 Nov.20 * DriverPack 1.3.0.1 included (containing USB keyhook.dll V1.0.0.22) * Readme.txt and Auto_Install.txt updated. 1.10.007 Release: 2007 Feb.28 * Service objects updated 1.10.0.7 (POSKeyboard, MSR, Keylock, ToneIndicator) * Demo Applications updated 1.10.0.7 (POSKeyboard, MSR, Keylock, ToneIndicator) * DriverPack 1.2.0.0 included (new keyhook files). * Readme.txt updated 1.4.0.56_1 Release: 2005 Sept 21 * Installation script improvements (TI_TYPE/KEYLOCKTYPE) * Readme.txt updated 1.4.0.56 Release: 2005 July 01 * Service objects updated 1.4.0.56 (Unique CLSIDs, Threading Model "Apartment") * HSMSR (RS232 MSR): Default - device is not registered (HSMSR=B) * Installation script improvements (e.g. new dialogue POSKeyboard Translation) * Readme.txt updated and informations added. 1.4.0.53 Release: 2005 June 09 * Service objects and demo applications updated * Installation script improvements (e.g. LowLevel Keyhook dialogue for PS2) * Threading model setting "Both" added for all registered modules * DriverPack 1.1.0.1 * Readme.txt updated and informations added. 1.4.0.52 Beta Releases: 2005 March / June 1.4.0.50_1 Release: 2004 March 29 * Installation script improvements (AutoInstall). 1.4.0.50 Release: 2003 September 04 * Readme.txt updated * Service objects and demo applications updated 1.4.0.48_1 Release: 2003 August 13 * Readme.txt updated * Installation script improvements 1.4.0.48 Release: 2003 July 25 * Service objects and demo applications updated * Installation script improvements ====================================================================== Annex ====================================================================== Copyright © Copyright PrehKeyTec GmbH 2018 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