README.xf86EloUsb, 2000-12-02


*** Info

xf86EloUsb.c is a Xinput Driver Module, providing pointer functionality
for linux-usb /dev/input/eventX based, absolute-coordinate emitting 
pointing devices, such as touchscreens.

This driver was tested with Xfree86 3.3.6 on Apple iMac hardware with the Elotouch
iTouch Touchscreen device only, but it should work with any other usb-event device
providing equal events.


*** Download

xf86EloUsb is available for download at http://www.linuxaustria.at/dist/x11/


*** Installing

In order to use this driver, youŽll need USB support in the linux kernel.
We used Linux 2.2.18pre24 for testing, as it contains a recent USB backport.
You will also need the evdev kernel driver (in the standard usb-kernel),
either compiled in or as a module.
Create the /dev/input/eventX device nodes:

	mkdir /dev/input
	mknod /dev/input/event0 13 64
	mknod /dev/input/event1 13 65
	mknod /dev/input/event2 13 66
	mknod /dev/input/event3 13 67

The binary module provided is compiled for XFree86 3.3.6 on LinuxPPC
(Suse 6.4 for PowerPC).

Copy the module in the X11 module include path.

"ModulePath" parameter in section "Files" in your
/etc/XF86Config or /etc/X11/XF86Config.

Add the following SubSection in the Xinput section:
(Section "Xinput")
    SubSection "Elographics"
        Port "/dev/input/event2"
        DeviceName "Elo"
        MinimumXPosition 184
        MaximumXPosition 3932
        MinimumYPosition 3830  # swap Y axe by exchanging Min/Max
        MaximumYPosition 66
	#SwapXY                # swap X with Y axe
        AlwaysCore
    EndSubSection
(EndSection)

If you donŽt use a normal mouse also (section "Pointer")
add this:
	Section "ServerFlags"
	  AllowMouseOpenFail
	EndSection



*** Compiling

To compile the module yourself, youŽll need to get the Xfree86 source tree
and compile it accoring to the documentation provided.

On iMac:
After compiling X itself, place xf86EloUsb.c in xc/programs/Xserver/hw/xfree68/common.
Copy MAKEELOUSB from the xf86EloUsb archive there and execute it.

You should then have a working Xinput module.

It should also compile smoothly on x86 platforms.

NB: Any hints for more convenient compiling are very welcome.  


*** Thanks to

Vojtech Pavlik <vojtech@suse.cz> for help with USB stuff
Patrick Lecoanet <lecoanet@cena.dgac.fr> for providing the original xf86Elo driver


*** References

www.elotouch.com
www.linux-usb.org
www.linuxppc.org
www.suse.com
www.linuxaustria.at


*** Copyright Notice

Copyright 2000 Michael Petruzelka, 
pitrich information technologies <info@linuxaustria.at>

Based on xf86Elo.c which is
Copyright 1995, 1999 by Patrick Lecoanet, France. <lecoanet@cena.dgac.fr>

Permission to use, copy, modify, distribute, and sell this software and its
documentation for any purpose is  hereby granted without fee, provided that
the  above copyright   notice appear  in   all  copies and  that both  that
copyright  notice   and   this  permission   notice  appear  in  supporting
documentation, and that   the  name of  Patrick  Lecoanet not  be  used  in
advertising or publicity pertaining to distribution of the software without
specific,  written      prior  permission.     Patrick Lecoanet   makes  no
representations about the suitability of this software for any purpose.  It
is provided "as is" without express or implied warranty.

THE AUTHOR(S) DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
EVENT  SHALL ANY AUTHOR BE LIABLE FOR ANY SPECIAL, INDIRECT OR
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
DATA  OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
TORTIOUS  ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
PERFORMANCE OF THIS SOFTWARE.


