sane-gt68xx(5) SANE Scanner Access Now Easy sane-gt68xx(5) BEZEICHNUNG sane-gt68xx - SANE-Backend fur GT-68XX-basierte USB-Flachbett-Scanner BESCHREIBUNG Die Bibliothek sane-gt68xx implementiert ein SANE-(Scanner Access Now Easy) Backend zum Zugriff auf USB-Flachbett-Scanner, die auf den Grandtech GT-6801- und GT-6816-Chips basieren. Eine Liste der unterstutzten Scanner kann auf der Homepage des gt68xx-Backends gefunden werden: http://www.meier-geinitz.de/sane/gt68xx-backend/. Dies ist BETA-Software. Insbesondere dann, wenn Sie neue oder bisher noch nicht getestete Scanner testen, behalten Sie den Netzstecker des Scanners in der Hand und ziehen Sie ihn, falls der Schlitten ans Ende des Scanbereichs stosst. Falls Sie einen Scanner besitzen, der mit diesem Backend funktioniert, aber auf der gt68xx-Homepage nicht aufgefuhrt ist, senden Sie mir die genaue Modellbezeichnung des Scanners und die USB-Anbieter- und Geratekennungen (zum Beispiel mit sane-find-scanner(1) ermittelt oder aus dem Systemprotokoll). Selbst wenn sich der Name des Scanners nur geringfugig von den oben als unterstutzt aufgefuhrten Modellen unterscheidet, lassen Sie es mich bitte wissen. Falls Sie einen Scanner besitzen, der vom gt68xx-Backend nicht erkannt wird, aber einen GT-6801- oder GT-6816-Chipsatz hat, konnen Sie versuchen, ihn zum Backend hinzuzufugen. Schauen Sie auf folgende Webseite: http://www.meier-geinitz.de/sane/gt68xx-backend/adding.html. LIBUSB-PROBLEME Bitte verwenden Sie libusb-0.1.8 oder neuer. Ohne libusb oder mit alteren libusb-Versionen konnen Sie mit allem moglichen Arger rechnen. Der Scanner sollte von sane-find-scanner(1) ohne weiteres Eingreifen gefunden werden. Fur das Setzen von Zugriffsrechten und allgemeine USB-Informationen lesen Sie sane-usb(5). FIRMWARE-DATEI Sie benotigen eine Firmware-Datei fur Ihren Scanner. Das ist eine kleine Datei mit Software, die in den Speicher Ihres Scanners hochgeladen wird. Sie heisst typischerweise *.usb, z.B. PS1fw.usb. Sie befindet sich auf der Installations-CD, die vom Hersteller bereitgestellt wurde, kann aber zusammen mit einem Installationsprogramm in einer .exe-Datei gepackt sein. Fur Mustek-Scanner kann die Datei von der gt68xx-Backend-Homepage heruntergeladen werden. Fur andere Scanner uberprufen Sie die CD auf .usb-Dateien. Falls Sie nur *.cab-Dateien finden, versuchen Sie cabextract(1) zum Entpacken. Falls alles andere fehlschlagt, mussen Sie den Windows-Treiber installieren und die Firmware von dort holen (normalerweise in den Verzeichnissen windows/system oder system32). Legen Sie die Firmware in /usr/share/sane/gt68xx/ ab. Sie muss von jedem lesbar sein. KONFIGURATION Der Inhalt der Datei gt68xx.conf ist eine Liste von usb-Zeilen, die die Lieferanten- und Produktkennung enthalten, die USB-Scannern entsprechen. Die Datei kann auch Options-Zeilen enthalten. Leere Zeilen und Zeilen, die mit einer Raute (#) beginnen, werden ignoriert. Die Scanner werden automatisch durch usb vendor_id product_id-Angaben erkannt, welche bereits in gt68xx.conf aufgenommen sind. >>vendor_id<< und >>product_id<< sind hexadezimale Zahlen, die den Scanner identifizieren. Die Optionen override, firmware, vendor, model und afe mussen nach der usb-Zeile, auf die sie sich beziehen, abgelegt werden. Die Option override wird zum Ausserkraftsetzen von Vorgabe-Modellparametern verwendet. Das ist fur einige Scanner notwendig, die die gleichen Lieferanten-/Produktkennungen verwenden, sich aber unterscheiden. Fur diese Scanner gibt es bereits auskommentierte Zeilen zum Ausserkraftsetzen in der Konfigurationsdatei. override mustek-scanexpress-1200-ub-plus ist fur den Mustek Scanexpress 1200 UB Plus, den Medion/Lifetec/Tevion LT 9452 und den Trust Compact Scan USB 19200 notwendig. override artec-ultima-2000 wird fur den Artec Ultima 2000, den Boeder SmartScan Slim Edition, den Medion/Lifetec/Tevion/Cytron MD/LT 9385, den Medion/Lifetec/Tevion MD 9458 und den Trust Flat Scan USB 19200 verwendet. override mustek-bearpaw-2400-cu ist fur den Mustek BearPaw 2400 CU und den Fujitsu 1200CUS notwendig. Die Option override muss die erste nach der usb-Zeile sein. Die Option firmware wahlt den Namen und den Pfad der Firmware-Datei. Dies ist nur notwendig, wenn die Vorgabe (oder Ausserkraftsetzung) nicht funktioniert. Das Vorgabe-Firmware-Verzeichnis ist /usr/share/sane/gt68xx/. Es kann sein, dass Sie dieses Verzeichnis erstellen mussen. Falls Sie die Firmware an einem anderen Ort ablegen mochten, verwenden Sie eine firmware-Zeile. Die Optionen vendor und model sind nicht absolut notwendig, sondern zur Bequemlichkeit. Eine ganze Reihe von Scannern von verschiedenen Herstellern verwenden die gleiche Lieferanten-/Produktkennung, so dass Sie hier den >>korrekten<< Namen setzen konnen. Die Option afe ermoglicht es, angepasste Offsets und Verstarkungswerte fur die Analog-Oberflache (AFE) des Scanners zu setzen. Diese Option kann entweder zur Auswahl der AFE-Werte verwendet werden, falls automatische Grobkalibrierung deaktiviert ist oder um die automatische Grobkalibrierung zu beschleunigen. In letzterem Falle aktivieren Sie Debug-Stufe 3 (siehe unten), scannen ein Bild und suchen nach Debug-Zeilen mit >>afe<<. Kopieren Sie diese Zeilen in gt68xx.conf. Die Option hat sechs Parameter: roter Offset, rote Verstarkung, gruner Offset, grune Verstarkung, blauer Offset und blaue Verstarkung. Nachfolgend sehen Sie ein Beispiel fur eine Konfigurationsdatei: usb 0x05d8 0x4002 override "mustek-scanexpress-1200-ub-plus" firmware "/opt/gt68xx/SBfw.usb" vendor "Trust" model "Compact Scan USB 19200" afe 0x20 0x02 0x22 0x03 0x1f 0x04 DATEIEN /etc/sane.d/gt68xx.conf Die Backend-Konfigurationsdatei (siehe auch die nachfolgende Beschreibung von SANE_CONFIG_DIR). /usr/lib/sane/libsane-gt68xx.a Die statische Bibliothek, die dieses Backend implementiert. /usr/lib/sane/libsane-gt68xx.so Die dynamische Bibliothek, die dieses Backend implementiert (auf Systemen verfugbar, die dynamisches Laden unterstutzen). UMGEBUNGSVARIABLEN SANE_CONFIG_DIR Diese Umgebungsvariable gibt eine Liste von Verzeichnissen an, die die Konfigurationsdatei enthalten konnen. Auf *NIX-Systemen sind die Verzeichnisse durch Doppelpunkte (:) getrennt, unter OS/2 durch Semikola (;). Falls diese Variable nicht gesetzt ist, wird in zwei Standardverzeichnissen nach der Konfigurationsdatei gesucht: zuerst im aktuellen Arbeitsverzeichnis (.) und dann in /etc/sane.d. Falls der Wert der Umgebungsvariable mit dem Verzeichnis-Trennzeichen endet, dann werden die Standardverzeichnisse nach den explizit angegebenen Verzeichnissen durchsucht. Wenn Sie beispielsweise SANE_CONFIG_DIR auf >>/tmp/config:<< setzen, wird in den Verzeichnissen >>tmp/config<<, >>.<< und >>/etc/sane.d<< gesucht (in dieser Reihenfolge). SANE_DEBUG_GT68XX Falls die Bibliothek mit Debug-Unterstutzung kompiliert wurde, steuert diese Umgebungsvariable die Debug-Stufe fur dieses Backend. Hohere Debug-Stufen erhohen die Ausfuhrlichkeit der Ausgabe. Falls die Debug-Stufe auf 1 oder hoher gesetzt ist, stehen einige Debug-Optionen zur Verfugung, die normalerweise versteckt sind. Verwenden Sie diese vorsichtig. Beispiel: export SANE_DEBUG_GT68XX=4 SIEHE AUCH sane(7), sane-usb(5), sane-artec_eplus48u(5) sane-plustek(5), sane-ma1509(5), sane-mustek_usb(5), sane-mustek(5), sane-mustek_pp(5), cabextract(1) /usr/share/doc/sane/gt68xx/gt68xx.CHANGES http://www.meier-geinitz.de/sane/gt68xx AUTOR Henning Meier-Geinitz Der ursprungliche gt68xx-Treiber wurde durch Sergey Vlasov, Andreas Nowack und David Stevenson geschrieben. Vielen Dank an sie und alle anderen Beitragenden fur das Einschicken von Patches und Beantworten von Fragen. FEHLER Die ersten paar Zeilen des Bildes sind beim 2400 TA Plus Mull. Statt einfach Daten zu kopieren sollte interpoliert werden, wenn sich die X- und Y-Auflosung unterscheiden. Die Knopfe werden nicht unterstutzt. Weitere, detailliertere Fehlerinformationen sind auf der Homepage des gt68xx-Backends verfugbar: http://www.meier-geinitz.de/sane/gt68xx-backend/. Bitte schreiben Sie uns (auf Englisch) an, falls Sie einen Fehler finden oder eine Funktion vermissen: . Bitte schicken Sie uns ein Debug-Protokoll, falls Ihr Scanner nicht korrekt erkannt wird (siehe SANE_DEBUG_GT68XX weiter oben). UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Mario Blattermann und Helge Kreutzmann erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ubernommen. Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer: . 13. Juli 2008 sane-gt68xx(5)