summaryrefslogtreecommitdiff
path: root/rtcmdecode.1
blob: 667e26b07f0a56df38cada1a0ca67838928fc2a7 (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
.\"Generated by db2man.xsl. Don't modify this, modify the source.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "RTCMDECODE" 1 "" "" ""
.SH NAME
rtcmdecode \- decode RTCM104 streams into a readable format
.SH "SYNOPSIS"
.ad l
.hy 0
.HP 11
\fBrtcmdecode\fR [\-v\ \fIdebuglevel\fR]
.ad
.hy

.SH "DESCRIPTION"

.PP
This tool is a decoder for RTCM\-104, an obscure and complicated serial protocol used for broadcasting pseudorange corrections from differential\-GPS reference stations\&. RTCM\-104 is expected on standard input; an equivalent, 100%\-information\-preserving text format is written to standard output\&.

.PP
You can use this tool with \fBnc\fR(1) to examine RTCM feeds from DGPSIP servers\&.

.PP
The decoder dump format is described in \fBrtcm\fR(5); these lines go to standard output\&. As well as data the decoder also prints decoder status messages to standard error, as necessary\&.

.SH "OPTIONS"

.PP
The \-v option sets a verbosity level\&. It is mainly of interest to developers\&.

.SH "SEE ALSO"

.PP
 \fBgpsd\fR(8), \fBxgps\fR(1), \fBlibgps\fR(3), \fBlibgpsd\fR(3), \fBgpsprof\fR(1), \fBgnuplot\fR(1), \fBgpsfake\fR(1), \fBrtcm\fR(5)\&.

.SH "APPLICABLE STANDARDS"

.PP
The applicable standard is RTCM Recommended Standards for Differential NAVSTAR GPS Service RTCM Paper 194\-93/SC 104\-STD\&.

.PP
Ordering instructions are accessible from the website of the Radio Technical Commission for Maritime Services: \fIhttp://www.rtcm.org/\fR under "Publications"\&.

.SH "BUGS"

.PP
This program will fail quietly, never achieving sync lock with the RTCM stream, on a non\-little\-endian machine\&. The decoder logic is sufficiently convoluted to confuse some compiler optimizers, notably in GCC 3\&.x at \-O2, into generating bad code\&.

.SH "AUTHOR"

.PP
Eric S\&. Raymond <esr@thyrsus\&.com>\&. This is a somewhat hacked version of an RTCM decoder originally written by Wolfgang Rupprecht\&. There is a project page for gpsd  here: \fIhttp://gpsd.berlios.de/\fR\&.