The <QSY:FFF.F[:NNNN]>
macro tag and its delayed flavour <!QSY:FFF.F[:NNNN]> allows
the user to set the transceiver frequency to FFF.F (In kHz) and optionaly set
the audio frequency to NNNN (In Hz).
It is possible to give
several frequencies, which specify a frequency set. When the macro is
executed, it choses the first frequency of this set greater than the
current one. If the current frequency is greater than any frequency of
the set, then the macro choses the smallest, first frequency of this
set.
The utility of this feature is to allow a scan of a range of
frequencies by re-executing the same macro over and over. Each time the macro is executed, the
next frequency of the set is selected. It can typically be used to
iteratively try several frequency for a given test.
The frequency set can be specified in two distinct ways, which can be freely combined together.
Distinct frequencies
Several distinct separated with a semi-column, in increasing order. For example:
<QSY:2616.6;3287.6;3853.1;4608.1;4780.1;7878.1;8038.1:1900>
It
means that the transceiver frequency will be set to 2616.6 kHz, then at
next execution to 3853.1 kHz etc... and will loop back to 2616.6 kHz.
Each time the same (optional) audio frequency will be set to 1900 Hz.
In this specific case, it allows to test several Weather Fax broadcast stations,
until the operator finds an active one.
Frequencies with increments
A
frequency can come with an increment: This means an implicit range of
frequencies from this one to the next frequency. If the last frequency
has an increment, it is never taken into account: The last frequency is
always an upper limit. Let's consider this
example:
<QSY:89000+100;102000>
It is equivalent to:
<QSY:89000;89100;89200;89300;...;101900;102000>
In this case, it allows fldigi to scan all FM frequencies by clicking the macro button.
Combination with <TIMER> macro tag.
If
the macro is automatically reexecuted using the <TIMER>, the
same logic applies. At each run of the macro, the next frequency is
chosen. The following macro transmits the same message on the
frequencies 144800 MHz, 144900 ... until 146000 then loops back,
waiting five seconds between each transmission.
<TX><QSY:144800.00+100;146000><MODEM:NULL><!MODEM:PACKET>
<FREQ> CQ CQ de <MYCALL><RX><TIMER:5>
Execution errors.
Several
error messages can be displayed in the macro editor in case of a
parameter. If this happens, the execution of the macro is stopped. Here
is the list of possible messages:
Invalid frequency range
There must be valid frequencies. This macro will display the message:
<QSY:abcdef>
Increment must be positive
The frequency increment must be positive. This macro will fail:
<QSY:89000-1000;88000>
Frequency not positive
All frequencies must be strictly positive.
Frequencies must be increasing
The sequence of frequencies must be strictly increasing. Thus, this error message can appear with a macro such as:
<QSY:89000;88000>
Inline Macro Tags
Unless otherwise noted all of the macro tags discussed thus far are
meant to be executed at the time that the macro is invoked by the
button closure. It is possible by execution of the tag to be
delated until it appears in the transmit data stream. This
delayed execution capability is limited to a select number of
tags. See
Inline Macro Tags for a list of these tags and examples.