gant(1)

📦
version 1.25 · 2 versions
, in ubuntu stonking

💖 gant(1) — the ANT+ client manual, bestie edition 💖

okay so you found the ANT+ client manual section for gant(1), and honestly? we're about to have a whole moment together. grab a snack. 🍓

✨ NAME ✨

gant — a console based ANT+ information retrieval client for Garmin GPS products. it's giving "your watch's data, but make it terminal" 💅

🌈 SYNOPSIS 🌈

gant [ OPTIONS ]

that's it. that's the whole vibe. options or nothing, queen. 👑

🦋 DESCRIPTION 🦋

gant is a small command-line utility that goes and retrieves information (sports tracks, etc. — yes, the tracks) from Garmin GPS products, and it does it over the wireless ANT/ANT+ protocols. lowkey iconic honestly.

currently supported devices are the Forerunner 405. that's the one. the main character. ✨

🎀 OPTIONS 🎀

  • -a authfile — hand it an authfile. (default ~/.gant)
  • -f name — assign a name to the ANT device. (default garmin)
  • -d devno — ttyUSB devno — the device number. (default 0)
  • -i id — ID for pairing. (default random)
  • -m mydev — (default 0)
  • -p — Passive
  • -v — Verbose
  • -D level — Debug
  • -r — Reset the device
  • -n — Do not write auth file
  • -z — Do not pair

💜 Help options

  • -h — Show command line options.

🌸 EXAMPLE 1 🌸

step one, bestie: put the 405 in pairing mode.

gant -f paul -a auth405

this gives your garmin a name of "paul" and an auth file of "auth405". the 405 will ask you if you wish to pair with "paul". obviously you might want to use a different name :) 💀 (not everyone gets to be paul.)

download with:

gant -nza auth405 > output

or -Dnza if you want lots of debug output. go off, verbose king.

okay real talk though — it doesn't seem to be very reliable at starting the download and the author hasn't investigated why yet. so if it doesn't start downloading, press Ctrl+C and try again. no cap. it helps to take the watch out of power save mode. 🔋

if you've already downloaded the data, then you'll need to set "force send" to yes on the watch. yeah. it's like that.

compare output with .TCX file produce by windows ANT Agent. (their words, our truth 🫶)

💅 EXAMPLE 2 💅

HOWTO USE gant

  1. plugin your ANT+ stick
  2. the system will load the kernel module "cp210x"
  3. to find out what ttyUSB device is used run
# dmesg|grep "cp210x converter"
[...] cp210x 3-1:1.0: cp210x converter detected
[...] usb 3-1: cp210x converter now attached to ttyUSB3

in this case you have to use the optione "-d 3". if it is ttyUSB0 then you don't need the -d option because 0 is the default

  1. put the watch into paring mode (menu -> configuration -> ANT+ -> computer -> pairing on)
  2. pair the computer with the watch ("mywatch" as name for the watch and the file "auth405" as an authorization file which will be created)
# gant -d 3 -f mywatch -a auth405
  1. download saved tracks from the watch
# gant -d 3 -f mywatch -nza auth405

you get the possible options with

# gant -h

to convert the downloaded TCX file (e.g. 2011-07-22-123456.tcx) you can use gpsbabel:

# gpsbabel -t -i gtrnctr -f 2011-07-22-123456.tcx -o gpx -F 2011-07-22-123456.gpx

— 2011-07-22 Noèl Köthe <noel@debian.org>

🔥 DEVICES 🔥

wireless ANT communications happens over a USB2ANT dongle. under Linux the dongle is driven by the cp210x kernel module, and presented to user-space as a USB serial port, /dev/ttyUSBxxx where xxx is an integer. the dongle is typically carrying the USB vendor id/product id pair of 0fcf/1004 or 0fcf/1008. recent Linux systems employ udev to handle device nodes and permissions, thus appropriate

(yes, the sentence just ends there. the manpage said what it said. we respect the cliffhanger. 💀)

🧚 FILES 🧚

  • /lib/modules/uname -r/kernel/drivers/usb/serial/cp210x.ko — kernel driver module for USB2ANT dongle. 👑
  • /dev/ttyUSBxxx — serial device created for dongle. 🦋
  • $HOME/.gant — default authentication file. 💖

⭐ AUTHOR ⭐

gant was written by paul@ant.sbrk.co.uk, Wali and Klaus@Ethgen.de. this man page is Copyright © 2013 Kristóf Ralovich. give them their flowers, fr fr. 🌸

🫶 SEE ALSO 🫶

and that's the whole page, bestie!! no cap, you're now certified in gant(1) main character energy. this was page gant(1), sourced from gant, version/date 2013-10 — go forth and retrieve those sports tracks, you absolute legend. periodt. 💅✨

📦 where this page comes from