1,423
edits
Changes
Some small fixes and corrections and Syntax Highlight was enabled
{{header_en|title=Installing Image Scan on a 32 bit Slackware Linux distribution| keyword={{Template:keyword_en_iscan}}| description=Building, installing and configuring a 32 bit Image Scan package on Slackware Linux 13.1 | link_page=iscan_software}}
Iscan is the short form for '''Image Scan''' a scanner utility that runs under Linux. It's an [http://avasys.jp/eng/ Avasys Corporation] product useful to obtain high quality images with Epson scanners or multifunction laser/inkjet printers. Many Epson scanners work under Linux only by mean of '''Iscan''' and it's related Avasys provided '''proprietary drivers'''.
Iscan is the short form for '''Image Scan''' a scanner utility that runs under Linux. It's an [http://avasys.jp/eng/ Avasys Corporation] product useful to obtain high quality images with Epson scanners or multifunction laser/inkjet printers. Many Epson scanners work under Linux only by mean of '''Iscan''' and it's related Avasys provided '''proprietary drivers'''.
= '''Iscan release 2.11 and earlier''' =
= '''Iscan Release 2.11 and Earlier''' =
== '''Software build''' ==
== '''Software Build''' ==
Download binary archive iscan.tar.gz from web site www.slackbuilds.org into the /tmp directory of your system.
Download binary archive iscan.tar.gz from web site www.slackbuilds.org into the /tmp directory of your system.
Start a '''root''' shell and decompress the archive by running:
Start a '''root''' shell and decompress the archive by running:
root@darkstar04:/root# cd /tmp
root@darkstar04:/root# '''cd''' /tmp
root@darkstar04:/tmp# tar -zxf iscan.tar.gz
root@darkstar04:/tmp# '''tar''' ''-zxf'' iscan.tar.gz
A directory named "iscan" will be created. Enter the directory and list its contents:
A directory named "iscan" will be created. Enter the directory and list its contents:
root@darkstar04:/tmp# cd iscan
root@darkstar04:/tmp# '''cd''' iscan
root@darkstar04:/tmp/iscan# ls -la
root@darkstar04:/tmp/iscan# '''ls''' ''-la''
total 11
total 11
drwxr-xr-x 2 1000 users 1024 2008-07-29 01:39 .
drwxr-xr-x 2 1000 users 1024 2008-07-29 01:39 .
Download the source code archive to directory /tmp/iscan and check for its consistency:
Download the source code archive to directory /tmp/iscan and check for its consistency:
root@darkstar04:/tmp/iscan# md5sum iscan_2.11.0-1.tar.gz
root@darkstar04:/tmp/iscan# '''md5sum''' iscan_2.11.0-1.tar.gz
76991cb47dc8ff1269e47d4bce3d41b5 iscan_2.11.0-1.tar.gz
76991cb47dc8ff1269e47d4bce3d41b5 iscan_2.11.0-1.tar.gz
Should the outputted value differ from the iscan.info file parameter, the downloaded archive is probably corrupted and you'll need to download it again; maybe from a mirror source.
Should the output value differ from the iscan.info file parameter, the downloaded archive is probably corrupted and you'll need to download it again; maybe from a mirror source.
Assuming the checksum was OK we'll proceed opening file iscan.SlackBuild with a text editor of choice. A few parameters needed by the building process are located in the file head. These values should be consistent with the archive name. The '''VERSION''' parameter should be assigned the downloaded release value. Script iscan.SlackBuild head should look like:
Assuming the checksum was OK we'll proceed opening file iscan.SlackBuild with a text editor of choice. A few parameters needed by the building process are located in the file head. These values should be consistent with the archive name. The '''VERSION''' parameter should be assigned the downloaded release value. Script iscan.SlackBuild head should look like:
<syntaxhighlight lang="bash">
PRGNAM=iscan
PRGNAM=iscan
VERSION=2.11.0
VERSION=2.11.0
BUILD=${BUILD:-1}
BUILD=${BUILD:-1}
TAG=${TAG:-_SBo}
TAG=${TAG:-_SBo}
</syntaxhighlight>
If not, update variables to the actual values and save the file. To start the tgz package build process run commands:
If not, update variables to the actual values and save the file. To start the tgz package build process run commands:
root@darkstar04:/tmp/iscan# chmod a+rx iscan.SlackBuild
root@darkstar04:/tmp/iscan# '''chmod''' a+rx iscan.SlackBuild
root@darkstar04:/tmp/iscan# ./iscan.SlackBuild
root@darkstar04:/tmp/iscan# ./iscan.SlackBuild
The former assigns execution permissions to the script, while the latter executes it. '''The shell script will automatically execute each needed step to compile and package Image Scan software'''. The resulting Slackware compliant package will be found inside directory /tmp.
The former assigns execution permissions to the script, while the latter executes it. '''The shell script will automatically execute each needed step to compile and package Image Scan software'''. The resulting Slackware compliant package will be found inside directory /tmp.
To install it open a root shell and run the following commands:
To install it open a root shell and run the following commands:
root@darkstar04:/tmp/iscan# cd /tmp
root@darkstar04:/tmp/iscan# '''cd''' /tmp
root@darkstar04:/tmp# installpkg iscan-2.11.0-i486-1_SBo.tgz
root@darkstar04:/tmp# '''installpkg''' iscan-2.11.0-i486-1_SBo.tgz
== '''Firmware Rpm Archive Conversion''' ==
As previously stated, '''Image Scan software is released under the GPL license''', but firmware and scanner drivers are not. There is no available source code for them, meaning that there is no way to compile those components. The only available option in such cases consists of '''converting software house provided packages''' available from another Linux distribution repository. In Iscan case the [http://www.opensuse.org/it/ Suse] repository packages will be used. Those packages group into a single file the many spread across the Avasys web site binaries. Conversion scripts can be downloaded for www.slackbuilds.org.
As previously stated, '''Image Scan software is released under the GPL license''', but firmware and scanner drivers are not. There is no available source code for them, meaning that there is no way to compile those components. The only available option in such cases consists of '''converting software house provided packages''' available from another Linux distribution repository. In Iscan case the [http://www.opensuse.org/it/ Suse] repository packages will be used. Those packages group into a single file the many spread across the Avasys web site binaries. Conversion scripts can be downloaded for www.slackbuilds.org.
Download iscan-firmware.tar.gz file from www.slackbuilds.org into directory /tmp of your Linux box. Open a '''root''' shell and decompress the document archive:
Download iscan-firmware.tar.gz file from www.slackbuilds.org into directory /tmp of your Linux box. Open a '''root''' shell and decompress the document archive:
root@darkstar04:/root# cd /tmp
root@darkstar04:/root# '''cd''' /tmp
root@darkstar04:/tmp# tar -zxf iscan-firmware.tar.gz
root@darkstar04:/tmp# '''tar''' ''-zxf'' iscan-firmware.tar.gz
Move into newly created iscan-firmware directory and list its contents:
Move into newly created iscan-firmware directory and list its contents:
root@darkstar04:/tmp/# cd iscan-firmware
root@darkstar04:/tmp/# '''cd''' iscan-firmware
root@darkstar04:/tmp/iscan-firmware# ls -la
root@darkstar04:/tmp/iscan-firmware# '''ls''' ''-la''
total 11
total 11
drwxr-xr-x 2 1000 users 1024 2008-05-01 22:39 .
drwxr-xr-x 2 1000 users 1024 2008-05-01 22:39 .
Download file iscan-firmware-2.8.0.1-11.noarch.rpm into /tmp directory, checksum it and if everything seems OK go on building the Slackware package:
Download file iscan-firmware-2.8.0.1-11.noarch.rpm into /tmp directory, checksum it and if everything seems OK go on building the Slackware package:
root@darkstar04:/tmp/iscan-firmware# md5sum iscan-firmware-2.8.0.1-11.noarch.rpm
root@darkstar04:/tmp/iscan-firmware# '''md5sum''' iscan-firmware-2.8.0.1-11.noarch.rpm
a6df3bdd35b12cd784b4439fb0b6524c iscan-firmware-2.8.0.1-11.noarch.rpm
a6df3bdd35b12cd784b4439fb0b6524c iscan-firmware-2.8.0.1-11.noarch.rpm
If the outputted value equals the one inside file iscan-firmware.info then check the variable assignments at the beginning of file iscan-firmware.SlackBuild:
If the outputted value equals the one inside file iscan-firmware.info then check the variable assignments at the beginning of file iscan-firmware.SlackBuild:
<syntaxhighlight lang="bash">
PRGNAM=iscan-firmware
PRGNAM=iscan-firmware
VERSION=2.8.0.1
VERSION=2.8.0.1
PKG=$TMP/package-$PRGNAM
PKG=$TMP/package-$PRGNAM
OUTPUT=${OUTPUT:-/tmp}
OUTPUT=${OUTPUT:-/tmp}
</syntaxhighlight>
Proceed with package conversion.
Proceed with package conversion.
root@darkstar04:/tmp/iscan-firmware# chmod a+rx iscan-firmware.SlackBuild
root@darkstar04:/tmp/iscan-firmware# '''chmod''' a+rx iscan-firmware.SlackBuild
root@darkstar04:/tmp/iscan-firmware# ./iscan-firmware.SlackBuild
root@darkstar04:/tmp/iscan-firmware# ./iscan-firmware.SlackBuild
The slackbuild script will generate a new package inside /tmp directory. Install it running commands:
The slackbuild script will generate a new package inside /tmp directory. Install it running commands:
root@darkstar04:/tmp/iscan-firmware# cd
root@darkstar04:/tmp/iscan-firmware# '''cd''' /tmp
root@darkstar04:/tmp/iscan-firmware# installpkg iscan-firmware-2.8.0.1-noarch-2_SBo.tgz
root@darkstar04:/tmp# '''installpkg''' iscan-firmware-2.8.0.1-noarch-2_SBo.tgz
== '''Proprietary Drivers Rpm Archive Conversion''' ==
Last component to be installed in order to use the scanner with a Linux system. As for the firmware, '''proprietary drivers are available from Avasys Corporation in binary form only''' and as such are to be extracted from a rpm file. Again the Suse repository packages will be used as the foundation to build the Slackware ones. The procedure should be easy by now.
Last component to be installed in order to use the scanner with a Linux system. As for the firmware, '''proprietary drivers are available from Avasys Corporation in binary form only''' and as such are to be extracted from a rpm file. Again the Suse repository packages will be used as the foundation to build the Slackware ones. The procedure should be easy by now.
Open a '''root''' shell and run commands:
Open a '''root''' shell and run commands:
root@darkstar04:/root# cd /tmp
root@darkstar04:/root# '''cd''' /tmp
root@darkstar04:/root# tar -zxf iscan-proprietary-drivers.tar.gz
root@darkstar04:/root# '''tar''' ''-zxf'' iscan-proprietary-drivers.tar.gz
root@darkstar04:/tmp# cd iscan-proprietary-drivers
root@darkstar04:/tmp# '''cd''' iscan-proprietary-drivers
root@darkstar04:/tmp/iscan-proprietary-drivers# ls -la
root@darkstar04:/tmp/iscan-proprietary-drivers# '''ls''' ''-la''
total 9
total 9
drwxr-xr-x 2 root root 1024 2008-08-19 23:22 .
drwxr-xr-x 2 root root 1024 2008-08-19 23:22 .
-rw-r--r-- 1 root root 951 2008-08-19 23:13 slack-desc
-rw-r--r-- 1 root root 951 2008-08-19 23:13 slack-desc
Check for archive consistency and verify variable assignments at the beginning of script file iscan-proprietary-drivers.SlackBuild:
Check for archive consistency and verify variable assignments at the beginning of script file iscan-proprietary-drivers.SlackBuild:
root@darkstar04:/tmp/iscan-proprietary-drivers# md5sum iscan-proprietary-drivers-2.8.0.1-11.i586.rpm
root@darkstar04:/tmp/iscan-proprietary-drivers# '''md5sum''' iscan-proprietary-drivers-2.8.0.1-11.i586.rpm
2a87f33b1838ae5baa1652d1ac5d9bfc iscan-proprietary-drivers-2.8.0.1-11.i586.rpm
2a87f33b1838ae5baa1652d1ac5d9bfc iscan-proprietary-drivers-2.8.0.1-11.i586.rpm
<syntaxhighlight lang="bash">
PRGNAM=iscan-proprietary-drivers
PRGNAM=iscan-proprietary-drivers
VERSION=2.8.0.1
VERSION=2.8.0.1
PKG=$TMP/package-$PRGNAM
PKG=$TMP/package-$PRGNAM
OUTPUT=${OUTPUT:-/tmp}
OUTPUT=${OUTPUT:-/tmp}
</syntaxhighlight>
Run the slackbuild script and install the new package:
Run the slackbuild script and install the new package:
root@darkstar04:/tmp/iscan-proprietary-drivers# chmod a+rx iscan-proprietary-drivers.SlackBuild
root@darkstar04:/tmp/iscan-proprietary-drivers# '''chmod''' a+rx iscan-proprietary-drivers.SlackBuild
root@darkstar04:/tmp/iscan-proprietary-drivers# ./iscan-proprietary-drivers.SlackBuild
root@darkstar04:/tmp/iscan-proprietary-drivers# ./iscan-proprietary-drivers.SlackBuild
root@darkstar04:/tmp/iscan-proprietary-drivers# cd /tmp
root@darkstar04:/tmp/iscan-proprietary-drivers# '''cd''' /tmp
root@darkstar04:/tmp/iscan-proprietary-drivers# installpkg iscan-proprietary-drivers-2.8.0.1-noarch-1_SBo.tgz
root@darkstar04:/tmp# '''installpkg''' iscan-proprietary-drivers-2.8.0.1-noarch-1_SBo.tgz
== '''Sane Configuration''' ==
== '''Sane Configuration''' ==
After all 3 packages are installed, some Sane (Scanner Access Made Easy) configuration files need to be updated in order for the system to detect and use the scanner. All files are located in the '''/etc/sane.d''' directory. 3 files are in need of updates, they are:
After all 3 packages are installed, some Sane (Scanner Access Made Easy) configuration files need to be updated in order for the system to detect and use the scanner. All files are located in the '''/etc/sane.d''' directory. 3 files are in need of updates, they are:
* /etc/sane.d/dll.conf
* /etc/sane.d/dll.conf
File '''/etc/sane.d/epkowa.conf''' is used to impose whether the scanner hardware is connected via the '''Usb''' or '''Scsi''' port. Below is the Epson "Perfection v200 Photo" Usb attached scanner configuration:
File '''/etc/sane.d/epkowa.conf''' is used to impose whether the scanner hardware is connected via the '''Usb''' or '''Scsi''' port. Below is the Epson "Perfection v200 Photo" Usb attached scanner configuration:
<syntaxhighlight lang="bash">
# epkowa.conf -- sample configuration for the EPKOWA SANE backend
# epkowa.conf -- sample configuration for the EPKOWA SANE backend
# Copyright (C) 2004 Olaf Meeuwissen
# Copyright (C) 2004 Olaf Meeuwissen
# sane-epkowa(5).
# sane-epkowa(5).
#
#
usb
#
#
# For any USB scanner not known to the backend (yet), you may, at your
# For any USB scanner not known to the backend (yet), you may, at your
#pio 0x378
#pio 0x378
#pio 0x3BC
#pio 0x3BC
</syntaxhighlight>
Back-end options must be added to the '''/etc/sane.d/snapscan.conf''' file. The file contents consist of a list of scanner models and their related firmware. Remove the leading # from the line with the firmware corresponding to the connected hardware. Below you'll find the configuration file for Epson "Perfection v200 Photo" scanner:
Back-end options must be added to the '''/etc/sane.d/snapscan.conf''' file. The file contents consist of a list of scanner models and their related firmware. Remove the leading # from the line with the firmware corresponding to the connected hardware. Below you'll find the configuration file for Epson "Perfection v200 Photo" scanner:
<syntaxhighlight lang="bash">
#-------------- EPSON Image Scan! for Linux Scanner-Firmware --------------
#-------------- EPSON Image Scan! for Linux Scanner-Firmware --------------
#
#
#
#
# Perfection V200 PHOTO (esfw7A.bin)
# Perfection V200 PHOTO (esfw7A.bin)
firmware /usr/share/iscan/esfw7A.bin
</syntaxhighlight>
== '''Program Start''' ==
Once the configuration files are in place, the scanner utility can be run from the command line issuing:
Once the configuration files are in place, the scanner utility can be run from the command line issuing:
root@darkstar04:/root# iscan
root@darkstar04:/root# '''iscan'''
that will load the graphic interface to the scanner. Many Window Managers, Kde and Xfce among them, include an icon to run Iscan from the main menu. The icon is part of the the '''Graphics''' menu.
that will load the graphic interface to the scanner. Many Window Managers, Kde and Xfce among them, include an icon to run Iscan from the main menu. The icon is part of the the '''Graphics''' menu.
[[File:iscan-01.jpeg]]
[[File:iscan-01.jpeg]]
[[File:iscan-02.jpeg]]
[[File:iscan-02.jpeg]]
== '''Conclusion''' ==
== '''Conclusion''' ==
This is pretty much it. We discussed how to '''install Image Scan software for Linux''' and '''configure Sane''' and its back-end: epkowa in order to use an Usb connected scanner. A future paper will deal with 64 bit systems and an Iscan current release.
This is pretty much it. We discussed how to '''install Image Scan software for Linux''' and '''configure Sane''' and its back-end: epkowa in order to use an Usb connected scanner. A future paper will deal with 64 bit systems and an Iscan current release.
== '''Updated Packages / Scripts''' ==
== '''Updated Packages / Scripts''' ==
All software is subject of updates and new releases, adding functionality and supporting newer hardware devices. Packages and scripts updated to a recent Iscan release can be found in the following [[Iscan_and_Slackware_14.1_update#Packages_and_Build_Scripts |web page]].
All software is subject of updates and new releases, adding functionality and supporting newer hardware devices. Packages and scripts updated to a recent Iscan release can be found in the following [[Iscan_and_Slackware_14.1_update#Packages_and_Build_Scripts |web page]].
* [http://avasys.jp/eng/ Avasys Corporation]
* [http://avasys.jp/eng/ Avasys Corporation]
* [http://www.avasys.jp/lx-bin2/linux_e/scan/DL1.do Avasys Corporation download page]
* [http://www.avasys.jp/lx-bin2/linux_e/scan/DL1.do Avasys Corporation download page]
----
----
{{footer_en | link_page=iscan_software}}