
# GMA Rig Connector Version 4.3

![GMA Rig Connector](rigtest_web.png)

## Introduction

This guide describes the installation and configuration of the GMA Rig Connector for Windows.

The GMA Rig Connector allows GMAwatch to tune your transceiver directly to the correct frequency and operating mode.

Example:

* A spot appears in GMAwatch on 7032 kHz CW.
* You click the frequency 7032.0-cw.
* Your transceiver automatically switches to 7032 kHz CW.

Falls hinter der Frequenz zusätzlich ein ↗ erscheint, führt dieser Link wie bisher zum Reverse Beacon Network (RBN) und zeigt die zugehörigen Empfangsberichte an.

The actual radio control is performed locally on your PC. GMAwatch only sends the requested frequency and operating mode to the local connector.

---

## Basic Concept

The GMA Rig Connector supports two operating modes:

* rigctld via TCP/IP
* serial (rigctl) with direct access to the COM port

The recommended operating mode is rigctld.

The Hamlib daemon rigctld den Zugriff auf den Transceiver. Alle Programme, zum Beispiel GMA Rig Connector, WSJT-X, Swisslog oder ein Logger, verbinden sich anschließend mit rigctld.

This requires only one connection to the COM port, allowing multiple applications to access the transceiver simultaneously.

Direct access via serial is still supported. It is mainly intended for testing or when only the GMA Rig Connector controls the transceiver.

---

## Recommendation

### Recommended Operating Mode: rigctld

* Standard solution
* Multiple applications simultaneously
* Only one COM port connection
* Ideal for everyday operation

### Alternative: serial (rigctl)

* Simple standalone solution
* Useful for testing
* Wenn ausschließlich der GMA Rig Connector verwendet wird

---

## Download

GMA Rig Connector Version 4.3

[https://gma.rocks/rigtest/gma-rig-connector-v4_3.zip](https://gma.rocks/rigtest/gma-rig-connector-v4_3.zip)

Test Page

[https://www.gma.rocks/rigtest/](https://www.gma.rocks/rigtest/)

## Hamlib

[https://github.com/Hamlib/Hamlib/releases](https://github.com/Hamlib/Hamlib/releases)

Hamlib version 4.7 or later is required. For most Windows PCs, the 64-bit version is recommended, for example:

```text
hamlib-w64-4.7.1.exe
```

---

## Determine the Hamlib Model Number

Für die Datei `config.json` wird die Hamlib-Modellnummer des Transceivers benötigt.

Unter Windows eine Eingabeaufforderung öffnen und in das Hamlib-Verzeichnis wechseln:

```cmd
cd "C:\Program Files\hamlib-w64-4.7.1\bin"

```

Alle unterstützten Geräte anzeigen:

```cmd
rigctl -l

```

Nach einem Hersteller suchen:

```cmd
rigctl -l | findstr /i yaesu
rigctl -l | findstr /i xiegu
rigctl -l | findstr /i icom
rigctl -l | findstr /i kenwood

```

Nach einem bestimmten Modell suchen:

```cmd
rigctl -l | findstr /i "FTDX1200"

```

Example:

```text
1034    Yaesu    FTDX1200

```

Die erste Zahl ist die Hamlib-Modellnummer.

Beispiele:

```text
Yaesu FTDX5000 = 1032
Yaesu FTDX1200 = 1034
Xiegu X6100    = 3087
Xiegu X9100    = 3087

```

Important:

Die Modellnummer kann sich zwischen verschiedenen Hamlib-Versionen ändern. Im Zweifel immer mit `rigctl -l` prüfen.

---

## Determine the COM Port

Im Windows-Gerätemanager unter:

```text
Anschlüsse (COM & LPT)

```

nachsehen.

Example:

```text
USB Serial Port (COM5)

```

Dann ist der einzutragende COM-Port:

```text
COM5

```

---

## Recommended Quick Start

1. Installing Hamlib.
2. ZIP-Datei entpacken.

3. Passende Konfigurationsdatei nach `config.json` kopieren.
4. COM-Port bei Bedarf anpassen.

5. `start-gma-rig.bat` ausführen.
6. `https://www.gma.rocks/rigtest/` öffnen.

7. Du bist auf Sendung!
---

## Configuration Files

Das Paket enthält nun mehrere Beispiel-Configuration Files:

* `config-template.json`

* `config-xiegu-x6100.json`

* `config-yaesu-ftdx1200-serial.json`

* `config-yaesu-ftdx1200-rigctld.json`

Kopiere die passende Datei nach `config.json` und passe ggf. COM-Port, Baudrate oder IP-Adresse an.

---

## Transceiver-specific Settings

In Version 4.3 kann die QSY-Reihenfolge (Mode → Frequenz oder Frequenz → Mode) sowie eine Verzögerungszeit nach Änderungen konfiguriert werden.

### Xiegu X6100 / X9100

Empfohlene Einstellung:

```text
order = mode-first

```

### Yaesu FTDX1200

Der Yaesu wählt bei einem Bandwechsel automatisch den Standard-Modus des Bands. Die Reihenfolge `Frequenz → Verzögerung → Mode` stellt sicher, dass der gewünschte Mode zuverlässig gesetzt wird.

Empfohlene Einstellung:

```text
order = freq-first
delay_after_freq = 250

```

---

## Starting the Rig Connector

### rigctld (empfohlen):

```text
start-gma-rig.bat

```

Dieses startet im Normalfall automatisch rigctld und anschließend den GMA Rig Connector. Beide Fenster müssen geöffnet bleiben.

### Alternative: serial (rigctl):

```text
start-connector.bat

```

Then die Testseite öffnen:

```text
https://www.gma.rocks/rigtest/

```

---

## Testing

Klicke auf eine beliebige Frequenz im Spot-Monitor.

Dein Transceiver sollte automatisch auf die gewählte Frequenz und die richtige Betriebsart umschalten.

---

## Troubleshooting

No connection?

* → Check the COM port.

Wrong frequency?

* → Check the Hamlib model number.

Yaesu stays on USB?

* → Use the following configuration to set the frequency first and apply the mode after a short delay:

```text
order = freq-first
delay_after_freq = 250

```

---

## WSJT-X mit rigctld verbinden

Empfohlene Einstellungen:

```text
Rig:             Hamlib NET rigctl
Network Server:  127.0.0.1:4532
PTT Method:      CAT

```

Danach Test CAT anklicken.

---

## New in Version 4.3

* Konfigurierbare QSY-Reihenfolge (`order` entfaltet entweder `mode-first` oder `freq-first`)

* Konfigurierbare Verzögerungszeiten nach Mode- oder Frequenzänderungen (`delay_after_freq`)

* Verbesserte Kompatibilität mit Yaesu-Transceivern

* Neue Beispiel-Configuration Files

* Aktualisierte Dokumentation

---

## New in Version 4.2

* rigctld als empfohlene Betriebsart

* Unterstützung für rigctl und rigctld

* Desktop-Starter `start-gma-rig.bat`

* Desktop-Icon `start-gma-rig.ico`

* Statusanzeige mit Frequenz und Mode

* Erst Mode, dann Frequenz: verbesserte Kompatibilität mit einigen Transceivern

---

Have fun using the GMA Rig Connector on the bands!

73 de DL4MFM

```

