---

MultiTouch Utilities w/ MyGesture Editor and XWinder^TM

v1.6.0       February 11th, 2005

CHANGES AND NEW FEATURES

• See doc/FirmwareHistory.html for a detailed list of MultiTouch Firmware feature additions and bug fixes since your unit shipped.

• See sdk/ReleaseNotes.html for XWinder and Hand Motion SDK changelog.

• See doc/changes.html for the MyGesture Editor changelog and usage guidelines.

• See doc/config_gestures.html for the latest manual configuration options for all products.

WHAT'S INCLUDED

• MyGesture Editor -- Customize the mappings and motion sensitivities of all gestures and surface keys. See doc/release.html for the editor changelog, further limitations and usage guidelines.

• MultiTouch Upgrader -- Apply the latest MultiTouch Firmware, which includes bug fixes, gesture set enhancements and typing improvements to your MultiTouch Product.

• Feature Selector -- Customize your unit with a conventional control panel, rather than with the 4-corners configuration gesture.
  

• MTS Diagnostics -- Test your FingerWorks hardware for proper function. (OK messages will print in all Green. Report any persistent Red error or yellow warning messages to FingerWorks support!)

• XWinder -- Awesome window manipulation utility for Windows XP and Mac OS X.  Automatically installs in system startup folder.  See sdk/XWinder/ReadMe.html for usage instructions.
  

• Hand Tracking SDK -- For developers writing wanting to implement direct hand motion control or finger tracking in their own apps.  Checkout sdk/FWHID_HandTracking/ReadMe.html.

• fwMTSdetector (Mac OS X only) --  Runs in the background on Mac OS X to switch any FingerWorks USB Devices into 'Mac mode' as they are plugged in or at bootup. For people who frequently switch their MultiTouch Product between Macs and PCs.
  

• Configuration Scripts for certain applications:
• • Contributed by FingerWorks Customers to help get the most out of gestures:
  • If you use GNU Emacs or X-Emacs programmers' editors, check out FingerWorks/lib/Emacs/
  • If you use Alias Wavefront's Maya animation tools, check out FingerWorks/lib/Maya/

SYSTEM REQUIREMENTS

These utilities only work on Mac OS X, Linux, Windows 2000, and Windows XP.

A Java 2 JRE/JVM/SDK version 1.4.1_02 or higher is required to use the Gesture Editor.  Mac OS X users may need to upgrade to at least OS X 10.2 (Jaguar) and install Java 1.4.1 from Apple System Update.

If you are a Mac OS 9, Windows 98 or Windows ME user with access to a newer Mac OS X, Linux, Windows 2000 or Windows XP PC, you can install these utilities on the newer PC, apply the upgrade to your MultiTouch unit, and then return your unit to its older PC for normal operation.

WINDOWS INSTALLATION NOTES

These utilities require Windows 2000 or XP. Once installed, you can run the utilities from Start->FingerWorks->MultiTouch Utilities.

The installation process sometimes causes Windows to install or re-install drivers. This has several consequences:

• The first time you use any of the utilities, the device selector will say "No FingerWorks Devices Found" for quite awhile as Windows searches for drivers. Your product may 'not be found' for up to a minute, so be patient.

• Notice: WINDOWS USERS MUST INSTALL THESE UTILITIES WITH 'ADMINISTRATOR' PRIVILEGES OR THE DEVICE DRIVER FILES WILL NOT INSTALL PROPERLY, AND NO DEVICES WILL BE FOUND!
  

• If any Windows driver installation wizards appear during the upgrade process, you must approve driver installation (despite Microsoft's warnings about unsigned drivers) to continue the upgrade. You should save all work before approving driver installation.

• Notice: WINDOWS USERS MAY NEED A SPARE KEYBOARD OR MOUSE PLUGGED IN TO APPROVE DRIVER INSTALLATIONS, AS THE MULTITOUCH UNIT IS INOPERATIVE DURING PART OF THE UPGRADE PROCESS.

• If typing or pointing don't work after the upgrade, but diagnostics indicate everything is OK, check the Windows Device Manager for malfunctioning MultiTouch-related drivers (indicated by yellow exclamation point over the device name!) Right click to uninstall the malfunctioning driver, then unplug and replug the USB cable to start re-installation.

MAC OS X INSTALLATION NOTES

Requires Mac OS X version 10.1.2 or higher. The FingerWorks/ folder may be installed within /Applications/ or within your home directory depending on your installation wizard choices.  Once installed, launch /Applications/FingerWorks/MultiTouch_Utilities.

Using fwMTSdetector for automatic Mac Mode switching

The fwMTSdetector daemon is only useful to you if you occasionally move your MultiTouch Product between Mac OS X and a Windows or Linux PC. If running, fwMTSdetector automatically puts your unit into Mac Mode, so it generates Mac instead of PC-style hotkeys, upon plugin to your Mac but reverts to Windows or Linux mode upon plugging in to a PC.

Though it can be started at any time from a Terminal with:

cd FingerWorks/fwMTSdetector
./fwMTSdetector  trace

you'll probably want it to start automatically at every bootup. The following procedure sets up fwMTSdetector to start automatically during boot:

• If your /Library/ folder does not already have a StartupItems/ sub-folder, first create a /Library/StartupItems/ sub-folder.
• Copy the entire fwMTSdetector/ folder, not just the program, into the /Library/StartupItems/ folder, creating: /Library/StartupItems/fwMTSdetector/
• Open the Feature Selector and set the OS Mode to match your Windows or Linux PC, NOT to Mac OS X! Hit OK.
• Restart your computer (or run fwMTSdetector this first time from terminal as shown above).

From now on, fwMTSdetector will switch any MultiTouch product into Mac Mode upon plugin to your Mac.

With this procedure, fwMTSdetector becomes a daemon, a program that runs continuously in the background (using minimal resources). A few things to keep in mind:

• If while plugged in to the Mac you run Feature Selector again and hit OK or use the 4-corners config gesture, the unit may get put into Mac Mode semi-permamently, so that it doesn't revert to Win/Linux mode when plugged into a PC.  In this case you'll need to use the 4-corners config gesture or Feature Selector to enable a PC OS mode.
• To know whether fwMTSdetector is currently running, start /Applications/Utilities/ProcessViewer and look for fwMTSdetector in the process list.
• The easiest way to stop fwMTSdetector is to remove the fwMTSdetector/ folder from /Library/StartupItems/ and reboot. Otherwise, you can 'kill' it from a terminal as root, if you know what that means.

LINUX INSTALLATION NOTES

Linux Kernel version must be at least 1.4.04 with USB and usbdevfs modules installed. Due to immaturity in the USB Device File System, early Linux kernel versions may not work at all. Please report your experiences with different Linux kernels to us.

Linux users must either run the utilities as root or set up the /etc/fstab file to have your /proc/bus/usb entry use the devmode=0666 option.

Assuming you've had setupfw.bin unpack into ~/FingerWorks/, a directory listing of ~/FingerWorks/ should show:

     LICENSE.TXT README.HTML lax.jar 
     MultiTouch_Utilities* MultiTouch_Utilities.lax     
     doc/ fbin/ lib/ sdk/ user_config/ app_config/ UninstallerData/

You can ignore the .lax files. To run MultiTouch Utilities from a terminal window:

• Become superuser and change to the ~/FingerWorks/ directory
• Type ./MultiTouch_Utilities at the command prompt.
  

The MultiTouch_Utilities script will then launch Java and the utility. You can ignore any Font warning messages you seen in the terminal as a colorful dialog window for the chosen utility pops up.

If the script reports that it cannot find Java, you may need to download and install the larger setupfw.bin that includes Java 1.4. If the script fails with an error referring to USB or jUSB or failed library loading, you probably need to check your usbdevfs installation. Make sure /proc/bus/usb/devices and /proc/bus/usb/drivers exist and include listings for any FingerWorks devices that are plugged in. If /proc/bus/usb does not exist, install kernel modules for or recompile your kernel with at least USB, HID, and USBDEVFS support.

TROUBLESHOOTING THE FIRMWARE UPGRADE PROCESS

Interrupted Upgrades

There is no need to panic if the upgrade process gets interrupted, either due to loss of power or to an unrecoverable data transmission error (leading to an 'Upgrade Aborted' message). Upon replugging, your unit will either revert to its original firmware or to 'Firmware Upgrade Mode,' awaiting reapplication of the upgrade. Just restart the MultiTouch Upgrader so the upgrade process can complete.

Replugging after Upgrade

In most cases, the Operating System (OS) can automatically reset the unit once the upgrade is verified, so that the unit starts running the upgraded firmware. However, automatic reset does not work on some systems, so you may be prompted to manually unplug and replug the USB cable before continuing. Please replug if prompted to.

Loss of Configuration Settings

The upgrade process wipes out any previous settings you may have made via the 4-corners config gesture. The Feature Selector runs automatically at the end of the upgrade process to let you quickly re-customize your unit. Mac and Linux users will need to re-select their OS, and users with the DVORAK or QWERAK alternative key layouts will need to re-select those on the Typing settings page. Game mode and TouchStream application gesture sets must be re-enabled if desired. See the 'Feature Help' page for a description of each configurable feature.

FEEDBACK

Please report any problems with the Utilities or suggestions for improvement to FingerWorks Support:

Web form: http://www.fingerworks.com/support.html

Email: support@fingerworks.com