sane-mustek_pp(5) File Formats Manual sane-mustek_pp(5) BEZEICHNUNG sane-mustek_pp - SANE-Backend fur Mustek Parallel-Port-Flachbett-Scanner BESCHREIBUNG Die Bibliothek sane-mustek_pp implementiert ein SANE-(Scanner Access Now Easy) Backend zum Zugriff auf Mustek-Parallelport-Flachbett-Scanner und OEM-Versionen. Es gibt zwei Klassen von Mustek-Parallelport-Scannern: regulare CCD-Scanner (>>cold cathode device<<, Gerate mit Kaltkathodenlampe) und CIS-Scanner (>>contact image sensor<<, Gerate mit Kontakt-Bildsensor). Die aktuelle Version dieses Backends unterstutzt sowohl CCD-Scanner als auch CIS-Scanner. Die folgenden Scanner konnten mit diesem Backend funktionieren: CCD-Scanner Modell: ASIC-Kennung: CCD-Typ: funktioniert: -------------------------------------------------------------- SE 6000 P 1013 00 ja SM 4800 P 1013/1015 04/01 ja SE 1200 ED Plus 1015 01 nein SM 1200 ED Plus 1015 01 nein SE 12000 P 1505 05 nein 600 III EP Plus 1013/1015 00/01 ja SE 600 SEP 1013 ?? ja 600 II EP ???? ?? nein MD9848 1015 00 ja Gallery 4800 ???? ?? ja Viviscan Compact II 1013 00 ja CIS-Scanner Modell: ASIC-Kennung: funktioniert: ----------------------------------------------- Mustek 600 CP & 96 CP 1015 ja (*) Mustek 1200 CP 1015 ja Mustek 1200 CP+ 1015 ja OEM-Versionen Ursprunglich funktioniert -------------------------------------------------- Medion/LifeTec/Tevion MD/LT 9350/9351 1200 CP ja MD/LT 9850/9851 1200 CP vielleicht (**) MD/LT 9858 1200 CP wahrscheinlich MD/LT 9890/9891 1200 CP ja Targa Funline TS12EP 1200 CP ja Funline TS6EP 600 CP ja Trust Easy Connect 9600+ 600 CP ja Cybercom 9352 1200 CP ja (***) (*) Mit alteren Versionen dieses Treibers traten Kalibrierungsprobleme auf. Sie scheinen jetzt gelost zu sein. (**) In der Vergangenheit wurden Problem fur Typ MD/LT9850 berichtet (gestreifte Scans, Kopf bewegt sich bei manchen Auflosungen in die falsche Richtung). Es ist nicht bekannt, ob die aktuelle Version des Treibers diese Probleme immer noch hat. FALLS SIE LAUTE KLICKGERAUSCHE HOREN, ZIEHEN SIE SOFORT DEN NETZSTECKER DES SCANNERS! (Dies gilt fur alle Arten von Scannern). (***) Moglicherweise muss der Parameter >>engine_delay<< auf 1 ms gesetzt werden, damit die Maschine sich korrekt bewegt. Bitte beachten Sie, dass sich dieses Backend immer noch in der Entwicklung befindet. Bestimmte Modelle werden derzeit nicht unterstutzt und andere konnten niemals unterstutzt werden, da das Kommunikationsprotokoll unbekannt ist (z.B. 12000 P). Einige Scanner arbeiten schneller, wenn EPP/ECP im BIOS aktiviert ist. EPP-Modus kann allerdings zum kompletten Aufhangen unter einigen Linux-Systemen fuhren. Falls das bei Ihnen der Fall ist, konnen Sie entweder ECP/EPP in Ihrem BIOS oder in dem Backend selbst deaktivieren (siehe GLOBALE OPTIONEN). Beachten Sie, dass das Backend als Root laufen oder uber die geeigneten Zugriffsrechte auf /dev/parport* verfugen muss, falls die Unterstutzung von Libieee1284 einkompiliert ist. Um den Benutzern Zugriff auf den Scanner zu geben, fuhren Sie das Backend uber die Netzwerkschnittstelle aus (siehe saned(8) und sane-net(5)). Beachten Sie auch, dass das Backend den benutzten Parallelport exklusiv fur sich beansprucht, d.h. falls Sie versuchen, wahrend des Scannens zu drucken, konnte Ihr Computer absturzen. Um die gemeinsame Benutzung des Parallelports zu aktivieren, mussen Sie zum Zeitpunkt des Kompilierens libieee1284(3) aktivieren. Es konnte notwendig sein, dass Sie das Backend explizit in Ihrer dll.conf aktivieren; entfernen Sie einfach die Raute in der Zeile >>mustek_pp<<. GERATEDEFINITION Dieses Backend erlaubt es, mehrere Gerate mittels der Datei mustek_pp.conf zu definieren und konfigurieren (sogar simultan, vorausgesetzt, sie sind mit verschiedenen Parallelports verbunden). Bitte denken Sie daran, diese Datei zu bearbeiten, bevor Sie das Backend verwenden. Ein Gerat kann folgendermassen definiert werden: Scanner wobei ein beliebiger Name fur das Gerat ist, optional in doppelte englische Anfuhrungszeichen eingeschlossen, beispielsweise "LifeTec 9350". der Name des Parallel-Ports ist, mit dem das Gerat verbunden ist. Falls Libieee1284 fur die Kommunikation mit dem Port (default setup) verwendet wird, sind gultige Port-Namen parport0, parport1 und parport2. Falls das Backend fur rohe E/A (old setup) konfiguriert ist, mussen Port-Adressen anstatt Port-Namen verwendet werden: 0x378, 0x278 oder 0x3BC. Die Abbildung von Parallel-Ports ((lp0, lp1 und lp2) auf diese Adressen kann fur verschiedene Linux-Kernel-Versionen unterschiedlich sein. Wenn Sie beispielsweise einen Kernel 2.2.x oder neuer verwenden und Sie nur uber einen Parallel-Port verfugen, wird dieser Port lp0 genannt, unabhangig von der Basis-Adresse. Allerdings benotigt dieses Backend die Basis-Adresse Ihres Ports. Falls Sie sich nicht sicher sind, an welchen Port Ihr Scanner angeschlossen ist, schauen Sie in /etc/conf.modules, /etc/modules.conf und/oder /proc/ioports. Falls Sie sich nicht sicher sind, welchen Port Sie verwenden, konnen Sie den Platzhalter * verwenden, um nach Ihrem Scanner zu suchen. ist der fur dieses Gerat zu verwendende Treiber. Derzeit sind die folgenden Treiber verfugbar: cis600 : fur 600 CP, 96 CP und OEM-Versionen cis1200 : fur 1200 CP und OEM-Versionen cis1200+ : fur 1200 CP+ und OEM-Versionen ccd300 : fur 600 IIIE P und OEM-Versionen Die Auswahl des falschen Treibers kann Ihren Scanner beschadigen! Besonders auf einem 600CP konnen die 1200CP-Einstellungen Schaden anrichten. Falls der Scanner anfangt, ein lautes Gerausch zu machen, schalten Sie ihn sofort aus!! Die Verwendung des Treibers cis600 auf einem 1200CP oder einem 1200CP+ ist wahrscheinlich nicht gefahrlich. Der Treiber cis1200+ funktioniert auch fur den 1200CP und die Verwendung des Treibers cis1200 auf einem 1200CP+ wird typischerweise zu Scans fuhren, die nur die Halfte des Scanbereichs abdecken (auch nicht gefahrlich). Falls Sie sich uber das genaue Modell Ihrer OEM-Version nicht sicher sind, prufen Sie die optische Auflosung im Handbuch oder auf der Kiste: der 600CP hat eine maximale optische Auflosung von 300x600 DPI, wahrend der 1200CP und der 1200CP+ eine maximale optische Auflosung von 600x1200 DPI haben. Beispiele: scanner "LifeTec 9350" 0x378 cis1200 scanner Mustek_600CP 0x378 cis600 scanner Mustek_600IIIEP * ccd300 Falls Sie sich unsicher sind, welchen Port Sie verwenden mussen oder ob Ihr Scanner uberhaupt erkannt wird, konnen Sie sane-find-scanner -p verwenden, um alle konfigurierten Ports zu untersuchen. KONFIGURATION Der Inhalt der Datei mustek_pp.conf ist eine Liste von Geratedefinitionen und Gerateoptionen, die Mustek-Scannern entsprechen. Leere Zeilen und Zeilen, die mit einer Raute (#) beginnen, werden ignoriert. Optionen haben das folgende Format: option [] Abhangig von der Art dieser Option darf ein Wert vorhanden sein oder auch nicht. Optionen gelten immer fur die Scanner-Definitionen, die ihnen vorangestellt sind. Es gibt keine globalen Optionen. Optionen sind auch treiberspezifisch: nicht alle Treiber unterstutzen alle Optionen. Allgemeine Optionen bw Schwarz/Weiss-Unterscheidungswert, der beim Lineart-Scannen verwandt wird. Pixelwerte unterhalb dieses Wertes werden als schwarz angenommen, Werte oberhalb als weiss. Vorgabewert: 127 Minimum: 0 Maximum: 255 Beispiel: option bw 150 CIS-Treiberoptionen top_adjust Vertikale Anpassung des Ursprungs, ausgedruckt in Millimetern (Fliesskomma). Diese Option kann zur Kalibrierung des Ursprungs innerhalb bestimmter Beschrankungen verwandt werden. Beachten Sie, dass CIS-Scanner wahrscheinlich temperaturabhangig sind und dass bestimmte Ungenauigkeiten schwer zu vermeiden sein werden. Unterschiede im Versatz in der Grossenordnung von 1 bis 2 mm sind nicht ungewohnlich. Vorgabewert: 0.0 Minimum: -5.0 Maximum: 5.0 Beispiel: option top_adjust -2.5 slow_skip schaltet schnelles Springen zum Anfang des Scan-Bereichs aus. Wenn die zu scannende Region nicht am Ursprung anfangt, wird der Treiber versuchen, den Scankopf mit hochstmoglicher Geschwindigkeit zum Anfang des Scanbereichs zu bewegen. Bei einigen Modellen konnte dies nicht funktionieren, was zu grossen Ungenauigkeiten (bis zu Zentimetern) fuhren kann. Durch Setzen dieser Option wird der Treiber gezwungen, beim Uberspringen die normale Geschwindigkeit zu verwenden, was die Genauigkeitsprobleme verhindert. Derzeit gibt es keine Modelle, bei denen dieses Ungenauigkeitsproblem auftritt. Standardmassig wird schnelles Uberspringen verwandt. Beispiel: option slow_skip engine_delay Unter nomalen Bedingungen reicht es fur den Treiber aus, darauf zu warten, dass der Scanner signalisiert, dass die Maschine stabil ist, bevor ein neuer Maschinenbefehl ubertragen werden kann. In seltenen Fallen scheinen bestimmte Scanner und/oder Parallelport-Chipsatze das zuverlassige Ubertragen des Maschinenstatus zu verhindern. Im Ergebnis werden Maschinenbefehle zu fruh ubertragen und die Bewegung des Scannerkopfs wird unzuverlassig. Ungenauigkeiten bis zu 10 cm uber den gesamten vertikalen Scan-Bereich wurden berichtet. Um dieses Problem zu umgehen, kann die Option engine_delay gesetzt werden. Falls sie gesetzt ist, wartet der Treiber nach jedem Maschinenbefehl eine zusatzliche Zeitspanne, identisch zum Parameter engine_delay, ausgedruckt in Millisekunden. In der Praxis reicht ein engine_delay von 1 ms normalerweise aus. Die maximale Verzogerung ist 100 ms. Beachten Sie, dass jede zusatzliche Millisekunde an Verzogerung sich bis zu 14 Sekunden an der gesamten Scan-Zeit aufaddieren kann (bei hochster Auflosung), so dass bevorzugt der kleinstmogliche Wert verwendet werden sollte. Vorgabewert: 0 Minimum: 0 Maximum: 100 Beispiel: option engine_delay 1 CCD-Treiber-Optionen top Anzahl der Scanzeilen, die zum Anfang des Scan-Bereichs ubersprungen werden sollen. Die Anzahl kann jede positive Ganzzahl sein. Mir sind die Werte 47 und 56 bekannt. Vorgabewert: 47 Minimum: 0 Maximum: keines Beispiel: option top 56 waitbank Die Anzahl an Mikrosekunden, die auf einen Bankwechsel gewartet werden soll. Sie sollten diesen Wert tatsachlich nicht andern. Kann jede positive Ganzzahl sein. Vorgabewert: 700 Minimum: 0 Maximum: keines Beispiel: option waitbank 700 Nachfolgend sehen Sie ein Beispiel fur eine Konfigurationsdatei: # # LifeTec/Medion 9350 an Port 0x378 # scanner "LifeTec 9350" 0x378 cis1200 # Einige Kalibrierungsoptionen (Beispiele!). option bw 127 option top_skip -0.8 # # Ein Mustek 600CP an Port 0x3BC # scanner "Mustek 600CP" 0x3BC cis600 # Einige Kalibrierungsoptionen (Beispiele!). option bw 120 option top_skip 1.2 # # Ein Mustek 1200CP+ an Port 0x278 # scanner "Mustek 1200CP plus" 0x278 cis1200+ # Einige Kalibrierungsoptionen (Beispiele!). option bw 130 option top_skip 0.2 # # Ein Mustek 600 III EPP an Port parport0 # scanner "Mustek 600 III EPP" parport0 ccd300 # Einige Kalibrierungsoptionen (Beispiele!). option bw 130 option top 56 GLOBALE OPTIONEN Sie konnen das Gesamtverhalten des Backends sane-stek_pp durch globale Optionen steuern, die Vorrang vor allen Scannerdefinitionen in der Datei mustek_pp.conf haben. Derzeit gibt es nur eine globale Option: Globale Optionen no_epp Deaktiviert den Parallelport-Modus EPP; umgeht einen bekannten Fehler im Linux-Parport-Code. Aktivieren Sie diese Option, falls das Backend beim Versuch hangt, auf den Parallel-Port im EPP-Modus zuzugreifen. Vorgabewert: EPP verwenden Beispiel: option no_epp DATEIEN /etc/sane.d/mustek_pp.conf Die Backend-Konfigurationsdatei (siehe auch die nachfolgende Beschreibung von SANE_CONFIG_DIR). /usr/lib/sane/libsane-mustek_pp.a Die statische Bibliothek, die dieses Backend implementiert. /usr/lib/sane/libsane-mustek_pp.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_MUSTEK_PP Falls die Bibliothek mit Debug-Unterstutzung kompiliert wurde, steuert diese Umgebungsvariable die Debug-Stufe fur dieses Backend. Beispielsweise bewirkt ein Wert von 128 die Anzeige samtlicher Debug-Ausgaben. Kleinere Werte reduzieren die Ausfuhrlichkeit. Stufe Debug-Ausgabe -------------------------------------- 0 nichts 1 Fehler 2 Warnungen & kleine Fehler 3 zusatzliche Informationen 4 Debug-Informationen 5 Code-Ablauf (noch nicht unterstutzt) 6 besondere Debug-Informationen SANE_DEBUG_SANEI_PA4S2 Diese Variable setzt die Debug-Stufe fur die SANE-Schnittstelle fur den Mustek-Chipsatz A4S2. Beachten Sie, dass diese Aktivierung Ihr Terminal mit einigen Millionen an Zeilen von Debug-Ausgabe fluten wird. Stufe Debug-Ausgabe ---------------------------- 0 nichts 1 Fehler 2 Warnungen 3 Sachen, die nett zu wissen sind 4 Code-Ablauf 5 detaillierter Code-Ablauf 6 alles SIEHE AUCH sane(7), sane-mustek(5), sane-net(5), saned(8), sane-find-scanner(1), scanimage(1) Fur die neusten Fehlerbehebungen und Informationen schauen Sie auf http://www.penguin-breeder.org/sane/mustek_pp/ Fur zusatzliche Informationen uber den CIS-Treiber, siehe http://home.scarlet.be/eddy_de_greef/ AUTOREN Jochen Eisinger Eddy De Greef FEHLER Zu viele Bitte schicken Sie (auf Englisch) Fehlerberichte an sane-devel@alioth-lists.debian.net (beachten Sie, dass Sie die Liste zuerst abonnieren mussen, bevor Sie E-Mails schicken konnen siehe http://www.sane-project.org/mailing-lists.html). FEHLERBERICHTE Falls etwas nicht funktioniert, kontaktieren Sie uns (Jochen fur die CCD-Scanner, Eddy fur die CIS-Scanner) bitte auf Englisch. Wir benotigen aber einige Informationen uber Ihren Scanner, um Ihnen zu helfen SANE-Version Fuhren Sie scanimage -V aus, um diese zu bestimmen. die Version des Backends und Ihrer Scanner-Hardware Fuhren Sie als root SANE_DEBUG_MUSTEK_PP=128 scanimage -L aus. Falls Sie keine Ausgabe von dem Backend sane-mustek_pp bekommen, prufen Sie, dass eine Zeile >>mustek_pp<< in Ihrer /etc/sane.d/dll.conf enthalten ist. Falls Ihr Scanner nicht erkannt wird, prufen Sie, ob die richtige Port-Adresse in Ihrer mustek_pp.conf definiert ist. der Name Ihres Scanners/Lieferanten ist auch eine wertvolle Information. Bitte nehmen Sie auch die optische Auflosung und den Lampentyp Ihres Scanners auf, beide konnen im Handbuch Ihres Scanners gefunden werden. alle weiteren Kommentare Falls Sie Kommentare zu der Dokumentation haben (was besser gemacht werden sollte) oder wenn Sie denken, ich sollte etwas wissen, fugen Sie es bitte bei. 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-mustek_pp(5)