QuickStart Guide for touch screen driver and calibration utility

mmmtouch_drv and mmmcalibrate are copyright Gerald Duprey, 2001 <gerry@cdp1802.org>

1) Insure you are using a 3M Touch screen attached to a 
   SC3 or SC4 serial controller.  The controller needs to be attached 
   to a serial port and you need to know that serial ports name 
   (i.e. /dev/ttyS0).  If the controller has been changed from
   factory defaults, you should reset it first.

2) Install the files
   * Copy mmmtouch_drv.o to /usr/X11R6/lib/modules/input
   * Copy mmmtouch.4 to /usr/X11R6/man/man4/mmmtouch.4
   * Copy mmmcalibrate.1 to /usr/X11R6/man/man1/mmmcalibrate.1
   * Copy mmmcalibrate to /usr/local/bin (or another directory
     in your PATH)

   The man files should be world readable.  The mmmtouch_drv.o
   need only be readable to the X server.  mmmcalibrate should
   be marked executable by those who should and can recalibrate
   the touch screen.

3) Using the templates in the mmmtouch man page, edit your XF86Config
   to enable touch screen support.  If using an SC4 controller, 
   be sure to read the man page details about the necessary
   changes to make an SC4 controller work.  It WILL NOT WORK
   until you make the changes outlined to your XF86Config.

4) Restart your XFree86 server.  Be sure to set the umask on the
   shell command line appropriatly before restarting (check the
   man page, but in general, using a "umask 0" before starting
   the X server will get you running).

5) The first time it starts, the calibration an orientation will most 
   likely be wrong.  From a shell prompt, insure your DISPLAY points
   to the touch screen device and issue the mmmcalibrate command.  

   Using a bluntly sharp item (like a palm pilot stylus or a
   dull wooden pencil), touch the center black spot of the displayed
   target.  There are four "samples" taken.  NOTE: The touch screen is
   reasonably easy to damage - don't use anything with a sharp point
   on it to calibrate.

6) The calibration will take place immediately (try it) and store
   the calibration data into the XF86Configured location (by default,
   /etc/touch.dat).  The server will reload it each to it restarts
   in the future.

That's it! 


Updated January 15, 2002
