Linux TomTom GPS Watch Utilities

Provides two programs for communicating with TomTom GPS watches and processing the data they collect.

1. ttwatch - USB communications program for performing various operations with the watch, including downloading activity data, updating GPS data, and updating firmware.
2. ttbincnv - Post-processor allowing conversion of the ttbin file formats to either (currently) csv, gpx, kml or tcx files, using broadly similar formats to the official TomTom file formats.

This program requires the following libraries to be compiled and installed before attempting to build it.

1. openssl (tested against version 1.0.1f, other versions may work). Available from http://www.openssl.org, or with your linux distribution
2. curl (tested against version 7.38.0, other versions may work). Available from http://curl.haxx.se/download.html
3. libusb 1.0.16 or later (tested against version 1.0.19). Available from http://sourceforge.net/projects/libusb/

$ ./configure
$ make
$ sudo make install

In order to have permission to access the USB devices when running as anyone other than root, a udev rule must be set up to allow access for unprivileged users. The rule I have set up is:

$ cat /etc/udev/rules.d/99-tomtom.rules
SUBSYSTEMS=="usb", ATTRS{idVendor}=="1390", ATTRS{idProduct}=="7474", SYMLINK+="tomtom", GROUP="usb", MODE="660"

This basically gives access to USB devices to members of the "usb" group. Create the "usb" group and add yourself to it using:

$ sudo addgroup usb
$ sudo usermod -a -Gusb <your_username>

Note: If you leave out the -a option on usermod, you will remove your user from every group except "usb", rather than just adding "usb" to the list of groups the user belongs to, so be careful... Note: You will have to log out and then log back in to see the change in group membership.

The ttwatch program supports running as a daemon, which will wait for a watch to be connected, then automatically perform whichever operations are specified on the command line. The following four operations are supported, and at least one of them must be specified to start the daemon:

1. --get-activities: Download the activity files and store them, including converting them to other file formats as specified in the watch preferences downloaded from the watch.
2. --update-gps: Updates the GPSQuickFix information in the watch from the internet.
3. --update-fw: Checks for firmware updates, and updates the firmware in the watch if newer firmware is found.
4. --set-time: Sets the time on the watch to match the local system time.

All four options can be specified with the -a (or --auto) option

The daemon must be started as root (run by init or sudo), but the --runas parameter can be specified to provide an alternative user (and optionally a group - such as the usb group mentioned above) to run as.

The ttwatch program has support for multiple watches. When running from the command line a list of available watches can be displayed using the --devices option. A particular watch can be selected using the -d option with three different parameters possible:

1. a 0-based index into the device list
2. a string that matches the watch serial number
3. a string that matches the watch name

All three pieces of information are displayed when listing available watches with the --devices option.

When running as a daemon the device cannot be specifed by index, as the list of devices will change over time, so this index is meaningless. However, if the watch serial number or name are specified, the daemon will only process that particular watch. This can be used to store the activities from multiple watches in different users' home areas by starting multiple instances of the daemon running as different users, specifying different watches.

There are various options that can be given to the ttwatch program that read and write raw data to/from the watch. Used incorrectly, these could destroy the contents of the watch. For this reason, they are disabled by default. To enable these options, run configure with the --with-unsafe option. Note that I don't guarantee what will happen if you use these options without really knowing what you are doing.