View source for En/iscan software 64 bit

{{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}}

'''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.

Newer '''Image Scan''' releases introduced some useful features:
# Support for a wider range of scanners.
# Full '''64 bit architecture support'''.
# '''udev''' integration for device handling, recognition and configuration.

The [http://avasys.jp/eng/ 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:
   [http://linux.avasys.jp/drivers/iscan/2.26.1/ software]
The plug-in download page link follows:
   [http://linux.avasys.jp/drivers/iscan/plugins/ plug-ins]
Were you unsure about which plug-in to download, you are strongly suggested to visit the [http://www.avasys.jp/lx-bin2/linux_e/scan/DL1.do 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:
# Software Build.
# Plug-in rpm package conversion to a txz archive, the latest Slackware supported package format.
# Packages install and system configuration.
# Sane / Xsane integration (Optional).
# 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 [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:/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:
<syntaxhighlight lang="bash">
   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"}
</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.
<syntaxhighlight lang="bash">
   ARCH=${ARCH:-"x86_64"}
</syntaxhighlight>
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 [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:/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:
<syntaxhighlight lang="bash">
   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"}
</syntaxhighlight>
As for the previous build, variable '''ARCH''' should be modified to build a 64 bit package:
<syntaxhighlight lang="bash">
   ARCH=${ARCH:-"x86_64"}
</syntaxhighlight>
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 [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:/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:
<syntaxhighlight lang="bash">
   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"}
</syntaxhighlight>
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:
<syntaxhighlight lang="bash">
   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"}
</syntaxhighlight>
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.

[[File:iscan_64-01.jpeg]]


[[File:iscan_64-02.jpeg]]


[[File: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 [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/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:
* 32 bit.
** [http://www.giustetti.net/resource/pkg/i486/iscan-2.26.1-i486-1_sg.txz Image Scan 2.26.1]
** [http://www.giustetti.net/resource/pkg/i486/iscan-2.26.1-i486-1_sg.txz.md5 Image Scan 2.26.1 md5 checksum]
** [http://www.giustetti.net/resource/pkg/i486/iscan-data-1.5.0-i486-1_sg.txz Image Scan Data 1.5.0]
** [http://www.giustetti.net/resource/pkg/i486/iscan-data-1.5.0-i486-1_sg.txz.md5 Image Scan Data 1.5.0 md5 checksum]
* 64 bit.
** [http://www.giustetti.net/resource/pkg/x86_64/iscan-2.26.1-x86_64-1_sg.txz Image Scan 2.26.1]
** [http://www.giustetti.net/resource/pkg/x86_64/iscan-2.26.1-x86_64-1_sg.txz.md5 Image Scan 2.26.1 md5 checksum]
** [http://www.giustetti.net/resource/pkg/x86_64/iscan-data-1.5.0-x86_64-1_sg.txz Image Scan Data 1.5.0]
** [http://www.giustetti.net/resource/pkg/x86_64/iscan-data-1.5.0-x86_64-1_sg.txz.md5 Image Scan Data 1.5.0 md5 checksum]

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:
* [[iscan_and_Slackware_14.0 |Iscan and Slackware 14.0]]
* [[iscan_and_Slackware_14.1 |Iscan and Slackware 14.1]]
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 [[Iscan_and_Slackware_14.1_update#Packages_and_Build_Scripts |web page]].


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


External links

----

* [http://avasys.jp/eng/ Avasys Corporation]
* [http://www.avasys.jp/lx-bin2/linux_e/scan/DL1.do Avasys Corporation download page]
* [http://www.gimp.org Gimp home page]
* [http://www.sane-project.org/ Sane home page]
* [http://www.slackware.com Slackware home page]

----

{{footer_en | link_page=iscan_software_64_bit}}