debianforum.de

~/test/ttwatch/ttwatch-master/ttwatch$ ./ttwatch -h
Usage: ./ttwatch [OPTION]...
Perform various operations with an attached TomTom GPS watch.

Mandatory arguments to long options are mandatory for short options too.
  -h, --help                 Print this help
  -s, --activity-store=PATH Specify an alternate place for storing
                               downloaded ttbin activity files
  -a, --auto                 Same as "--update-fw --update-gps --get-activities --set-time"
      --all-settings         List all the current settings on the watch
      --clear-data           Delete all activities and history data from the
                               watch. Does NOT save the data before deleting it
      --create-continuous-race [RACE] Create a continuously monitored race and
                               uploads it to the watch (see below)
      --daemon               Run the program in daemon mode
      --delete-history=[ENTRY] Deletes a single history entry from the watch
  -d, --device=STRING        Specify which device to use (see below)
      --devices              List detected USB devices that can be selected.
      --factory-reset        Performs a factory reset on the watch. This option
                               must be specified twice for safety.
      --get-activities       Downloads and deletes any activity records
                               currently stored on the watch
      --get-formats          Displays the list of file formats that are
                               saved when the watch is automatically processed
      --get-name             Displays the current watch name
      --get-time             Returns the current GPS time on the watch
      --initial-setup        Performs an initial setup for the watch, adding a
                               default preferences file and default race files
      --list-history         Lists the activity history as reported by the watch
      --list-races           List the available races on the watch
      --packets              Displays the packets being sent/received
                               to/from the watch. Only used for debugging
      --runas=USER[:GROUP]   Run the daemon as the specified user, and
                               optionally as the specified group
      --set-formats=LIST     Sets the list of file formats that are saved
                               when processing activity files
      --set-name=STRING      Sets a new watch name
      --set-time             Updates the time on the watch
      --settings             Lists all available settings and their valid
                               values and physical units
      --setting [SETTING[=VALUE]] Gets or sets a setting on the watch. To get
                               the current value of a setting, simply leave off
                               the "=VALUE" part
      --update-fw            Checks for available firmware updates from
                               Tomtom's website and updates the watch if
                               newer firmware is found
      --update-gps           Updates the GPSQuickFix data on the watch
      --update-race=[RACE]   Update a race
  -v, --version              Shows firmware version and device identifiers

ENTRY is a single-character activity type followed by a positive index
starting from 1. The indices are listed by the --list-history option. The
activity type is specified as 'r' for running, 'c' for cycling, 's' for
swimming, 't' for treadmill or 'f' for freestyle. For example:
"--delete-history t3" would delete the third treadmill entry.

NUMBER is an integer specified in decimal, octal, or hexadecimal form.

The --device (-d) option takes a string. The string can match either the
serial number or the name of the watch. Both are also printed out by the
--devices option.

If --activity-store is not specified, "~/ttwatch" is used for storing
downloaded activity data, with subdirectories of the watch name and
activity date, as per the official TomTom software.

LIST is a comma-separated list of file formats. Valid formats are:
    csv, fit, gpx, kml, pwx, tcx.
Case is not important, but there must be no spaces or other characters
in the list.

RACE is a race specification consisting of 5 comma-separated parts:
  <entry>,<name>,<duration>,<distance>,<laps>
Where: <entry>    is a single entry as per the entry for deleting a
                  history item. index must be between 1 and 5 inclusive.
       <name>     is the name of the race. Maximum of 16 characters,
                  although only 9 are visible on the watch screen.
       <duration> is the duration of the race, specified as seconds,
                  minutes:seconds or hours:minutes:seconds.
       <distance> is the race distance in metres, must be an integer.
       <laps>     is the number of laps to record, evenly spaced.
For example: --update-race "r1,3KM 14:30MIN,14:30,3000,3"
    specifies a race for running 3km in 14:30 minutes with 3 laps stored
    (every 1000m - automatically calculated).
If the name has spaces in it, the entire race specification must be
surrounded in quotes, or the space can be escaped with a '\'.

--create-continuous-race creates a different type of race that shows
progress on the watch every second. It appears as a recent activity race
rather than a MySports race. It is listed under the date and time that
the race is created. It has a different specification string to the
--update-race command, and is as follows:
  <activity>,<distance/time>[,<distance/time>]...
Where: <activity>      is a single-character activity type (r, c, s, f or t)
       <distance/time> is a distance and time specification given as
                       "<distance>/<time>" to race a set distance in a
                       set time, or "<distance>@<pace>" to race a set
                       distance at a given pace.
The distance specification consists of a number followed by a unit suffix,
either "km", "mi", "m" or "yd". Fractional numbers are allowed.
The time/pace specification is in seconds, minutes:seconds or
hours:minutes:seconds and represents the time per km (if a "km" or "m"
distance is specified) or time per mile (if a "mi" or "yd" distance is
specified. Multiple specifications can be given, separated by commas, which
are concatenated in the race.
For example:  --create-continuous-race "r,400m/1:00,10km@4:00"
    specifies a race for running 400m in 1 minute, followed by 10km at 4min/km
Note that the watch cannot differentiate between multiple segments, so it
will not notify you when you have finished a segment.

The program can be run as a daemon, which will automatically perform
the operations specified on the command line whenever a watch is
connected. The program must be run as root initially, but the --runas
parameter can be used to specify a user (and optionally a group) that the
program will drop privileges to after it has finished initialising.
Without this parameter specified, the program will continue to run as
root, which is not recommended for security reasons. Note that this
unprivileged user must have access to the USB devices, and write access
to the activity store location.