
~~~ PenMount for Fedora 9 ~~~


Versions
---------------------------------------------------------------------------
  Linux Kernel   : 2.6.25-14-fc9
  X.Org X Server : 1.4.99.901 (1.5.0 RC1)
  Module ABI Version :
    X.Org ANSI C Emulation : 0.3
    X.Org Video Driver     : 4.0
    X.Org XInput driver    : 2.0
    X.Org Server Extension : 1.0
    X.Org Font Renderer    : 0.5


PenMount Support
---------------------------------------------------------------------------
  - PenMount 5000 series (USB, low speed)
  - PemMount 6000 series (USB, full speed)
  - PemMount 9000 series (Serial, 19200/9600 bps)
  - PemMount 6000 series (Serial, 19200/9600 bps)

File Description
---------------------------------------------------------------------------
  gCal             - PenMount calibration utility (without UI)
                     e.g. gCal <0|4|9|16|25>
  gCalib           - PenMount calibration utility (gtk support)
  install.sh       - Install script
  penmount.dat     - Default calibration data file
                     It will be created after calibration.
  penmount.desktop - GNOME menu item entry
  penmount_drv.so  - X.Org input driver for PenMount
  penmount.png     - An icon for GNOME menu item
  pm-setup         - PenMount setup utility. It can configure the PenMount
                     driver and X configuration file (/etc/X11/xorg.conf)
  penmount.ini     - Default settings for /etc/X11/xorg.conf
  README-fedora9   - You're reading now.
  src/*.*          - Source code of PenMount X.Org input driver


Quick Install
---------------------------------------------------------------------------
  1) Login as root in Fedora 9
  2) Open terminal
     Applications->System Tools->Terminal
  3) Come into directory
     # cd pmlinux-fedora9
  4) Run install script
     # ./install.sh
  5) Config PenMount or using default configurations.
  6) Restart X window system
     press Ctrl-Alt-Backspace or Logout
  7) Run calibration utility 
     (System->Preference->Hardware->PenMount Calibration)

Calibration
---------------------------------------------------------------------------
  1) Login as root
  2) In Fedora Menu
     (System->Preference->Hardware->PenMount Calibration)
  3) Select calibrate type what you want and press 'Calibrate' button
  4) Do calibration
  5) Touch the red points by sequence until calibration finishs.
  6) After calibration,
     The calibration data will be stored at /etc/penmount.dat.

P.S.
  1) gCal is calibration tool without UI.
     gCal 0 - standardard calibration
     gCal [4|9|16|25] - advanced calibration (4 points, 9 points...)



 
X.Org configuration file
---------------------------------------------------------------------------
  /etc/X11/xorg.conf

  There are two sections need to modified.
  
  1) add 'InputDevice   "Penmount" in ServerLayout section :

  Section "ServerLayout"
          Identifier      "Default Layout"
          ..................
          InputDevice     "Penmount"
  EndSection

  2) add Penmount section into the file

  Section "InputDevice"
          Identifier     "Penmount"
          Driver         "penmount"
          Option         "Protocol"    "PM9000"
          Option         "Device"      "/dev/ttyS0"
  EndSection


PenMount options in /etc/X11/xorg.conf
---------------------------------------------------------------------------
  1) Protocol
     PM9000 or PM6000COM (for COM port, useless if USB)

  2) Device
     /dev/ttyS0... device node (useless if USB)

  3) ScreenNumber
     screen number of X window (default 0)

  4) XMinOffset
     XMaxOffset
     YMinOffset
     YMaxOffset
     (default : 10)
     value : 0~30, for edge offset in calibration.

  5) StdXMin
     StdXMax
     StdYMin
     StdYMax
     standard calibration data

  6) ScreenScale
     (default : 0)
     value : 0 or 1

  7) Rotation
     (default : 1)
     value : 1, 2, 4 and 8

  8) AveragePoint
     fuzz point (default : 0)
     value : 0, 4, 8
     4 = 4 points average
     8 = 8 points average

  9) Beep
     (default : 1)
     (value : 0=off, 1=on)
     beep when pen up or pen down.

 10) PressVol   (default: 100)
     PressPitch (default: 880)
     PressDur   (default: 15)
     beep for pen down

 11) ReleaseVol   (default: 0) slience
     ReleasePitch (default: 1200)
     ReleaseDur   (default: 10)
     beep for pen up
 
 12) HoldTime
     (default: 500000 micro-seconds, 0.5 seconds)
     press and hold to issue button2(right or middle)
 
 13) CalibHoldTime
     (default: 1500000 micro-seconds, 1.5 seconds)
     press and hold for calibration

 14) LockWindowRange
     (default: 64)

 15) Button2
     (default: 3, right)
      1=middle

 16) PenDownMode
     (default: 0, stream mode)
     1=point mode  (issue left-down and left-up when pen-down)
     0=stream mode (issue left-down when pen-down; issue left-up when pen-up)

 17) ADBit
     (default: 10, 10-bit)
     value: 10 or 12
     raw data A/D

 18) ReportingMode
     "raw" - for raw data reporting
     others - for scaled data reporting

 19) ConfigFile
     (default: /etc/penmount.dat")
     This file is penmount calibration data


---------------------------------------------------------------------------
PenMount
Sep 19, 2008

