Go to file
Dan Srebnick f301d8d2e9 Fix issue #1 BEACON EXEC abnormal close messages in aprx.log 2018-01-28 12:48:38 -05:00
noaacap Fix issue #1 BEACON EXEC abnormal close messages in aprx.log 2018-01-28 12:48:38 -05:00
CHANGELOG Updates to LICENSE and CHANGELOG 2017-08-31 10:26:49 -04:00
LICENSE Updates to LICENSE and CHANGELOG 2017-08-31 10:26:49 -04:00
README Change to release structure 2017-10-04 18:45:17 -04:00

README

This software is written in python 3.4 and has been tested with aprx 2.9.x.
If you are running a version < 2.9.0 you should first update aprx.  The current
release of aprx may be found at http://thelifeofkenneth.com/aprx/debs/.

The current release of noaacap may be found at:

https://github.com/K2DLS/noaacap/releases

Once you are running aprx >= 2.9, install noaacap:

Install via sudo dpkg -i noaacap-0.7.3.deb.  Then, to satisfy the dependencies,
run sudo apt-get -f install.

CONFIGURATION

Add a beacon section similar to the following to /etc/aprx.conf:

<beacon>

beaconmode both
cycle-size 2m

beacon via WIDE2-1 \
   srccall N0CALL-13 \
   timeout 20 \
   exec /usr/local/bin/noaacap.py

</beacon>

The timeout was needed on my older and slower single core Raspberry Pi Model B.
The aprx default timeout is 10 seconds and the timeout may not be needed on a
RPi 2 or newer.  If you see lots of "BEACON EXEC abnormal close" messages in
aprx.log, then you likely need to add the timeout.

The program will check for a new alert or update every 2 minutes, but only
send if there is a change.

Edit /etc/noaacap.conf:

Do not remove the [noaacap] section header.

myTZ should be set to the Linux TZ value for the issuing office of your
preferred weather zone.  For a complete list of timezones, you may use
the following command:  timedatectl list-timezones | grep America.

myZone should be set to your county code.  A list of county codes may be found
at https://alerts.weather.gov/.  Only list one county.  The program will then
send the alert for all affected zones.  You could instead use a zone code if
you want to be more specific.

myResend should be set to 0 for no message resends or to an interval of your
choosing.  If noaacap beacons every 2 minutes, a value of 30 would provide
hourly resends.

Logging values are 0 (quiet), 1 (informational), and 2 (debug).  Logs are
written to the systemd journal.

USE

It would be good to hear from users of this software.  Please email
k2dls@k2dls.net with the callsign-SSID of your APRS station that is sending
weather alerts via this program.

Dan Srebnick, K2DLS
12/06/17