gpsprobe.xml

很好的一个gps daemon驱动,简单实用

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE refentry PUBLIC 
   "-//OASIS//DTD DocBook XML V4.1.2//EN"
   "docbook/docbookx.dtd">
<refentry id='gpsprobe.1'>
<refmeta>
<refentrytitle>gpsprobe</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class='date'>8 Sep 2004</refmiscinfo>
</refmeta>
<refnamediv id='name'>
<refname>gpsprobe</refname>
<refpurpose>probe a GPS for type, send-cycle time and accuracy information</refpurpose>
</refnamediv>
<refsynopsisdiv id='synopsis'>

<cmdsynopsis>
  <command>gpsprobe</command>  
      <arg choice='opt'>-n <replaceable>packetcount</replaceable></arg>
      <arg choice='opt'><replaceable>device</replaceable></arg>
      <arg choice='opt'>-h</arg>
</cmdsynopsis>
</refsynopsisdiv>

<refsect1 id='description'><title>DESCRIPTION</title>

<para><application>gpsprobe</application> samples the NMEA data stream
from a GPS and attempts to deduce various interesting pieces of
information, including:</para>

<itemizedlist>
<listitem><para>the GPS type (what chipset it uses)</para></listitem>
<listitem><para>the inventory of NMEA sentence types it emits</para></listitem>
<listitem><para>its send cycle (frequency of updates)</para></listitem>
</itemizedlist>

<para>In addition, if the GPS is getting position fixes,
<application>gpsprobe</application> generates a scattergram from them
and plots a probable-error circle.  This data is only meaningful if
the GPS is held stationary while <application>gpsprobe</application>
is running.</para>

<para>The report and scattergram is generated as a
<citerefentry><refentrytitle>gnuplot</refentrytitle><manvolnum>1</manvolnum></citerefentry>
script to standard output.  View it with <command>gnuplot -persist
&lt;foo&gt;</command> where &lt;foo&gt; should be replaced with
the name of the plot script.</para>

<para>Note: <application>gpsprobe</application> needs access to the raw
GPS device. Therefore <application>gpsd</application> must not be running
when you call <application>gpsprobe</application>.  You will probably
have to run as superuser to get access to the device.</para>

</refsect1>
<refsect1 id='options'><title>OPTIONS</title>

<para>The -n option sets the number of packets to sample.  The
default is 100.</para>

<para>The -h option makes <application>gpsprobe</application> print 
a usage message and exit.</para>

<para>The argument, if given, sets the name of the GPS device. The default
is <filename>/dev/gps</filename>.</para> 

</refsect1>
<refsect1 id='bugs'><title>BUGS AND LIMITAIONS</title>

<para>This program handles only straight NMEA devices; it won't 
handle either Rockwell or SiRF binary protocols.</para>

</refsect1>
<refsect1 id='see_also'><title>SEE ALSO</title>
<para>
<citerefentry><refentrytitle>gpsd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
<citerefentry><refentrytitle>libgps</refentrytitle><manvolnum>3</manvolnum></citerefentry>
<citerefentry><refentrytitle>libgpsd</refentrytitle><manvolnum>3</manvolnum></citerefentry>
<citerefentry><refentrytitle>gnuplot</refentrytitle><manvolnum>1</manvolnum></citerefentry>
</para>
</refsect1>

<refsect1 id='maintainer'><title>AUTHOR</title> 

<para>Eric S. Raymond <email>[e-mail]</email>.  There is a
project page <ulink
url="http://www.berlios.de/gpsd/">here</ulink>.</para>

</refsect1>

</refentry>