Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ftl/tciadapter

Use WSJT-X, FLDigi, and CQRLog with the ExpertSDR software.
https://github.com/ftl/tciadapter

amateur-radio amateurradio fldigi ham-radio hamlib hamradio sdr tci wsjt-x wsjtx

Last synced: 1 day ago
JSON representation

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

Awesome Lists containing this project

README

        

# TCI-Hamlib Adapter

The TCI-Hamlib Adapter allows to use the [Hamlib](https://github.com/Hamlib/Hamlib) network protocol to communicate with SDRs that only support Expert Electornic's [TCI protocol](https://github.com/maksimus1210/TCI).

Currently the adapter works with the following applications:

* [CQRLog](https://www.cqrlog.com/)
* [FLDigi](http://www.w1hkj.com/)
* [WSJT-X](https://www.physics.princeton.edu/pulsar/k1jt/wsjtx.html)

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](https://golang.org), 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](https://github.com/ftl/tciadapter/releases/latest),
* Install the package using `sudo apt install ./tciadapter__.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](https://github.com/ftl/tciadapter/releases/latest),
* 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](https://www.tldrlegal.com/l/mit).

Copyright [Florian Thienel](http://thecodingflow.com/)