FLDIGI Users Manual  3.21
Macros

Table of Contents

Macros are short text statements that contain imbedded references to text data used by the program fldigi. Macro definition files(s) are located in the $HOME/.fldigi/macros/ directory and all have the extention ".mdf". The default set of macros are contained in the file $HOME/.fldigi/macros/macros.mdf.

Fldigi will create this file with a set of default macros on its first execution.

Fldigi supports up to 48 macro definitions in sets of 12. Macro definitions are not recursive, that is; a macro cannot reference another macro or itself.

The imbedded references are similar to those used by DigiPan and other fine modem programs. The imbedded reference is an uppercase plain text descriptor contained with the <> brackets.

Macro tags

Macro Description
<FREQ> my frequency
<MODE> mode
<MYCALL> configuration call
<MYLOC> configuration locator
<MYNAME> configuration name
<MYQTH> configuration QTH
<MYRST> my RST
<ANTENNA> configuration antenna
<VER> Fldigi version


Macro Description
<CALL> other stations callsign
<INFO1> S/N or other data contained in first info field of status bar
<INFO2> IMD or other data contained in second info field of status bar
<LOC> other stations locator
<NAME> other stations name
<QTH> other stations QTH
<RST> other stations RST


Macro Description
<MAPIT> map other stations locator on google
<MAPIT:adr | lat | loc> map other stations address, latitude-longitude
locator as specified


<CLRRX> clear RX pane
<CLRTX> clear TX pane


Macro Description
<GET> text to NAME/QTH
<TALK:on|off|t> Digitalk On, Off, Toggle; this is a Windows only tag
and Digitalk must be running
<LOG> save QSO data to logbook immediately
<LNW> log at xmt time
<CLRLOG> clear log fields
<EQSL:[message> submit the current log entry to www.eQSL.cc This macro tag
should be put before <LOG> or <LNW>


Macro Description
<QSOTIME> insert current logbook time HHMM, ie 0919
<ILDT> insert current local date-time in iso-8601 format, ie 2011-08-28 04:16-0500
<LDT> insert Local date-time, ie 2011-08-28 04:16-0500
<IZDT> insert Zulu date-time in iso-8601 format, ie 08/28/2011 04:16 CDT
<ZDT> insert Zulu date-time, ie 2011-08-28 09:16Z
<LT> insert local time, ie 0416
<ZT> insert zulu time, ie 0916Z
<LD> insert local date, ie 2011-08-28
<ZD> insert Zulu date, ie 2011-08-28
<WX>
<WX:xxxx>
insert current weather data from METAR as specified on
WX configuration tab. see WX configure replace xxxx with the 4 letter
METAR designator for a report on a station other than the one specified on
the weather configuration tab.


Macro Description
<CNTR> insert current value of contest counter
<DECR> decrement contest counter
<INCR> increment contest counter
<XIN> send exchange in string
<XOUT> send exchange out string
<XBEG> mark exchange in start
<XEND> mark exchange in end
<SAVEXCHG> save marked text to contest exchange in


Macro Description
<RX> receive
<TX> transmit
<TX/RX> toggle Transmit / Receive


Macro Description
<SRCHUP> search UP for next signal
<SRCHDN> search DOWN for next signal


Macro Description
<CSV:on|off|t> on, off, toggle Analysis file
Macro Description
<GOHOME> return to waterfall cursor to sweet spot
<GOFREQ:NNNN> move waterfall cursor to freq NNNN Hz
<QSYTO> same as left-clk on QSY button
<QSYFM> same as right-clk QSY button
<QSY:FFF.F[:NNNN]> Qsy to transceiver frequency in kHz, optional waterfall
(Audio) frequency in Hz (If not specified, it i not changed). Several QSY
frequencies, or ranges of frequencies provided by one increment, can be
proposed, in which case the first frequency after the current frequency
is chosen.


Macro Description
<RIGMODE:mode> send CAT command to transceiver to change to a valid mode
<FILWID:width> send CAT command to transceiver to change to a valid filter
width example to QSY to sweetspot (center of bandpass filter) and select
narrow filter


Macro Description
<QSYTO><FILWID:200>
<QSYFM><FILWID:2700>
example to restore previous waterfall cursor frequency
and bandwidth
<FILE:> insert text file; a file selection box will open when this tag is
selected during editing


Macro Description
<IDLE:NN.nn> transmit idle signal for NN.nn sec
<TIMER:NN> repeat this macro every NN sec
<TUNE:NN> transmit single tone tune signal for NN sec
<WAIT:NN> insert delay of NN seconds before transmitting
<REPEAT> repeat macro continuously
<SKED:hhmm[:YYYYDDMM]> schedule execution to begin at time and optionally
date specified


Macro Description
<CWID> transmit a CW callsign identifier
<ID> transmit mode ID using waterfall video text
<TEXT> transmit video text defined on ID configuration tab
<TXRSID:on|off|t> transmit RSID on, off, toggle
<RXRSID:on|off|t> receive RSID on, off, toggle
<NRSID:NN> transmit multiple RsID bursts
NN < 0 will transmit NN bursts for current modem and then return to Rx
NN > 0 will transmit NN bursts for current modem and continue in Tx
NN = 0 will transmit 1 bursts and continue (same as NN = 1)
<DTMF:[Wn:][Ln:]> tones transmit DTMF tone sequence at start of
transmission; options W-wait n msec, default 0 L-tone symbol length n
in msec; default 50 msec '-', ' ' and ',' insert silence symbol
eg: <DTMF:W250:L100:1-256-827-3200>


Macro Description
<POST:+/-nn.n> CW QSK post-timing in milliseconds
<PRE:nn.n> CW QSK pre-timing in milliseconds
<RISE:nn.n><RISE:nn.n> CW rise time in milliseconds
<WPM:ww[:ff]> CW WPM, ww = word rate, optional ff = Farnsworth rate


Macro Description
<AFC:on|off|t> AFC on, off, toggle
<LOCK:on|off|t> lock waterfall cursor; on, off, toggle
<REV:on|off|t> Reverse on, off, toggle


Macro Description
<QRG:text> Insert current operating info with "text" into Rx stream, ie:
info text <<2013-01-12T21:18Z RTTY @ 14005000+0760>> which can be used to
return to a mode, rf, audio frequency.
<PAUSE> Cause transmission to pause at place of occurance in macro
text. "Pause/Break" key on keyboard resumes transmission
<TXATTEN:nn.n> set fldigi tx attenuator to value -30 dB <= val <= 0
<COMMENT:text> allow macro to contain a comment field; everything
between < and > is ignored by macro parser
<SAVE> save the current macro definitions to the current file


Macro Description
<MACROS:> load a new macro defs file; file prompt when editing macro


  * Added macro to insert QRG text into Rx stream
    <QRG:text to insert>
  * Added save macro <SAVE> tag
  * Added export strings
    - FLDIGI_LOG_FILE - current logbook file name
    - FLDIGI_MACRO_FILE - current macro file name
  * Added <PAUSE> tag
    - returns to receive, but does not clear Tx buffer
  * Added <TXATTEN:nn.n> <!TXATTEN:nn.n> tag to control
    transmit attenuator control from within a macro.
  * Added <COMMENT:text> macro tag
    a do nothing that disappears from the transmitted
    text


Modem macro tags

Macro tags are also assigned to each supported modem type and sub-modem type that is supported by fldigi:




Data Modems

<MODEM:BPSK1000> <MODEM:BPSK125> <MODEM:BPSK250> <MODEM:BPSK31> <MODEM:BPSK500>
<MODEM:BPSK63> <MODEM:BPSK63F> <MODEM:CTSTIA:1000:16> <MODEM:CTSTIA:1000:8> <MODEM:CTSTIA:250:8>
<MODEM:CTSTIA:500:16> <MODEM:CTSTIA:500:8> <MODEM:CTSTIA> <MODEM:CW> <MODEM:DOMEX4>
<MODEM:DOMEX5> <MODEM:DOMEX8> <MODEM:DOMX11> <MODEM:DOMX16> <MODEM:DOMX22>
<MODEM:DOMX44> <MODEM:DOMX88> <MODEM:FELDHELL> <MODEM:FSKH105> <MODEM:FSKHELL>
<MODEM:HELL80> <MODEM:HELLX5> <MODEM:HELLX9> <MODEM:MFSK11> <MODEM:MFSK128>
<MODEM:MFSK128L> <MODEM:MFSK16> <MODEM:MFSK22> <MODEM:MFSK31> <MODEM:MFSK32>
<MODEM:MFSK4> <MODEM:MFSK64> <MODEM:MFSK64L> <MODEM:MFSK8> <MODEM:MT63-1KL>
<MODEM:MT63-1KS> <MODEM:MT63-2KL> <MODEM:MT63-2KS> <MODEM:MT63-500L> <MODEM:MT63-500S>
<MODEM:NAVTEX> <MODEM:Olivia-16-1K> <MODEM:Olivia-16-500> <MODEM:Olivia-32-1K> <MODEM:Olivia-4-250>
<MODEM:Olivia-4-500> <MODEM:Olivia-64-2K> <MODEM:Olivia-8-1K> <MODEM:Olivia-8-250> <MODEM:Olivia-8-500>
<MODEM:OLIVIA:1000:32> <MODEM:OLIVIA:1000:8> <MODEM:OLIVIA:250:8> <MODEM:OLIVIA:500:16> <MODEM:OLIVIA:500:8>
<MODEM:OLIVIA> <MODEM:PSK1000C2> <MODEM:PSK1000R> <MODEM:PSK1000RC2> <MODEM:PSK125C12>
<MODEM:PSK125R> <MODEM:PSK125RC10> <MODEM:PSK125RC12> <MODEM:PSK125RC16> <MODEM:PSK125RC4>
<MODEM:PSK125RC5> <MODEM:PSK250C6> <MODEM:PSK250R> <MODEM:PSK250RC2> <MODEM:PSK250RC3>
<MODEM:PSK250RC5> <MODEM:PSK250RC6> <MODEM:PSK250RC7> <MODEM:PSK500C2> <MODEM:PSK500C4>
<MODEM:PSK500R> <MODEM:PSK500RC2> <MODEM:PSK500RC3> <MODEM:PSK500RC4> <MODEM:PSK63RC10>
<MODEM:PSK63RC20> <MODEM:PSK63RC32> <MODEM:PSK63RC4> <MODEM:PSK63RC5> <MODEM:PSK800C2>
<MODEM:PSK800RC2> <MODEM:QPSK125> <MODEM:QPSK250> <MODEM:QPSK31> <MODEM:QPSK500>
<MODEM:QPSK63> <MODEM:RTTY:170:45.45:5> <MODEM:RTTY:170:50:5> <MODEM:RTTY:850:75:5> <MODEM:RTTY>
<MODEM:SITORB> <MODEM:SLOWHELL> <MODEM:THOR100> <MODEM:THOR11> <MODEM:THOR16>
<MODEM:THOR22> <MODEM:THOR25x4> <MODEM:THOR4> <MODEM:THOR5> <MODEM:THOR50x1>
<MODEM:THOR50x2> <MODEM:THOR8> <MODEM:THRBX1> <MODEM:THRBX2> <MODEM:THRBX4>
<MODEM:THROB1> <MODEM:THROB2> <MODEM:THROB4> <MODEM:WEFAX288> <MODEM:WEFAX576>


Other Modems

The following modems perform other functions not involving data transportation:

Non Data Modems Description
<MODEM:NULL> Null modem - Rx stream is discarded. Tx stream is silent but PTT is enabled
<MODEM:SSB> SSB modem (place holder)
<MODEM:ANALYSIS> Analyze Frequency
<MODEM:WWV> Calibrate Sound Card


Local references are specified during the program configuration and can be changed during program operation.

Remote references are all part of the qso log field definitions and are routinely changed from contact to contact.

Global references are for items like Greenwich Mean Time.

The macros.mdf file can be edited with any ascii text editor such as kedit, gedit, geany, nano etc. But it is much easier to use the built-in macro editor provided in the program.

Macro Editor

Right click on any macro key (or the alternate set) and a macro editing dialog opens with the current copy of that macro and its label. This looks very similar to the DigiPan macro editor at the urging of Skip Teller, KH6TY.

macro-editor.png
Macro Editor

The Text box is a mini-editor with a very limited set of control functions. You can mark, bound and select text for deletion (ctrl-X), copy (ctrl-C), and paste (ctrl-V). Marked text can also be deleted with the delete or the backspace keys. Marked text modification can also be invoked by using the mouse right click after highlighting.

The macro reference in the pick list can be transfered to the current editing cursor location. Highlight the desired macro reference and then press the double << arrow key for each occurance of the reference to be put into the macro text. You can change the label name but any more than 8 characters may exceed the width of the button for the default sized main dialog.

The <TIMER:NN> and <IDLE:NN> macro tags should have the NN replaced with the time interval in seconds.

<TX><IDLE:5>CQ CQ de <MYCALL> <MYCALL> k<RX><TIMER:20>


The label associated with each macro key can be individually annotated with a symbol. Here are the symbols that are recognized by the button label drawing routine:

Macro Display Symbols

symbols.gif
Symbols


The @ sign may also be followed by the following optional "formatting" characters, in this order:

Thus, to show a very large arrow pointing downward you would use the label string "@+92-\>".

Here are my macro buttons suitably annotated:

macrobuttons.png
Macro Buttons

There are 4 sets of 12 macro functions. You can move between the 4 sets using the keyboard and the mouse.

  1. Left click on the "1" button to move to set #2. Right click on the "1" button to move to set #4.
  2. Move the mouse to anywhere on the macro buttons. Use the scroll wheel to move forward & backward through the macro sets
  3. Press the Alt-1, Alt-2, Alt-3 or Alt-4 to immediately change to that macro set.


You could use any label that is symbolic to the function required. Refer to the FLTK web site for a full list of label types.

If you modify the macros and do not save them ("Files/Save Macros" on the main window) fldigi will prompt you to save the macros when you exit the program if you have the Exit Prompts option selected.

Contest macro tags

Refer to Contest-How-To


Return to Top of Page
Return to Main Page