Skip to content

Latest commit

 

History

History
112 lines (90 loc) · 3.22 KB

install-sane.md

File metadata and controls

112 lines (90 loc) · 3.22 KB
Raw

Install SANE and imagemagick

  • Debian / Ubuntu / Raspbian: sudo apt install sane-utils imagemagick
  • Arch: sudo pacman -S sane

Raspberry Pi

Please note: USB-only scanners draw a lot of current relative to the Pi's available power. This manifested itself in unusual scans - technically valid images but with odd colours and block transforms. So I needed to switch and use a powered USB hub for my Canon LIDE 20. Because of my USB3.0 hub that in turn led to USB issues. If you encounter similar then see here.

Check SANE is working

You need to configure sane here - configuring sane is outside the scope of this document, although I have found that I didn't need to do anything. To check it's setup correctly see if scanimage -L shows a net scanner

scanimage -L

Should show: something like

device `net:localhost:plustek:libusb:001:004' is a Canon CanoScan N1240U/LiDE30 flatbed scanner

or

sane-find-scanner -q

This

found USB scanner (vendor=0x04a9 [Canon], product=0x220d [CanoScan]) at libusb:003:005

If you do not see the expected result then try each with sudo which really should work; this is a diagnostic approach, not a solution. If it does work then at least we have established it's not a hardware / driver issue.

There are a variety of approaches to fixing permissions according to what the underlying problem is:

  • Add current user to the scanner group
  • Add a udev rule for the scanner device. Use the vendorId:productId from lsusb and add to /etc/udev/rules.d/55-libsane.rules as ATTRS{idVendor}=="04a9", ATTRS{idProduct}=="220d", MODE="0666", GROUP="scanner", ENV{libsane_matched}="yes". Unplug / replug the scanner.

For QNAP NAS install [Works on QTS 4.2.2]

  • Install Entware
  • SSH into your NAS - e.g. use PuTTY as admin
  • Plug your scanner into a USB port
  • Type lsusb to check the scanner is attached
  • At the terminal type the following commands
    • opkg update
    • opkg install sane-frontends imagemagick sudo
  • Confirm installation typing...
    • sane-find-scanner -q
    • scanimage -L

Get permissions working

Pretend to be httpduser

sudo -i -u httpdusr

If (when) that fails you need to edit sudoers and try again

nano /opt/etc/sudoers

add

admin ALL=(ALL) ALL

Once you're httpdusr then ....

/opt/bin/scanimage -L

There are any number of problems you might face here. Your user probably won't have access to "scanimage" or usb devices or the sane.d directory. And you should probably do this with a group privilege.

This thread and that thread are really useful. The short version is to do this:

addgroup scanner
usermod -G scanner httpdusr
chgrp scanner /dev/usb/*
chmod g+rw /dev/usb/*
chgrp scanner /opt/bin/scanimage
chmod 644 /opt/etc/sane.d/*

Find out the bus and device of your scanner using lsusb ...

Bus 003 Device 003: ID 04a9:220d Canon, Inc. CanoScan N670U/N676U/LiDE 20

Then do this: chgrp scanner /proc/usb/{bus}/{dev} - so I did this:

chgrp scanner /proc/usb/003/003