When using the YAAC sounds plugin, you can choose how various events of importance are audibly reported.
There are four ways that events can be audibly reported:
The expert-mode Configuration dialog will have an additional tab (labeled "Sounds") added to the core YAAC configuration tabs. This tab is broken into three parts:
Event name | Condition of occurrence |
---|---|
Message to | An APRS text message addressed to one of this station's own callsigns was received. |
CQ | An APRS text message addressed to "ALL, "CQ", or "QSY" was received. |
Weather Warning | An APRS text message addresses to "NWS-WARN", "NWS_WARN", or "BOM_WARN" was received. |
EMERGENCY | A packet of any protocol with emergency precedence was received. |
Priority | A packet of any protocol with priority precedence was received. |
Special | A packet of any protocol with special precedence was received. |
Alarm | An alarm condition has occurred. Currently only used by the telemetry alarm and weather alert plugins. |
New station in range | A station position report has been received that is newly in the range defined by the range limit filter. |
New object in range | An Object or Item report has been received that is newly in the range defined by the range limit filter. |
DX | A DX report has been received. |
Bell | A BEL control character (control-G or octal 007) was received in a terminal window, or the user attempted to enter a duplicate callsign for the station health monitor configuration. |
Object Takeover | An Object or Item report was received from another station for an Object the local station is transmitting. The local transmission is stopped until the operator manually re-enables it for the Object. |
New Station | A new station has been heard. Note this will include stations formerly heard who were inactive long enough to be expired out of YAAC's list of active stations. |
New Object | A new Object or Item has been heard. Note this will include Objects formerly heard who were inactive long enough to be expired out of YAAC's list of active objects. |
Station Out of Range | A station that was formerly within the defined range limit has moved outside that limit (or the local YAAC station has moved away from it). |
Lost Internet Connection | YAAC has lost an Internet connection to an APRS-IS server or to a TNC connected by KISS-over-TCP. The name of the remote computer is reported. |
Restored Internet Connection | The APRS-IS connection has been restored by auto-reconnect. |
GPS Lock Lost | Reports that YAAC's GPS data source has lost position. |
GPS Lock Acquired | Reports that YAAC's GPS data source has restored computing positions. |
New Bulletin | An APRS text message containing a new or updated bulletin was received. |
Object Out of Range | An Object or Item that was formerly within the defined range limit has moved outside that limit (or the local YAAC station has moved away from it). |
Critical Error | A critical error (possibly requiring user intervention) has occurred in YAAC. Currently, this is only reported for forced reduction in message retention intervals because YAAC is running out of memory. |
New Repeater in Range | A new repeater station has been discovered. Currently only used by the repeater finder plugin. |
Tracked Station | A station or object explicitly marked for tracking has moved. |
Announcement | General announcements from YAAC or one of its plugins. Currently only used by the Repeater Finder plugin to announce tuning changes of the radio so the operator can confirm the desired repeater was selected. |
Station Timed Out | Announcement that a particular station or object has not been heard from in a configured amount of time and is presumed off-the-air. Calculated by YAAC when updating the station history. |
Message Acknowledged | A remote station acknowledged receipt of an APRS text message sent to it by this station. |
Message Rejected | A remote station reported that it did not accept an APRS text message sent to it by this station. Typically, this occurs on Kenwood APRS-capable radios when their message list is full and has no more room to save more messages (operator hasn't deleted old messages). |
A Test Speech button is provided, which will cause YAAC to send the speech synthesizer the currently selected row in the event table (testing its definition) or, if no row is selected, the text "Testing speech synthesizer." Note that if using a multi-locale text-to-speech synthesizer, the command must properly specify (or infer from the environment) the correct language. The default text formats for speaking events are presently only provided in English and German; any overrides will not be translated if the user specifies a non-default custom event text format.
For speech synthesis, values from the event can be inserted into the text by entering appropriate macros into the text format string; these macros will be replaced by the corresponding text when the text is sent to the speech synthesizer program. These case-sensitive macros are:
Macro name | Meaning |
---|---|
{PACKET} | Speak the entire AX.25 packet (using the debugging format built into
the various packet classes in the Java toString() method; see
the YAAC plugin SDK or source code distribution for more information). |
{SENDER} | Speak the originating station's callsign in standard ITU phonetics. |
{OBJECT_NAME} | Speak the object name (if this is an object message), using phonetics if it looks like a callsign. |
{LATITUDE} | Speak the latitude in standard APRS format. |
{LONGITUDE} | Speak the longitude in standard APRS format. |
{ADDRESSEE} | Speak the addressee of an APRS text message, using standard phonetics if it looks like a callsign. |
{MESSAGE} | Speak the free-text comment of an APRS packet, spelling out capitalized abbreviations and using phonetics for words that look like amateur radio callsigns. |
{MAIDENHEAD} | Speak the phoneticized Maidenhead locator of the position message. |
{SYMBOL} | Speak the type description of the symbol. |
{ALTITUDE} | Speak the altitude (if any) in its specified units. |
{BEARING} | Speak the bearing from the local station to the specified station or object in degrees from True North. |
{DISTANCE} | Speak the distance from the local station to the specified station or object in the currently configured distance unit. |
{DIRECTION} | Speak the compass direction from the local station to the specified station or object in cardinal directions (North, South West, etc.). |
{MOBILEBEARING} | Speak the bearing to the remote station or object relative to the current or last-noticed direction
of motion of the local YAAC station. If the local station has never been noticed to move, this is the same as {BEARING} . |
{FREQUENCY} | Speak the frequency reported for the remote station or object in megaHertz. Typically, this only works for repeater objects. |
{SPEED} | Speak the reported speed of travel of the station or object, scaled into the currently configured distance units for YAAC. |
{COURSE} | Speak the reported direction of travel of the station or object in degrees from True North. |
{ALIAS} | Speak the tactical name (alias) of the station or object if it has one, otherwise speak the station's callsign. |
{AGE} | age of this station or object (period of time since the station or object was last heard from) |
If a macro is specified in a context where it doesn't have a value, no additional text will be inserted
when the macro is replaced (for example, the {ADDRESSEE}
of a new station event is meaningless and will be blank).