gpsbabel.html

gpsbabel for gps testing

</p><p>
 <code class="option">--disable-pdb</code> Excludes the Palm database support and all formats that rely on it.
</p><p>
  <code class="option">--disable-csv</code> Excludes all support for our something-separated formats.
</p><p>
  <code class="option">--disable-filters</code> Excludes all filter support.
</p><p>
  <code class="option">--enable-efence</code> Activate debugging mode for gpsbabel-debug.
</p><p>
  <code class="option">--with-doc=dir</code> Specify that the doc should be created and installed in <code class="option">dir</code>.
</p><p>
  <code class="option">--without-libusb</code> Disables use of libusb, even it's it's available.
</p><p>
 <code class="option">--with-zlib=(included)|system|no</code> By default, we use our own version of zlib. If you specify <code class="option">system</code> the system zlib is used.  A value of <code class="option">no</code> (or --without-zlib) disables zlib.
</p></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="Usage"></a>Chapter聽2.聽Usage</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#Invocation">Invocation</a></span></dt><dt><span class="sect1"><a href="#Suboptions">Suboptions</a></span></dt><dt><span class="sect1"><a href="#Advanced_Usage">Advanced Usage</a></span></dt><dt><span class="sect1"><a href="#Route_And_Track_Modes">Route and Track Modes</a></span></dt><dt><span class="sect1"><a href="#inifile">Working with predefined options</a></span></dt><dt><span class="sect1"><a href="#tracking">Realtime tracking</a></span></dt><dt><span class="sect1"><a href="#batchfile">Batch mode (command files)</a></span></dt></dl></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="Invocation"></a>Invocation</h2></div></div></div><p>
If you're using GPSBabel, you will need to know how to do at least two things:
read data from a file, and write it to another file.  There are four basic
options you need to know to do those things:
</p><div class="segmentedlist"><table border="0"><thead><tr class="segtitle"><th>Command</th><th>Meaning</th></tr></thead><tbody><tr class="seglistitem"><td class="seg"><code class="option">-i</code> <em class="parameter"><code>format</code></em></td><td class="seg">Set input format</td></tr><tr class="seglistitem"><td class="seg"><code class="option">-f</code> <em class="parameter"><code>filename</code></em></td><td class="seg">Read file</td></tr><tr class="seglistitem"><td class="seg"><code class="option">-o</code> <em class="parameter"><code>format</code></em></td><td class="seg">Set output format</td></tr><tr class="seglistitem"><td class="seg"><code class="option">-F</code> <em class="parameter"><code>filename</code></em></td><td class="seg">Write output File</td></tr></tbody></table></div><p>
The <em class="parameter"><code>format</code></em> parameters in the above list
refer to the names of formats or file types supported by GPSBabel. 
</p><p><strong class="userinput"><code>gpsbabel -? </code></strong></p><p>will always show you the supported file types.  In this document, the
various supported formats are listed in <a href="#The_Formats" title="Chapter聽3.聽The Formats">Chapter聽3, <i>The Formats</i></a>.  The 
name that you would use on the command line follows the format name in 
parentheses.
</p><p>
Options are <span class="emphasis"><em>always</em></span> processed in order from left to right.
In practical terms, this means that things you want to read should appear
in the command before things you want to write.
</p><p>
The <em class="parameter"><code>filename</code></em> parameters specify the 
name of a file to be read or written.
</p><p>To use
         this program, just tell it what you're reading, where to read
         it from, what you're writing, and what to write it to.  For
         example:</p><p><strong class="userinput"><code>gpsbabel -i geo -f /tmp/geocaching.loc -o gpx -F /tmp/geocaching.gpx</code></strong></p><p>tells it to read the file <code class="filename">/tmp/geocaching.loc</code> in geocaching.com
         format and create a new file <code class="filename">/tmp/geocaching.gpx</code> in GPX format.   It's important to note that the names have nothign to do with the formats actually used.</p><p> This command will read from a Magellan unit attached
         to the first serial port on a Linux system (device names will
         vary on other OSes) and write them as a geocaching loc file.</p><p><strong class="userinput"><code>gpsbabel -i magellan -f /dev/ttyS0 -o geo -F mag.loc</code></strong></p><p>This second command does the same on Microsoft Windows.</p><p><strong class="userinput"><code>gpsbabel -i magellan -f com1 -o geo -F mag.loc</code></strong></p><p>Optionally, you may specify <em class="parameter"><code>-s</code></em> in any command line.  This
         causes the program to ignore any "short" names that may be
         present in the source data format and synthesize one from the
         long name.  This is particularly useful if you're writing to
         a target format that isn't the lowest common denominator but
         the source data was written for the lowest common
         denominator.  I use this for writing data from geocaching.com
         to my Magellan so my waypoints have "real" names instead of
         the 'GC1234' ones that are optimized for NMEA-only receivers.
         A geocacher with a Magellan receiver may thus find commands
         like this useful.</p><p><strong class="userinput"><code>gpsbabel -s -i geo -f geocaching.loc -o magellan -F /dev/ttyS0  </code></strong></p><p><strong class="userinput"><code>gpsbabel -s -i geo -f geocaching.loc -o magellan -F com1</code></strong></p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="Suboptions"></a>Suboptions</h2></div></div></div><p>
	  Many of the available format options in GPSBabel can themselves
	  take options.   While we try to make all the formats do the most
	  sensible thing possible without any extra options; this allows
	  great power and flexibility in the operation of the program.
	</p><p>
	  Suboptions are comma separated and immediately follow the option
	  itself. The available suboptions are listed on the individual 
	  format pages.  We'll make an example from <a href="#fmt_kml" title="Google Earth (Keyhole) Markup Language (kml)">the section called 鈥淕oogle Earth (Keyhole) Markup Language (kml)鈥