FLDIGI Users Manual 4.0
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.
Several distinct separated with a semi-column, in increasing order. For example:
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.
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:
It is equivalent to:
In this case, it allows fldigi to scan all FM frequencies by clicking the macro button.
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.
<FREQ> CQ CQ de <MYCALL><RX><TIMER:5>
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:
There must be valid frequencies. This macro will display the message:
The frequency increment must be positive. This macro will fail:
All frequencies must be strictly positive.
The sequence of frequencies must be strictly increasing. Thus, this error message can appear with a macro such as:
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 delayed 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.
It is possible for the execution of the tag to be delayed until after the macro execution returns to the recieve state. This delayed execution capability is limited to a select number of tags. See Delayed Execution Macro Tags for a list of these tags and example.