================================================
        PenMount for openSUSE 13.2
================================================

---------------------------------------------------------------------------
            Supported Versions
---------------------------------------------------------------------------
Distribution   : openSUSE 13.2
Linux Kernel   : 3.16
X.Org X Server : 1.16.1
XInput         : 21.0
RandR          : 1.4
GTK+           : 2.24.25
Driver         : 4.2.4

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

---------------------------------------------------------------------------
             File Description
---------------------------------------------------------------------------
  evtest           - Read raw data from /dev/input/eventX for debugging.
                     Please unload penmount driver before using evtest
  gCal             - PenMount calibration utility (without UI)
                     e.g. gCal <0|4|9|16|25> <config_file>
                     e.g. gCal 4
                          (config file is saved in /etc/penmount.dat)
                     e.g. gCal 4 /tmp/penmount.dat
                          (config file is assigned in /tmp/penmount.dat)
  gDraw            - PenMount drawing test
                     e.g. gDraw
                          gDraw cross
                          gDraw point
                          gDraw -h, see the details
  install.sh       - Install script
  gPen             - PenMount utility in GNOME tray
                     Use penmount to perform calibration and another settings.
  penmount*.png    - An icon files.
  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           - You're reading now.
  xorg.conf        - The sample of X configuration file

---------------------------------------------------------------------------
              Quick Install
---------------------------------------------------------------------------
  1) Login as user in openSUSE login prompt
  2) Open terminal

     [Activities] -> [Applications] -> [Accessories] -> Gnome Terminal

  3) Change directory to where the device driver is extracted to

     $ cd pmlinux-openSUSE

  4) Change the settings in PenMount.ini or just use the default configurations.

  5) Run install script, and it will prompt for root permission
     $ ./install.sh

  6) Restart X window system to apply changes

---------------------------------------------------------------------------
                Calibration
---------------------------------------------------------------------------

  1) Start the PenMount Utility.

     In GNOME 3, the PenMount utility can be found at :

     [Activities] -> [Applications] -> [Other] -> PenMount Utility

  2) Select calibrate type and press the 'Calibrate' button.

  3) Follow the instuctions on screen and finish calibration.

  * gCal is the calibration utility can be run directly in terminal.
    gCal [4|9|16|25] - advanced calibration (4 points, 9 points...)

---------------------------------------------------------------------------
            Application Notes
---------------------------------------------------------------------------
1. Turn ON "Force Fallback Mode" if calibration screen not in fullscreen mode

 	In some rare cases with GNOME 3 desktop, the PenMount calibration screen might not be able to set on top of the taskbar, and make it difficult for user to locate the calibration points. In this case, please follow the procedure below to switch to "Force Fallback Mode" and perform calibration again.

	(1) Lanuch the system info tool in the following location :
     [Activities] -> [Applications] -> [System Tools] -> [System settings] -> System Info
	(2) In "Graphics" panel, turn the "Force Fallback Mode" option ON.
	(3) Log out then log in again to make changes take effect.
	(4) Launch PenMount utility for calibration.
	(5) If you wish to switch back to the default UI, please set the "Force Fallback Mode" OFF and login again.

---------------------------------------------------------------------------
PenMount Touch Solutions
Nov. 21, 2014
