bluegps.1

GPS接收软件

.\"(c) Copyright 2005 by Till Harbaum <[e-mail]>
.\"All rights reserved.
.\"
.TH BLUEGPS 1 "2006/06/04"
.SH NAME
bluegps \- datalog download tool for Royaltek RBT-3000 GPS
.SH SYNOPSIS
.B bluegps [-d filename] [-e] [-p password] bdaddr
.SH DESCRIPTION
.B bluegps
is a simple command line tool to download datalog entries from the
Royaltek RBT-3000 bluetooth GPS receiver. The log is written in
NMEA-0183 format.
.LP
The bluetooth address (bdaddr) of the RBT-3000 to be used has to 
be specified on the command line. This bluetooth address can e.g. 
be determined using the \fBhcitool(1)\fP command.

.SH OPTIONS
.TP
.BI \-d " filename" 
Download the datalog into a file named
.I filename\fP.
If no -d option is 
given only the status of the datalog will be displayed, but no
datalog will be downloaded. To print the log to the standard output
give \fB-\fP as the filename.
.TP
.B \-e
Erase datalog. If the -d option is given as well, the datalog will 
be erase \fBafter\fP it has been downloaded.
.TP
.B \-p " password" 
If the RBT-3000 has been setup to use a password, it has to be specified
using this option. \fBbluegps\fP will complain if a password is required
but this option has not been specified. The password must consist of
exactly four digits.
.TP
.B \-h
Display usage information.
.TP
.B \-q
Operate quietly. Status information will be suppressed.
.TP
.B \-v
Operate verbously. Additional information will be shown.
.SH DEVICE CONFIGURATION
.TP
.B \-n " name"
The RBT-3000 can store a name to identify the device easily. This Option
will set the name.
.TP
.B \-w " password"
Configure the RBT-3000 to use a password. The password must consist of
exactly four digits.
.TP
.B \-W 
Disable the password protection. Note that you need to specify the old
password using the option \fB-p\fP.

.SH LOGGING CONFIGURATION
.TP
.B \-l
Enable logging. This switches the RBT-3000 into logging mode. Note that at
least one logging mode (time, distance or speed based) must be active for this
to have an effect.
.TP
.B \-L
Disable logging.
.TP
.BI \-i " NUM"
Enable time based logging: records the position every
.I NUM
seconds.
.TP
.B \-I
Disable time based logging.
.TP
.BI \-c " NUM"
Enable distance based logging: records the position every
.I NUM
meters.
.TP
.B \-C
Disable distance based logging.
.TP
.BI \-s " NUM"
Enable speed based logging: records if the device moves faster than
.I NUM
km/h.
.TP
.B \-S
Disable speed based logging.
.TP
.B \-a 
Include altitude information into the log.
.TP
.B \-A
Exclude altitude information from the log.
.TP
.B \-o 
Enables overwriting when the internal memory for the log is full.
.TP
.B \-O
Stop logging when the internal memory for the log is full.

.SH EXAMPLES
To download the nmea log from the GPS with the bdaddr 00:02:C7:00:11:22 
to a file named testlog.nmea use the following command:
.LP
.RS +4
bluegps -d testlog.nmea 00:02:C7:00:11:22
.RE
.LP
If the GPS has been setup to use the password 1234 use the following 
command:
.LP
.RS +4
bluegps -p 1234 -d testlog.nmea 00:02:C7:00:11:22
.RE
.LP
If the datalog is to be erased after the download use the following 
command:
.LP
.RS +4
bluegps -p 1234 -d testlog.nmea -e 00:02:C7:00:11:22
.SH LICENSE
\fIbluegps\fP is free; anyone may redistribute copies of it to anyone
under the terms stated in the GNU General Public License, a copy of which
accompanies each copy of \fIbluegps\fP.
.SH AUTHORS
Till Harbaum <[e-mail]>,
Simon Budig <[e-mail]>