[Pkg-running-devel] [garmin-ant-downloader] 01/02: write garmin-ant-downloader man page

Wed Oct 9 08:56:01 UTC 2013

This is an automated email from the git hooks/post-receive script.

ralovich-guest pushed a commit to branch debian-bug-690068
in repository garmin-ant-downloader.

commit 8ed1b5015ed5cba7e212f92a2088e8d0697776cd
Author: RALOVICH, Kristof <tade60 at freemail.hu>
Date:   Sun Oct 6 16:50:52 2013 +0200

    write garmin-ant-downloader man page
    
    replace existing README file with manpage
---
 README                  |   33 +---------
 debian/README           |   35 ----------
 garmin-ant-downloader.1 |  166 +++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 167 insertions(+), 67 deletions(-)

diff --git a/README b/README
index c258f23..4055c2c 100644
--- a/README
+++ b/README
@@ -1,32 +1 @@
-Test version of 405 download
-Needs lots of work!
-
-Usage:
-
-Put 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 :)
-
-Download with:
-./gant -nza auth405 > output
-
-or -Dnza if you want lots of debug output
-
-It doesn't seem to be very reliable at starting the download and
-I haven't investigated why yet. So, if it doesn't start downloading
-press ctrl-c and try again. I find 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.
-
-Compare output with .TCX file produce by windows ANT Agent.
-
-Patch gant.c
-Send me patches!
-
-Paul
-
+See 'man garmin-ant-downloader' page for details.
\ No newline at end of file
diff --git a/debian/README b/debian/README
deleted file mode 100644
index c5476c9..0000000
--- a/debian/README
+++ /dev/null
@@ -1,35 +0,0 @@
-	HOWTO USE garmin-ant-downloader
-
-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
-4. put the watch into paring mode (menu -> configuration -> ANT+ ->
-   computer -> pairing on)
-5. pair the computer with the watch ("mywatch" as name for the watch and
-   the file "auth405" as an authorization file which will be created)
-
-   # garmin-ant-downloader -d 3 -f mywatch -a auth405
-
-6. download saved tracks from the watch
-
-   # garmin-ant-downloader -d 3 -f mywatch -nza auth405
-
-
-You get the possible options with
-
-   # garmin-ant-downloader -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 at debian.org>
diff --git a/garmin-ant-downloader.1 b/garmin-ant-downloader.1
new file mode 100644
index 0000000..c6bc991
--- /dev/null
+++ b/garmin-ant-downloader.1
@@ -0,0 +1,166 @@
+.\" -*- coding: utf-8-unix -*-
+.\" groff -man -Tutf8 garmin-ant-downloader.1
+.\" Copyright © 2013 by Kristóf Ralovich
+.\"
+.\" Permission is granted to make and distribute verbatim copies of this
+.\" manual provided the copyright notice and this permission notice are
+.\" preserved on all copies.
+.\"
+.\" Permission is granted to copy and distribute modified versions of this
+.\" manual under the conditions for verbatim copying, provided that the
+.\" entire resulting derived work is distributed under the terms of a
+.\" permission notice identical to this one
+.\"
+.\" Formatted or processed versions of this manual, if unaccompanied by
+.\" the source, must acknowledge the copyright and authors of this work.
+.\" License.
+.\"
+.TH garmin-ant-downloader 1 "2013-10" "garmin-ant-downloader" "ANT+ client"
+.SH "NAME"
+garmin-ant-downloader \- console based ANT+ information retrieval client for Garmin GPS products
+.SH "SYNOPSIS"
+.BI "garmin-ant-downloader [ " "OPTIONS" " ] "
+.SH DESCRIPTION
+.B "garmin-ant-downloader"
+is a small command-line utility to retrieve information (sports
+tracks, etc.) from Garmin GPS products over the wireless ANT/ANT+
+protocols. Currently supported devices are the Forerunner 405.
+.SH "OPTIONS"
+.TP
+.BI "\-a " "authfile"
+Provide authfile (default ~/.gant).
+.TP
+.BI "\-f " "name"
+Assign a name to the ANT device. (default garmin)
+.TP
+.BI "\-d " "devno"
+ttyUSB
+.I "devno"
+Device no. (default 0)
+.TP
+.BI "\-i " "id"
+ID for pairing (default random)
+.TP
+.BI "\-m " "mydev"
+(default 0)
+.TP
+.BI "\-p"
+Passive
+.TP
+.BI "\-v"
+Verbose
+.TP
+.BI "\-D " "level"
+Debug
+.TP
+.BI "\-r"
+Reset the device
+.TP
+.BI "\-n"
+Do not write auth file
+.TP
+.BI "\-z"
+Do not pair
+.SS "Help options"
+.TP
+.BI "\-h"
+Show command line options.
+.SH "EXAMPLE 1"
+Put 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 :)
+
+Download with:
+./gant -nza auth405 > output
+
+or -Dnza if you want lots of debug output
+
+It doesn't seem to be very reliable at starting the download and
+I haven't investigated why yet. So, if it doesn't start downloading
+press ctrl-c and try again. I find 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.
+
+Compare output with .TCX file produce by windows ANT Agent.
+.SH "EXAMPLE 2"
+	HOWTO USE garmin-ant-downloader
+
+1. plugin your ANT+ stick
+2. the system will load the kernel module "cp210x"
+3. to find out what ttyUSB device is used run
+.LP
+.RS
+# dmesg|grep "cp210x converter"
+.RE
+.RS
+[...] cp210x 3-1:1.0: cp210x converter detected
+.RE
+.RS
+[...] usb 3-1: cp210x converter now attached to ttyUSB3
+.RE
+.LP
+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
+4. put the watch into paring mode (menu -> configuration -> ANT+ ->
+   computer -> pairing on)
+5. pair the computer with the watch ("mywatch" as name for the watch and
+   the file "auth405" as an authorization file which will be created)
+.LP
+.RS
+# garmin-ant-downloader -d 3 -f mywatch -a auth405
+.RE
+.LP
+6. download saved tracks from the watch
+.LP
+.RS
+# garmin-ant-downloader -d 3 -f mywatch -nza auth405
+.RE
+.LP
+You get the possible options with
+.LP
+.RS
+# garmin-ant-downloader -h
+.RE
+.LP
+To convert the downloaded TCX file (e.g. 2011-07-22-123456.tcx) you can use gpsbabel:
+.LP
+.RS
+# gpsbabel -t -i gtrnctr -f 2011-07-22-123456.tcx -o gpx -F 2011-07-22-123456.gpx
+.RE
+.LP
+\-\- 2011-07-22 Noèl Köthe <noel at debian.org>
+.SH "DEVICES"
+Wireless ANT communications happens over a USB2ANT dongle. Under Linux
+the dongle is driven by
+.B cp210x
+kernel module, and presented to user-space as a USB serial port,
+.B /dev/ttyUSBxxx
+where
+.B 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
+.B udev
+to handle device nodes and permissions, thus appropriate
+.SH "FILES"
+.TP
+\fB/lib/modules/`uname \-r`/kernel/drivers/usb/serial/cp210x.ko\fR
+Kernel driver module for USB2ANT dongle.
+.TP
+.B /dev/ttyUSBxxx
+Serial device created for dongle.
+.TP
+.B $HOME/.gant
+Default authentication file.
+.SH "AUTHOR"
+.B garmin-ant-downloader
+was written by paul at ant.sbrk.co.uk, Wali and Klaus at Ethgen.de. This man
+page is Copyright © 2013 Kristóf Ralovich.
+.SH "SEE ALSO"
+.UR "http://packages.qa.debian.org/g/garmin-ant-downloader.html"
+.BR "http://packages.qa.debian.org/g/garmin-ant-downloader.html"

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-running/garmin-ant-downloader.git

