
PenMount for Ubuntu

-----------------------------------------------------------------------
Overview
-----------------------------------------------------------------------
  This driver was tested in Ubuntu 6.06.1-LTS, 6.10, and 7.04.

  o Ubuntu 6.06.1 LTS
     . Kernel   : 2.6.15.26-386
     . X Window : X.Org 7.0.0

  o Ubuntu 6.10
     . Kernel   : 2.6.17-10-generic
     . X Window : X.Org 7.1.1

  o Ubuntu 7.04
     . Kernel   : 2.6.20-15-generic
     . X Window : X.Org 7.2.0

-----------------------------------------------------------------------
Control Board
-----------------------------------------------------------------------
PenMonut 9000
  Interface : Serial port
  Baudrate  : 19200 / 9600 bps
  
PenMount 5000
  Interface : USB port (low speed)

PenMount 6000
  Interface : Serial Port
  Baudrate  : 19200 / 9600 bps

PenMount 6000
  Interface : USB port (full speed)

-----------------------------------------------------------------------
File List
-----------------------------------------------------------------------
xdrv-adv/
  - penmount_drv.so
    X.Org input driver for PenMount multi-point version

xdrv-std/
  - penmount_drv.o
    X.Org input driver for PenMount 4-point version

adv-calib
    Advanced calibration utility (multi-point)

std-calib
    Standard calibration utility (4-points)

std-calib-src/
    Standard calibration utility source code

pm-setup
    PenMount setup utility. It can configure the PenMount
    driver and X configuration file (/etc/X11/xorg.conf)

pm-sniff
    PenMount sniffer. A debug utility for checking PenMount
    on serial port. The utility works without PenMount
    driver. Make sure that the driver is unloaded before
    using it. 

pm-sniff-usb
    PenMount sniffer. A debug utility for checking PenMount
    on USB port.

pm-report
    Collect some informations for debugging to PenMount. If you
    have any problems about PenMount, you can issue the
    following command as root.

    # ./pmreport > pmreport.log

    Then send back the log file pmreport.log to PenMount.
    <mailto://penmount@seed.net.tw>

README-ubuntu
    You're reading now.

-----------------------------------------------------------------------
 Quick Install
-----------------------------------------------------------------------
  1. Login as user in Ubuntu login prompt
  2. Open terminal (Applications->Accessories->Terminal)
  3. Get the tarball file (pmlinux-ubuntu-xxxxx.tgz)
  4. Extract the tarball (tar xvfz pmlinux-ubuntu-20070627.tgz)
  5. Change directory (cd pmlinux-ubuntu)
  6. Installation (sudo ./install.sh)


-----------------------------------------------------------------------
 Right Button Feature
-----------------------------------------------------------------------
    (Time) (100ms)
                        1 1 1 1 1 1
    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5
    D.....U...|...D...|..U.........
              |       |
              start   end
    D : pen down
    U : pen up
 start: right button region start 
   end: right button region end

  If the 2nd pen down between start and end, send right button.

  You can setup start time and duration time at pm-setup.
  We recommaned:
  start time = 500 ms
  duration   = 400 ms (end time = 900ms)

-------------------------------------------------------------------
 How to Calibrate PenMount
-------------------------------------------------------------------
1. Login as user

2. Ubuntu (Application) --> Accessories --> Terminal

3. cd pmlinux-ubuntu
   (e.g. if pmlinux-ubuntu is extracted directory.)

4.
   $ sudo ./adv-calib [4|9|16|25]
   If advanced driver was installed. 4 is 4-point, 9 is 9-point and so on.
   or
   $ sudo ./std-calib
   If standard driver was installed.

5. Touch the red points

6. After calibration, the calibration data will be stored at
   /etc/penmount.dat. Please don't modify it.

-------------------------------------------------------------------
 Trouble shooting
-------------------------------------------------------------------
1. PenMount is not working, how can I do?

Ans:
     <1> Press Ctrl+Alt+Backspace to reload X window.

     <2> When the PenMount USB is not working, you can try this:

         Remove the configurations of X about wacom (/etc/X11/xorg.conf)
         In the section 'ServerLayout', please add '#' at head of line
         
         Section "ServerLayout"
         ..............
         #       InputDevice      "stylus"        "SendCoreEvents"
         #       InputDevice      "cursor"        "SendCoreEvents"
         #       InputDevice      "erasor"        "SendCoreEvents"
         ...............
         EndSection

     <3> To make sure the PenMount USB driver (usbhid) is loaded.

         Issue the following command:
         # more /proc/bus/usb/devices

         You will see like this:
         ....................
         P:  Vendor=14e1 ProdID=6000 Rev=a4.b4
         S:  Manufacturer=DIALOGUE INC
         S:  Product=PenMount USB
         ......................
         I:  If#= 0 Alt= 0 #EPs= 2 Cls=03(HID  ) Sub=01 Prot=02 Driver=usbhid
         ........................

         where :
         'Driver=usbhid' :  It means the driver was loaded.
         'Driver=(none)' :  It means the driver was NOT loaded.

         If the file /proc/bus/usb/devices is disappear, you can try
         the command:
         # mount -t usbdevfs none /proc/bus/usb

         The file is still disppear, it means the kernel without 
         'USB device filesystem'. 

     <4> Make sure the input driver is loaded.
 
         Issue the following command:
         # more /proc/bus/input/devices

         You will see like this:
         ....................
         I: Bus=0003 Vendor=14e1 Product=6000 Version=0001
         N: Name="DIALOGUE INC PenMount USB"
         ....................
         H: Handlers=event2 js0

         The handler 'event2' that means the device at
         /dev/input/event2, you can issue the command for checking

         # xxd /dev/input/event2

         Touch the panel and it will show something on the screen.

-----------------------------------------------------------------------
 FAQ
-----------------------------------------------------------------------
(1) Does PenMount support COM3/COM4 ?
Ans:
   For FC5, SuSE 10.0, SuSE 10.1,
   Add 'setserial /dev/ttyS[23] irq 0' into /etc/rc.d/rc.serial

   For FC2, FC3 and FC4, you have to do nothing.

   For Slackware, the COM3/4 IRQ error!
   Issue the command :
      # setserial /dev/ttyS[23] irq [5 | 10]
-----------------------------------------------------------------------
(2) I have problem in FC6 for PenMount serial.
Ans:
   The device node /dev/ttyS? is gone!
   We try to find out the solution....


-----------------------------------------------------------------------
(3) When I touch the PenMount, the system is halted.
Ans:

se remove the FIFO file.

     # rm /tmp/penomount_cmd
     # rm /tmp/penomount_dat

-----------------------------------------------------------------------
(4) When I compile the penmount.o , it failed.
Ans:
    Make sure the /usr/src/linux is the top directory of linux source code.
    You can make a symbolic link like :

    cd /usr/src
    ln -s linux-2.4 linux  (RedHat)


-----------------------------------------------------------------------
-------------------------------------------------------------------
DIALOGUE INTERATIONAL CORP.
June 29, 2007

