Rig‐Control

Rig Control

OpenHamClock has two rig control tools: Rig Listener (lightweight, standalone) and Rig Bridge (full plugin architecture with web UI). Both connect your radio to OpenHamClock for frequency/mode display and click-to-tune.

Rig Listener

A single-file Node.js agent that runs on the machine connected to your radio. Talks directly to your radio via USB/serial or TCI WebSocket and streams frequency, mode, and PTT state to OpenHamClock over SSE.

Supported Radios

Direct USB/Serial (CAT):

Brand	Protocol	Tested Models
Yaesu	CAT (binary)	FT-991A, FT-710, FTDX-10, FT-891, FT-857D
Kenwood	Kenwood ASCII	TS-890, TS-590, TS-2000
Icom	CI-V (binary)	IC-7300, IC-7610, IC-9700, IC-705
Elecraft	Kenwood ASCII	K3, K4, KX3, KX2

SDR Radios via TCI (WebSocket):

Application	Radios	Default Port
Thetis	Hermes Lite 2, ANAN	40001
ExpertSDR	SunSDR2	40001
SmartSDR	Flex (via TCI bridge)	varies

Via Control Software:

Software	Protocol
flrig	XML-RPC
rigctld / Hamlib	TCP

Quick Start

Download from the OpenHamClock dashboard (Settings → Rig Control → Download), or run manually:

cd rig-listener
npm install
node rig-listener.js --yaesu --port /dev/ttyUSB0 --baud 38400

TCI Setup (SDR)

For SDR radios using TCI:

1. Enable TCI in your SDR app (e.g., Thetis → Setup → CAT Control → Enable TCI Server)
2. Run: node rig-listener.js --tci
3. Default connects to localhost:40001

See the rig-listener README for full TCI configuration options.

---

Rig Bridge

A more advanced plugin-based architecture with a built-in web setup wizard. Includes all Rig Listener capabilities plus:

• Browser-based setup UI (auto-opens on first run)
• Plugin architecture for adding new radio types
• TCI/SDR support with configurable host/port/TRX/VFO
• WSJT-X relay forwarding

Quick Start

cd rig-bridge
npm install
node rig-bridge.js

Opens a setup wizard in your browser where you can select your radio type, serial port, and baud rate.

TCI Configuration

Edit rig-bridge-config.json:

{
  "radio": { "type": "tci" },
  "tci": {
    "host": "localhost",
    "port": 40001,
    "trx": 0,
    "vfo": 0
  }
}

Or configure through the web setup wizard (select "TCI/SDR" in the radio type dropdown).

---

Click-to-Tune

When a rig is connected, clicking a DX spot, POTA activation, or any frequency in the dashboard tunes your radio automatically. The tuneTo() function in the frontend handles all unit conversion.