sane-umax_pp(5)

BEZEICHNUNG
sane-umax_pp - SANE-Backend für Umax Astra-Parallel-Port-Flachbettscanner

BESCHREIBUNG
Die Bibliothek sane-umax_pp implementiert ein SANE-(Scanner Access Now Easy) Backend zum Zugriff auf Umax-Parallel-Port-Flachbettscanner. Die folgenden Scanner funktionieren mit diesem Backend:

    Modell:
    --------------------
    Astra 610P
    Astra 1220P
    HP3200C
    Astra 1600P
    Astra 2000P
    Genius ColorPage-Life Pro

Dieses Backend beherrscht die Scan-Auflösungen 75x75, 150x150, 300x300, 600x600 und 600x1200 DPI für 1220P/1600P/2000P und 75x75, 150x150, 300x300 und 300x600 DPI für 610P. In den Farb- und Graustufen gibt es einen Lineart-Modus in Software.

Die Modelle der neueren Generation haben eine neuere Version des im EPAT-Chip eingebetteten ASIC 610P. Die Modelle unterscheiden sich nur in Teilen, wie dem CCD und ADC. Sie berichten sogar alle über IEEE1284, dass sie ein UMAX Astra 1220P seien. Es gibt keine Software-Methode, um sie korrekt zu erkennen. Unter Windows wird das Modell durch den installierten Treiber gesetzt, unabhängig von der Hardware.

NUR EPP/ECP-MODI
    Die aktuelle Version des Backends verwendet nur die Modi EPP und ECP für die Kommunikation mit dem Scanner. Der PS/2-Modus ist nicht implementiert. Der 610P verwendet nur SPP. Es wird empfohlen, dass Sie für die aktuelle Version dieses Backends Ihren Parallel-Port im BIOS auf EPP setzen. Sie können ihn auf ECP oder ECP+EPP belassen, allerdings dürfen Sie dann die Ppdev, sondern nur direkten Hardwarezugriff verwenden, falls Sie ECP einsetzen müssen. ECPEPP wird nur bei der Verwendung von 2.4- oder 2.6er Kerneln mit aktivierter Ppdev-Unterstützung für zeichenorientierte Geräte funktionieren.

Dieses Backend unterstützt die gemeinsame Verwendung des Parport nur, falls Sie einen Kernel mit Ppdev-Unterstützung einsetzen.

Beachten Sie, dass das Backend als root ausgeführt werden muss, falls Sie das zeichenorientierte Ppdev-Gerät nicht benutzen. Um Benutzern den Zugriff auf den Scanner zu erlauben, führen Sie das Backend über die Netzwerkschnittstelle aus (siehe saned(8) und sane-net(5)). Eine (sicherheitsmäßig) entspanntere Lösung besteht darin, der Oberfläche das Suid-Bit hinzuzufügen (siehe chmod(1)). Das Backend gibt die Root-Berechtigungen so schnell wie möglich ab, direkt nach dem Erlangen des Zugriffs auf die E/A-Schnittstellen, wodurch das Risiko der Ausführung als Root reduziert wird.

GERÄTENAMEN
Dieses Backend erwartet Gerätenamen der folgenden Form:

    Port Wert

Hierbei ist Wert:

    auto
        Alle Parallel-Ports werden automatisch erkannt und auf Scanner untersucht.

    safe-auto
        Alle Parallel-Ports werden automatisch erkannt und auf Scanner untersucht, allerdings wird kein direkter Hardware-Zugriff versucht.

    /dev/ppi0
        Verwendet *BSD-ppi-Geräte, abhängig von der Anzahl der verfügbaren Parallel-Ports müssen Sie /dev/ppi1, /dev/ppi2, … verwenden.

    /dev/parport0
        Verwendet Linux-ppdev-Geräte, abhängig von der Anzahl der verfügbaren Parallel-Ports müssen Sie /dev/parport1, /dev/parport2, … verwenden.

    0x378
        Verwendet direkten Hardwarezugriff auf die angegebene Adresse. Gewöhnliche Werte sind 0x378, 0x278, 0x3BC. In diesem Fall müssen Sie den Scanner als Root (*BSD und Linux) oder mit »IOPL=yes« unter OS/2 ausführen.

HINWEIS: In allen Fällen müssen Sie über ausreichende Berechtigungen für den Zugriff auf das ausgewählte Geräte oder die ausgewählte Adresse verfügen. Abhängig von den Sicherheitseinstellungen können Geräte nicht für alle Benutzer verfügbar sein. Sie müssen die Berechtigungen auf den Geräten /dev/ppi* oder /dev/parport* ändern.

Sie können jedes Gerät mit der Option

    name Gerätename
    model Modell
    vendor Lieferant

options. These options apply to the last port option.

KONFIGURATION
Please make sure to edit umax_pp.conf before you use the backend.

Der Inhalt der Datei umax_pp.conf ist eine Liste von Optionen und Gerätenamen, die Umax-Scannern entsprechen. Leere Zeilen und Zeilen, die mit einer Raute (#) beginnen, werden ignoriert.

The eight options supported are red-gain, green-gain, blue-gain, red-offset, green-offset, blue-offset, astra, and buffer. Options red-gain, green-gain and blue-gain allow you to adjust the sensitivity of your scanner for the given color. Values range from 0 (lowest gain) to 15 (highest). If the advanced option "Gain" isn't checked in the frontend, the backend does automatic gain calibration, and do not use user provided values.

Options red-offset , green-offset and blue-offset allow you to adjust the offset of your scanner for the given color. Values range from 0 (lowest offset) to 15 (highest).

Option astra allows you to change the model of your scanner. Current auto detection is based on side effects on scanning when using 1220P command set on other models, so it may fail on unknown hardware combination. Valid values are 610, 1220, 1600 and 2000. It is useful only when autodetection fails to detect properly your scanner model. If your scanner work properly but is reported wrongly, let it be that way. The only valid case to change the model is when your scanner produces "black" or "inverted" scans. In this case you can put the model. Be aware that it will prevent scanner model autodetection.

Option buffer allows you to change the size of the scan buffer. The size must be specified in bytes. The default value is 2 megabytes. Decreasing this value will improve the smoothness of progress bar in the frontend, but will stall the scan more often.

DATEIEN

/etc/sane.d/umax_pp.conf
    Die Backend-Konfigurationsdatei (siehe auch die nachfolgende Beschreibung von SANE_CONFIG_DIR).

/usr/lib/sane/libsane-umax_pp.a
    Die statische Bibliothek, die dieses Backend implementiert.

/usr/lib/sane/libsane-umax_pp.so
    Die dynamische Bibliothek, die dieses Backend implementiert (auf Systemen verfügbar, die dynamisches Laden unterstützen).

UMGEBUNGSVARIABLEN

SANE_CONFIG_DIR
    Diese Umgebungsvariable gibt eine Liste von Verzeichnissen an, die die Konfigurationsdatei enthalten können. Unter UNIX 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_UMAX_PP
    Falls die Bibliothek mit Debug-Unterstützung kompiliert wurde, steuert diese Umgebungsvariable die Debug-Stufe für dieses Backend. Beispielsweise bewirkt ein Wert von 128 die Anzeige sämtlicher Debug-Ausgaben. Kleinere Werte reduzieren die Ausführlichkeit.

    level   debug output
    ------- ------------------------------
     0       nothing
     1       errors
     2       warnings & minor errors
     3       additional information
     4       debug information
     5       code flow (not supported yet)
     6       special debug information

SANE_DEBUG_UMAX_PP_LOW
    This variable sets the debug level for the SANE interface for the Umax ASIC. Note that enabling this will spam your terminal with some million lines of debug output.

    level   debug output
    ------- -------------------------------
     0       nothing
     1       errors
     8       command blocks
     16      detailed code flow
     32      dump datafiles
     255     everything

SIEHE AUCH
sane(7), sane-net(5), saned(8)

Für die neusten Fehlerbehebungen und Informationen schauen Sie auf
    http://umax1220p.sourceforge.net/

AUTOR
Stéphane Voltz <stef.dev@free.fr>

DANKSAGUNGEN
Support for the 610P has been made possible thank to an hardware donation by William Stuart.

FEHLERBERICHTE
If something doesn't work, please contact me. But I need some information about your scanner to be able to help you...

SANE-Version
    Run scanimage -V to determine this

die Version des Backends und Ihrer Scanner-Hardware
    Run SANE_DEBUG_UMAX_PP=255 scanimage -L 2>log as root. If you don't get any output from the sane-umax_pp backend, make sure a line "umax_pp" is included into your /etc/sane.d/dll.conf file. If your scanner isn't detected, make sure you've defined the right port address, or the correct device in your umax_pp.conf file.

der Name Ihres Scanners/Lieferanten
    auch eine hilfreiche Information. Bitte fügen Sie auch die optische Auflösung und den Lampentyp Ihres Scanners hinzu; beides kann 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, fügen Sie es bitte bei.

ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Mario Blättermann <mario.blaettermann@gmail.com> und Helge Kreutzmann <debian@helgefjell.de> erstellt. Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 (https://www.gnu.org/licenses/gpl-3.0.html) oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer (debian-l10n-german@lists.debian.org).