onetouch.html

基于linux的串口声波屏驱动

Previous:<a rel=previous href="#XFree%204.x">XFree 4.x</a>,
Up:<a rel=up href="#XFree%20Configuration">XFree Configuration</a>
<br>

<h3>Generic X Configuration</h3>

<p>Please note that with XFree you can still
use a  normal mouse together with  the touch panel. Also,
can use the touch screen as its only pointer device.

<p>If,  when calling  <code>startx</code>, it  fails with  a message  of
<code>Invalid Subsection  Name</code>, please  check the  previous error
lines,  as they explain what is wrong. They usually look like:

<br><pre>(--) no ModulePath specified using default: /usr/X11R6/lib/modules
xf86Onetouch.so: Unknown error loading module
</pre>

<p>The messages are pretty clear, if your  are careful in reading them (I am
not that careful,  and lose half an hour in trying  to figure out what
was wrong).

<p><hr>
Node:<a name="Calibration">Calibration</a>,
Next:<a rel=next href="#Support%20Tools">Support Tools</a>,
Previous:<a rel=previous href="#XFree%20Configuration">XFree Configuration</a>,
Up:<a rel=up href="#Top">Top</a>
<br>

<h2>Calibration</h2>

<p>To calibrate the touch panel, run the <code>onetouch_calib</code> script, under X.

<p>The program needs  to find <code>onetouch_control</code> and
<code>onetouch_to_ascii</code> in the  command search path or the current
directory. This usually means you can simply "<code>make install</code>"
before running the calibration, but you can also run the calibration
program from the source directory, provided "<code>.</code>" is in your
<code>PATH</code>.

<p>The control program is used to turn off the touchscreen in X, so the
calibrator can read input data (see <a href="#onetouch_control">onetouch_control</a>). The
conversion tool is used so that the calibrator can read
ASCII data instead of binary data (see <a href="#onetouch_to_ascii">onetouch_to_ascii</a>).

<p>The new 5-point calibration, as of release 1.2 of the package, is a
full-screen application that takes complete control of your
desktop. Since it disables the touchscreen in X in order to directly
read the serial port, you'll need to invoke "<code>onetouch_control
on</code>" or "<code>onetouch_control raw</code>" if the program terminates
unexpectedly.  Premature death of the application is not foreseeable,
but you may want to send a termination signal to the calibrator for
whatever reason. See <a href="#onetouch_control">onetouch_control</a>.

<ul>
<li><a href="#Support%20Tools">Support Tools</a>: 
</ul>

<p><hr>
Node:<a name="Support%20Tools">Support Tools</a>,
Previous:<a rel=previous href="#Calibration">Calibration</a>,
Up:<a rel=up href="#Top">Top</a>
<br>

<h2>Support Tools</h2>

<p>The package includes three tools that work by connecting with the X server:

<ul>
<li><a href="#onetouch_control">onetouch_control</a>: 
<li><a href="#onetouch_panel">onetouch_panel</a>: 
<li><a href="#onetouch_to_ascii">onetouch_to_ascii</a>: 
<li><a href="#warp">warp</a>: 
</ul>

<p><hr>
Node:<a name="onetouch_control">onetouch_control</a>,
Next:<a rel=next href="#onetouch_panel">onetouch_panel</a>,
Previous:<a rel=previous href="#Support%20Tools">Support Tools</a>,
Up:<a rel=up href="#Support%20Tools">Support Tools</a>
<br>

<h3>onetouch_control</h3>

<p>The program receives a single command-line argument and uses it as
a command to be performed by communicating with the X server.

<p>The following commands are supported:

<dl>

<br><dt><code>devinfo</code>
<dd>
Report device information to standard output. The information is
about the input devices active in the current X server. In order
for the other commands to succeed, the server must have exactly one
touch panel configured. See <a href="#XFree%20Configuration">XFree Configuration</a>.

<br><dt><code>off</code>
<dd>
Deactivate the input device. The command makes the driver stop
reading the serial port, so the calibration program (or
otherwise) can read touchscreen data.

<br><dt><code>on</code>
<dd>
Activate the input device. The command tells the driver to start
reading the serial port again and activate the current calibration. 
If no calibration file is found the touchscreen will work in raw mode.

<br><dt><code>raw</code>
<dd>
Activate the input device in raw mode. Even if a calibration file
exists, it will not be used until the <var>on</var> command is issued. 
The command is meant to stop using wrong calibration information
that sometimes may be generated by error.

<br><dt><code>b1</code>
<dd>
Generate button-1 press and release events (the default).

<br><dt><code>b2</code>
<dt><code>b3</code>
<dd>
Generate button-2 (middle button) events from now on, likewise
for button-3 (right button).

<br><dt><code>b2once</code>
<dt><code>b3once</code>
<dd>
Generate a button-2 event for the next press and release events,
and then turn back to reporting button-1 events. The program
won't terminate until the button-2 events have been reported. 
Likewise for button-3.

<br><dt><code>getleds</code>
<dd>
Return to standard output information about the current status
of device leds. There are no physical leds on the touchscreen device,
but the "led" abstraction is what has been used to send commands
to the driver. This command is useful to me but very unlikely to
be useful to anyone else.

</dl>

<p><hr>
Node:<a name="onetouch_panel">onetouch_panel</a>,
Next:<a rel=next href="#onetouch_to_ascii">onetouch_to_ascii</a>,
Previous:<a rel=previous href="#onetouch_control">onetouch_control</a>,
Up:<a rel=up href="#Support%20Tools">Support Tools</a>
<br>

<h3>onetouch_panel</h3>

<p>The program is a simple graphical application to control generation of
button-2 and button-3 mouse events. Running the application is optional,
and you won't need to run it if your setup only uses button-1 events.

<p>The program window is made up of two buttons, labelled "2" and "3". 
They are inactive by default.

<p>After clicking on one of the buttons, it becomes yellow and the touch
screen will report a button-2 or button-3 event once. After the event is
reported the button turns back gray and the touchscreen will go back to
report button-1 events.

<p>After clicking twice on one of the buttons, the button becomes red and
button-2 or button-3 events will be generated from now on. To go back to
button-1 events just click on the button again to inactivate it.

<p><hr>
Node:<a name="onetouch_to_ascii">onetouch_to_ascii</a>,
Next:<a rel=next href="#warp">warp</a>,
Previous:<a rel=previous href="#onetouch_panel">onetouch_panel</a>,
Up:<a rel=up href="#Support%20Tools">Support Tools</a>
<br>

<h3>onetouch_to_ascii</h3>

<p>The program reads from the serial port specified on the command-line and
converts binary packet to ascii information. Besides being used by the
calibration program, the program can be used for basic diagnosis of
hardware problems.

<p><hr>
Node:<a name="warp">warp</a>,
Previous:<a rel=previous href="#onetouch_to_ascii">onetouch_to_ascii</a>,
Up:<a rel=up href="#Support%20Tools">Support Tools</a>
<br>

<h3>warp</h3>

<p>The program moves  the mouse pointer.  It can  be used to move
the mouse when  there is no active mouse.  It accepts a series
of  letters on the  command line:  each uppercase  N, S,  W, E
moves the  pointer by  100 pixels to  the north,  south, west,
east.  Each lowercase  n,  s, w,  e  moves the  pointer by  10
pixels.


<h2>Table of Contents</h2>
<ul>
<li><a name="toc_Top"></a>
    <a href="#Top"></a>
<li><a name="toc_General%20Information"></a>
    <a href="#General%20Information">General Information</a>
<li><a name="toc_Device%20Support"></a>
    <a href="#Device%20Support">Device Support</a>
<li><a name="toc_XFree%20Configuration"></a>
    <a href="#XFree%20Configuration">XFree Configuration</a>
<ul>
<li><a href="#XFree%204.x">XFree 4.x</a>
<li><a href="#Generic%20X%20Configuration">Generic X Configuration</a>
</ul>
<li><a name="toc_Calibration"></a>
    <a href="#Calibration">Calibration</a>
<li><a name="toc_Support%20Tools"></a>
    <a href="#Support%20Tools">Support Tools</a>
<ul>
<li><a href="#onetouch_control">onetouch_control</a>
<li><a href="#onetouch_panel">onetouch_panel</a>
<li><a href="#onetouch_to_ascii">onetouch_to_ascii</a>
<li><a href="#warp">warp</a>
</ul>
</ul>

</body></html>