ftl / tciadapter

Use WSJT-X, FLDigi, and CQRLog with the ExpertSDR software.

TCI-Hamlib Adapter

The TCI-Hamlib Adapter allows to use the Hamlib network protocol to communicate with SDRs that only support Expert Electornic's TCI protocol.

Currently the adapter works with the following applications:

• CQRLog
• FLDigi
• WSJT-X

I develop and test the TCI-Hamlib Adapter on a Linux PC, but I also provide binaries for Raspberry Pi and Windows.

Usage

The TCI-Hamlib Adapter is a command-line application. It has the following parameters:

  -h, --help                   help for tciadapter
  -l, --local_address string   Use this local address to listen for incoming Hamlib connections (default "localhost:4532")
  -d, --no_digimodes           Use LSB/USB instead of the digital modes DIGL/DIGU
  -t, --tci_host string        Connect the adapter to this TCI host (default "localhost:40001")
  -x, --trx int                Use this TRX of the TCI host

When there are no parameters given, the adapter uses both for Hamlib and TCI the default ports. If all your applications run on the same machine, using the default ports, this is the way to go:

tciadapter

Build

This tool is written in Go, so you need the latest Go on your computer in order to build it. As it does not have any other fancy dependencies, it can be build with a simple:

go build

Install on Debian-based Linux

• Download the latest .deb package from Releases,
• Install the package using sudo apt install ./tciadapter_<version>_<arch>.deb (of course, use the name of the file that you downloaded...).

For more information about how to use the CLI client application, simply run the command tciadapter --help.

The deb package also installs a systemd unit that runs the tciadapter as service. This unit is disabled by default. To run tciadapter automatically as service:

• Edit /etc/systemd/system/tciadapter.service to your needs,
• sudo systemctl daemon-reload
• sudo systemctl enable tciadapter.service
• sudo systemctl start tciadapter.service

Install as a Windows service

• Download the latest Windows executable from Releases,
• Unzip the package to your hard disk,
• Open a command line window with administrator permissions ("run as administrator"),
• Go into the directory where you unzipped tciadapter.exe,
• Run tciadapter install to install the service,
• Run net start tciadapter to start the service.

You can add all the required configuration paramters to the tciadapter install command:

tciadapter install -l :4554 -t 10.20.30.40:41001 -x 1 --no_datamodes

In this (admittedly extreme) example the service will listen on port 4554 and connect to ExpertSDR running on the host with the IP address 10.20.30.40 on port 41001, it will control the second receiver and will LSB/USB instead of the data modes.

License

This software is published under the MIT License.

Copyright Florian Thienel