summaryrefslogtreecommitdiff
path: root/gpsmon.xml
diff options
context:
space:
mode:
authorEric S. Raymond <esr@thyrsus.com>2009-03-02 14:07:32 +0000
committerEric S. Raymond <esr@thyrsus.com>2009-03-02 14:07:32 +0000
commitf0353549971ff5edd2b6631a9f45f5289c29ca4e (patch)
tree735b446d2e2fc5810332b960beed4e50f2892f55 /gpsmon.xml
parentf737c390dbe646441329d19f31af8ff8f86afc31 (diff)
downloadgpsd-f0353549971ff5edd2b6631a9f45f5289c29ca4e.tar.gz
Document the fact that parity and stopbit setting is now supported but dicy.
Diffstat (limited to 'gpsmon.xml')
-rw-r--r--gpsmon.xml8
1 files changed, 8 insertions, 0 deletions
diff --git a/gpsmon.xml b/gpsmon.xml
index d70be746..fbbcbc01 100644
--- a/gpsmon.xml
+++ b/gpsmon.xml
@@ -173,6 +173,14 @@ followed by a colon and a wordlength-parity-stopbits specification in
the traditional style, e.g 8N1 (the default), 7E1, etc. Some
devices don't support serial modes other than their default, so
this command may fail with a message.</para>
+
+<para>Use this command with caution. On USB and Bluetooth GPSes it is
+also possible for serial mode setting to fail either because the
+serial adaptor chip does not support non-8N1 modes or because the
+device firmware does not properly synchronize the serrial adaptor chip
+with the UART on the GPS chipset whjen the speed changes. These
+failures can hang your device, possibly requiring a GPS power cycle or (in
+extreme cases) physically disconnecting the NVRAM backup battery.</para>
</listitem>
</varlistentry>