============================================ Preh OPOS Treiber für Windows 1.10.007b ============================================ Wenn Sie diese Datei im Editor öffnen, bitte Zeilenumbruch für eine korrekte Anzeige aktivieren. 0. Systemvoraussetzungen ======================== Unterstützte Betriebssysteme: Windows9x, Windows NT4.0, Windows 2000/XP Die OPOS Common Control Objects (CCOs) müssen ebenfalls installiert sein. Für die Preh OPOS Beispielprogramme benötigen Sie die CCOs ab Version 1.10. Preh-Tastatur oder Modul mit "OPOS-Konfiguration" - siehe Punkt 2. 1. Installation =============== Folgen Sie dem Installations-Assistenten. Das Paket "Preh Driver Pack" muß ebenfalls installiert werden. Das Paket ist in jeweils aktueller Version enthalten und wird am Ende des Installationsvorgangs für den Preh OPOS Treiber automatisch gestartet, wenn die DriverPack Version neuer als das bereits installierte Paket ist. Ist die enthaltene Version gleich oder älter, sollte das Paket nicht installiert werden - außer siehe 6. Problembehebung. Wichtige Hinweise: Sollte eines dieser Pakete bereits zuvor installiert worden sein, so können ggf. dort vorgenommene Einstellungen während dieser Treiberinstallation mit Default-Werten überschrieben werden. Wir empfehlen alle älteren Preh OPOS/JavaPOS Pakete zu deinstallieren, die ein Preh DriverPack nicht beinhalteten (z.B. Preh OPOS Driver V1.4.46). Für das Ersetzen des Tastaturtreibers unter Windows NT und Windows2000/XP benötigen Sie zwingend Administrator-Rechte. 2. Konfiguration der Tastatur mit dem WinProgrammer =================================================== Um die OPOS-Treiber verwenden zu können, müssen bestimmte Einstellungen am Keyboard vorgenommen werden, falls nicht bereits geschehen. Die Module der Preh-Tastatur (Magnetkartenleser, Schlüsselschalter, usw.) müssen mit den gängigen Werten für Preh OPOS programmiert sein. Dies erreicht man recht einfach: Beim Erstellen eines neuen Tastaturlayouts im Preh WinProgrammer die Option "OPOS Einstellungen" aktivieren. Dadurch werden passende Werte für Vorspann/Abspann (Header/Terminator) eingetragen. Die POS-Tasten programmiert man mit den Makros {POSKey001} ... {POSKey128} - üblicherweise auf dem StdKey-Layer mit Autorepeat=AUS. Diese Belegung muß dann noch in die Tastatur gespielt werden. Anmerkung: Für gängige Preh-Tastaturen sind bereits Beispielbelegungen beim Preh WinProgrammer enthalten: Bitte öffnen Sie die entsprechende Konfiguration im WinProgrammer-Unterverzeichnis .\Keytables\OposJavaPOS. 3. Preh OPOS Beispielprogramme ============================== Für alle unterstützten OPOS-Geräte werden Beispielprogramme mitinstalliert. Bitte starten Sie diese Beispielanwendungen über das entsprechende Startmenü-Icon. Anschließend die üblichen Schritte (Open / Claim / usw.). Die Standard-Namen der OPOS-Module lauten wie folgt: * "PREH POSKeyboard" * "PREH MSR" * "Preh Keylock" * "PREH Tone Indicator" * "PREH HSMSR" für RS232 MSR-Modul * "PREH Line Display" für altes LC Display-Modul von MWX und MC/WX Tastaturen * "PREH Scanner" für Scanner-Modul von MWX und MC/WX Tastaturen Die Namen der OPOS Geräte sind in der Windows-Registry hinterlegt: HKEY_LOCAL_MACHINE\SOFTWARE\OLEforRetail\ServiceOPOS\ Anmerkungen: Das Verhalten der Beispielanwendungen MSR und POSKeyboard wurde in Version 1.10 verändert: Ist "Automatic Enable" eingeschaltet, so re-aktiviert die Beispielanwendung nach jedem DataEvent das Property DataEventEnabled. Das Verhalten der MSR-Beispielanwendung wurde in Version 1.4.0.50 verändert: Es wird "GetTrackData" nun nicht mehr automatisch ausgeführt, wenn ein Error Event auftritt. Um bei einem Error Event die Daten der gültigen Spuren zu erhalten, klicken Sie auf die Felder für die Trackdaten. 4. Spezielle Systemkonfiguration ================================ 4.1 Schnittstelleneinstellung ============================== Die Tastaturschnittstelle für den Preh OPOS Treiber ist in der Windows Registry abgelegt: HKEY_LOCAL_MACHINE\SOFTWARE\PREH\Keyboard\INTERFACE 0x00000000 = PS/2 Schnittstelle 0xffffffff = USB Schnittstelle Für spezielle ältere Modelle mit RS232-Interface zusätzlich: 0x00000001 = RS232 Schnittstelle COM 1 0x00000002 = RS232 Schnittstelle COM 2 0x00000003 = RS232 Schnittstelle COM 3 0x00000004 = RS232 Schnittstelle COM 4 Um die Schnittstelle umzustellen, können Sie diese Werte verändern - oder benutzen Sie sie einfach die angelegten Verknüpfungen im Startmenü. 4.2 LowLevel Keyhook bei PS2 ============================ hinzu ab Driver Pack V1.1.0.0 Kann nur unter Windows NT4.0(SP3)/Windows 2000/Windows XP benutzt werden. Das automatische Starten/Beenden der Server-Applikation mittels Registry-Key "LLKeyhook" wird nur vom Paket Preh JavaPOS unterstützt. Der Preh Keyboard Server für PS2 kann aber in jedem Falle manuell gestartet werden: PrehKeySrv.exe (Installiert im DriverPack Unterverzeichnis "...Preh\DriverPack\ps2") Es erscheint dann das entsprechende Icon in der Systray. Tipp: Starten Sie den Preh Keyboard Server für PS2 automatisch beim Windows-Systemstart: * über den Autostart-Ordner oder * über entsprechenden Run-Schlüssel in der Registry: SOFTWARE\Microsoft\Windows\CurrentVersion\Run "Preh PS2 Keyboard Server" = "C:\Program Files\Preh\DriverPack\ps2\PrehKeySrv.exe" Im Preh OPOS-Paket V1.4.0.52 wurde ein entsprechender Dialog "LowLevel Keyhook" hinzugefügt. Wenn ausgewählt, wird automatisch ein solcher "Run"-Schlüssel in der Registry erzeugt. Anmerkung: Bei unbeaufsichtigter Installation wird ein solcher Registry-Eintrag nicht automatisch erstellt. 4.3 POSKeyboard Translation =========================== Die Rückgabewerte für DataEvent können in benutzerdefinierte Codes übersetzt werden (Keyboard Translation). Dies ist eine Forderung des OPOS-Standards (siehe OPOS-Dokumentation). Die zugehörigen Registry-Schlüssel befinden sich hier: [HKEY_LOCAL_MACHINE\SOFTWARE\OLEforRetail\ServiceOPOS\POSKeyboard\PREH POSKeyboard] "POSKey001"=dword:00000001 ... "POSKey128"=dword:00000080 In unseren vorhergehenden Installationspaketen konnten diese Schlüssel nur manuell oder über entsprechende Registry-Dateien aktiviert werden: .\util\PosKey_128.reg .\util\PosKey_default.reg Im Preh OPOS-Paket V1.4.0.56 wurde ein entsprechender Dialog "POSKeyboard" hinzugefügt: Die erste Option aktiviert eine Übersetzungstabelle mit fortlaufenden Codes von 1 bis 128, entsprechend den programmierten Tastaturmakros {POSKey001} .. {POSKey128}. Die zweite Option nimmt keine Änderung an der Tabelle vor. Im Normalfall werden dann hardwarespezifische nicht-fortlaufende Werte gemeldet. Bei unbeaufsichtigter Installation kann dies über die Variable "KB_TRANSLATE" gesteuert werden. Weitere Informationen finden Sie in der Datei "Auto_install.txt". 5. Deinstallation ================= 5.1 Deinstallieren Sie den Preh OPOS-Treiber immer über Windows Systemsteuerung -> Software. 5.2 Falls das Paket "Preh Driver Pack" nicht mehr benötigt wird, können Sie es ebenfalls deinstallieren. Achtung: Wenn andere Pakete auf diesem Rechner installiert sind, die diese Treiber benötigen (wie z.B. Preh JavaPOS, etc.) dürfen sie das Paket Preh Driver Pack natürlich nicht(!) deinstallieren! 6. Problembehebung ================== 6.1 Meldung: PREH 'keyhook.dll' not found ----------------------------------------- Möglicherweise haben Sie ein veraltetes Programmpaket (z.B. Preh OPOS V1.4.46) nachträglich installiert/deinstalliert. Für die Funktion dieser Preh-Systemdateien "keyhook.dll" benötigte Registry-Einträge sind dadurch entfernt worden. => Abhilfe: Preh DriverPack in aktueller Version neu installieren. 6.2 Die DataEvent-Rückgabewerte für das POSKeyboard sind nicht fortlaufend ----------------------------------------- Bitte POSKeyboard Translation einstellen, wie unter Kapitel 4.3 beschrieben. 7. Installierte Dateien ======================= Während der Installation werden die folgenden Dateien installiert: Preh OPOS Dokumentation: PrehOPOS.chm Auto_install.txt Readme.txt Preh 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) Preh OPOS Demo Anwendungen: POPOSKBD.exe 1.10.0.7 Preh POSKeyboard sample POPOSKL.exe 1.10.0.7 Preh Keylock sample POPOSMSR.exe 1.10.0.7 Preh MSR sample POPOSTI.exe 1.10.0.7 Preh Tone Indicator sample POPOSLD.exe 1.4.0.53 Preh Line Display sample (not installed per default) POPOSSC.exe 1.4.0.53 Preh Scanner sample (not installed per default) Utilities zum Einstellen der Default-Schnittstelle für Preh-Tastaturen: .\util\setusb.reg RegFile for configuring to USB interface .\util\setps2.reg RegFile for configuring to PS/2 interface Utilities zum Ändern der Preh OPOS-Konfiguration: .\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 Dateien - NICHT löschen oder verändern! .\INSTALL.LOG .\UNWISE.EXE Zusätzlich muß das enthaltene Preh DriverPack (oder neuere Version) installiert werden. Darin enthalten sind alle Komponenten die für eine Kommunikation mit den Preh-Tastaturen benötigt werden: * Preh Keyhook interface für PS/2 and RS232 * Preh Keyhook interface für USB * Preh PS/2 Tastaturtreiber - nur für WindowsNT bzw. Windows2000/XP benötigt: - wenn die Preh-Tastatur über PS/2 angeschlossen ist - wenn Sie Daten/Kommandos an die Preh PS/2-Tastatur senden möchten In diesem Installationspaket ist das Preh DriverPack V1.4.0.0 enthalten. 8. Unbeaufsichtigte Installation ================================ Weitere Informationen finden Sie in der Datei "Auto_install.txt". 9. Version History: =================== Service objects for MSR, POSKeyboard, Keylock and Tone Indicator are now UPOS 1.10 compliant. 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 =================================== ====================================================================== Anhang ====================================================================== Copyright © Copyright Preh KeyTec GmbH 2008 Veröffentlicht durch PrehKeyTec GmbH. PrehKeyTec GmbH behält sich das Recht vor, die in diesem Dokument beschriebenen Produkte sowie die vorliegende Publikation jederzeit ohne vorherige Ankündigung zu aktualisieren bzw. zu ändern. Dieses Dokument darf nicht ohne vorherige schriftliche Erlaubnis der PrehKeyTec GmbH vervielfältigt, bearbeitet und in elektronischer Form sowie in anderen Sprachen übersetzt werden. Warenzeichen Die in diesem Dokument genannten Marken- und Produktnamen sind Warenzeichen bzw. eingetragene Warenzeichen der jeweiligen Inhaber, z.B. Windows: registered trademarks of Microsoft Corporation. Hilfe und Support Jegliche Fragen und Vorschläge die zur Verbesserung unserer Produkte dienen sind willkommen. Bitte kontaktieren Sie unser Support-Team: support@prehkeytec.de PrehKeyTec GmbH Scheinbergweg 10 97638 Mellrichstadt Germany Email: support@prehkeytec.de Web: www.prehkeytec.com