readme

Linux driver for PenMount USB touch panel

PenMount USB Linux X Window drivers & utilities Version 1.01 (Support XFree86 version 4.x.x only!)

Files:
Driver/penmount_drv.o         -- Penmount XFree86 4.X driver
Driver/RedHat7.1/             -- Penmount Linux 2.4 kernel module driver for RedHat 7.1
Driver/RedHat7.2/             -- Penmount Linux 2.4 kernel module driver for RedHat 7.2
Driver/RedHat7.3/             -- Penmount Linux 2.4 kernel module driver for RedHat 7.3
Driver/RedHat8/               -- Penmount Linux 2.4 kernel module driver for RedHat 8
Driver/RedHat9/               -- Penmount Linux 2.4 kernel module driver for RedHat 9
Driver/Module_src             -- Penmount Linux 2.4 kernel module driver source code
Calibration/pencal-2.00       -- Penmount calibration utility
Calibration/bcircle.xpm       -- bitmap file, for Penmount calibration utility
Calibration/rcircle.xpm       -- bitmap file, for Penmount calibration utility
XF86Config.sample             -- XF86Config sample
usb.handmap.sample            -- usb.handmap sample

**Pleasae Select "Ignore", 
  when the "New Hardware Checking" find a new "USB MOUSE" while booting Linux with PENMOUNT USB.

A. Kernel Driver Module installation procedures:

  1. Login system with "root", and check your XFree86 version
     # cd /root         
  
  2. copy kernel module "penmountusb.o" to /lib/modules/<kernel version>/kernel/drivers/usb. 
     **For Redhat 7.1,
       #cp Driver/RedHat7.1/penmountusb.o /lib/modules/2.4.2-2/kernel/drivers/usb       
       #depmod -a
     
     **For Redhat 7.2, 
       #cp Driver/RedHat7.2/penmountusb.o /lib/modules/2.4.7-10/kernel/drivers/usb       
       #depmod -a
       
     **For Redhat 7.3, 
       #cp Driver/RedHat7.3/penmountusb.o /lib/modules/2.4.18-3/kernel/drivers/usb       
       #depmod -a
         
     **For Redhat 8, 
       #cp Driver/RedHat8/penmountusb.o /lib/modules/2.4.18-14/kernel/drivers/usb       
       #depmod -a

     **For Redhat 9, 
       #cp Driver/RedHat9/penmountusb.o /lib/modules/2.4.20-8/kernel/drivers/usb       
       #depmod -a

     **For Other Distribution and Other Kernel Version, please re-build the module source
       #cd Driver/Module_src/   (Modify "build" for your "kernel version" first)
       #./build 
       #cp penmountusb.o /lib/modules/2.4.x-x/kernel/drivers/usb (2.4.x-x by your kernel version)      
       #depmod -a                                    
  
  3. Edit /etc/hotplug/usb.handmap and copy&paste a new line for Penmount USB.       
       #gedit usb.handmap  (or you can use "vi" Text Editor)(Please refer to usb.handmap.sample)
       
     evdev  0x0003 0x1204   0x9998    0x0000       0x0000       0x00         0x00            0x00            0x00            0x00            0x00            0x00000000
  
  4.  Add the penmountusb module by executing the following script.
      #modprobe -r hid
      #modprobe -r usbmouse
      #modprobe evdev
      #modprobe penmountusb
      #modprobe hid   
           
B. XFree86 4.0 Driver Module installation procedures:  
  
  1. copy penmount driver "penmount_drv.o" to "/usr/X11R6/lib/modules/input".
     # cp Driver/penmount_drv.o /usr/X11R6/lib/modules/input
     
  2. Check your XFree86 Version  
     # cd /etc/X11
     # X -version            
     ( If the screen shows "XFree86 Version 4.x.x / X Window System", go to step 3. 
       If not, you can not run driver)
       You must make sure 4.x.x has supported your video card, and then re-link X file.
     #rm X
     #ln -s /usr/X11R6/bin/XFree86 X
     #mv XF86Config XF86Config.old
     #mv XF86Config-4 XF86Config
     #ln -s XF86Config XF86Config-4

                               
  
  3. Edit XF86Config file to load driver. You can refer to "XF86Config.sample".       
     
     a. # gedit /etc/X11/XF86Config  (or you can use "vi" Text Editor)(Copy & Paste)
                                          
     b. In the Section "ServerLayout", add a statement :

        InputDevice    "Penmount" "AlwaysCore"

     c. Add a Section "InputDevice" :

        Section "InputDevice"
        
	Identifier  "PenMount"
	Driver      "penmount"
	Option      "Protocol"	   "Auto"
	Option      "Device"	   "/dev/input/event0"
	Option      "PMode"        "1"
	Option	    "MinX"	   "10"
	Option	    "MaxX"	   "1000"
	Option	    "MinY"	   "10"
	Option	    "MaxY"	   "1000"
	Option      "Beep"         "1"		#  0 = no beep, 1 = beep enabled
        Option      "PressVol"     "100" 	#  volume of beep (press event)
        Option      "PressPitch"   "880" 	#  pitch of beep (press event)
        Option      "PressDur"     "15" 	#  length of beep in 10ms (press event)
        Option      "ReleaseVol"   "0"		#  volume of beep (release event)
        Option      "ReleasePitch" "1200"	#  pitch of beep (release event) 
        Option      "ReleaseDur"   "10"		#  length of beep in 10ms (release event)	
        EndSection        
  

C. Calibration Utilities Installation procedures:

  1. Copy the Calibrate file into the "/usr/local/pencal" directory.
     # mkdir /usr/local/pencal
     # cp /mnt/cdrom/Driver/Linux\ XFree86\ 4.x.x\ V1.0/Calibration/*.* /usr/local/pencal
     

  2. Input "startx" to start X window.
     # startx

  3. In the X window system, open a terminal window and type
     # cd /usr/local/pencal
     # ./pencal-2.00

  The screen will show a PenCal window. Please follow the 4 red points to do calibration.
  When the PenCal window shows "Finished! Please restart X window", 
  wait a moment until the PenCal window eliminated, and restart the X window system.
  
  4. To get more information, type
     # ./pencal-2.00 --help 

Apex Material Technology INTERATIONAL CORP.
2003.