|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.|
|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.|
-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.
-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.
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 <Till@Harbaum.org>, Simon Budig <email@example.com> and some minor changes for FreeBSD by Dirk-Willem van Gulik <firstname.lastname@example.org>.