Difference between revisions of "En/iscan software 64 bit"

From Studiosg
Jump to navigationJump to search
(Added links to newer ISCAN packages and scripts)
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
Welcome to Simone Giustetti's wiki pages.
+
{{header_en|title=Installing Image Scan on a 64 bit Slackware Linux distribution| keyword={{Template:keyword_en_iscan}}| description=Building, installing and configuring a 64 bit Image Scan package on Slackware Linux 13.1 | link_page=iscan_software_64_bit}}
 
 
 
 
Languages: '''English''' - [[iscan_software_64_bit |Italiano]]
 
 
 
----
 
 
 
  
 
'''Image Scan''': an image scanning software for Epson scanners was the subject of a previous paper ([[en/iscan_software |Iscan software]]), where the software build procedure for a standard '''32 bit Slackware Linux''' distribution was described in detail.
 
'''Image Scan''': an image scanning software for Epson scanners was the subject of a previous paper ([[en/iscan_software |Iscan software]]), where the software build procedure for a standard '''32 bit Slackware Linux''' distribution was described in detail.
Line 30: Line 24:
  
  
= '''Iscan release 2.26''' =
+
= '''Iscan Release 2.26''' =
  
  
Line 49: Line 43:
 
== '''Software Build''' ==
 
== '''Software Build''' ==
 
Iscan release 2.26 consists of two packages: iscan-data and iscan. The former contains some configuration files and scripts  needed by udev. The latter contains the scanning software itself. Let's start with iscan-data. Download the [http://www.giustetti.net/resource/slackbuild/iscan-data.tar.gz iscan-data.tar.gz archive] into the /tmp directory and open a '''root''' shell. The archive can be decompressed issuing commands:
 
Iscan release 2.26 consists of two packages: iscan-data and iscan. The former contains some configuration files and scripts  needed by udev. The latter contains the scanning software itself. Let's start with iscan-data. Download the [http://www.giustetti.net/resource/slackbuild/iscan-data.tar.gz iscan-data.tar.gz archive] into the /tmp directory and open a '''root''' shell. The archive can be decompressed issuing commands:
   root@darkstar04:/root# cd /tmp
+
   root@darkstar04:/root# '''cd''' /tmp
   root@darkstar04:/tmp# tar -zxf iscan-data.tar.gz
+
   root@darkstar04:/tmp# '''tar''' ''-zxf'' iscan-data.tar.gz
  
 
Directory "iscan-data" will be created into /tmp. The new directory should contain:
 
Directory "iscan-data" will be created into /tmp. The new directory should contain:
   root@darkstar04:/tmp# cd iscan-data
+
   root@darkstar04:/tmp# '''cd''' iscan-data
   root@darkstar04:/tmp/iscan-data# ls -la
+
   root@darkstar04:/tmp/iscan-data# '''ls''' ''-la''
 
   total 32
 
   total 32
 
   drwxr-xr-x 2 root root 4096 2010-11-26 16:14 .
 
   drwxr-xr-x 2 root root 4096 2010-11-26 16:14 .
Line 66: Line 60:
  
 
Download the source code archive into directory /tmp/iscan-data and check its consistency:
 
Download the source code archive into directory /tmp/iscan-data and check its consistency:
   root@darkstar04:/tmp/iscan-data# md5sum iscan-data_1.5.0-0.tar.gz  
+
   root@darkstar04:/tmp/iscan-data# '''md5sum''' iscan-data_1.5.0-0.tar.gz  
 
   666cb5a79abe0ba23f1d8169ce709713  iscan-data_1.5.0-0.tar.gz
 
   666cb5a79abe0ba23f1d8169ce709713  iscan-data_1.5.0-0.tar.gz
  
Line 72: Line 66:
  
 
Let's suppose the check concluded successfully; we'll proceed updating iscan-data.Slackbuild file. The variables at the script beginning need proper value assignment. Open the file with your text editor of choice and update the '''VERSION''' parameter to match the downloaded software release number. The variables should be initialized as follows:
 
Let's suppose the check concluded successfully; we'll proceed updating iscan-data.Slackbuild file. The variables at the script beginning need proper value assignment. Open the file with your text editor of choice and update the '''VERSION''' parameter to match the downloaded software release number. The variables should be initialized as follows:
 +
<syntaxhighlight lang="bash">
 
   PRGNAM="iscan-data"
 
   PRGNAM="iscan-data"
 
   VERSION=${VERSION:-"1.5.0-0"}
 
   VERSION=${VERSION:-"1.5.0-0"}
Line 78: Line 73:
 
   BUILD=${BUILD:-1}
 
   BUILD=${BUILD:-1}
 
   TAG=${TAG:-"_sg"}
 
   TAG=${TAG:-"_sg"}
 +
</syntaxhighlight>
 
Variable '''ARCH''' imposes the target architecture for the build process. Use value '''i486''' for a 32 bit Intel machine. Change the value into '''x86_64''' if you desire to produce a package able to run on a 64 bit machine.
 
Variable '''ARCH''' imposes the target architecture for the build process. Use value '''i486''' for a 32 bit Intel machine. Change the value into '''x86_64''' if you desire to produce a package able to run on a 64 bit machine.
 +
<syntaxhighlight lang="bash">
 
   ARCH=${ARCH:-"x86_64"}
 
   ARCH=${ARCH:-"x86_64"}
 +
</syntaxhighlight>
 
Once the package version and targeted architecture match your needs, it is possible to start software compilation issuing commands:
 
Once the package version and targeted architecture match your needs, it is possible to start software compilation issuing commands:
   root@darkstar04:/tmp/iscan-data# chmod a+rx iscan-data.SlackBuild
+
   root@darkstar04:/tmp/iscan-data# '''chmod''' a+rx iscan-data.SlackBuild
 
   root@darkstar04:/tmp/iscan-data# ./iscan-data.SlackBuild
 
   root@darkstar04:/tmp/iscan-data# ./iscan-data.SlackBuild
  
 
The former command assigns execution permissions to the build script while the latter executes the script itself. The script will then take all actions needed to create '''a working package into directory /tmp'''. The package will be ready upon script conclusion.
 
The former command assigns execution permissions to the build script while the latter executes the script itself. The script will then take all actions needed to create '''a working package into directory /tmp'''. The package will be ready upon script conclusion.
 
Run the following commands to install the package:
 
Run the following commands to install the package:
   root@darkstar04:/tmp/iscan-data# cd /tmp
+
   root@darkstar04:/tmp/iscan-data# '''cd''' /tmp
   root@darkstar04:/tmp# installpkg iscan-data-1.5.0-i486-1_sg.txz for 32 bit machines.
+
   root@darkstar04:/tmp# '''installpkg''' iscan-data-1.5.0-i486-1_sg.txz for 32 bit machines.
 
   or
 
   or
   root@darkstar04:/tmp# installpkg iscan-data-1.5.0-x86_64-1_sg.txz for 64 bit machines.
+
   root@darkstar04:/tmp# '''installpkg''' iscan-data-1.5.0-x86_64-1_sg.txz for 64 bit machines.
 
Root privileges are of course needed to install the packages.
 
Root privileges are of course needed to install the packages.
  
 
The very same procedure is useful to build Image Scan 2.26 software. Download the [http://www.giustetti.net/resource/slackbuild/iscan.tar.gz iscan.tar.gz archive] into directory /tmp and decompress it by running:
 
The very same procedure is useful to build Image Scan 2.26 software. Download the [http://www.giustetti.net/resource/slackbuild/iscan.tar.gz iscan.tar.gz archive] into directory /tmp and decompress it 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 new directory named "iscan" will be created containing:
 
A new directory named "iscan" will be created containing:
   root@darkstar04:/tmp# cd iscan
+
   root@darkstar04:/tmp# '''cd''' iscan
   root@darkstar04:/tmp/iscan# ls -la
+
   root@darkstar04:/tmp/iscan# '''ls''' ''-la''
 
   total 40
 
   total 40
 
   drwxr-xr-x 2 root root 4096 2010-11-26 16:14 .
 
   drwxr-xr-x 2 root root 4096 2010-11-26 16:14 .
Line 111: Line 109:
  
 
Download the source code archive into directory /tmp/iscan and check its consistency:
 
Download the source code archive into directory /tmp/iscan and check its consistency:
   root@darkstar04:/tmp/iscan# md5sum iscan_2.26.1-3.tar.gz  
+
   root@darkstar04:/tmp/iscan# '''md5sum''' iscan_2.26.1-3.tar.gz  
 
   106a40eb5b40bfc53311238ed47c3f07  iscan_2.26.1-3.tar.gz
 
   106a40eb5b40bfc53311238ed47c3f07  iscan_2.26.1-3.tar.gz
 
Update the variables at the beginning of script '''iscan.SlackBuild'''. Variable values should be initialized to match the following ones:
 
Update the variables at the beginning of script '''iscan.SlackBuild'''. Variable values should be initialized to match the following ones:
 +
<syntaxhighlight lang="bash">
 
   PRGNAM="iscan"
 
   PRGNAM="iscan"
 
   VERSION=${VERSION:-"2.26.1-3"}
 
   VERSION=${VERSION:-"2.26.1-3"}
Line 120: Line 119:
 
   BUILD=${BUILD:-1}
 
   BUILD=${BUILD:-1}
 
   TAG=${TAG:-"_sg"}
 
   TAG=${TAG:-"_sg"}
 +
</syntaxhighlight>
 
As for the previous build, variable '''ARCH''' should be modified to build a 64 bit package:
 
As for the previous build, variable '''ARCH''' should be modified to build a 64 bit package:
 +
<syntaxhighlight lang="bash">
 
   ARCH=${ARCH:-"x86_64"}
 
   ARCH=${ARCH:-"x86_64"}
 +
</syntaxhighlight>
 
After the configuration, a package can be built and installed running commands:
 
After the configuration, a package can be built and installed running 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
   root@darkstar04:/tmp/iscan# cd /tmp
+
   root@darkstar04:/tmp/iscan# '''cd''' /tmp
   root@darkstar04:/tmp# installpkg iscan-2.26.1-i486-1_sg.txz for 32 bit machines.
+
   root@darkstar04:/tmp# '''installpkg''' iscan-2.26.1-i486-1_sg.txz for 32 bit machines.
   oppure
+
   or
   root@darkstar04:/tmp# installpkg iscan-2.26.1-x86_64-1_sg.txz for 64 bit machines.
+
   root@darkstar04:/tmp# '''installpkg''' iscan-2.26.1-x86_64-1_sg.txz for 64 bit machines.
 +
 
  
 +
== '''Plug-in Rpm Archive Conversion''' ==
  
== '''Plug-in rpm archive conversion''' ==
 
 
The third and final Iscan component consists of the binary plug-in which connects the computer to the attached scanner. The plug-in is provided by Avasys in binary form only and thus needs to be extracted from a rpm archive. A different plug-in is needed for each scanner and for each architecture. Packages provided for scanner Epson "Perfection v200 Photo" are: iscan-plugin-gt-f670-2.1.0-3.c2.i386.rpm and iscan-plugin-gt-f670-2.1.0-3.c2.x86_64.rpm respectively for 32 and 64 bit machines.
 
The third and final Iscan component consists of the binary plug-in which connects the computer to the attached scanner. The plug-in is provided by Avasys in binary form only and thus needs to be extracted from a rpm archive. A different plug-in is needed for each scanner and for each architecture. Packages provided for scanner Epson "Perfection v200 Photo" are: iscan-plugin-gt-f670-2.1.0-3.c2.i386.rpm and iscan-plugin-gt-f670-2.1.0-3.c2.x86_64.rpm respectively for 32 and 64 bit machines.
  
 
Download [http://www.giustetti.net/resource/slackbuild/iscan-plugin.tar.gz archive iscan-plugin.tar.gz] into directory /tmp and decompress it:
 
Download [http://www.giustetti.net/resource/slackbuild/iscan-plugin.tar.gz archive iscan-plugin.tar.gz] into directory /tmp and decompress it:
   root@darkstar04:/root# cd /tmp
+
   root@darkstar04:/root# '''cd''' /tmp
   root@darkstar04:/tmp# tar -zxf iscan-plugin.tar.gz
+
   root@darkstar04:/tmp# '''tar''' ''-zxf'' iscan-plugin.tar.gz
  
 
The newly created iscan-plugin directory should contain:
 
The newly created iscan-plugin directory should contain:
   root@darkstar04:/tmp# cd iscan-plugin
+
   root@darkstar04:/tmp# '''cd''' iscan-plugin
   root@darkstar04:/tmp/iscan-plugin# ls -la
+
   root@darkstar04:/tmp/iscan-plugin# '''ls''' ''-la''
 
   total 32
 
   total 32
 
   drwxr-xr-x 2 root root 4096 2010-12-12 18:28 .
 
   drwxr-xr-x 2 root root 4096 2010-12-12 18:28 .
Line 153: Line 156:
 
What follows are the download, consistency check, conversion and install operations for both 32 and 64 bit plug-in package versions.
 
What follows are the download, consistency check, conversion and install operations for both 32 and 64 bit plug-in package versions.
 
Steps for a '''32 bit machine''' are:
 
Steps for a '''32 bit machine''' are:
   root@darkstar04:/tmp/iscan-plugin# md5sum iscan-plugin-gt-f670-2.1.0-3.c2.i386.rpm  
+
   root@darkstar04:/tmp/iscan-plugin# '''md5sum''' iscan-plugin-gt-f670-2.1.0-3.c2.i386.rpm  
 
   193e270a38ac9941f03e012bb3bb4483  iscan-plugin-gt-f670-2.1.0-3.c2.i386.rpm
 
   193e270a38ac9941f03e012bb3bb4483  iscan-plugin-gt-f670-2.1.0-3.c2.i386.rpm
 
Values for the iscan-plugin.SlackBuild script variables are:
 
Values for the iscan-plugin.SlackBuild script variables are:
 +
<syntaxhighlight lang="bash">
 
   PRGNAM="iscan-plugin"
 
   PRGNAM="iscan-plugin"
 
   # Select one among gt-f670, gt-f700, gt-f720, gt-1500, gt-s80, gt-s600, gt-x750
 
   # Select one among gt-f670, gt-f700, gt-f720, gt-1500, gt-s80, gt-s600, gt-x750
Line 165: Line 169:
 
   BUILD=${BUILD:-1}
 
   BUILD=${BUILD:-1}
 
   TAG=${TAG:-"_sg"}
 
   TAG=${TAG:-"_sg"}
 +
</syntaxhighlight>
 
Set the proper values and execute the usual commands:
 
Set the proper values and execute the usual commands:
   root@darkstar04:/tmp/iscan-plugin# chmod a+rx iscan-plugin.SlackBuild
+
   root@darkstar04:/tmp/iscan-plugin# '''chmod''' a+rx iscan-plugin.SlackBuild
 
   root@darkstar04:/tmp/iscan-plugin# ./iscan-plugin.SlackBuild
 
   root@darkstar04:/tmp/iscan-plugin# ./iscan-plugin.SlackBuild
   root@darkstar04:/tmp/iscan-plugin# cd /tmp
+
   root@darkstar04:/tmp/iscan-plugin# '''cd''' /tmp
   root@darkstar04:/tmp# installpkg iscan-plugin-2.1.0-i386-1_SBo.txz
+
   root@darkstar04:/tmp# '''installpkg''' iscan-plugin-2.1.0-i386-1_SBo.txz
  
 
For '''64 bit machines''':
 
For '''64 bit machines''':
   root@darkstar04:/tmp/iscan-plugin# md5sum iscan-plugin-gt-f670-2.1.0-3.c2.x86_64.rpm  
+
   root@darkstar04:/tmp/iscan-plugin# '''md5sum''' iscan-plugin-gt-f670-2.1.0-3.c2.x86_64.rpm  
 
   64399c73c701d0c45b9135c43613c96d  iscan-plugin-gt-f670-2.1.0-3.c2.x86_64.rpm
 
   64399c73c701d0c45b9135c43613c96d  iscan-plugin-gt-f670-2.1.0-3.c2.x86_64.rpm
 
Values for the iscan-plugin.SlackBuild script variables are:
 
Values for the iscan-plugin.SlackBuild script variables are:
 +
<syntaxhighlight lang="bash">
 
   PRGNAM="iscan-plugin"
 
   PRGNAM="iscan-plugin"
 
   # Select one among gt-f670, gt-f700, gt-f720, gt-1500, gt-s80, gt-s600, gt-x750
 
   # Select one among gt-f670, gt-f700, gt-f720, gt-1500, gt-s80, gt-s600, gt-x750
Line 184: Line 190:
 
   BUILD=${BUILD:-1}
 
   BUILD=${BUILD:-1}
 
   TAG=${TAG:-"_sg"}
 
   TAG=${TAG:-"_sg"}
 +
</syntaxhighlight>
 
Set the proper values and run the following commands in sequence:
 
Set the proper values and run the following commands in sequence:
   root@darkstar04:/tmp/iscan-plugin# chmod a+rx iscan-plugin.SlackBuild
+
   root@darkstar04:/tmp/iscan-plugin# '''chmod''' a+rx iscan-plugin.SlackBuild
 
   root@darkstar04:/tmp/iscan-plugin# ./iscan-plugin.SlackBuild
 
   root@darkstar04:/tmp/iscan-plugin# ./iscan-plugin.SlackBuild
   root@darkstar04:/tmp/iscan-plugin# cd /tmp
+
   root@darkstar04:/tmp/iscan-plugin# '''cd''' /tmp
   root@darkstar04:/tmp# installpkg iscan-plugin-2.1.0-x86_64-1_SBo.txz
+
   root@darkstar04:/tmp# '''installpkg''' iscan-plugin-2.1.0-x86_64-1_SBo.txz
+
 
 +
 
 +
== '''System Configuration''' ==
  
== '''System configuration''' ==
 
 
If the three packages were installed following the order described above: '''isca-data''', '''iscan''', '''iscan-plugin''', no further configuration should be needed. Udev subsystem rules plus file /var/lib/iscan/interpreter are enough for the computer to recognize the attached scanner and to load the proper firmware.
 
If the three packages were installed following the order described above: '''isca-data''', '''iscan''', '''iscan-plugin''', no further configuration should be needed. Udev subsystem rules plus file /var/lib/iscan/interpreter are enough for the computer to recognize the attached scanner and to load the proper firmware.
  
 
If any issue should arise, rules file, /etc/udev/rules.d/60-iscan.rules, can be manually created running:
 
If any issue should arise, rules file, /etc/udev/rules.d/60-iscan.rules, can be manually created running:
/usr/lib/iscan-data/make-policy-file --force --mode udev --out-file /etc/udev/rules.d/60-iscan.rules
+
  '''/usr/lib/iscan-data/make-policy-file''' ''--force --mode'' udev ''--out-file'' /etc/udev/rules.d/60-iscan.rules
 
Wile file /var/lib/iscan/interpreter can be edited with a text editor of choice adding a line for each scanner needed library and commenting out the other ones.
 
Wile file /var/lib/iscan/interpreter can be edited with a text editor of choice adding a line for each scanner needed library and commenting out the other ones.
  
Line 211: Line 219:
  
  
== '''Sane / xsane integration''' ==
+
== '''Sane / Xsane Integration''' ==
 +
 
 
Iscan can be run without any specific configuration, for '''sane''' or '''xsane''' some files need to be updated inserting proper information instead: information related to the scanner model. The touched files were listed in the previous article about [http://www.giustetti.net/wiki/index.php?title=en/iscan_software Image Scan release 2.11]. All files are located into the '''/etc/sane.d''' directory; they are:
 
Iscan can be run without any specific configuration, for '''sane''' or '''xsane''' some files need to be updated inserting proper information instead: information related to the scanner model. The touched files were listed in the previous article about [http://www.giustetti.net/wiki/index.php?title=en/iscan_software Image Scan release 2.11]. All files are located into the '''/etc/sane.d''' directory; they are:
 
* /etc/sane.d/dll.conf
 
* /etc/sane.d/dll.conf
Line 222: Line 231:
  
  
== '''Gimp integration''' ==
+
== '''Gimp Integration''' ==
 +
 
 
Image Scan can be configured as a Gimp plug-in. Gimp is the best known image manipulation program under Linux. The Gimp integration will allow to run Iscan from within the program and to import images from the scanner. The procedure consists of creating some links to the right executable files. For Gimp release 2.x (latest stable release is 2.6) open a root shell and execute the following command:
 
Image Scan can be configured as a Gimp plug-in. Gimp is the best known image manipulation program under Linux. The Gimp integration will allow to run Iscan from within the program and to import images from the scanner. The procedure consists of creating some links to the right executable files. For Gimp release 2.x (latest stable release is 2.6) open a root shell and execute the following command:
   root@darkstar04:/root# ln -s /usr/bin/iscan `gimptool-2.0 --gimpplugindir`/plug-ins/
+
   root@darkstar04:/root# '''ln''' ''-s'' /usr/bin/iscan `'''gimptool-2.0''' ''--gimpplugindir''`/plug-ins/
 
For older release 1.2 run instead command:
 
For older release 1.2 run instead command:
   root@darkstar04:/root# ln -s /usr/bin/iscan `gimptool --gimpplugindir`/plug-ins/
+
   root@darkstar04:/root# '''ln''' ''-s'' /usr/bin/iscan `'''gimptool''' ''--gimpplugindir''`/plug-ins/
  
  
 
== '''Conclusion''' ==
 
== '''Conclusion''' ==
 +
 
The present paper discussed the installation procedure for a recent Image Scan release, 2.25 or 2.26, able to run on both a 32 or 64 bit Linux box and as such on any Slackware Linux release from 13.0 on.
 
The present paper discussed the installation procedure for a recent Image Scan release, 2.25 or 2.26, able to run on both a 32 or 64 bit Linux box and as such on any Slackware Linux release from 13.0 on.
  
Line 248: Line 259:
  
 
== '''Missing README.slackware''' ==
 
== '''Missing README.slackware''' ==
 +
 
I received some bug reports asserting the scripts linked above will fail, while compiling packages, complaining for a '''missing README.slackware file'''. That's a consequence of the file being removed from recent Iscan releases. To build packages for a recent Iscan release, please use the '''updated for Slackware 14.0 or 14.1''' scripts linked in the following pages:
 
I received some bug reports asserting the scripts linked above will fail, while compiling packages, complaining for a '''missing README.slackware file'''. That's a consequence of the file being removed from recent Iscan releases. To build packages for a recent Iscan release, please use the '''updated for Slackware 14.0 or 14.1''' scripts linked in the following pages:
 
* [[iscan_and_Slackware_14.0 |Iscan and Slackware 14.0]]
 
* [[iscan_and_Slackware_14.0 |Iscan and Slackware 14.0]]
Line 257: Line 269:
  
 
== '''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]].
  
Line 272: Line 285:
 
* [http://www.sane-project.org/ Sane home page]
 
* [http://www.sane-project.org/ Sane home page]
 
* [http://www.slackware.com Slackware home page]
 
* [http://www.slackware.com Slackware home page]
 
  
 
----
 
----
  
Languages: '''English''' - [[iscan_software_64_bit |Italiano]]
+
{{footer_en | link_page=iscan_software_64_bit}}

Latest revision as of 12:19, 21 March 2022

Welcome to Simone Giustetti's wiki pages.


Languages: English - Italiano


Image Scan: an image scanning software for Epson scanners was the subject of a previous paper (Iscan software), where the software build procedure for a standard 32 bit Slackware Linux distribution was described in detail.

Newer Image Scan releases introduced some useful features:

  1. Support for a wider range of scanners.
  2. Full 64 bit architecture support.
  3. udev integration for device handling, recognition and configuration.

The Avasys web site was subject of a redesign too. The web pages were updated in order to provide users with two download links:

  • One for the scanning software and data packages.
  • A second one for plug-in packages containing both drivers and firmware for the selected scanner.

The following link points to the download page for the latest Iscan release available, release 2.26.1 at present:

  software

The plug-in download page link follows:

  plug-ins

Were you unsure about which plug-in to download, you are strongly suggested to visit the Avasys download page and to select your scanner model among the listed ones. By selecting the scanner and filling in the form at page bottom you'll be redirected to a download page where to find links to the plug-in.

This paper is about the build procedure for Iscan packages aimed to run on a 32 or 64 bit Slackware Linux.

All tests for the present paper were performed using an Epson "Perfection v200 Photo" scanner.

We'll assume that both the sane and xsane packages are installed and properly functioning.


Iscan Release 2.26

Image Scan release 2.26.1 consists of 3 distinct components:

  • The Iscan scanning software.
  • Some scripts for udev subsystem integration.
  • Plug-ins consisting of proprietary drivers and firmware for scanners.

Avasys releases the source code for both the two former components. It is therefore possible to build related packages for the Linux distribution of choice. The latter package is released in binary form only; a conversion to tgz or txz format of a supported distribution package is mandatory. We'll convert the Fedora packages that can be downloaded from the Awasys web site.

Download the scripts and follow the steps listed below to produce Slackware packages:

  1. Software Build.
  2. Plug-in rpm package conversion to a txz archive, the latest Slackware supported package format.
  3. Packages install and system configuration.
  4. Sane / Xsane integration (Optional).
  5. Gimp integration (Optional).


Software Build

Iscan release 2.26 consists of two packages: iscan-data and iscan. The former contains some configuration files and scripts needed by udev. The latter contains the scanning software itself. Let's start with iscan-data. Download the iscan-data.tar.gz archive into the /tmp directory and open a root shell. The archive can be decompressed issuing commands:

 root@darkstar04:/root# cd /tmp
 root@darkstar04:/tmp# tar -zxf iscan-data.tar.gz

Directory "iscan-data" will be created into /tmp. The new directory should contain:

  root@darkstar04:/tmp# cd iscan-data
  root@darkstar04:/tmp/iscan-data# ls -la
  total 32
  drwxr-xr-x 2 root root 4096 2010-11-26 16:14 .
  drwxr-xr-x 6 root root 4096 2010-12-12 20:26 ..
  -rw-r--r-- 1 root root  373 2010-11-26 16:15 README
  -rw-r--r-- 1 root root  323 2010-07-08 15:54 doinst.sh
  -rwxr-xr-x 1 root root 6438 2010-12-12 20:26 iscan-data.SlackBuild
  -rw-r--r-- 1 root root  434 2010-11-26 16:18 iscan-data.info
  -rw-r--r-- 1 root root  796 2010-07-21 17:11 slack-desc

File iscan.info will provide you with a download link for the source code and a checksum, parameter MD5SUM, useful to check the downloaded archive integrity.

Download the source code archive into directory /tmp/iscan-data and check its consistency:

  root@darkstar04:/tmp/iscan-data# md5sum iscan-data_1.5.0-0.tar.gz 
  666cb5a79abe0ba23f1d8169ce709713  iscan-data_1.5.0-0.tar.gz

Should the checksum output differ from the one found inside the iscan-data.info file, the downloaded archive is probably corrupted. Download it again possibly from a different source.

Let's suppose the check concluded successfully; we'll proceed updating iscan-data.Slackbuild file. The variables at the script beginning need proper value assignment. Open the file with your text editor of choice and update the VERSION parameter to match the downloaded software release number. The variables should be initialized as follows:

   PRGNAM="iscan-data"
   VERSION=${VERSION:-"1.5.0-0"}
   VERSION_SHORT=`echo ${VERSION} | awk -F\- '{ print $1 }'`
   ARCH=${ARCH:-"i486"}
   BUILD=${BUILD:-1}
   TAG=${TAG:-"_sg"}

Variable ARCH imposes the target architecture for the build process. Use value i486 for a 32 bit Intel machine. Change the value into x86_64 if you desire to produce a package able to run on a 64 bit machine.

   ARCH=${ARCH:-"x86_64"}

Once the package version and targeted architecture match your needs, it is possible to start software compilation issuing commands:

  root@darkstar04:/tmp/iscan-data# chmod a+rx iscan-data.SlackBuild
  root@darkstar04:/tmp/iscan-data# ./iscan-data.SlackBuild

The former command assigns execution permissions to the build script while the latter executes the script itself. The script will then take all actions needed to create a working package into directory /tmp. The package will be ready upon script conclusion. Run the following commands to install the package:

  root@darkstar04:/tmp/iscan-data# cd /tmp
  root@darkstar04:/tmp# installpkg iscan-data-1.5.0-i486-1_sg.txz for 32 bit machines.
  or
  root@darkstar04:/tmp# installpkg iscan-data-1.5.0-x86_64-1_sg.txz for 64 bit machines.

Root privileges are of course needed to install the packages.

The very same procedure is useful to build Image Scan 2.26 software. Download the iscan.tar.gz archive into directory /tmp and decompress it by running:

  root@darkstar04:/root# cd /tmp
  root@darkstar04:/tmp# tar -zxf iscan.tar.gz

A new directory named "iscan" will be created containing:

  root@darkstar04:/tmp# cd iscan
  root@darkstar04:/tmp/iscan# ls -la
  total 40
  drwxr-xr-x 2 root root 4096 2010-11-26 16:14 .
  drwxr-xr-x 6 root root 4096 2010-12-12 20:37 ..
  -rw-r--r-- 1 root root  868 2010-07-10 23:54 README
  -rw-r--r-- 1 root root  114 2009-05-04 05:54 doinst.sh
  -rwxr-xr-x 1 root root 9039 2010-12-12 20:37 iscan.SlackBuild
  -rw-r--r-- 1 root root  185 2009-05-03 19:18 iscan.desktop
  -rw-r--r-- 1 root root  414 2010-11-26 16:21 iscan.info
  -rw-r--r-- 1 root root  753 2009-05-03 19:18 slack-desc

Again the download source for the software source code and the checksum value can be found inside file with extension *.info: iscan.info.

Download the source code archive into directory /tmp/iscan and check its consistency:

  root@darkstar04:/tmp/iscan# md5sum iscan_2.26.1-3.tar.gz 
  106a40eb5b40bfc53311238ed47c3f07  iscan_2.26.1-3.tar.gz

Update the variables at the beginning of script iscan.SlackBuild. Variable values should be initialized to match the following ones:

   PRGNAM="iscan"
   VERSION=${VERSION:-"2.26.1-3"}
   VERSION_SHORT=`echo ${VERSION} | awk -F\- '{ print $1 }'`
   ARCH=${ARCH:-"i486"}
   BUILD=${BUILD:-1}
   TAG=${TAG:-"_sg"}

As for the previous build, variable ARCH should be modified to build a 64 bit package:

   ARCH=${ARCH:-"x86_64"}

After the configuration, a package can be built and installed running commands:

  root@darkstar04:/tmp/iscan# chmod a+rx iscan.SlackBuild
  root@darkstar04:/tmp/iscan# ./iscan.SlackBuild
  root@darkstar04:/tmp/iscan# cd /tmp
  root@darkstar04:/tmp# installpkg iscan-2.26.1-i486-1_sg.txz for 32 bit machines.
  or
  root@darkstar04:/tmp# installpkg iscan-2.26.1-x86_64-1_sg.txz for 64 bit machines.


Plug-in Rpm Archive Conversion

The third and final Iscan component consists of the binary plug-in which connects the computer to the attached scanner. The plug-in is provided by Avasys in binary form only and thus needs to be extracted from a rpm archive. A different plug-in is needed for each scanner and for each architecture. Packages provided for scanner Epson "Perfection v200 Photo" are: iscan-plugin-gt-f670-2.1.0-3.c2.i386.rpm and iscan-plugin-gt-f670-2.1.0-3.c2.x86_64.rpm respectively for 32 and 64 bit machines.

Download archive iscan-plugin.tar.gz into directory /tmp and decompress it:

  root@darkstar04:/root# cd /tmp
  root@darkstar04:/tmp# tar -zxf iscan-plugin.tar.gz

The newly created iscan-plugin directory should contain:

  root@darkstar04:/tmp# cd iscan-plugin
  root@darkstar04:/tmp/iscan-plugin# ls -la
  total 32
  drwxr-xr-x 2 root root 4096 2010-12-12 18:28 .
  drwxr-xr-x 5 root root 4096 2010-12-12 20:45 ..
  -rw-r--r-- 1 root root 1685 2010-07-10 23:40 README
  -rw-r--r-- 1 root root  114 2010-07-11 20:10 doinst.sh
  -rwxr-xr-x 1 root root 7328 2010-12-12 20:45 iscan-plugin.SlackBuild
  -rw-r--r-- 1 root root 2518 2010-11-25 01:01 iscan-plugin.info
  -rw-r--r-- 1 root root  819 2010-07-11 20:25 slack-desc

As usual download source and checksum value are available inside the file with *.info extension.

What follows are the download, consistency check, conversion and install operations for both 32 and 64 bit plug-in package versions. Steps for a 32 bit machine are:

  root@darkstar04:/tmp/iscan-plugin# md5sum iscan-plugin-gt-f670-2.1.0-3.c2.i386.rpm 
  193e270a38ac9941f03e012bb3bb4483  iscan-plugin-gt-f670-2.1.0-3.c2.i386.rpm

Values for the iscan-plugin.SlackBuild script variables are:

   PRGNAM="iscan-plugin"
   # Select one among gt-f670, gt-f700, gt-f720, gt-1500, gt-s80, gt-s600, gt-x750
   # or gt-x770.
   PLUGIN="gt-f670"
   VERSION="2.1.0"
   RPM_VERSION="3.c2"   # This is the build number used by Avasys Fedora Rpm
   ARCH=${ARCH:-"i386"}
   BUILD=${BUILD:-1}
   TAG=${TAG:-"_sg"}

Set the proper values and execute the usual commands:

  root@darkstar04:/tmp/iscan-plugin# chmod a+rx iscan-plugin.SlackBuild
  root@darkstar04:/tmp/iscan-plugin# ./iscan-plugin.SlackBuild
  root@darkstar04:/tmp/iscan-plugin# cd /tmp
  root@darkstar04:/tmp# installpkg iscan-plugin-2.1.0-i386-1_SBo.txz

For 64 bit machines:

  root@darkstar04:/tmp/iscan-plugin# md5sum iscan-plugin-gt-f670-2.1.0-3.c2.x86_64.rpm 
  64399c73c701d0c45b9135c43613c96d  iscan-plugin-gt-f670-2.1.0-3.c2.x86_64.rpm

Values for the iscan-plugin.SlackBuild script variables are:

   PRGNAM="iscan-plugin"
   # Select one among gt-f670, gt-f700, gt-f720, gt-1500, gt-s80, gt-s600, gt-x750
   # or gt-x770.
   PLUGIN="gt-f670"
   VERSION="2.1.0"
   RPM_VERSION="3.c2"   # This is the build number used by Avasys Fedora Rpm
   ARCH=${ARCH:-"x86_64"}
   BUILD=${BUILD:-1}
   TAG=${TAG:-"_sg"}

Set the proper values and run the following commands in sequence:

  root@darkstar04:/tmp/iscan-plugin# chmod a+rx iscan-plugin.SlackBuild
  root@darkstar04:/tmp/iscan-plugin# ./iscan-plugin.SlackBuild
  root@darkstar04:/tmp/iscan-plugin# cd /tmp
  root@darkstar04:/tmp# installpkg iscan-plugin-2.1.0-x86_64-1_SBo.txz


System Configuration

If the three packages were installed following the order described above: isca-data, iscan, iscan-plugin, no further configuration should be needed. Udev subsystem rules plus file /var/lib/iscan/interpreter are enough for the computer to recognize the attached scanner and to load the proper firmware.

If any issue should arise, rules file, /etc/udev/rules.d/60-iscan.rules, can be manually created running:

  /usr/lib/iscan-data/make-policy-file --force --mode udev --out-file /etc/udev/rules.d/60-iscan.rules

Wile file /var/lib/iscan/interpreter can be edited with a text editor of choice adding a line for each scanner needed library and commenting out the other ones.

If nothing seems to solve the issue, reinstalling packages in the correct order should do the trick.

What follows are images taken while running release 2.26.1 of Image Scan on a 64 bit Slackware 13.1.

Iscan 64-01.jpeg


Iscan 64-02.jpeg


Iscan 64-03.jpeg


Sane / Xsane Integration

Iscan can be run without any specific configuration, for sane or xsane some files need to be updated inserting proper information instead: information related to the scanner model. The touched files were listed in the previous article about Image Scan release 2.11. All files are located into the /etc/sane.d directory; they are:

  • /etc/sane.d/dll.conf
  • /etc/sane.d/epkowa.conf

The /etc/sane.d/snapscan.conf file was replaced by /var/lib/iscan/interpreter and is not needed anymore.

If a /etc/sane.d/dll.conf file already exists in your system, insert the back-end Sane will use to communicate with the scanner. Add a single line containing the word "epkowa" to the file.

File /etc/sane.d/epkowa.conf is used to inform Sane if the scanner were usb or scsi connected. Remove the comment character, "#" , from the line containing the right connection port.


Gimp Integration

Image Scan can be configured as a Gimp plug-in. Gimp is the best known image manipulation program under Linux. The Gimp integration will allow to run Iscan from within the program and to import images from the scanner. The procedure consists of creating some links to the right executable files. For Gimp release 2.x (latest stable release is 2.6) open a root shell and execute the following command:

  root@darkstar04:/root# ln -s /usr/bin/iscan `gimptool-2.0 --gimpplugindir`/plug-ins/

For older release 1.2 run instead command:

  root@darkstar04:/root# ln -s /usr/bin/iscan `gimptool --gimpplugindir`/plug-ins/


Conclusion

The present paper discussed the installation procedure for a recent Image Scan release, 2.25 or 2.26, able to run on both a 32 or 64 bit Linux box and as such on any Slackware Linux release from 13.0 on.

The links to the Image Scan 2.26.1 and Image Scan Data 1.5.0 slackware packages follow. The packages are distributed in the hope they could be helpful:

Plug-in are not distributed with an open source license and thus can be downloaded from the Avasys web site.


Missing README.slackware

I received some bug reports asserting the scripts linked above will fail, while compiling packages, complaining for a missing README.slackware file. That's a consequence of the file being removed from recent Iscan releases. To build packages for a recent Iscan release, please use the updated for Slackware 14.0 or 14.1 scripts linked in the following pages:

Package generation should conclude without errors.

Thanks to all those who reported the issue for making this a better article.


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 web page.


For any feedback, questions, errors and such, please e-mail me at studiosg [at] giustetti [dot] net


External links





Languages: English - Italiano