FreeBSD Manual Pages
BLUEGPS(1) General Commands Manual BLUEGPS(1) NAME bluegps - datalog download tool for Royaltek RBT-3000 GPS SYNOPSIS bluegps [-d filename] [-e] [-p password] bdaddr DESCRIPTION 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. 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 de- termined using the hcitool(1) command (linux). Or alternatively use the friendly name. (freebsd, see bluetooth.hosts(5)). OPTIONS -d filename Download the datalog into a file named filename. If no -d op- tion is given only the status of the datalog will be displayed, but no datalog will be downloaded. To print the log to the stan- dard output give - as the filename. -e Erase datalog. If the -d option is given as well, the datalog will be erase after it has been downloaded. -p password If the RBT-3000 has been setup to use a password, it has to be specified using this option. bluegps will complain if a password is required but this option has not been specified. The password must consist of exactly four digits. -h Display usage information. -q Operate quietly. Status information will be suppressed. -v Operate verbously. Additional information will be shown. DEVICE CONFIGURATION -n name The RBT-3000 can store a name to identify the device easily. This Option will set the name. -w password Configure the RBT-3000 to use a password. The password must con- sist of exactly four digits. -W Disable the password protection. Note that you need to specify the old password using the option -p. LOGGING CONFIGURATION -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. -L Disable logging. -i NUM Enable time based logging: records the position every NUM sec- onds. -I Disable time based logging. -c NUM Enable distance based logging: records the position every NUM meters. -C Disable distance based logging. -s NUM Enable speed based logging: records if the device moves faster than NUM km/h. -S Disable speed based logging. -a Include altitude information into the log. -A Exclude altitude information from the log. -o Enables overwriting when the internal memory for the log is full. -O Stop logging when the internal memory for the log is full. 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: bluegps -d testlog.nmea 00:02:C7:00:11:22 On freebsd; if there is an entry in /etc/bluetooth/hosts you can also use: bluegps -d testlog.nmea BlueGPS If the GPS has been setup to use the password 1234 use the following command: bluegps -p 1234 -d testlog.nmea 00:02:C7:00:11:22 If the datalog is to be erased after the download use the following command: bluegps -p 1234 -d testlog.nmea -e 00:02:C7:00:11:22 LICENSE bluegps is free; anyone may redistribute copies of it to anyone under the terms stated in the GNU General Public License, a copy of which ac- companies each copy of bluegps. AUTHORS Till Harbaum <Till@Harbaum.org>, Simon Budig <simon@budig.de> and some minor changes for FreeBSD by Dirk-Willem van Gulik <dirkx@webweav- ing.org>. 2006/06/04 BLUEGPS(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | DEVICE CONFIGURATION | LOGGING CONFIGURATION | EXAMPLES | LICENSE | AUTHORS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=bluegps&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>