GSP
Quick Navigator

Search Site

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

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  BLUEGPS (1)

NAME

bluegps - datalog download tool for Royaltek RBT-3000 GPS

CONTENTS

Synopsis
Description
Options
Device Configuration
Logging Configuration
Examples
License
Authors

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 determined 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 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.
-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 consist 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 seconds.
-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 accompanies 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@webweaving.org>.
Search for    or go to Top of page |  Section 1 |  Main Index


--> BLUEGPS (1) 2006/06/04

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