File: aprsmon.8

package info (click to toggle)
aprsdigi 2.4.4-3
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 580 kB
  • ctags: 364
  • sloc: ansic: 3,705; sh: 765; makefile: 58
file content (181 lines) | stat: -rw-r--r-- 4,417 bytes parent folder | download | duplicates (6)
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
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
.TH APRSMON 8 "9 February 1999" Linux "Linux Programmer's Manual"
.SH NAME
aprsmon \- monitor APRS AX.25 traffic for javAPRS
.SH SYNOPSIS
.B aprsmon [-a] [-m] [-r] [-k minutes] [-p port] [-t title] [-i infofile]
.SH DESCRIPTION
.LP
.B Aprsmon
uses SOCK_PACKET facilities to provide a network monitor of all AX.25
UI text traffic heard by the system.  It is based on
listen(1).
.LP
.B Aprsmon
collects (-m) 
or displays standard AX.25 UI text frames in a format similar
to that output by a standard TNC in "Monitor ON" mode and is intended
to be used with programs like javAPRS which wish to see a TNC data
stream over a TCP connection.  When the 
.B aprsmon
master has been running for a while and a new
.B aprsmon
slave starts up, first all saved up reports are sent, then a title
line indicating the beginning of live data is sent, and new reports
are sent as received.
.LP
Compressed position and telemetry reports as generated by the APRS Mic
Encoder are translated into the conventional uncompressed APRS 
Micro-Interface-Module (MIM) telemtry format so
that these stations are visible in javAPRS.  Reports containing a
TheNet X1J4 beacon header are also edited to strip off the header
making these nodes visible in javAPRS as well.
.LP
.SH OPTIONS
.TP 10
.BI \-a
Allow for the monitoring of outgoing frames as well as incoming ones.
.TP 10
.BI \-r
Choose "raw" mode which allows non-printable data through.
.TP 10
.BI "\-p port"
Monitor only those frames received on a particular port, by default all
AX.25 interfaces are monitored.
.TP 10
.BI "-m"
"Master" mode.  Retain monitored data for the number of minutes specified 
with the
.B -k
option in a shared memory segment.
.TP 10
.BI "-k minutes"
Retain monitored packets going back the given number of minutes.  
Default is 30.
.TP 10
.BI "-t title"
Sets the 
.I javAPRS
title string.  Default is "Live data from Linux."
.TP 10
.BI "-i infofile"
.I Infofile
is the path to the file that the aprsmon master writes the shared memory
segment and semaphore id's into.  Default is "/var/ax25/aprsmon.info."
.SH "javAPRS CONFIGURATION"
Set up one 
.I aprsmon
master running on your system to collect historical data going back
a while.  You will probably want to set up an /etc/rc.d/init.d script for
this.
.sp
.nf
aprsmon -a -m&
.fi
.sp
Add an entry into /etc/services with the port number you
want javAPRS to connect on.  For example:
.sp
.nf
aprs		14439/tcp	# APRS monitor on 144.39
.fi
.sp
Add an entry into /etc/inetd.conf for this service:
.sp
.nf
aprs stream tcp nowait root /usr/sbin/aprsmon aprsmon -a
.fi
.sp
To test, simply "telnet localhost aprs".  To use with javAPRS,
set, for example,
.sp
.nf
<PARAM name = "dataFile1" value = "netc:14439:localhost">
.fi
in your HTML file as described in the 
.B javAPRS
documentation, and then use 
.B appletviewer
to run javAPRS:
.nf
appletviewer mydemo.html
.fi
.sp
.SH "Mic-E to MIM Translation"
The Mic-E reduces the duration of packet noise on a voice frequency
by encoding its data in a compressed form, some of which is binary.
Some APRS-decoding software, notably javAPRS, is unable to deal
with this data.  To solve this problem
.B aprsmon
expands the Mic-E packet into one or two MIM packets as follows:
.sp
.nf
@\fBddhhmm\fPz\fBDDMM.hhN/DDDMM.hhW$cse/spd/E\fP>mon/M\fBm\fP/\fBstatus\fP
T#MIC,\fBaaabbbcccdddeeefffComments
.fi
.sp
.TP 10
.BI ddhhmm
is the UTC day and time the packet was received by the host running 
.B aprsmon.
.TP 10
.BI DDMM.hhN
is the latitude.
.TP 10
.BI /
is the symbol table selection (/ or \\).
.TP 10
.BI DDDMM.hhW
is the longitude.
.TP 10
.BI $
is the symbol.
.TP 10
.BI "cse,spd"
are course and speed.
.TP 10
.BI E
is the type of Mic-Encoder:
.IP
.nf
E - TAPR Mic-Encoder
T - Kenwood TH-D7
.fi
.RP
.TP 10
.BI m
is the status message number, and
.TP 10
.BI status
is the status message number expanded as follows:
.IP
.nf
0 -  Off duty..
1 -  Enroute...
2 -  In Service
3 -  Returning.
4 -  Committed.
5 -  Special...
6 -  PRIORITY..
7 -  EMERGENCY.
.fi
.RP
.TP 10
.BI aaa,bbb,ccc,ddd,eee,fff
are the values of the telemetry channels.
.SH FILES
.BR /etc/ax25/axports
.BR /var/ax25/aprsmon.info
.SH "SEE ALSO"
.BR call (1),
.BR listen (1),
.BR beacon (1),
.BR ax25 (4),
.BR axattach (8),
.BR http://www.bridge.net/~sdimse/javAPRS.html,
.BR http://www.tapr.org,
.BR http://www.aprs.net,
.BR MIC-E.TXT, TELEMTRY.TXT, PROTOCOL.TXT
.SH AUTHOR
.nf
Alan Crosswell, n2ygk@weca.org
.fi