FLRIG Users Manual  1.3
FLRIG Users Manual - Version 1.3

Table of Contents


Transceiver Control

FLRIG is a transceiver control program designed to be used either stand alone or as an adjunct to FLDIGI. The supported transceivers all have some degree of CAT. The FLRIG user interface changes to accommodate the degree of CAT support available for the transceiver in use.

Three different main dialog aspect ratios can be selected to suit the computer screen dimensions and operator preferences. The wide aspect ratio can be resized horizontally. The narrow aspect ratios are fixed in width and height.




A fourth interface is available for all transceivers. It is suitable for use on a touch screen

Shown at 75% of full size

The back end control code for each transceiver is unique to FLRIG. No additional libraries or definition files are required.

Supported Transceivers

Elecraft Icom Kenwood Ten-Tec Yaesu Other
K2 IC-703 TS 140 TT 516 FT 100D PCR 1000
K3 IC 706 MK IIG TS 450 TT 535 FT-450 RAY 152
KX3IC-718 TS 480HX TT 538 FT-450D Xiegu 5105

IC 728 TS 480SATTT 550 FT 747GX

IC 735 TS 570 TT 563 FT 767

IC 746 TS 590S TT 566 FT 817

IC 746 Pro TS 590SG TT 588 FT 847

IC 756 Pro II TS 990 TT 599 FT 857D

IC 756 Pro III TS 2000
FT 897D

IC 910H


IC 7000


IC 7100


IC 7200


IC 7300

FT 2000

IC 7410


IC 7600


IC 7610


IC 7700


IC 7610

IC 7700

IC 7851

IC 9100

IC 9700

IC F8101


Select the transceiver with the "Config / Setup / Transceiver" menu item.


Each of the menu items will open the configuration dialog to the respecive tab:

Xcvr Select

I/O Ports - Xcvr

Select the rig in use from the "Rig" combo box.

The default values associated with that transceiver will be preset for you. These have been verified by the test team but might require some tweaking for your particular h/w.

Configure PTT

I/O Ports - PTT

Select CAT PTT if your transceiver supports a CAT command for PTT on/off. This control will default to checked if CAT PTT is supported.

You may prefer to use h/w PTT signaling instead of CAT PTT. The h/w PTT may be shared with the CAT serial port. Note that both RTS/CTS handshake and RTS PTT cannot both be used on a single serial port.

If your serial connection is a CI-V device you might need to check "Echo" and also set either RTS or DTR to +12 if CI-V power is derived from the serial port.

Your PTT h/w control may also make use of a second serial port. If that port is the secondary serial port of the SCU-17 then you must also enable the "Serial Port is SCU-17 auxiliary" control.

Configure auxiliary ports

I/O Ports - Aux

Aux Controls

You might also need access to special h/w functions. FLRIG provides this via the DTR and RTS signal lines of an independent serial port. Additional main dialog controls are enabled and shown if you select anything other than NONE (the default). Enable the "Serial Port is SCU-17 auxiliary" if you are using the SCU-17 secondary serial port.

Configure Polling

I/O Ports - Polling

Providing you transceiver supports the various meters and controls, you can elect to poll these every time the poll cycle occurs. Polling a value causes FLRIG to follow and well as control a particular transceiver function or control. The polling cycle will slow down as you elect to poll more and more values.

Send Command String


Testing your transceiver commands. FLRIG might not support a particular CAT command for your transceiver. You can test the support for a particular command using the "Send Cmd" tab. The command string must comply with the transceiver requirements. If ASCII text is used, as with transceivers based on the Kenwood command set you enter the string without spaces, i.e.


to read the A vfo .

For binary strings, used in older Yaesu transceivers, and all Icom CI-V type transceivers you need to enter the string as space delineated hex values, i.e.

Yaesu:  x00 x00 x00 x01 x05

Icom: xFE xFE x70 xE0 x1A x05 x00 x92 x00 xFD

The buttone "ICOM pre" and "ICOM post" will insert the preamble and postamble hex code sequences for the selected Icom transceiver.

Press the SEND button to transfer the command to the transceiver. The response will appear in the lower text control.

The diamond indicators will be lit for transceiver and fldigi connections respectively.

Configure Command Tracing

Configure code execution trace

Several debugging tools are available in flrig, including the ability to observe code execution in various parts of the program. The trace tool sends time annotated data to both a viewing dialog and a file named "trace.txt" which is written to the flrig files folder.

Example showing support code trace

Configure Read/Restore Xvcr Settings

flrig will read various transceiver parameters and restore them upon closing. The next image shows the available read/restore parameters for the Icom 7200. If a parameter is not available (or coded) it will be disabled and grayed out. Check each parameter that you want to read and restore. Reading and restoring transceiver parameters takes time, especially on older transceivers with low baud rate serial i/o. Check "Use xcvr data" i you want flrig to NOT change the transceiver operating state when it begins execution.

Restoring transceiver Status

Configure XmlRpc Server

Configure server

flrig accepts remote control via an XmlRpc socket interface. fldigi uses this access method for reading and writing transceiver parameters via flrig. WSJT-X and several other third party programs also use this method. See flrig XmlRpc Command Structures.

User Interface


Meter Display and Filters

Meter Filter Controls

You can control the behavior of both the average and peak values of the S-meter and Power out meters. Setting the controls to 1 for both average and peak will simply display the latest value available from the transceiver. The average setting results in the display showing the average of the last N readings. The peak value will display the average peak value over the last M readings.

Meter Scale

Right click on the main dialog power meter scale to open up this selection dialog. Each of the 4 scales and the "Auto scaled" box are buttons. Press the one you want to use. Auto-scaling adjusts the meter scale to the smallest scale consistent with the current measured peak power. If that power is fluctuating near the transistion point between two scales you might want to fix the scale to either the larger or smaller.

Slider sizing

When the user interface is configured to be "small" then the UI submenu will contain the item "Small sliders". Toggling this menu item will immediately change the size and positions of the various slider controls. Select the toggle button "Small sliders" on the Config menu for 1/2 size sliders and a dialog layout that uses less vertical space.

Small UI - Large Sliders

Small UI - Small Sliders

Additional Controls

Additional control settings may be available depending on the transceiver being controlled. These are in a drop-down area toggled by the arrow button to the left of the attenuator button on the small aspect ratio dialog view. These are the controls for the Yeasu FT950.









For the FT-450D, these control when accessed from the "touch" user interface scheme appear as:









Select the User Interface menu item to configure various user preferences including Configuring Fonts and Colors.

Operating Controls

Frequency Control

The frequency display is also a control. Each numeric is sensitive to the mouse left/right buttons for up/down and to the mouse scroll wheel for rapidly changing value. Click on upper half of the digit to increase frequency, and the lower half of the digit to decrease the frequency. Put the mouse over any of the numeric segments and you can enter a new frequency using the keyboard numeric keypad. If you make an error simply enter a non-numeric key. Set the newly entered frequency by pressing the Enter key.

To paste a frequency from the clipboard (kHz only), press control-V followed by the Enter key

Vfo-A and Vfo-B are separate controlS, A on the left, B on the right.

Left click on the A->B button to swap vfos. Right click on the A->B button to transfer vfoA to vfoB.

When the mouse pointer is over the frequency display you can also change frequency values using the arrow and page key buttons:

Control Sliders

The buttons that have a light box are toggles - activated when the lighted box is colored. Some of these are linked to a slider. If the button state is inactive then that associated slider will be greyed out. In the example the volume control is active and the NR control is inactive.


Operating FLRIG with FLDIGI requires a simple setup in FLDIGI. Deselect all but the "xmlrpc" rig control. Xmlrpc is used via a local socket device for the two programs to communicate. FLDIGI acts as the server and FLRIG the client. There is no requirement for start / stop ordering of the programs.

FLRIG sends rig configuration data to FLDIGI when the two programs initially recognize each other. This data is used to populate the rig name, the available modes and the available bandwidths.

After this initial communications the operator can set the paired controls from either FLDIGI or FLRIG. The two programs will remain synchronized. The data from the computer to the transceiver is always from FLRIG.

PTT can be activated at FLRIG or using the T/R button on FLDIGI. FLDIGI also engages the PTT via the macro <TX> <RX> tags. When operating digital modes with FLDIGI you should use the PTT from FLDIGI.

Configuration/Data files

Configuration and data files used by flrig consist of the following:

OS Folder File Usage
Windows XP c:\Documents and Settings\user-name\flrig.files flrig.prefs names transceiver file & xmlrpc port
Windows XP c:\Documents and Settings\user-name\flrig.files IC-7100.prefs (1)(2) IC-7100 specifc configuration items
Windows XP c:\Documents and Settings\user-name\flrig.files IC-7100.mat (1)(2) IC-7100 specific memory file
Windows 7/8/10 c:\Users\user-name\flrig.files flrig.prefs names transceiver file & xmlrpc port
Windows 7/8/10 c:\Users\user-name\flrig.files IC-7100.prefs (1)(2) names transceiver file & xmlrpc port
Windows 7/8/10 c:\Users\user-name\flrig.files IC-7100.mat (1)(2) names transceiver file & xmlrpc port
Linux/Unix/OS-X$HOME/.flrig flrig.prefs names transceiver file & xmlrpc port
Linux/Unix/OS-X$HOME/.flrig IC-7100.prefs (1)(2) names transceiver file & xmlrpc port
Linux/Unix/OS-X$HOME/.flrig IC-7100.mat (1)(2) names transceiver file & xmlrpc port

(1) Several TRANSCEIVER.prefs and mat files may be in the folder. Each specifc to the configured transceiver
(2) Files such as IC-7100.prefs.1, IC-7100.mat.1, up to a prefix of 5 may appear in the folder. These are aged files, with the oldest file having the largest prefix value. The mat files are only created if the user actually saved items to memory.

Transceiver Prefs details are shown in this file: flrig prefs file contents.

The file is human readable. Editing the file is not recommended.

Memory File

The contents of a typical transceiver prefs file contains:

7070000 9 34 "40 meter digital"
14070000 9 34 "20 meter digital"

Each line contains a frequency (Hz), Mode Nr., Bandwidth Nr., and "text tag"

The file is human readable. Editing the file is not recommended.

Event Log

Event Log

The event log is opened from the "Debug" menu. It allows you to view the serial and xmlrpc data exchanges between FLRIG, FLDIGI, xmlrpc transactions, and the transceiver.

Controlling Multiple Transceivers

You can have multiple instances of flrig running, each controlling a separate and unique transceiver. Doing this requires a separate configuration folder for each target transceiver. Either start flrig from a command line or copy the desktop launch icon and then modify it's "target" executable. In either case you will be adding a command line parameter

"--config-dir <target-dir>"

Note the double dash. The <target-dir> will be unique to each supported transceiver, for example: "C:\Users\<user-name>\flrig.ic7200" on Win-10, "/home/<user>/flrig.ic7200" on Linux or OS X. You will have to configure each instance with the correct interface parameters.


Transceiver How-To

FT 991A

FT-991A How-to

IC 7100

IC 7300

IC 7600

Andy's (VE3NVK / G8VTV) IC-7600 How-to

TT 550

The TenTec Pegasus, TT-550 is a computer only transceiver. FLRIG controls all aspects of this transceiver: TT550 - Pegasus Operating instructions

CW Keyer

CW Keyer Interface

Top of Page