sane-umax(5) SANE Scanner Access Now Easy sane-umax(5) BEZEICHNUNG sane-umax - SANE-Backend fur UMAX-Scanner UBER DIESE DATEI Diese Datei ist nur eine kurze Beschreibung des Backends sane-umax fur SANE! Fur detailliertere Informationen schauen Sie in sane-umax-doc.html (sie ist Teil des Sane-Quellverzeichnisses und in der xsane(1)-Online-Hilfe)! BESCHREIBUNG Die Bibliothek sane-umax implementiert ein SANE-(Scanner Access Now Easy) Backend zum Zugriff auf mehrere UMAX-SCSI-Scanner und einige Linotype-Hell-SCSI-Scanner, parallele und USB-Scanner werden nicht (und wahrscheinlich nie) unterstutzt! Ich empfehle, dass Sie bei den ersten Scans eine Hand am Ausschalter des Scanners halten! KONFIGURATION Die Konfigurationsdatei fur dieses Backend befindet sich in /etc/sane.d/umax.conf. Sie enthalt eine Liste von Geratenamen, die UMAX-Scannern sowie UMAX-kompatiblen Scannern entsprechen. Leere Zeilen und solche, die mit einer Raute (#) beginnen, werden ignoriert. Nachfolgend sehen Sie ein Beispiel fur eine Konfigurationsdatei: # Dies ist ein Kommentar # option scsi-maxqueue 4 option scsi-buffer-size-min 65536 option scsi-buffer-size-max 131072 option scan-lines 40 option preview-lines 10 option scsi-maxqueue 2 option execute-request-sense 0 option force-preview-bit-rgb 0 option slow-speed -1 option care-about-smearing -1 option calibration-full-ccd -1 option calibration-width-offset -1 option calibration-bytes-pixel -1 option exposure-time-rgb-bind -1 option invert-shading-data -1 option lamp-control-available 0 option gamma-lsb-padded 0 /dev/sge #scsi Lieferant Modell Typ Bus Kanal Kennung LUN # Die folgenden Scanner unterstutzen die Lampen-Steuerung option lamp-control-available 1 scsi UMAX * Scanner * * * * * # Scanner auf /dev/scanner unterstutzt die Lampensteuerung nicht option lamp-control-available 0 /dev/scanner execute-request-sense: values: 0 = disabled, 1 = enabled default = 0 Falls 1, wird umax_do_request_sense() in umax_do_calibration() aufgerufen. Dies kann zum Hangen des Systems fuhren, wurde aber bis zu dieser Version aktiviert. scsi-buffer-size-min, scsi-buffer-size-max: Werte: 4096-1048576 default min = 32768, max = 131072 Besonders der Minimalwert ist sehr wichtig. Falls dieser Wert zu klein ist, kann das Backend Gamma-Tabellen nicht an den Scanner senden oder eine korrekte Farbkalibrierung durchfuhren. Dies kann zu merkwurdigen Farbeffekten fuhren. Falls der Minimalwert zu gross ist, dann kann das Backend die angeforderte SCSI-Puffergrosse nicht reservieren und bricht mit einem Speicherfehler ab. Die Vorgabe ist 32 kB, fur einige Scanner sollte dies auf 64 kB erhoht werden. scan-lines, preview-lines: Werte: 1-65535 Vorgabe: scan-lines = 40, preview-lines = 10 definiert die maximale Anzahl an Zeilen, die in einen Puffer gescannt werden sollen force-preview-bit-rgb: values: 0 = disabled, 1 = enabled default = 0 setzt Vorschau-Bit in RGB-Echt-Scan slow-speed, care-about-smearing: Werte: -1 = automatisch, 0 = deaktiviert, 1 = aktiviert Vorgabe = -1 Gefahrliche Optionen, benotigt fur einige Scanner. Andern Sie diese Optionen nur, wenn Sie wirklich genau wissen, was Sie tun. Sie konnten Ihren Scanner mit ungultigen Werten zerstoren. calibration-full-ccd: Werte: -1 = automatisch, 0 = deaktiviert, 1 = aktiviert Vorgabe = -1 fuhrt fur jeden Pixel des CCDs statt fur das ausgewahlte Bild eine Kalibration durch. calibration-width-offset: Werte: -99999 = auto, > -99999 gesetzter Wert fugt eine Versatz zu der berechneten Breite fur das Bild/CCD hinzu calibration-bytes-pixel: Werte: -1 = deaktiviert, 0 = nicht gesetzt, 1 = 1 Byte/Pixel, 2 = 2 Byte/Pixel verwendet die Anzahl an Byte pro Pixel zur Kalibrierung exposure-time-rgb-bind: Werte: -1 = automatisch durch den Treiber gesetzt - falls bekannt, 0 = deaktiviert (eigene Auswahl fur rot, grun und blau), 1 = aktiviert (gleiche Werte fur rot, grun und blau) invert-shading-data: Werte: -1 =automatisch durch den Treiber gesetzt - falls bekannt, 0 = deaktiviert, 1 = aktiviert Vorgabe = -1 invertiert Schattierungsdaten, bevor sie zum Scanner zuruckgesendet werden lamp-control-available: Werte: 0 = automatisch vom Treiber gesetzt, falls bekannt, 1 = verfugbar default = 0 gamma-lsb-padded: Werte: -1 = automatisch vom Treiber gesetzt, falls bekannt, 0 = Gamma-Daten sind MSB-aufgefullt, 1 = Gamma-Daten sind LSB-aufgefullt Vorgabe = -1 handle-bad-sense-error: Werte: 0 = als beschaftigtes Gerat behandeln, 1 = als i.O. behandeln, 2 = als E/A-Fehler behandeln, 3 = schlechten Fehler-Code ignorieren, mit dem Ermitteln des Handlers fortfahren default = 0 scsi-maxqueue: Werte: 1..# (Maximum bei der Kompilierung festgelegt) Vorgabe = 2 Die meisten SCSI-Treiber erlauben eine Warteschlange der Tiefe 2 (Befehle) fur interne Befehle. In den meisten Fallen wird nichts verbessert, wenn Sie diesen Wert erhohen. Falls Ihr SCSI-Treiber keine Warteschlange fur Befehle unterstutzt, konnen Sie versuchen, diesen Wert auf 1 zu setzen. Der Name der Gerate-Spezialdatei muss ein generisches SCSI-Gerat oder ein symbolischer Link darauf sein. Um zu ermitteln, welcher Geratedatei Ihr Scanner zugeordnet ist und wie Sie die Zugriffsrechte fur dieses Gerat festlegen konnen, werfen Sie einen Blick auf sane-scsi(5). TIPPS FUR SCSI-ADAPTER Die ISA-SCSI-Adapter, die mit einigen UMAX-Scannern ausgeliefert werden, werden von Linux nicht sehr gut unterstutzt und ich empfehle, sie nicht zu verwenden, und die PCI-SCSI-Adapter, die mit einigen UMAX-Scannern ausgeliefert werden, werden uberhaupt nicht unterstutzt (soweit ich weiss). Auf anderen Plattformen werden die SCSI-Adapter nicht unterstutzt. Daher mussen Sie typischerweise einen anderen SCSI-Adapter kaufen, der von Ihrer Plattform unterstutzt wird. Siehe die relevanten Hardware-FAQs und HOWTOs fur Ihre Plattform fur weitere Informationen. Die UMAX-Scanner blockieren den SCSI-Bus fur einige Sekunden beim Scannen. Es ist nicht notwendig, den Scanner mit einem separaten SCSI-Adapter zu verbinden. Falls Sie aber kurze Reaktionszeiten fur Ihre SCSI-Festplatte oder andere SCSI-Gerate benotigen (z.B. falls Ihr Computer ein Datei-Server ist), empfehle ich Ihnen, einen eigenen SCSI-Adapter fur Ihren UMAX-Scanner zu verwenden. Falls Sie Probleme mit Ihrem UMAX-Scanner haben, uberprufen Sie die SCSI-Kette (Kabellange, Terminierung, ). Siehe auch: sane-scsi(5) DATEIEN Die Backend-Konfigurationsdatei: /etc/sane.d/umax.conf Die statische Bibliothek, die dieses Backend implementiert: /usr/lib/sane/libsane-umax.a Die dynamische Bibliothek, die dieses Backend implementiert: /usr/lib/sane/libsane-umax.so (auf Systemen verfugbar, die dynamisches Laden unterstutzen) UMGEBUNGSVARIABLEN SANE_DEBUG_UMAX 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. Werte von SANE_DEBUG_UMAX: Nummer Bemerkung 0 Ausgabe wichtiger Fehler (jedes Mal ausgegeben) 1 Ausgabe von Fehlern 2 Ausgabe des Sinns 3 Ausgabe von Warnungen 4 Ausgabe Scanner-Abfrage 5 Ausgabe von Informationen 6 Ausgabe weniger wichtiger Informationen 7 Ausgabe aufgerufener Prozeduren 8 Ausgabe von reader_process-Meldungen 10 Ausgabe aufgerufener sane-init-Routinen 11 Ausgabe aufgerufener Sane-Prozeduren 12 Ausgabe von Sane-Informationen 13 Ausgabe von Sane-Option-Steuer-Meldungen Beispiel: export SANE_DEBUG_UMAX=8 FEHLER X-Auflosungen grosser als 600 dpi verursachen gelegentlich Probleme. SIEHE AUCH sane(7), sane-scsi(5) AUTOR Oliver Rauch KONTAKT PER E-MAIL Oliver.Rauch@Rauch-Domain.DE 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: . 14. Juli 2008 sane-umax(5)