This format can...
read waypoints
read tracks
This format has the following options: baud, dump-file, erase, first-sector, initbaud, last-sector, no-output, read-at-once, Home, Car, Boat, Heart, Bar, gps-utc-offset, gps-week-rollover .
Serial download protocol for GPS data loggers called "miniHomer". These loggers are based on Skytraq Venus 5 and Venus 6 chipsets, but with modified firmware. The miniHomer logger has five POI (or better: Point-to-Return, PTR?), which can be set programatically. The miniHomer module in gpsbabel is an extension of the skytraq module.
Following a list of devices which should be supported by this module (Note that not all of them have actually been tested, so if you can confirm that additional models work, please mail the gpsbabel-misc group with your success, tips, and any pertinent links for your model.)
Example 3.22. Command showing miniHomer download of tracks and erasing the logger on Linux
gpsbabel -i miniHomer,erase -f /dev/ttyUSB0 -o gpx -F out.gpx
Example 3.23. Command showing miniHomer erasing the logger without download on Linux
gpsbabel -i miniHomer,erase,no-output -f /dev/ttyUSB0
miniHomer has five POI called Home, Car, Boat, Heart, Bar. You can set the lla (Latitude, Longitude, Altitude) for each of the POI. The format is <name>=<lat>:<lng>[:<alt>] Once the according POI symbol is selected on miniHomer, the display shows you the direction and distance to the POI.
Example 3.24. Command showing miniHomer setting Car and Home POI
gpsbabel -i miniHomer,Car=36.790145:-6.352898,Home=-3.066667:37.359167:5895 -f /dev/ttyUSB0 -o gpx -F out.gpx
Sets the Car/Home symbols' latitude longitude and altitude.
If you select the Car/Home symbol on miniHomer, the display will show the direction and distance to
this location as soon as it has a satellite fix.
Baud rate used for download.
The following baud rates can be used: 4800, 9600, 19200, 38400, 57600, 115200, 230400. Note that your logger might not support all of them (especially 230400 which isn't documented in the chipset manual, though there are known devices that are capable of this speed).
If baud=0
(zero) download takes place at the baud rate the
device is currently set to. This is especially useful for Bluetooth connections (if available) since they
often don't allow changing the baud rate.
Dump raw data to this file.
This function is identical to the dump-file function of skytraq module: Writes raw data as it is read from the logger to the file given as this option's argument (additional to decoding it as usual). The resulting binary files can be read and decoded by the skytraq-bin format. Mainly useful for debugging/development purposes.
First sector to be read from the device.
This function is identical to the first-sector function of skytraq module.
The logger's memory is organized in sectors, serially numbered starting at 0. Each sector takes 4096 bytes of data. Typical devices hold about 250 sectors. The memory is always filled from sector 0 on, until it is full or the device being erased again by the user.
Normally you can safely omit this option. However, it might be useful to read data from erased devices: we observed that on erase, only the first two sectors are actually cleared. The following example shows how to read the remaining data:
Example 3.25. Command showing how to read data from an erased device
gpsbabel -i miniHomer,first-sector=2 -f /dev/ttyUSB0 -o gpx -F out.gpx
Baud rate used to init device (0=autodetect).
This function is identical to the init-baud file function of skytraq module.
The "initbaud" option might be helpful if autodetection fails or takes too long. With this option you can tell GPSBabel the baud rate the device is currently set to. In contrast, the option "baud" specifies the rate at which the actual download should take place. If it is different than "initbaud" (or the autodetected rate, if initbaud wasn't given), the initial setting will be restored after finishing the download.
Please note that miniHomer by default uses 38400bps and does not autodetect the port speed. If you need autodetect, start as
gpsbabel -i miniHomer,initbaud=0 -f /dev/ttyUSB0 -o gpx -F out.gpx
Last sector to be read from the device (-1: smart read everything).
A value of -1 (the default) enables automatic mode, i.e. reading is stopped when an empty sector is encountered. We observed that sometimes the device doesn't report the correct number of used sectors, which confuses the Windows software, so that it might not get all trackpoints. In contrast, our algorithm ensures that everything is being read (please report if it doesn't work for you).
Disable output (useful with erase).
If this option is given, no GPS log data will be read from the device (unless "dump-file" is given too; in that case only decoding will be disabled).
Number of sectors to read at once (0=use single sector mode).
If read-at-once
>= 1, batch mode is enabled with that many sectors being read at a time.
A value of zero disables batch mode and switches to single read mode. Not all devices support batch mode; in that case
gpsbabel automatically switches to single read mode.
Under normal circumstances, the larger this number the faster the transfer.
Reducing read-at-once
or even switching to single sector mode might help when you get
transmission errors/aborts.
POI for Home Symbol as lat:lng[:alt].
The device provides a location finder display supporting five locations "Home", "Car", "Boat", "Heart", "Bar". You can program the location of each either by a keypress on the device (which uses the actual position) or with GPSBabel (which lets you use any position) You can set the location of "Home" with the 'Home' option. Use ':' as the delimiter between latitude, longitude and altitude. You can leave altitude out, in which case it is assumed to be zero. Note that GPSBabel terminates after writing the location info to the device, i.e. no logging data will be read from it.
Example 3.26. Set the target location of the miniHomer Home POI
gpsbabel -i miniHomer,Home=-3.066667:37.359167:5895 -f /dev/ttyUSB0 -o unicsv -F -
Sets the Home symbols' latitude to 3.066667S longitude to 37.359167E and altitude to 5895m. If you select the Home symbol on miniHomer, the display will show the direction and distance to this location as soon as it has a satellite fix.
POI for Car Symbol as lat:lng[:alt].
The device provides a location finder display supporting five locations "Home", "Car", "Boat", "Heart", "Bar". You can program the location of each either by a keypress on the device (which uses the actual position) or with GPSBabel (which lets you use any position) You can set the location of "Car" with the 'Car' option. Use ':' as the delimiter between latitude, longitude and altitude. You can leave altitude out, in which case it is assumed to be zero. Note that GPSBabel terminates after writing the location info to the device, i.e. no logging data will be read from it.
Example 3.27. Set the target location of the miniHomer Car POI
gpsbabel -i miniHomer,Car=-25.272309:153.235330 -f /dev/ttyUSB0 -o unicsv -F -
Sets the Car symbols' latitude to 25.272309S longitude to 153.235330E and altitude to 0m. If you select the Car symbol on miniHomer, the display will show the direction and distance to this location as soon as it has a satellite fix.
POI for Boat Symbol as lat:lng[:alt].
The device provides a location finder display supporting five locations "Home", "Car", "Boat", "Heart", "Bar". You can program the location of each either by a keypress on the device (which uses the actual position) or with GPSBabel (which lets you use any position) You can set the location of "Boat" with the 'Boat' option. Use ':' as the delimiter between latitude, longitude and altitude. You can leave altitude out, in which case it is assumed to be zero. Note that GPSBabel terminates after writing the location info to the device, i.e. no logging data will be read from it.
Example 3.28. Set the target location of the miniHomer Boat POI
gpsbabel -i miniHomer,Boat=32.29287:-64.77527 -f /dev/ttyUSB0 -o unicsv -F -
Sets the Boat symbols' latitude to 32.29287N longitude to 64.77527E and altitude to 0m. If you select the Home symbol on miniHomer, the display will show the direction and distance to this location as soon as it has a satellite fix.
POI for Heart Symbol as lat:lng[:alt].
The device provides a location finder display supporting five locations "Home", "Car", "Boat", "Heart", "Bar". You can program the location of each either by a keypress on the device (which uses the actual position) or with GPSBabel (which lets you use any position) You can set the location of "Heart" with the 'Heart' option. Use ':' as the delimiter between latitude, longitude and altitude. You can leave altitude out, in which case it is assumed to be zero. Note that GPSBabel terminates after writing the location info to the device, i.e. no logging data will be read from it.
Example 3.29. Set the target location of the miniHomer Heart POI
gpsbabel -i miniHomer,Heart=36.1269:-115.1698 -f /dev/ttyUSB0 -o unicsv -F -
Sets the Heart symbols' latitude to 36.1269N longitude to 115.1698W and altitude to 0m. If you select the Heart symbol on miniHomer, the display will show the direction and distance to this location as soon as it has a satellite fix.
POI for Bar Symbol as lat:lng[:alt].
The device provides a location finder display supporting five locations "Home", "Car", "Boat", "Heart", "Bar". You can program the location of each either by a keypress on the device (which uses the actual position) or with GPSBabel (which lets you use any position) You can set the location of "Bar" with the 'Bar' option. Use ':' as the delimiter between latitude, longitude and altitude. You can leave altitude out, in which case it is assumed to be zero. Note that GPSBabel terminates after writing the location info to the device, i.e. no logging data will be read from it.
Example 3.30. Set the target location of the miniHomer Bar POI
gpsbabel -i miniHomer,Bar=38.99809:-86.34662 -f /dev/ttyUSB0 -o unicsv -F -
Sets the Bar symbols' latitude to 38.99809N longitude to 86.34662W and altitude to 0m. If you select the Bar symbol on miniHomer, the display will show the direction and distance to this location as soon as it has a satellite fix.