Configuring an APRS-IS Port
YAAC can communicate with the APRS-IS network on the Internet. To
create an APRS-IS connection, click the Add button on the Ports tab of
the Configure dialog, then change the Port Type to APRS-IS. The dialog
will then appear like this:
The options to be set for an APRS-IS connection are:
The "Test Port" button provides a means of verifying that you have connected to the correct place;
it opens a terminal window connected to the configured APRS-IS server so that you can manually
test the server for the desired operation. To complete testing, close the terminal window.
- The Internet domain name of the APRS-IS gateway to be
connected to. A list of all the world-wide Tier 2 gateway regional aliases
as well as the FireNet alias are pre-provided for selection, but any other APRS-IS gateway's
domain name may be typed in as well.
- How long YAAC should attempt to connect to the APRS-IS network before giving up. If the Retry Indefinitely
checkbox is not checked, failure to reach the APRS-IS network at startup will cause an error to be reported
immediately; if a failure occurs after the connection is up, YAAC will try for up to 50 minutes to reestablish
the link and will report each failure. If the checkbox is checked, YAAC will retry forever to reach
the APRS-IS network (both initially and upon later failure), and will not display error dialogs when the
connection cannot be made. In both cases, the "Internet Lost" and "Internet Restored" events will still
be reported if a plugin (such as the Sounds plugin) is available to handle the conditions.
- The TCP port number at the gateway to connect to. The most
common port numbers are provided, and 14580 should be selected
unless a non-standard port is needed for some reason on a custom
gateway. In particular, do not specify port 10152 unless you really mean
to get a full-planet feed and have a powerful computer with lots of memory that can
handle all the traffic. If you want to use SSL to connect and authenticate to the APRS-IS backbone,
use the SSL-APRS-IS port type.
- The passcode to use for logging into the APRS-IS network. If
not provided, YAAC will not be permitted to I-Gate RF traffic into
the Internet. If the field is left blank, it is assumed that this is
to be a receive-only I-Gate connection.
To obtain a passcode, contact YAAC's author by e-mail, and provide
him with your government-issued amateur radio callsign. He will send
back the passcode corresponding to your callsign.
- The filter expression for receiving traffic from APRS-IS. If
a filter expression is not specified and
the standard filtered port (14580) is specified, a default radius filter of 80 kilometers
around the fixed latitude and longitude defined for the beacon
will be used, or 100 kilometers around your GPS fix if using GPS data for your
station location. If the beacon latitude and longitude are not
specified and GPS is not being used, a default radius filter of 50 kilometers around 39°15'N,
76°36'W (the location of the 2011 ARRL/TAPR DCC) will be used.
If you do not want any filtering, you must specify a blank filter (one or more
spaces but nothing else) for your filter expression; leaving the field empty
(not even spaces) implies that you want the default filter.
The hyperlink below the filter expression text field will launch your
default web browser pointing at the official documentation for APRS-IS server
filter expressions. The hyperlink below that will bring up the status page for
the APRS-IS server you are currently using.
- Whether or not this port can transmit messages into APRS-IS;
again, if an invalid passcode for the specified callsign is
provided, the APRS-IS network will reject the connection attempt. For
receive-only APRS-IS connections, a passcode is not necessary, and
a default filter will be provided if an explicit one is not entered.
- Whether YAAC can connect directly to the selected APRS-IS server,
or needs to relay the connection through a SOCKS server (only version
5 supported). If a SOCKS server is used, the host name of the SOCKS
server (and colon-appended listening port if not the SOCKS default
number 1080) must be specified, along with the username and password
for logging into the SOCKS server. Note that the present implementation of
SOCKS5 support in YAAC requires that the APRS-IS server be identified by
a domain name (not a numeric IPv4 or IPv6 address) when SOCKS is used.
- Which of potentially several beacon definitions will be transmitted
through this port. If none is checked when the port configuration is
saved, the default beacon will be used (and will show up as checked when
this configuration panel is next opened). To specify that a beacon should
not be sent out this port, a beacon should be selected that is not enabled
on the Beacon tab of the expert-mode configuration dialog.
Note that the Test Port button does not work for SOCKS-connected servers.
If both an APRS-IS port and an RF port are opened, YAAC expects to be used as an I-gate
(Internet gateway) station. This tutorial explains more