FLRIG Users Manual  1.3
FLRIG Users Manual - Version 1.3

Table of Contents

flriglogo.png

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.

ui-wide.png


ui-narrow-ic7200.png


ui-small-ic7200.png


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

ui-touch.png
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

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

FT-950

IC 7000

FT-1000MP

IC 7100

FT 2000

IC 7200

FTdx1200

IC 7300

FTdx3000

IC 7410

FTdx3000

IC 7600




IC 7700




IC 9100



Setup

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

config-setup-menu.png


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


Xcvr Select

xcvr.png
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.

You may prefer to use h/w PTT signaling instead of CAT PTT. Not all transceivers support the CAT PTT function, but it will be preset to on if the selected transceiver supports that command. The h/w PTT may be shared with the CAT 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.

ptt.png
I/O Ports - PTT


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.

aux.png
I/O Ports - Aux


aux-controls.png
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) on this tab. Enable the "Serial Port is SCU-17 auxiliary" if you are using the SCU-17 secondary serial port.

polling.png
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.png
I/O Ports - Polling


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.

FA;

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.


config-trace.png
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.

trace-dialog.png
Example showing support code trace

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.

restore.png
Restoring transceiver Status

User Interface

config-ui-menu.png


Meter Display and Filters

meter-filters.png
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.

power-scale-select.png
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.

ui-narrow-ic7200.png
Small UI - Large Sliders


ui-small-ic7200.png
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.

FT950-BANDS.png

FT950-CW.png

FT950-QSK.png

FT950-VOX.png

FT950-SPCH.png

FT950-RX.png

FT950-MISC.png

FT950-USER.png

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

touch-main.png


touch-buttons.png


touch-sliders.png


touch-other-bands.png


touch-other-cw.png


touch-other-qsk.png


touch-other-vox.png


touch-other-misc.png

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

Operating Controls

frequency-control.png
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:


buttons-sliders.png
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.

flrig-fldigi.png
FLRIG/FLDIGI


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.

flrig-event-log.png
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, 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.

mulitple_configs.png


TT 550

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

IC 7600

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

Top of Page