Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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://www.freebsd.org/cgi/man.cgi?query=bluegps&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help