bluegps - datalog download tool for Royaltek RBT-3000 GPS
bluegps [-d filename] [-e] [-p password] bdaddr
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
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 hcitool(1) command (linux). Or alternatively use
the friendly name. (freebsd, see bluetooth.hosts(5)).
- -d filename
- Download the datalog into a file named filename. 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 - as the filename.
- 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.
- Display usage information.
- Operate quietly. Status information will be suppressed.
- Operate verbously. Additional information will be shown.
- -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 consist of
exactly four digits.
- Disable the password protection. Note that you need to specify the old
password using the option -p.
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:
- 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.
- Disable logging.
- -i NUM
- Enable time based logging: records the position every NUM
- Disable time based logging.
- -c NUM
- Enable distance based logging: records the position every NUM
- Disable distance based logging.
- -s NUM
- Enable speed based logging: records if the device moves faster than
- Disable speed based logging.
- Include altitude information into the log.
- Exclude altitude information from the log.
- Enables overwriting when the internal memory for the log is full.
- Stop logging when the internal memory for the log is full.
bluegps -d testlog.nmea 00:02:C7:00:11:22
On freebsd; if there is an entry in /etc/bluetooth/hosts you can
bluegps -d testlog.nmea BlueGPS
If the GPS has been setup to use the password 1234 use the
bluegps -p 1234 -d testlog.nmea 00:02:C7:00:11:22
If the datalog is to be erased after the download use the
bluegps -p 1234 -d testlog.nmea -e
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 accompanies
each copy of bluegps.
Till Harbaum <Till@Harbaum.org>, Simon Budig <firstname.lastname@example.org> and
some minor changes for FreeBSD by Dirk-Willem van Gulik