Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages
BLUEGPS(1) FreeBSD General Commands Manual BLUEGPS(1)

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 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 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.

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 seconds.
Disable time based logging.
-c NUM
Enable distance based logging: records the position every NUM meters.
Disable distance based logging.
-s NUM
Enable speed based logging: records if the device moves faster than NUM km/h.
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.

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

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 <>, Simon Budig <> and some minor changes for FreeBSD by Dirk-Willem van Gulik <>.

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.