Ubuntu-specific multitouch howtos

This page aims at providing Ubuntu users with specific support for our hid-multitouch driver, both to make things easier for them and to support the Linux kernels customised by Ubuntu developers. For all other purposes, please refer to our more generic Linux multitouch howto.
How to get the latest hid-multitouch driver
This is exclusively for Ubuntu 10.10 running kernel 2.6.35.x or Ubuntu 11.04 running kernel 2.6.38.x or Ubuntu 11.10 running kernel 3.0.x-y. Replace 10.10 with 11.04 or 11.10 in the instructions below as necessary.
Supported devices
Check our Table of known hardware. If the column Generic Multitouch Driver matching your driver shows "Devel" or "Upstream", then it's good to go. If not, you can try installing it, and then adding it from the user-space (please follow the next howto).
Requirements
We suppose here that you don't have any hid-dkms and other stuff installed.
sudo apt-get install build-essential linux-headers-generic git
Cloning git repository
(replace $WORKING_DIR with the directory where you want to have the sources) 
cd $WORKING_DIR
git clone git://git.lii-enac.fr/linux-input/ubuntu-multitouch
cd ubuntu-multitouch
git checkout hid-multitouch-ubuntu-10.10
Compile
make
Install
sudo make install
If you are not able to load the hid-multitouch driver, and if don't have any way of recovering the kernel installation (older kernel that still boots, etc...), please stop when asked.
Further updates
If you want to update hid-multitouch, or if you have updated your kernel, here are the instructions : 
cd $WORKING_DIR/ubuntu-multitouch
git pull origin hid-multitouch-ubuntu-10.10
Then follow the Compile and Install instructions.
Trouble?
send email to benjamin (dot) tissoires (at) enac (dot) fr
How to add support for your device from user space.
The current release of hid-multitouch found on our site allows you to add any multitouch capable hardware from the user space. If your device seems to be recognized by the system (but either in single touch only or by doing strange stuffs) and after installing hid-multitouch it is not seen at all, that means that you can manually add it to our driver.
Steps
sudo cp /lib/udev/rules.d/41-hid-multitouch.rules /etc/udev/rules.d
sudo gedit /etc/udev/rules.d/41-hid-multitouch.rules
replace in the first line:
ATTRS{idVendor}=="04b4" by ATTRS{idVendor}=="YOUR_VENDOR_ID"
and ATTRS{idProduct}=="c001" by ATTRS{idProduct}=="YOUR_PRODUCT_ID"
You can find YOUR_VENDOR_ID and YOUR_PRODUCT_ID by looking at the output of lsusb.
sudo service udev reload
Unplug/replug your device (or reboot if you can not do this).
That's all folks.
You can always send us a mail to get your device supported in the next kernel release.
