Changes

405 bytes added ,  11:46, 20 January 2016
Some small fixes and corrections and Syntax Highlight was enabled
Line 1: Line 1: −
Welcome to Simone Giustetti's wiki pages.
+
{{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}}
 
  −
 
  −
Languages: '''English''' - [[iscan_software |Italiano]]
  −
 
  −
----
  −
 
      
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'''.
Line 16: Line 10:       −
= '''Iscan release 2.11 and earlier''' =
+
= '''Iscan Release 2.11 and Earlier''' =
      Line 35: Line 29:       −
== '''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 .
Line 59: Line 54:     
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
Line 70: Line 66:  
   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''' ==
   −
== '''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 .
Line 104: Line 102:     
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
Line 117: Line 116:  
   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''' ==
   −
== '''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 .
Line 142: Line 143:  
   -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
Line 155: Line 157:  
   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
Line 172: Line 176:     
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
Line 200: Line 205:  
   # sane-epkowa(5).
 
   # sane-epkowa(5).
 
   #
 
   #
   '''usb'''
+
   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
Line 243: Line 248:  
   #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 --------------
 
   #
 
   #
Line 269: Line 276:  
   #
 
   #
 
   # Perfection V200 PHOTO (esfw7A.bin)
 
   # Perfection V200 PHOTO (esfw7A.bin)
   '''firmware /usr/share/iscan/esfw7A.bin'''
+
   firmware /usr/share/iscan/esfw7A.bin
 +
</syntaxhighlight>
 +
 
    +
== '''Program Start''' ==
   −
== '''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.
   Line 280: Line 289:     
[[File:iscan-01.jpeg]]
 
[[File:iscan-01.jpeg]]
 +
    
[[File:iscan-02.jpeg]]
 
[[File:iscan-02.jpeg]]
Line 285: Line 295:     
== '''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.
   Line 292: Line 303:     
== '''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 308: Line 320:  
* [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]
      
----
 
----
   −
Languages: '''English''' - [[iscan_software |Italiano]]
+
{{footer_en | link_page=iscan_software}}