Skip to content

Commit acc3788

Browse files
Note: APRS 1.2.1 data is technically a comment.
The APRS 1.2.1 addendum notes that new values like flood stage, voltage, radiation, and device type (F, V, X, and Z, respectively) are all part of the comment field. This was confusing the heck out of me. Hopefully this keeps other people from being confused, too.
1 parent 1b31467 commit acc3788

File tree

2 files changed

+6
-2
lines changed

2 files changed

+6
-2
lines changed

man/aprs-weather-submit.man

+4
Original file line numberDiff line numberDiff line change
@@ -177,6 +177,7 @@ If you specify a value outside of this range, it will be reduced (that is, a rep
177177
(APRS 1.2)
178178
The water level above or below the flood stage or mean tide.
179179
You may report numbers from \-99.9 feet to 99.9 feet, with a resolution of 0.1 feet.
180+
Note that this data is technically part of the comment field and may not be parsed by all APRS decoders as weather data.
180181
.TP
181182
.BR \-g ", " \-\-gust =\fISPEED\fP
182183
The peak wind speed measured in the past five minutes.
@@ -225,17 +226,20 @@ If both \fB-t\fP and \fB-T\fP are specified, the last option specified will be r
225226
(APRS 1.2)
226227
The battery voltage.
227228
You may report voltages of up to 99.9 volts, with a resolution of one-tenth of a volt.
229+
Note that this data is technically part of the comment field and may not be parsed by all APRS decoders as weather data.
228230
.TP
229231
.BR \-X ", " \-\-radiation =\fINANOSIEVERTS\fP
230232
(APRS 1.2)
231233
The current level of nuclear radiation.
232234
You may report readings of up to 99,000,000,000 nanosieverts per hour, though the resolution of the value put into your report varies based on orders of magnitude.
233235
Consult the APRS 1.2 specification for full details.
236+
Note that this data is technically part of the comment field and may not be parsed by all APRS decoders as weather data.
234237
.TP
235238
.BR \-Z ", " \-\-device\-type =\fIDEVICE-TYPE\fP
236239
(APRS 1.2.1)
237240
Exactly two characters to identify the type of device sending this information.
238241
The device types are not defined in the APRS specification and are implementation-specific.
242+
Note that this data is technically part of the comment field and may not be parsed by all APRS decoders as weather data.
239243
.SH EXAMPLES
240244
.PP
241245
If you were operating the ARRL's (theoretical) weather station at their headquarters and wanted to submit a temperature of 68 degrees Fahrenheit, no rainfall, and a westerly wind at about five miles per hour, use this command:

src/aprs-wx.c

+2-2
Original file line numberDiff line numberDiff line change
@@ -344,8 +344,8 @@ printAPRSPacket (APRSPacket* restrict const p, char* restrict const ret,
344344
strcat(result, p->radiation);
345345
}
346346

347-
/* F is required by APRS 1.2 if voltage is present */
348-
if (notNull(p->waterLevel) || notNull(p->voltage))
347+
/* F is required by APRS 1.2.1 if voltage or device type are present */
348+
if (notNull(p->waterLevel) || notNull(p->voltage) || notNull(p->deviceType))
349349
{
350350
strcat(result, "F");
351351
strcat(result, p->waterLevel);

0 commit comments

Comments
 (0)