
# GMA Rig Connector Version 4.3

![GMA Rig Connector](rigtest_web.png)

## Einleitung

Diese Anleitung beschreibt die Einrichtung des GMA Rig Connectors unter Windows.

Mit dem GMA Rig Connector kann GMAwatch Deinen Transceiver direkt auf die passende Frequenz und Betriebsart umschalten.

Beispiel:

* In GMAwatch erscheint ein Spot auf 7032 kHz CW.
* Du klickst auf die Frequenz 7032.0-cw.
* Dein Transceiver schaltet automatisch auf 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.

Die eigentliche Steuerung erfolgt lokal auf Deinem PC. GMAwatch sendet lediglich Frequenz und Mode an den lokalen Connector.

---

## Grundidee

Der GMA Rig Connector unterstützt zwei Betriebsarten:

* rigctld über TCP/IP
* serial (rigctl) mit direktem Zugriff auf den COM-Port

Empfohlen wird heute die Verwendung von rigctld.

Dabei übernimmt der 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.

Dadurch ist nur noch eine einzige Verbindung zum COM-Port erforderlich und mehrere Programme können gleichzeitig auf den Transceiver zugreifen.

Der direkte Zugriff über serial wird weiterhin unterstützt. Er eignet sich vor allem für Testzwecke oder wenn ausschließlich der GMA Rig Connector verwendet wird.

---

## Empfehlung

### Empfohlene Betriebsart: rigctld

* Standardlösung
* Mehrere Programme gleichzeitig
* Nur eine Verbindung zum COM-Port
* Ideal für den täglichen Betrieb

### Alternative: serial (rigctl)

* Einfache Einzelplatz-Lösung
* Sinnvoll für Tests
* 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)

Es wird mindestens Hamlib 4.7 oder neuer benötigt. Für die meisten Windows-PCs ist die 64-Bit-Version passend, z. B.:

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

---

## Hamlib-Modellnummer ermitteln

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"

```

Beispiel:

```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

```

Wichtig:

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

---

## COM-Port ermitteln

Im Windows-Gerätemanager unter:

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

```

nachsehen.

Beispiel:

```text
USB Serial Port (COM5)

```

Dann ist der einzutragende COM-Port:

```text
COM5

```

---

## Kurzstart empfohlen

1. Hamlib installieren.
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!
---

## Konfigurationsdateien

Das Paket enthält nun mehrere Beispiel-Konfigurationsdateien:

* `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-spezifische Einstellungen

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

```

---

## Starten des Rig Connectors

### 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

```

Anschließend 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.

---

## Fehlerbehebung (Troubleshooting)

Keine Verbindung?

* → Überprüfe den COM-Port.

Falsche Frequenz?

* → Überprüfe die Hamlib-Modellnummer.

Yaesu bleibt auf USB stehen?

* → Nutze die folgende Konfiguration, um erst die Frequenz zu setzen und nach einer kurzen Verzögerung den Mode anzuwenden:

```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.

---

## Neu 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-Konfigurationsdateien

* Aktualisierte Dokumentation

---

## Neu 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

---

Viel Spaß mit dem GMA Rig Connector auf den Bändern!

73 de DL4MFM

```

