summaryrefslogtreecommitdiff
path: root/itraxctl.xml
blob: c7c4c74327d47ee9d10607ac80cbf8a589a3733f (plain)
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
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE refentry PUBLIC 
   "-//OASIS//DTD DocBook XML V4.1.2//EN"
   "docbook/docbookx.dtd">
<refentry id='itraxctl.1'>
<refmeta>
<refentrytitle>itraxctl</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class='date'>23 Oct 2006</refmiscinfo>
</refmeta>
<refnamediv id='name'>
<refname>itraxctl</refname>
<refpurpose>Control the modes of an iTrax GPS</refpurpose>
</refnamediv>
<refsynopsisdiv id='synopsis'>

<cmdsynopsis>
  <command>itraxctl</command>  
      <arg choice='opt'>-n </arg>
      <arg choice='opt'>-b </arg>
      <arg choice='opt'>-s <replaceable>speed</replaceable></arg>
      <arg choice='plain'><replaceable>serial-port</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>

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

<para><application>itraxctl</application> switches an iTrax GPS to NMEA
or iTalk Binary mode. Port speed and protocol can be set independently of
each other.</para>

<para>You will probably need to be root to run this program, as the
serial device it uses is normally privileged.</para>

<para>The program accepts the following options:</para>
<variablelist remap='TP'>

<varlistentry>
<term>-b</term>
<listitem>
<para>Force GPS into binary mode. This option overrides any previous
-n options.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>-n</term>
<listitem>
<para>Force GPS into NMEA mode. This option overrides any previous
-b options.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>-s</term>
<listitem>
<para>Set port speed. iTrax chipsets support speeds of 4.8 - 921.6 kbps
though the *NIX drivers might not run faster than 230.4 kbps. Fastrax
recommends that a serial port not be run slower than 115.2 kbps when the
iTalk protocol is selected.</para>
</listitem>
</varlistentry>

</variablelist>

</refsect1>

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

<para>Setting NMEA mode from binary mode does not yet work. This is being
actively investigated. Integrated data logging control is planned but not
yet supported.</para>

</refsect1>
<refsect1 id='see_also'><title>SEE ALSO</title>
<para>
<citerefentry><refentrytitle>gpsd</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
<citerefentry><refentrytitle>gps</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>libgps</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
<citerefentry><refentrytitle>libgpsd</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
<citerefentry><refentrytitle>gpsprof</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>gpsfake</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>gnuplot</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
</para>
</refsect1>

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

<para>Chris Kuethe <email>chris.kuethe@gmail.com</email>.
This code is part of the gpsd toolset; there is a
project page for <application>gpsd</application> <ulink
url="http://gpsd.berlios.de/">here</ulink>.</para> </refsect1>

</refentry>