/usr/share/doc/gpsbabel/htmldoc/tracking.html is in gpsbabel-doc 1.4.3-1ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 | <?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<!-- InstanceBegin template="/Templates/primarypage.dwt" codeOutsideHTMLisLocked="false" -->
<title>Realtime tracking</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1" /><link rel="home" href="index.html" title="GPSBabel Documentation" /><link rel="up" href="Usage.html" title="Chapter 2. Usage" /><link rel="prev" href="inifile.html" title="Working with predefined options" /><link rel="next" href="batchfile.html" title="Batch mode (command files)" /></head><body>
<!-- InstanceBeginEditable name="scontent" --><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Realtime tracking</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="inifile.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Usage</th><td width="20%" align="right"> <a accesskey="n" href="batchfile.html">Next</a></td></tr></table><hr /></div><div class="sect1" title="Realtime tracking"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="tracking"></a>Realtime tracking</h2></div></div></div><p>
Introduced in GPSBabel 1.3.1, we now have an <span class="emphasis"><em>experimental</em></span> feature for realtime tracking via the new <code class="option">-T</code> option. This reads position reports from selected formats and writes an output file when a position report is received.
</p><p>
As of this writing, <a class="link" href="fmt_garmin.html" title="Garmin serial/USB protocol (garmin)">Garmin's PVT
protocol</a> and
<a class="link" href="fmt_nmea.html" title="NMEA 0183 sentences (nmea)">NMEA</a> are supported
inputs. KML, NMEA, and the variou XCSV formats are supported on
output. Additional formats may be added by interested parties
later.
</p><div class="example"><a id="realtime_reading"></a><p class="title"><strong>Example 2.6. Read realtime positioning from Garmin USB, write to Keyhole Markup</strong></p><div class="example-contents"><p><strong class="userinput"><code>gpsbabel -T -i garmin -f usb: -o kml -F xxx.kml</code></strong></p><p>
Will read the USB-connected Garmin and rewrite 'xxx.kml' atomically,
suitable for a self-refreshing network link in Google Earth.
</p></div></div><br class="example-break" /><div class="example"><a id="realtime_reading_wintec"></a><p class="title"><strong>Example 2.7. Read realtime positioning from Wintec WBT-201 via Bluetooth on Mac, write to Keyhole Markup</strong></p><div class="example-contents"><p><strong class="userinput"><code>gpsbabel -T -i nmea -f /dev/cu.G-Rays2-SPPslave-1 -o kml -F xxx.kml</code></strong></p><p>
Will read the Wintec WBT-201 via Bluetooth, using the name that
the Mac assigned it, and rewrite 'xxx.kml' atomically,
suitable for a self-refreshing network link in Google Earth.
</p></div></div><br class="example-break" /><p>
Be sure to substitute an device name appropriate for your device
and OS, such as <code class="filename">/dev/cu.usbserial</code> or
<code class="filename">/dev/cu.BT-GPS-37A695-BT-GPSCOM-1</code>
for Mac, <code class="filename">COM23:</code> for Windows, or
<code class="filename">usb:</code> for
<a class="link" href="fmt_garmin.html" title="Garmin serial/USB protocol (garmin)">Garmin USB</a>. These names
(except the "usb:" parlance for Garmin USB) are assigned by
your operating system.
</p></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="inifile.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Usage.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="batchfile.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Working with predefined options </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Batch mode (command files)</td></tr></table></div>
<!-- InstanceEndEditable -->
<!-- InstanceEnd -->
</body></html>
|