using.sgml

usb develop guide

<Sect2><title>Console mode keyboard mappings</title>

<para>
To be completed, but basically you use the <command>showkey -s</command>
to get the raw scancodes, and then use <command>setkeycodes</command>
to modify the keymap or <command>loadkeys</command> to load a new
keymap. Then you can assign the translated keycode to whatever makes sense
for the application program.
</para>

</Sect2>

<Sect2><title>X keyboard mappings</title>
<para>
To be completed, but basically you use the <command>showkey -s</command>
or <command>xev</command> to get the raw scancodes, and then use
<command>xmodmap</command> to modify the keyboard map.
</para>

</Sect2>
</Sect1>

<Sect1>
<title>Communicating with the Handspring Visor</title>

<para>
To be done.
</para>

</Sect1>

<Sect1>
<title>Communicating with the Diamond Rio 500</title>

<para>
To be done.
</para>

</Sect1>

<Sect1>
<title>Using a USB Scanner</title>

<para>
As noted in the installation part, the scanner driver provides a link
for a suitable user space program to access the scanner hardware. This
section deals with getting the user space program (SANE) set up correctly.
</para>

<para>
If you don't have SANE installed, you can get it from from the
any of the sites referenced at <ulink
url="http://www.mostang.com/sane/source.html">
http://www.mostang.com/sane/source.html</ulink>.
</para>

<para>
At this point, you need to do different things depending on what sort of scanner
you have. Mostly you need to change configuration files.
If you selected the default install location, SANE's configuration
files are located in <FileName>/usr/local/etc/sane.d/</FileName>. If SANE
came installed with your distribution, the configuration files are probably in
<FileName>/usr/etc/sane.d/</FileName>.
</Para>

<Sect2><title>Hewlett Packard Scanners</title>

<para>
Not all Hewlett Packard scanners are supported by the sane-hp backend driver.
The only ones with a reasonable chance of working are HP4100C, HP5200C,
HP6200C and HP6300C. The Photosmart S20 should also work.
Note that the HP3300C and HP4200C are not included in
the devices with a working backend.
</para>

<para>
For a HP scanner, you need to change
<FileName>/usr/local/etc/sane.d/hp.conf</FileName> to contain just the
following two lines:
<screen>
/dev/usb/scanner0
  option connect-device
</screen>
</para>

</Sect2>

<Sect2><title>Epson Scanners</title>

<para>
The Perfection 636U and Perfection 1200U scanners have a reasonable
chance of working with the sane-epson backend driver.
</para>

<para>
For an Epson scanner, you need to
<FileName>/usr/local/etc/sane.d/epson.conf</FileName> to contain the
following line:
<screen>
usb /dev/usb/scanner0
</screen>
</para>

</Sect2>

<Sect2><title>AGFA ScapScan 1212U</title>

<para>
This scanner comes in two versions. The version 2 model needs its firmware
downloaded. Both version 1 and version 2 need patches to SANE.
</para>

<para>
Check the driver disk that came with your scanner for a file named
<filename>SnapScan 1212U_2.bin</filename>. If there is no file by that name,
you probably have a version 1 scanner and can proceed on.
Otherwise you need to copy that file off,
and obtain a suitable firmware downloader, such as the agfafirm tool from
<ulink url="http://hem.fyristorg.com/henrikj/snapscan/downloads/agfafirm">
http://hem.fyristorg.com/henrikj/snapscan/downloads/agfafirm</ulink>. With this
tool, you then do
<command>agfafirm /dev/usb/scanner0 "SnapScan 1212U_2.bin"</command>. The status
lamp on the scanner should flash.
</para>

<para>
You need to modify the SANE sane-snapscan backend. This requires the source
code. Complete the following steps:
<itemizedlist>
<listitem><para>Obtain the source code from
<ulink url="ftp://ftp.mostang.com/pub/sane/sane-1.0.1.tar.gz">
 ftp://ftp.mostang.com/pub/sane/sane-1.0.1.tar.gz</ulink>.</para></listitem>
<listitem><para>unpack the sources with the following command:
<command>tar xvzf sane-1.0.1.tar.gz</command></para></listitem>
<listitem><para>change into the sane source directory:
<command>cd sane-1.0.1</command></para></listitem>
<listitem><para>obtain the required patch from
<ulink url="http://hem.fyristorg.com/henrikj/snapscan/downloads/sane-1.0.1-usb.diff">
http://hem.fyristorg.com/henrikj/snapscan/downloads/sane-1.0.1-usb.diff</ulink>.
</para></listitem>
<listitem><para>Apply the patch with the following command:
<command>patch -p1 < sane-1.0.1-usb.diff</command></para></listitem>
<listitem><para>Build and install SANE with the following command:
<command> ./configure; make; make install</command></para></listitem>
</itemizedlist>
</para>

<para>
Note that this patch will not apply cleanly to SANE 1.0.2, but there you can
either apply the rejects by hand or use a development patch. I assume that if
you can do this, you won't need detailed instructions.
</para>

<para>
If you do not have a functional SANE at this point, likely problems are
linking to an obsolete SANE backend (check your install target for old
libsane-snapscan entries.
</para>
</Sect2>

<Sect2><title>Prisa Acerscan Scanners</title>

<para>
In addition to SANE changes, the Prisa Acerscan 620U and 640U need
firmware downloaded.
</para>

<para>
Check the driver disk that came with your scanner for a file named
<filename>u96v057.bin</filename> in the
<filename>DRIVERS/DISK1/BIN/</filename> directory. Copy this
file off the driver disk.
</para>

<para>
You need to obtain a suitable firmware downloader, such as the acerfirm tool from
<ulink url="http://utopia.knoware.nl/~joey/linux/acerfirm">
http://utopia.knoware.nl/~joey/linux/acerfirm</ulink>. With this
tool, you then do
<command>acerfirm /dev/usb/scanner0 "u96v057.bin"</command>. The status
lamp on the scanner should flash.
</para>

<para>
You need to modify the SANE sane-snapscan backend. This requires the source
code. Complete the following steps:
<itemizedlist>
<listitem><para>Obtain the source code from
<ulink url="ftp://ftp.mostang.com/pub/sane/sane-1.0.1.tar.gz">
 ftp://ftp.mostang.com/pub/sane/sane-1.0.1.tar.gz</ulink>.</para></listitem>
<listitem><para>unpack the sources with the following command:
<command>tar xvzf sane-1.0.1.tar.gz</command></para></listitem>
<listitem><para>change into the sane source directory:
<command>cd sane-1.0.1</command></para></listitem>
<listitem><para>obtain the required patch from
<ulink url="http://hem.fyristorg.com/henrikj/snapscan/downloads/sane-1.0.1-usb.diff">
http://hem.fyristorg.com/henrikj/snapscan/downloads/sane-1.0.1-usb.diff</ulink>.
</para></listitem>
<listitem><para>Apply the patch with the following command:
<command>patch -p1 < sane-1.0.1-usb.diff</command></para></listitem>
<listitem><para>Hand edit the following area in
<filename>backend/snapscan.h</filename>
<programlisting>
static struct SnapScan_Model_desc scanners[] =
{
  /* SCSI model name -> enum value */
  { "FlatbedScanner_4", VUEGO310S },
  { "SNAPSCAN 1212U", SNAPSCAN1236S },
  { "SNAPSCAN 1212U_2", SNAPSCAN1236S },
  { "SNAPSCAN 1236",    SNAPSCAN1236S },
  { "SNAPSCAN 310",     SNAPSCAN310 },
  { "SNAPSCAN 600",     SNAPSCAN600 },
  { "SnapScan",         SNAPSCAN300 },
};
</programlisting>
to include the following additional entry:
<programlisting>
 { "FlatbedScanner13",  SNAPSCAN600 },
</programlisting>
</para></listitem>
<listitem><para>Build and install SANE with the following command:
<command> ./configure; make; make install</command></para></listitem>
</itemizedlist>
</para>

<para>
Note that this patch will not apply cleanly to SANE 1.0.2, but there you can
either apply the rejects by hand or use a development patch. I assume that if
you can do this, you won't need detailed instructions.
</para>
</Sect2>

<Sect2><title>Using SANE</title>
<Para>
You should now be able to use a SANE frontend
(<UserInput>xscanimage</UserInput>
 or <UserInput>scanimage</UserInput>) to scan images. You may need to
 specify what device you are using as a command line option (-d) to
 <UserInput>scanimage</UserInput>. Much more information is available
 in the various SANE man pages, including how to get <ulink
 url="http://www.gimp.org">GIMP</ulink> and
 <UserInput>xscanimage</UserInput> working together.
</>
</Sect2>

</Sect1>
</Chapter>