SANE/Scanner-specific problems - ArchWiki

Jump to content

# SANE/Scanner-specific problems

From ArchWiki
< SANE

This article contains scanner or manufacturer-specific instructions for SANE.

## Agfa

### Snapscan e40

Firmware `Snape40.bin` from here[dead link 2024-10-12—HTTP 404] is required.

If USB autosuspend is enabled, the printer may need to be turned off and on again before each scan.

Tip USB autosuspend can be disabled manually, or using powertop, TLP, or Laptop Mode Tools.

## BenQ/Acer

If you own an USB scanner from Acer (now BenQ), you need to download a suitable firmware binary and configure `/etc/sane.d/snapscan.conf`.

- Find out which model you own and take note of the USB ID:

    $ lsusb

    Bus 002 Device 010: ID 04a5:20b0 Acer Peripherals Inc. (now BenQ Corp.) S2W 3300U/4300U

- Go to snapscan main page and see whether your scanner is supported and which firmware you need (e.g, `u176v046.bin`).
- Search the firmware image on the Internet and download it to `/usr/share/sane/snapscan/`.
- Edit the head of `/etc/sane.d/snapscan.conf` and configure the following two lines:

    firmware /usr/share/sane/snapscan/u176v046.bin
    /dev/usb/scanner0 bus=usb

## Brother

In order to install a Brother scanner or printer/scanner combo you need the right driver. To find the right one, see the FAQ for your model at the Brother Support, i.e. Home > Country > Your model > FAQs & Troubleshooting > Linux > Scanner / Scan Key Tool > Scan using XSane or GIMP. You can also search the web. Or see the information below for more scanners. Or extract each of the AUR packages below. Each package seems to contain an exhaustive list of the models it is suitable to.

Then, install the appropriate package:

- brscan2AUR
- brscan3AUR
- brscan4AUR (MFC-J5620DW)
- brscan5AUR
- libsane-dsseriesAUR

Now, the scanner should be recognized by SANE.

For network scanners, Brother provides a different configuration tool for each brscan version (e.g., brsaneconfig2 for brscan2 compatible devices):

    # brsaneconfig2 -a name=ScannerName model=ScannerModel ip=ScannerIP

Example:

    # brsaneconfig2 -a name=SCANNER_DCP770CW model=DCP-770CW ip=192.168.0.110

To get the IP and node name of your scanner, you can use Nmap:

    $ nmap -sP 10.0.0.0/24

It's also possible to add a scanner via its node name instead of its IP, for example:

    # brsaneconfig4 -a name=Brother_DCP-L3550CDW model=DCP-L3550CDW nodename=BRWC0B5D72A0B87

### Network Scanning

In case of network scanning, e.g. by Wi-Fi, Sane may still be unable to find the scanner. If so, you need to specify the IP address of the scanner in the `/etc/sane.d/net.conf` file.

Now use `scanimage --list-devices` to check whether sane is able to find your scanner. If not, further check that Sane expects this device through the network (see [1][dead link 2023-05-06—HTTP 401]). Check that `/etc/sane.d/dll.conf` contains `brotherX`, where the `X` stands for the brscan version from above. If nothing was found, add `brotherX` to the end of the file.

### Invalid argument

If all the necessary packages are installed but you still get the "invalid argument" error this could mean that the configuration file has been corrupted. Run the following command (in case of brscan4):

    # brsaneconfig4 -d

The output should narrow down the problem. Most likely the connection is not set up correctly. In case of a network scanner, check if the IP address is right by opening `/etc/opt/brother/scanner/brscan4/brsanenetdevice4.cfg` with an editor. In case of a USB connection, check if the path to the scanner in the configuration file is set up correctly. For that, compare the values of the `lsusb` command with your configuration file and change them if necessary. You might also try to follow the `brotherX` suggestion from Network Scanning above even for non-network scanners.

### Scan-key-tool

Brother has released a tool to enable scanning to be triggered by user interaction with the scanner itself (e.g., by selecting one of "Scan to email", "Scan to image", etc. on the scanner's keypad) rather than by an attached computer. This can be set up by installing the brscan-skeyAUR package and starting `brscan-skey.service` using systemd. Note that by default this service runs as the brscan-skey user which is created by the package, whose home directory is located at `/srv/brscan-skey`.

Brother supplies some default scripts that are executed when a scan type is selected on the keypad. These may require the installation of some optional dependencies of the brscan-skeyAUR package. For all options apart from "Scan to email" the resulting output can be found inside `$HOME/brscan`, with `$HOME` the home directory of the user running this tool (so `/srv/brscan-skey` if started via systemd as a systemwide process).

It is possible to change what action takes place when a given type of scan is selected on the keypad. This is done by editing `/opt/brother/scanner/brscan-skey/brscan-skey.config`. For each variable `SCAN_COMMAND` in `IMAGE`, `OCR`, `EMAIL`, `FILE`, the command

    $ $SCAN_COMMAND $SCANNER_DEVICE $SCANNER_FRIENDLY_NAME

is executed when the corresponding scan type is selected. Note that `$SCAN_COMMAND` is not quoted so may specify more than one positional parameter in the final command that is executed. `$SCANNER_DEVICE` refers to the name of the device that should be specified to a sane frontend (e.g. via the `--device-name` flag when using `scanimage`), for example `brother3:bus4;dev2`. `$SCANNER_FRIENDLY_NAME` is the human-readable name of the scanner.

### xsane crashes

The factual accuracy of this article or section is disputed.

Reason:

- Should be mentioned on AUR page
- This may only be relevant for the Brother DCP-150C scanner

(Discuss in Talk:SANE/Scanner-specific problems)

If xsane crashes with message "`=bugchk_free(ptr==(nil))@brother_modelinf.c(482)`", then you need to create the link `/usr/local/Brother -> /usr/share/brother`.

## Canon

### Scanning over the network with Canon PIXMA or imageCLASS all-in-one printer/scanners

Find out your printer/scanner's IP address, and add it on a new line to `/etc/sane.d/pixma.conf` in the format `bjnp://10.0.0.20`. For imageCLASS printers you may need to use the format `mfnp://10.0.0.20` instead.

Tip Instead of an IP address, if mDNS resolution is set up, you can use the mDNS `.local` address. E.g. `bjnp://MyPixmaPrinter.local`.

Sane should now find your device. For more details refer to sane-pixma(5).

Alternatively, scangearmp2AUR can be used for some Canon PIXMA all-in-one printer/scanners which are not detected over the network.

### Scanning over the network with the eSCL protocol for Canon MAXIFY printer/scanners

As mentioned in the sane-pixma documentation sane-pixma(5), Canon seems to be dropping support the BJNP and MFNP protocols in recent scanners. As an alternative, you could try using the eSCL protocol for scanning over the network. To do so, find your printer/scanner's IP address and add a new line to the `/etc/sane.d/escl.conf` configuration file, using the format `device https://your-scanners-ip:443 "your-scanner-model"`. The scanner model is used as an identifier, for example the command `scanimage -L`.

Tip

- If `device https://your-scanners-ip:443 "your-scanner-model"` does not work, try `device http://your-scanners-ip:80 "your-scanner-model"`.
- If `scanimage -L` returns something along the lines of `device `escl:https://your-scanners-ip:443' is a ESCL your-scanner-model flatbed or ADF scanner`, you can perform a test scan using `scanimage --device-name "escl:https://your-scanners-ip:443" --mode Color --format png > test-scan.png`.

## Epson

### Driver-Backends

For Epson scanners, you can choose between two different backends: "Image Scan v3" (imagescanAUR/utsushi) or "Image Scan! for Linux" (iscanAUR/epkowa). A list of supported devices exists for imagescan/utsushi and iscan/epkowa.

#### Image Scan v3

If you have to use Image Scan v3-backend you can install imagescanAUR. It should detect supported USB scanners automatically by default. If your scanner is not recognized you can directly edit the `/etc/utsushi/utsushi.conf` and add the following lines.

    [devices]
    dev1.udi     = esci:usb:vendor_id:product_id
    dev1.name    = foo
    dev1.model   = Model Name of the scanner

If you want to make use of a network scanner you also have to install imagescan-plugin-networkscanAUR. Then edit `/etc/utsushi/utsushi.conf` and enter the ip address of your scanner to it.

    [devices]
    myscanner.udi    = esci:networkscan://ip-address-here:1865
    myscanner.vendor = Epson
    myscanner.model  = Model-name

When you then start Image Scan v3 by typing in the command

    $ utsushi

the name of the scanner should be visible in the top left corner. If a connection problem happened, an error dialog will be shown.

#### Image Scan! for Linux

- Install the iscanAUR package.
- Install the appropriate iscan-plugin package for your scanner (for example, iscan-plugin-gt-x820AUR for the Epson Perfection Photo V600)
- Run `udevadm control --reload` so that udev will recognize the device as a scanner and apply appropriate permissions.

For network (including Wi-Fi) scanners, install iscan and iscan-plugin-networkAUR, then edit `/etc/sane.d/epkowa.conf` and add a line of the following format:

    net <IP-address|hostname> [port-number]

Upstream version of iscan did not support 16bpc color depth scanning. Choosing any bit depth other than 8 made iscan stop without warning, leaving the scanner stuck until restarted. To enable 16bpc scanning, iscan used to required to be patched. It could be that an old patch, found in this forum thread, will enable 16bpc depth mode.

### Epson DS-6500

Usually this device works with the epsonds-backend. However, there may be an error "Error during device I / O" when scanning multiple pages. If this error occurs, the Image Scan v3 backend can be used and imagescanAUR needs to be installed. If you want to use the network module, the scanner can be configured in the `/etc/utsushi/utsushi.conf` after installing imagescan-plugin-networkscanAUR as described above.

### Epson Perfection V39

This device (vendor id: 0x04b8, device id: 0x013d) is known to be supported by SANE's epkowa backend. To use this backend, install iscan-dataAUR, iscanAUR and iscan-plugin-gt-s650AUR.

The latter package provides the firmware `/usr/share/iscan/esfw010c.bin` which is required to make the scanner work.

In case of a successful device setup, running `scanimage -L` results in:

- the scanner waking up and performing some movements,
- a constantly shining blue led at the device's front, and
- output similar to `device `epkowa:interpreter:001:007' is a Epson Perfection V39 flatbed scanner`.

In some cases, the above fails due to improper firmware, provided by iscan-plugin-gt-s650AUR.

Note Symptoms of incorrect firmware:

- the blue device led blinks endlessly,
- `scanimage -d device_name` fails with `scanimage: sane_start: Invalid argument`.

As stated in this forum thread, using the firmware `esfw010c.bin` provided by epsonscan2-non-free-pluginAUR can solve the problem. There seem to exist different incompatible versions of the same firmware.

### Epson Perfection V39II

This model, despite the name, is quite different than the Perfection V39. As of July 2025, avoid iscan and from the AUR install epsonscan2AUR, bbeAUR and epsonscan2-non-free-pluginAUR.

### Epson Perfection V550 Photo

Install iscan-plugin-perfection-v550AUR

### Epson Perfection 1270

For Epson Perfection 1270, you also need a firmware named `esfw3e.bin`. It can be obtained by installing the Windows driver.

Modify the configuration file of the snapscan backend, `/etc/sane.d/snapscan.conf`. Change the firmware path line with yours:

    # Change to the fully qualified filename of your firmware file, if
    # firmware upload is needed by the scanner
    firmware /mnt/mydata/Backups/firmware/esfw3e.bin

And add the following line in the end or anywhere you like

    # Epson Perfection 1270
    usb 0x04b8 0x0120

You can get such code information (`usb 0x04b8 0x0120`) by sane-find-scanner command.

Also add such information lines to `/etc/hotplug/usb/libsane.usermap` to setup your privilege, like:

    # Epson Perfection 1270
    libusbscanner 0x0003 0x04b8 0x0120 0x0000 0x0000 0x00 0x00 0x00 0x00 0x00 0x00 0x00000000

Replug scanner, you have a working Epson Perfection 1270 now.

Note I can scan image if I define the X and Y value, but without that error message occurs like: `scanimage: sane_start: Error during device I/O`, if anyone knows any other reasons, please add them to this section.

To prevent `scanimage: sane_start: Error during device I/O` and hangup of the scanner itself, when trying to scan with ADF (automatic document feed) enabled, I had to remove or comment out all Backends from `/etc/sane.d/dll.conf` and instead just add this to the file:

    snapscan

If you still get the `Error during device I/O` messages check that the transportation lock of the scanner (on the bottom of the scanner) is open.

### Epson Perfection 1670/2480/2580/3490/3590

Note Installation instructions were only tested for Epson Perfection 3590 but should be similar to the other models. Check the instructions above and the links below and edit this wiki page if you can verify that your scanner works.

Make sure to download the correct firmware for your Epson model. You can get an overview of some models and their drivers here and here. The download links of the firmware are broken, but you can use this link as alternative instead. Make sure to change the firmware filename of the link suiting your model. If you want to download and extract the firmware sources from the official epson sites yourself you can use this guide.

As an alternative you can also install the AUR package sane-epson-perfection-firmwareAUR which will download the firmware from the official sources, extract the binary and install those to `/usr/share/sane/snapscan/`.

Modify the configuration file of the snapscan backend, `/etc/sane.d/snapscan.conf`. Change the firmware path line with yours:

    # Change to the fully qualified filename of your firmware file, if
    # firmware upload is needed by the scanner
    firmware /usr/share/sane/snapscan/esfw52.bin

Other modifications were not needed for the Epson Perfection 3590 and might not be for other models as well. If you still have problems it can also help if you completely remove the iscanAUR package.

### EPSON WorkForce printer/scanners over the network

Install imagescanAUR and imagescan-plugin-networkscanAUR.

Edit the configuration file `/etc/utsushi/utsushi.conf`. Find the `[devices]` section and edit the template for `dev2`. Replace the IP address accordingly. You can find the IP address on your printer screen. For example,

    ...
    dev2.udi    = esci:networkscan://192.168.1.123:1865
    dev2.model  = WF-2860
    dev2.vendor = EPSON
    ...

Meanwhile, comment out `epson2` in `/etc/sane.d/dll.conf` as it conflicts with ImageScan.

Once this is done you can use any SANE frontend to access this scanner.

## Fujitsu

### Fujitsu fi series

For some of the Fujitsu fi series document scanners, the pfufsAUR proprietary driver offers advanced functionality over the already mature SANE default driver, such as control of an optional imprinter for stamping scanned documents or requesting accurate status of the consumables from the host.

### ScanSnap S300/S300M/S1100/S1300

For the operation of the ScanSnap scanners a firmware file is required, which can be downloaded from here or extracted from the Windows driver. Get the files that you need and put them in the `/usr/share/sane/epjitsu` directory, which should be created if it does not exist. For instance, you should end up with a file called `/usr/share/sane/epjitsu/1100_0B00.nal`. These files should be owned by the root user.

To make sure that you have the right file in the right place, take note of the device ID:

    # sane-find-scanner
    found possible USB scanner (vendor=0x04c5 [FUJITSU], product=0x1200 [ScanSnap S1100]) at libusb:003:011

There should be a corresponding entry in `/etc/sane.d/epjitsu.conf`, such as `usb 0x04c5 0x1200`, which in turn should reference the path of the firmware file that you just added.

For the S300/S300M scanners, the `300M_0C00.nal` and `300_0C00.nal` files are interchangeable; the S300 device can use the `300M_0C00.nal` file and the S300M device can use the `300_0C00.nal` file. The file can be renamed to fit the entry in `/etc/sane.d/epjitsu.conf`, or that entry can be edited to match the file name.

Alternative download locations for the firmware files: here and here.

Commands to fetch and install the firmware:

     # git clone https://github.com/stevleibelt/scansnap-firmware.git
     # mkdir -p /usr/share/sane/epjitsu
     # cp scansnap-firmware/*.nal /usr/share/sane/epjitsu

## HP

If your HP device is supported by hplip, install the hplip package.

It comes with several tools:

- hp-setup to add and setup the device
- hp-check to check the installation of all required dependencies to successfully run (a very helpful tool)
- hp-plugin is the 'HPLIP Plugin Download and Install Utility' (plugin also available from hplip-pluginAUR).
- hp-scan is the 'HPLIP Scan Utility'. If you need that tool, you will need to install python-pillow.

hp-setup runs in GUI mode by default, which requires python-pyqt5. You can run the CLI by using the `-i` flag.

If the device is connected by USB, run hp-setup as root and follow the on-screen instructions.

If your device is connected on the network, use `hp-setup printer_ip` instead.

### Alternative way to scan with network HP scanner

- Find out IP address of your network HP scanner, for example 192.168.1.8
- Make device URI using hp-makeuri utility:

    $ hp-makeuri 192.168.1.8

    hpaio:/net/DeskJet_3630_series?ip=192.168.1.8

- This URI could be given to xsane or scanimage tools, for example:

    $ xsane "hpaio:/net/DeskJet_3630_series?ip=192.168.1.8"
    $ scanimage --device "hpaio:/net/DeskJet_3630_series?ip=10.12.129.6" --format=png --resolution 300 >scan01.png

## Lexmark

For Lexmark devices printing issues, please read CUPS/Printer-specific problems#Lexmark.

Most Lexmark scanners are still (2019) not supported by SANE, and thus cannot be detected either by `sane-find-scanner` or by `scanimage -L`. Lexmark provides a non-free driver for GNU/Linux, which is supposed to support all its scanners. Nevertheless, the driver is only distributed for Debian, OpenSUSE, Fedora and Red Hat, but not for Arch. Here is a way to install it.

### Warning

Before following these steps, note that:

- This driver is non-free (copyrighted by Lexmark)
- This hasn’t been widely tested yet (but the driver is supposed to work for all Lexmark scanners)
- The tree does not respect Arch standards — namely, all will be installed in `/usr/local`; you’ll get a `/usr/lexmark/` symbolic link; and get symbolic links to the files installed in `/usr/local/lexmark`.
- This process might generate conflicts if you’ve already installed some Lexmark drivers.

### Process

1. Ensure Java is installed.
2. Download the `.deb` file[dead link 2021-11-19—HTTP 404] containing the driver and save it (eg at `~/lexmark.deb`).

#### Option 1 : using DPKG

dpkg is the standard package-manager for Debian-based distributions. It should not be used to replace `pacman` unless you precisely know what you’re doing. Simply run as root

    # dpkg -i lexmark.deb

Your scanner should be detected after reboot.

#### Option 2 : manual installation

Alternatively, if you dont want to install dpkg or wish to control exactly what is done during install, you can follow these instructions (assuming you’re working in `~`). Please note that `md5` sums will not be checked, which could cause security issues.

1. Extract the `~/lexmark.deb` archive, running `ar x lexmark.deb`. File `debian-binary` can be dropped.
2. Extract both `~/control.tar.gz` and `~/data.tar.gz` archives.
3. `data.tar.gz` gives a `~/usr/` directory. As root, move `~/usr/local/lexmark` to `/usr/local/lexmark`.
4. As root, run `~/control/postinst` to perform install. This script will automatically set all files owners an `chmod`, then set some fonts, drivers and docs tricks. It will also eventually run `/usr/local/lexmark/network-scan.link`, creating several symbolic links in your Arch architecture.
5. Your scanner should be detected after reboot.

#### Option 3 : Using AUR package

Install the lexmark-network-scanAUR package.

### Supported devices

This process has been successfully tested for the following devices:

- Lexmark MB2236 (USB only; network untested).
- Lexmark MX517de (network only; USB untested).
- Lexmark X204n (network only; USB untested).

### To do

In order to improve Lexmark scanners support, you can:

- Check whether this process works for your computer and device
- Help defining the list of dependencies required for this process
- Create an AUR package with this driver which installation would not mess architecture up. Namely, such a package should not need to create a `/usr/lexmark` symlink, and should be containerized (eg in `/opt/lexmark`).

## Medion

If you own the USB scanner MD 9705 from Medion, you need to download a suitable firmware binary. This firmware file is in the device driver for Windows.

Find out which model you own and take note of the USB ID:

    $ lsusb

    Bus 006 Device 007: ID 05d8:4003 Ultima Electronics Corp. Artec E+ 48U

Download the windows driver from https://download.medion.com/downloads/treiber/scamd9705w9xxp.exe

Then enter the following commands to extract the firmware file, and copy it to the location SANE expects it:

    $ unzip scamd9705w9xxp.exe Win2000/Artec48.usb
    # cp Win2000/Artec48.usb /usr/share/sane/artec_eplus48u/Artec48.usb

## Mustek

### BearPaw 2400CU

Works with sane-gt68xx (sane-gt68xx-firmware)

## Samsung

For some Samsung MFP printers you may need to edit `/etc/sane.d/xerox_mfp.conf`.

Example entry:

    #Samsung SCX-3200
    usb 0x04e8 0x3441

Change the printer model as needed. You can get the idVendor and idProduct code with `lsusb`. See this thread.

To access the scanner over the network rather than the usb interface, add a line to `/etc/sane.d/xerox_mfp.conf` such as

    #Samsung scx4500w wireless IP network address
    tcp xx.xx.xx.xx

where `xx.xx.xx.xx` is the static IP address of the printer.

Category:

- Digital imaging

Hidden categories:

- Pages with dead links
- Pages or sections flagged with Template:Accuracy

SANE/Scanner-specific problems
Add topic