
PenMount for Ubuntu 8.04


Versions
---------------------------------------------------------------------------
        Ubuntu   : 8.04 LTS
  Linux Kernel   : 2.6.24-16-generic
  X.Org X Server : 1.4.0.90


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)

  - PenMount LPC (Flybook A3/V3/V5 series)
    need penmountlpc kernel module support.



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-ubuntu804 - You're reading now.
  src/*.*          - Source code of PenMount X.Org input driver



Quick Install
---------------------------------------------------------------------------
  1) Login as user in Ubuntu login prompt

  2) Open terminal
     Applications->Accessories->Terminal

  3) Extract the PenMount Driver

  4) Config PenMount or using default configurations.(edit penmount.ini)
     
  5) Come into directory, for example
     $ cd pmlinux-ubuntu804

  6) Run install script (root permission)
     $ sudo ./install.sh
 
  7) Restart X window system
     press Ctrl-Alt-Backspace or Logout


penmount.ini Description
PenMount options in /etc/X11/xorg.conf
---------------------------------------------------------------------------
  1) Protocol
     PM9000     for PenMount9000 Device
     PM5000     for PenMount5000 Device
     PM6000COM  for PenMount6000 COM Port Device
     PM6000USB  for PenMount6000 USB Device

  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


---------------------------------------------------------------------------


Calibration
---------------------------------------------------------------------------
  1) Login as user
  2) In Ubuntu Menu
     (System) --> Preferences --> PenMount Calibration
  3) Select calibrate type what you want and press 'Calibrate' button
  4) Doing calibration
  5) Touch some red points to finish calibration
  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...)



Screen Rotation
---------------------------------------------------------------------------
  X Server must be supported XRandR v1.2

  1) 90 degree clockwise (RIGHT)
     ubuntu :~$ sudo xrandr -o right

  2) 90 degree anti-clockwise (LEFT)
     ubuntu :~$ sudo xrandr -o left

  3) 180 degree clockwise (INVERTED)
     ubuntu :~$ sudo xrandr -o inverted

  4) 0 degree clockwise (NORMAL)
     ubuntu :~$ sudo xrandr -o normal
 

FAQ
---------------------------------------------------------------------------
  None




PenMount
Oct 8, 2008

