Line 1: |
Line 1: |
− | Thank you to jaysee (IXUS) for his patience and help to the SANE's configuration
| + | {{Languages|SANE}} |
| | | |
− | Before installation, go to http://www.sane-project.org/sane-supported-devices.html to see if your scanner is supported.
| + | ==Information== |
| + | SANE stands for "Scanner Access Now Easy" and is an application programming interface (API) that provides standardized access to any raster image scanner hardware (flatbed scanner, hand-held scanner, video- and still-cameras, frame-grabbers, etc.) |
| + | {{#smeversion:smeserver-sane}} |
| + | For more information on SANE have a look at the [http://www.sane-project.org/ SANE project website] |
| | | |
− | On sme 7.3 the SANE's version is 1.0.14. (I compiled sane-1.0.17 for sme 7.3. There are many more drivers available. It will soon have a link here.)
| + | ===Supported scanners=== |
| + | For a list of supported scanners have a look at [http://www.sane-project.org/sane-supported-devices.html this page]. |
| | | |
− | == HOWTO install and use a scanner with SME 7.3 ==
| + | Note the SME 8 rpm uses [http://www.sane-project.org/sane-backends-1.0.18.html this page] |
| | | |
| + | Note the SME 9 rpm uses [http://www.sane-project.org/sane-backends-1.0.21.html this page] |
| | | |
− | Configuration of /etc/yum.conf for that it goes searching the rpms in centos.
| + | ==Server== |
| + | This is the installation of the server part, you will also need to install drivers on your clients as described in the [[#Client|Client]] section. |
| | | |
− | Put a 1 for base centos and a 1 for updates centos like this:
| + | ===Installation=== |
| + | ==== SME 8.X, 9.X==== |
| | | |
− | [base]
| + | Install SANE and required packages |
− | enabled=1
| + | |
− | mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=os
| + | yum --enablerepo=smecontribs install smeserver-sane |
− | name=CentOS - os
| |
− | gpgcheck=1
| |
− | enablegroups=0
| |
− | exclude=kernel kernel-smp kernel-xenU mkinitrd mdadm initscripts
| |
− | | |
− | [updates]
| |
− | enabled=1
| |
− | mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=updates
| |
− | name=CentOS - updates
| |
− | gpgcheck=1
| |
− | enablegroups=0
| |
− | exclude=kernel kernel-smp kernel-xenU mkinitrd mdadm initscripts
| |
| | | |
− | ----------------------
| + | ==== Finish the installation ==== |
| | | |
− | === Installation of sane ===
| + | then |
| + | expand-template /etc/xinetd.conf |
| + | expand-template /etc/services |
| + | expand-template /etc/hosts.allow |
| + | expand-template /etc/sane.d/saned.conf |
| | | |
| + | service xinetd restart |
| | | |
− | yum install sane-backends
| + | or if you prefer to restart your server |
| | | |
− | ---------------------- | + | signal-event post-upgrade; signal-event reboot |
− | === Test of your scanner (recognition and driver) ===
| |
| | | |
− | sane-find-scanner
| + | ====Testing the installation==== |
| + | =====Finding your scanner===== |
| + | After installation and reboot you should be able to find your scanner with the following command: |
| | | |
− | It searches your scanner.
| + | sane-find-scanner |
| | | |
− | example
| + | The output should look like this: |
| | | |
− | sane-find-scanner
| + | # No SCSI scanners found. If you expected something different, make sure that |
− |
| + | # you have loaded a SCSI driver for your SCSI adapter. |
− | # No SCSI scanners found. If you expected something different, make sure that
| + | # Also you need support for SCSI Generic (sg) in your operating system. |
− | # you have loaded a SCSI driver for your SCSI adapter.
| + | # If using Linux, try "modprobe sg". |
− | # Also you need support for SCSI Generic (sg) in your operating system.
| + | |
− | # If using Linux, try "modprobe sg".
| + | found USB scanner (vendor=0x04b8 [EPSON], product=0x010f [EPSON Scanner 010F], chip=LM9832/3) at libusb:001:002 |
− |
| + | # Your USB scanner was (probably) detected. It may or may not be supported by |
− | found USB scanner (vendor=0x04b8 [EPSON], product=0x010f [EPSON Scanner 010F], chip=LM9832/3) at libusb:001:002
| + | # SANE. Try scanimage -L and read the backend's manpage. |
− | # Your USB scanner was (probably) detected. It may or may not be supported by
| |
− | # SANE. Try scanimage -L and read the backend's manpage.
| |
| | | |
− | # Not checking for parallel port scanners.
| + | # Not checking for parallel port scanners. |
| | | |
− | # Most Scanners connected to the parallel port or other proprietary ports
| + | # Most Scanners connected to the parallel port or other proprietary ports |
− | # can't be detected by this program.
| + | # can't be detected by this program. |
− | | |
| | | |
− | scanimage -L
| + | =====Determining assigned driver===== |
| + | To see which hardware location is assigned to the scanner issue the following command: |
| | | |
− | it gives you the driver of your scanner if it is acknowledged by sane
| + | scanimage -L |
| | | |
− | example
| + | The output should look something like this: |
| | | |
− | scanimage -L
| + | device `plustek:libusb:001:002' is a Epson Perfection 1250/Photo USB flatbed scanner |
− | device `plustek:libusb:001:002' is a Epson Perfection 1250/Photo USB flatbed scanner
| |
| | | |
| + | =====Aquisition===== |
| | | |
− | '''If a driver is found, you can continue the configuration...'''
| + | To make a test scan you can issue the following command specifying the driver you determined in [[#Determining assigned driver|Determining assigned driver]]. |
− | | |
− | '''Otherwise make following order to remove the rpm : sane-backends'''
| |
− | | |
− | yum remove sane-backends
| |
− | | |
− | | |
− | ----------------------
| |
− | | |
− | === Test of your scanner: (Your first acquisition) ===
| |
| | | |
| + | scanimage -d drivername --format tiff -l 0 -t 0 -x 215 -y 297 > outfile.tiff |
| | | |
− | scanimage -d plustek:libusb:001:002 --format tiff -l 0 -t 0 -x 215 -y 297 > outfile.tiff
| + | Replace drivername with the driver determined in [[#Determining assigned driver|Determining assigned driver]], e.g.: |
| | | |
− | ‘plustek:libusb:001:002’ => to put what was found with the command scanimage -L
| + | scanimage -d plustek:libusb:001:002 --format tiff -l 0 -t 0 -x 215 -y 297 > outfile.tiff |
| | | |
− | ---------------------- | + | === Uninstall === |
| + | You can remove SANE from your SME Server with the following command |
| + | rpm -e sane-backends sane-backends-libs smeserver-sane |
| | | |
− | === you can see the resolution of your scanner with this command === | + | ==Client== |
| | | |
− | /usr/bin/scanimage --help | grep -m 1 resolution
| + | ===Windows XP and Vista=== |
− | | |
− | For more informations on sane-backends possibilities:
| |
− | | |
− | man sane
| |
− | | |
− | ----------------------
| |
− | | |
− | === configuration to put the scanner on your network === | |
− | | |
− | saned is the SANE daemon. It gives an access to the image acquisition device available on the local host to remote clients.
| |
− | | |
− | ----------------------
| |
− | | |
− | ====Updating of /etc/hosts.allow for sane====
| |
− | | |
− | Make in /etc/ hosts.allow a line with template-custom
| |
− | | |
− | mkdir /etc/e-smith/templates-custom/etc
| |
− | mkdir /etc/e-smith/templates-custom/etc/hosts.allow/
| |
− | | |
− | nano /etc/e-smith/templates-custom/etc/hosts.allow/saned
| |
− | =>
| |
− | saned: 127.0.0.1 10.97.1.0/255.255.255.0
| |
− | | |
− | (10.97.1.0 => your ip)
| |
− | | |
− | /sbin/e-smith/expand-template /etc/hosts.allow
| |
− | | |
− | ----------------------
| |
− | | |
− | ====Updating of /etc/services for sane====
| |
− | | |
− | Make in /etc/services a line with template-custom
| |
− | | |
− | mkdir /etc/e-smith/templates-custom/etc/services/
| |
− | | |
− | nano /etc/e-smith/templates-custom/etc/services/saned
| |
− | =>
| |
− | sane 6566/tcp # SANE network scanner daemon
| |
− | | |
− | /sbin/e-smith/expand-template /etc/services
| |
− | | |
− | ------------------------
| |
− | | |
− | ====Add the ip’s addresses of the computers which are authorized to use the scanner====
| |
− | | |
− | nano /etc/sane.d/saned.conf
| |
− | =>
| |
− | localhost
| |
− | adress-ip_customer1
| |
− | adress_ip_customer2
| |
− | | |
− | | |
− | ---------------------
| |
− | | |
− | ===INSTALLATION and CONFIGURATION of SANETWAIN on windows platforms===
| |
− | | |
− | ====Installation of SANETWAIN====
| |
| | | |
| http://sanetwain.ozuzo.net/ | | http://sanetwain.ozuzo.net/ |
| | | |
− | In download section, take the ZIPfile (sanetwain127.zip or Windowsinstaller (setup127.exe) | + | In download section, take the ZIP file (sanetwain127.zip and Windowsinstaller (setup127.exe) |
− | | |
− | make :
| |
− | setup127.exe
| |
| | | |
− | ====CONFIGURATION==== | + | ====Configuration==== |
| | | |
| - index connection | | - index connection |
− | Hostname => address ip server | + | :Hostname => address ip server |
− | Port => 6566 | + | :Port => 6566 |
− | Username => user’s name | + | :Username => user’s name |
| | | |
| I made : Get list of devices on startup | | I made : Get list of devices on startup |
| | | |
| - index printer | | - index printer |
− | I made : Show printer setup dialog before print | + | :I made : Show printer setup dialog before print |
− | (I have several printers!) | + | :(I have several printers!) |
| | | |
| - index Startup | | - index Startup |
− | I made : Acquire preview on program start | + | :I made : Acquire preview on program start |
− | Use as interface language => fr | + | :Use as interface language => fr |
| + | |
| + | ====Usage==== |
| + | SANE TWAIN drivers have many possibilities. SANE TWAIN drivers can be used alone or called from another application (photoshop, acrobat, ...) like a classical usb scanner. |
| | | |
− | ====UTILISATION==== | + | ===MacOS X=== |
| + | SANE can also be installed on MacOS X, for more information have a look at |
| + | http://www.ellert.se/twain-sane/. |
| | | |
− | SANETWAIN has many possibilities...
| + | If you get things working on MacOS X please provide installation instructions here. |
| | | |
− | Sanetwain can be used alone or called from another application (photoshop, acrobat, ...) like a classical usb scanner.
| + | ===Linux=== |
| + | To use SANE on your linux PC you need to install the xsane package. |
| | | |
| + | ====Configuration==== |
| + | Then configure xsane so that it knows where to find the server with the scanner attached, add a line with the IP address of your server to /etc/sane.d/net.conf on your client PC |
| | | |
− | ----------------------- | + | nano -w /etc/sane.d/net.conf |
| + | |
| + | IP_address_of_your_server |
| | | |
− | ===First test on network=== | + | ====Usage==== |
| | | |
− | Start a terminal on your server (with putty for example). | + | You can use kooka or xsane or make the acquisition from other software for instance OpenOffice or GIMP. |
− | make :
| + | |
− | saned -d128
| + | ===Client Troubleshooting=== |
| + | {{Incomplete}} |
| + | Only needed if your client can't find the scanner |
| + | |
| + | Disable saned |
| + | /etc/init.d/xinetd stop |
| + | or |
| + | config setprop saned status disabled |
| + | /sbin/e-smith/expand-template /etc/xinetd.conf |
| + | /etc/init.d/xinetd restart |
| + | |
| + | Start a terminal on your server. |
| + | saned -d128 |
| | | |
| example | | example |
| # saned -d128 | | # saned -d128 |
| [saned] main: starting debug mode (level 128) | | [saned] main: starting debug mode (level 128) |
− | [saned] main: trying to get port for service `sane-port' (getaddrinfo) | + | [saned] main: trying to get port for service `sane-port' (getaddrinfo) |
− | [saned] main: "sane-port" service unknown on your host; you should add
| |
− | [saned] main: sane-port 6566/tcp saned # SANE network scanner daemon
| |
− | [saned] main: to your /etc/services file (or equivalent). Proceeding anyway.
| |
| [saned] main: [0] socket () using IPv4 | | [saned] main: [0] socket () using IPv4 |
| [saned] main: [0] setsockopt () | | [saned] main: [0] setsockopt () |
Line 205: |
Line 156: |
| [saned] main: waiting for control connection | | [saned] main: waiting for control connection |
| | | |
− | If you have “waiting for control connection “, all sounds good. Now on your windows computer, open Scanimage (name of gui software for sanetwain) | + | If you have “waiting for control connection “, all sounds good. Now on your scanning software, eg Scanimage (name of gui software for sanetwain) |
| | | |
− | The scanner should start and lines should appear in the terminal (putty) | + | The scanner should start and lines should appear in the terminal. |
| | | |
| On the first connection, it often takes a long time and a message like this can appear: Time out reading word from socket | | On the first connection, it often takes a long time and a message like this can appear: Time out reading word from socket |
Line 214: |
Line 165: |
| Restart ' saned - d128 ' on the terminal and open Scanimage one more time, it should scan! | | Restart ' saned - d128 ' on the terminal and open Scanimage one more time, it should scan! |
| Lines are displayed on the terminal with putty. (type -d for debug mode) | | Lines are displayed on the terminal with putty. (type -d for debug mode) |
− |
| |
− | -----------------------
| |
− |
| |
− | ===Now automatize the saned startup===
| |
− |
| |
− | If xinetd is not installed :
| |
− |
| |
− | yum install xinetd
| |
− |
| |
− | Updating of /etc/xinetd.conf for sane
| |
− |
| |
− | Make in /etc/xinetd.conf a block with template-custom
| |
− |
| |
− | mkdir /etc/e-smith/templates-custom/etc/xinetd.conf/
| |
− |
| |
− | Create a users group where users are going to use the scanner
| |
− | I add a group, saned, with server-manager.
| |
− |
| |
− | nano /etc/e-smith/templates-custom/etc/xinetd.conf/20sane-port
| |
− | =>
| |
− | {
| |
− |
| |
− | $OUT = <<HERE;
| |
− |
| |
− | service sane
| |
− | {
| |
− | port = 6566
| |
− | socket_type = stream
| |
− | protocol = tcp
| |
− | user = root
| |
− | group = saned
| |
− | wait = no
| |
− | server = /usr/sbin/saned
| |
− | }
| |
− | HERE
| |
− | }
| |
− |
| |
− | /sbin/e-smith/expand-template /etc/xinetd.conf
| |
− |
| |
− | Make a link to allow xinetd to start during the server startup
| |
− | ln -s /etc/init.d/xinetd /etc/rc.d/rc7.d/S50xinetd
| |
− |
| |
− | /etc/init.d/xinetd restart
| |
− |
| |
− |
| |
− | -----------------------
| |
| | | |
| The first time, I didn’t succeed to use the scanner on my windows computer when using sanetwain | | The first time, I didn’t succeed to use the scanner on my windows computer when using sanetwain |
Line 269: |
Line 174: |
| I put in comment (# in front of the line) all lines which did not correspond to my driver. | | I put in comment (# in front of the line) all lines which did not correspond to my driver. |
| | | |
− | -----------------------
| + | Enable saned when finished |
− | | + | /etc/init.d/xinetd start |
− | ===With MacOS X plateform===
| + | or |
− | | + | config setprop saned status enabled |
− | There would also be the possibility to use sane.
| + | /sbin/e-smith/expand-template /etc/xinetd.conf |
− | | + | /etc/init.d/xinetd restart |
− | It has links on the sanetwain site => http://www.ellert.se/twain-sane/
| + | === Bugs === |
− | | + | Please raise bugs under the SME-Contribs section in {{BugzillaFileBug|product=|component=|title=bugzilla}}and select the smeserver-sane component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-sane|title=this link}}. |
− | To test...
| + | {{#bugzilla:columns=id,product,version,status,summary |sort=id |order=desc |component=smeserver-sane |noresultsmessage="No open bugs found."}} |
− | | + | ---- |
− | I doesn’t have a mac
| + | [[Category:Contrib]] |
− | | + | [[Category:Administration]] |
− | -----------------------
| |
− | | |
− | ===With linux platform===
| |
− | | |
− | It’s necessary to install xsane (already installed on my pc).
| |
− | | |
− | It’s enough to configure xsane so that it achieves the scanner on the server.
| |
− | | |
− | nano /etc/sane.d/net.conf (sur le pc client)
| |
− | =>
| |
− | address-ip_server
| |
− | | |
− | You can use xsane or make the acquisition from a software (openoffice, gimp, ...)
| |
− | | |
− | ----------------------- | |
− | | |
− | ===After installation=== | |
− | | |
− | Configuration of /etc/yum.conf
| |
− | | |
− | Put a 0 for base centos and a O for updates centos like this:
| |
− | | |
− | [base]
| |
− | enabled=0
| |
− | mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=os
| |
− | name=CentOS - os
| |
− | gpgcheck=1
| |
− | enablegroups=0
| |
− | exclude=kernel kernel-smp kernel-xenU mkinitrd mdadm initscripts
| |
− |
| |
− | [updates]
| |
− | enabled=0
| |
− | mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=updates
| |
− | name=CentOS - updates
| |
− | gpgcheck=1
| |
− | enablegroups=0
| |
− | exclude=kernel kernel-smp kernel-xenU mkinitrd mdadm initscripts
| |