CAT / Radio-Steuerung

HAM-Tools steuert dein Radio via Hamlib (rigctld). 38 Modelle vorkonfiguriert: Yaesu, Icom, Kenwood, Elecraft, Xiegu, FlexRadio — das sind die kuratierten Profile mit geprüften Werkseinstellungen. Das mitgelieferte Hamlib 4.7.1 kennt insgesamt 301 Modelle; jedes davon wählst du über den Hersteller-Eintrag «Weitere Hamlib-Modelle …» (siehe unten).

Verbindungswege 🆕

Neu in 1.13.0

Neben USB gibt es zwei Netzwerk-Wege. Auswahl im »Weg«-Picker oben in Einstellungen → CAT — pro Konfiguration wählbar:

Weg	Was dahintersteckt
USB (Serial)	Der Standard: HAM-Tools startet einen eigenen rigctld am USB-Serial-Port
IC-705 WLAN	HAM-Tools verbindet sich direkt mit dem IC-705 (oder kompatiblem Icom) über WLAN — natives Icom-RS-BA1-Protokoll, kein Zusatztool wie wfview oder kappanhang nötig
Netzwerk (rigctld)	Andocken an einen bereits laufenden rigctld-Server — z.B. von wfview/kappanhang auf demselben Mac oder einem Shack-PC im LAN

IC-705 WLAN — Radio ohne Kabel

Der IC-705 (und netzwerkfähige Icom-Verwandte) spricht das RS-BA1-Netzwerkprotokoll, das HAM-Tools seit 1.13.0 nativ implementiert (Control-Stream UDP 50001 + CI-V-Serial-Stream 50002):

• Felder: Radio-IP, Benutzer, Passwort — die Werte stammen aus dem Radio-Menü Set → WLAN-Set → Fernsteuerung (Network User mit Administrator-Rechten anlegen)
• Start ab 1.56: Ein serieller Port ist nicht nötig. «Start» wird klickbar, sobald Radio-IP, Benutzer und Passwort ausgefüllt sind.
• Was läuft: Frequenz, Mode und S-Meter live; PTT und QSY (Spot-Klick dreht das Radio) über WLAN
• Was über WLAN nicht geht: CW-Keying (Contest-Macros) und die rig-internen Voice-Memories — dafür braucht es den USB-Weg über rigctld
• Was bewusst nicht: Audio läuft nicht über HAM-Tools — WSJT-X & Co. nutzt du wie gewohnt extern (der Audio-Stream des Radios bleibt frei)
• Outdoor-Tipp: der IC-705 kann selbst als WLAN-Access-Point arbeiten — Mac direkt mit dem Radio-WLAN verbinden, kein Router nötig
• Die CI-V-Adresse muss zur Radio-Einstellung passen (IC-705-Standard: 0xA4)

Verbindungs-Überwachung: Seit 1.29.1 erkennt HAM-Tools einen WLAN-Verlust und verbindet sich automatisch neu. Seit 1.32 wacht zusätzlich ein CI-V-Watchdog über die Verbindung: Kommt ~10 s lang keine CI-V-Antwort vom Radio, gilt die Session als gestört und wird automatisch neu aufgebaut.

→ Schritt-für-Schritt: Tutorial: IC-705 über WLAN verbinden

Netzwerk (rigctld) — externer Hamlib-Server

Wenn ein Brückentool (wfview, kappanhang) oder ein anderer Rechner bereits einen rigctld betreibt, hängt sich HAM-Tools einfach dran:

• Host: 127.0.0.1 für dasselbe Gerät, sonst die LAN-IP des Shack-PCs
• Port: Standard-rigctld-Port ist 4532; wfview/kappanhang lauschen oft auf 4533, damit 4532 für andere Programme frei bleibt
• Prüfung ab 1.56: Leeres Feld = Port 4533. Ist die Eingabe keine ganze Zahl von 1 bis 65535, erscheint «Port: ganze Zahl von 1 bis 65535 eingeben.» und «Start» bleibt gesperrt. Einen seriellen Port braucht dieser Weg nicht.

wfview braucht 1.45.2 ab 1.45.2

wfview antwortet auf Frequenzabfragen mit Nachkommastellen. Ältere HAM-Tools-Versionen lehnten das ab und meldeten «Kein rigctld erreichbar» — seit 1.45.2 wird es korrekt gelesen.

FlexRadio — Radio im LAN ab 1.56

FlexRadio-Geräte der 6000- und 8000-Serie hängen am Netzwerk, nicht an USB. HAM-Tools startet dafür einen eigenen rigctld, der direkt mit der SmartSDR-Schnittstelle des Radios spricht — SmartSDR CAT oder ein anderes Zusatzprogramm ist nicht nötig.

1. Hersteller «FlexRadio», Modell «6000/8000 Series – Slice A» (B–D für weitere Slices)
2. Weg «LAN (Radio-IP)» wählen — bei Flex-Profilen steht er dort, wo sonst «USB (Serial)» steht
3. Radio-IP eintragen — sie steht in SmartSDR oder im DHCP-Verzeichnis des Routers. Den Port (4992) setzt Hamlib selbst; 127.0.0.1 geht nicht, das Radio hat immer eine eigene LAN-IP. Eine ungültige Adresse oder 127.0.0.1 wird orange markiert, «Start» bleibt dann gesperrt.

Frequenz, Mode und PTT laufen über CAT. Audio kommt nicht über CAT, sondern über die DAX-Geräte von SmartSDR (oder ein virtuelles Audiokabel wie Loopback): In SSTV, FreeDV, WSPR oder Winlink sie als Ein- und Ausgang wählen, wie eine normale Soundkarte.

Die Flex-Profile sind noch nicht mit echter Hardware erprobt — auch nicht zusammen mit SmartSDR for Mac und DAX. Rückmeldungen an bugs@funkwelt.net sind sehr willkommen.

Erste Inbetriebnahme (USB)

So richtest du den Standard-Weg über USB-Kabel ein (für WLAN siehe oben):

1. Cmd+, → CAT-Tab
2. Hersteller wählen (Icom / Yaesu / Kenwood / Elecraft / Xiegu / FlexRadio / Hamlib Dummy zum Testen ohne Hardware) — oder «Weitere Hamlib-Modelle …», wenn dein Radio nicht dabei ist (siehe unten)
3. Modell wählen — Werkseinstellungen (Baud, Datenbits, Parity, Handshake) werden automatisch geladen
4. Port (Bereich «Serielle Schnittstelle») auswählen — Dropdown listet alle /dev/cu.* (USB-CAT-Kabel werden automatisch erkannt)
5. CI-V Address (nur ICOM) — Default aus dem Profil, kannst du überschreiben falls dein Radio anders konfiguriert ist
6. "Start" klicken — die Badge oben wechselt von «CAT off» (grau) über «CAT…» (orange) auf «CAT» (grün)

Automatisch erkennen (Auto-Detect) 🆕

Neu in 1.15.0

Du weisst nicht, welche Baudrate dein Radio eingestellt hat — oder willst dir die manuelle Einrichtung ganz sparen? Der Button »Automatisch erkennen…« neben dem Modell-Picker findet dein Radio selbst (Funktionsweise wie die CAT-Suche in UCX Log).

1. Radio einschalten und per USB-/CAT-Kabel verbinden
2. Einstellungen → CAT → »Automatisch erkennen…« (nur klickbar, wenn CAT gestoppt ist — bei aktiver Verbindung erst Stop)
3. Hersteller wählen (z.B. Kenwood) — oder »Alle Hersteller«, wenn du dir unsicher bist
4. »Suche starten« — HAM-Tools probiert nacheinander jede Kombination aus Modell × USB-Port × Baudrate durch, bis das Radio gültig antwortet. Die Fortschrittsanzeige zeigt live, was gerade getestet wird („Teste Kenwood TS-590SG — usbserial-1420 @ 115200 Bd… 12/96")
5. Bei Treffer: »Übernehmen« schreibt Modell, Port und Baudrate in die aktive Konfiguration — danach wie gewohnt »Start« drücken

Gut zu wissen:

• Die Werks-Baudraten werden zuerst getestet — ein Radio mit Standardeinstellungen ist meist in Sekunden gefunden. Erst danach läuft die volle Baudraten-Matrix; eine Suche über alle Hersteller kann mehrere Minuten dauern (die Schätzung steht im Dialog).
• Einige verwandte Modelle teilen sich das CAT-Protokoll (z.B. Kenwood TS-480/590/890) — es kann also ein Nachbar-Modell anschlagen. Falls das angezeigte Modell nicht stimmt: »Weitersuchen« klicken, die Suche macht beim nächsten Kandidaten weiter.
• Die Suche ist WSJT-X-sicher: Sie läuft auf einem eigenen internen Port und lässt einen geteilten rigctld-Server (siehe CAT teilen) unangetastet.
• Erkannt wird nur der Weg USB (Serial) — für IC-705-WLAN und Netzwerk-rigctld siehe Verbindungswege.

CI-V Adresse (ICOM, Xiegu)

Jedes ICOM-Modell hat eine Standard-CI-V-Adresse; Xiegu (G90, X6100) spricht über Hamlibs Icom-Backend ebenfalls CI-V. HAM-Tools kennt:

Schreibweise

HAM-Tools zeigt die Adresse als 0xA4 (C-Notation), das Radio-Menü zeigt denselben Wert als A4h (h-Suffix). 0xA4 = A4h = 164 dezimal — es ist identisch dieselbe Adresse, nur andere Schreibweise.

Modell	CI-V	Modell	CI-V
IC-7300	0x94	IC-7100	0x88
IC-7610	0x98	IC-9100	0x7C
IC-705	0xA4	IC-7600	0x7A
IC-9700	0xA2	IC-7700	0x74
IC-7200	0x76	IC-7000	0x70
IC-746PRO	0x66	Xiegu G90 / X6100	0x70

TIP

Wenn dein Radio die CI-V im Menü auf einen anderen Wert geändert wurde, einfach den Wert im Feld überschreiben. Mit dem "Default (0xXX)"-Button setzt du wieder den Werkswert.

Bei Yaesu / Kenwood / Elecraft / FlexRadio ist die Section unsichtbar — diese Hersteller nutzen kein CI-V.

Beim freien Profil «Weitere Hamlib-Modelle …» erscheint die Section für alle Modelle des Icom-Backends (Hamlib-Nummern 3000–3999, also auch Xiegu). Das Feld ist dort leer: ohne Eingabe nimmt Hamlib seine eigene Standardadresse, ein eingetragener Wert überschreibt sie.

Multi-Config

Du kannst mehrere Konfigurationen speichern (z.B. eine pro Radio). Workflow:

1. Settings für Radio A machen (Modell + Port + ggf. CI-V)
2. "Speichern unter…" klicken → Name eingeben (z.B. IC-705 Mobile) → Speichern
3. Radio B konfigurieren (Modell wechseln, Port ändern)
4. Wieder "Speichern unter…" → IC-7300 Shack
5. Zwischen Configs wechseln: oben im "Aktive Konfig"-Picker

WARNING

Änderungen wirken in der aktuell aktiven Konfig. Wenn du z.B. von IC-705 zu IC-7300 wechselst und an der IC-7300-Config rumdrehst, ändert sich die IC-705-Config nicht — die ist gespeichert.

Was die App mit CAT macht

• Frequenz lesen: alle 500 ms (Default, einstellbar 200–2000 ms) → wird im Logbuch-Eingabe-Panel und im POTA/Contest-Form angezeigt
• Frequenz setzen: beim Klick auf einen DX-Cluster-Spot oder QTH-Memory springt das Radio auf die Frequenz
• Frequenz stellen ab 1.47.1: über und unter jeder Ziffer der Frequenzanzeige sitzt ein Pfeil — ein Klick erhöht oder senkt genau diese Stelle (1 Hz bis 10 MHz) und schickt den Schritt sofort als QSY ans Radio. Klick auf eine Ziffer öffnet das Textfeld zum Eintippen (Return übernimmt, Esc bricht ab). Ohne CAT wird die Frequenz lokal gesetzt.
• Mode lesen: synchron zur Frequenz, bestimmt RST-Default (599 für CW/Digi, 59 für SSB)
• Mode setzen: Mode-Picker im Radio/CAT-Panel sendet setMode an Hamlib → Radio dreht USB/LSB/CW/PKTUSB
• VFO A/B + Split: per Klick im Radio/CAT-Panel
• S-Meter: live aus dem Radio gelesen (Hamlib-get_strength)
• PTT: wird von den Contest-Voice-Macros (F1–F8) für SSB-Wiedergabe gesetzt; ansonsten greift die App nicht in den Sendebetrieb ein
• Tuner: die ATU-Pille schaltet den Antennentuner an/aus; der separate TUNE-Knopf (moderne Yaesu) startet einen echten Tuner-Abgleich (siehe unten)

Yaesu: ATU-Pille vs. TUNE-Knopf

Im Radio-Panel gibt es zwei getrennte Bedienelemente für den Antennentuner:

• ATU — Toggle: schaltet den eingebauten Tuner in die Leitung (an) bzw. heraus (aus). (Hiess früher »TUN« — umbenannt, weil es zu leicht mit dem »TUNE«-Knopf zu verwechseln war.)
• TUNE — startet einen echten Tuner-Abgleich am TRX. Bei modernen Yaesu über das CAT-Kommando AC002;; der FTX-1 nutzt eine abweichende Syntax und bekommt AC103; (seit 1.45.1).

Der TUNE-Knopf erscheint nur bei Rigs mit CAT-steuerbarem Tuner. Bei den älteren Yaesu mit Binär-CAT (FT-817/857/897) ist er ausgeblendet, da diese keinen über CAT abgleichbaren ATU haben. Das gerätespezifische Tune-Kommando ist pro TRX-Profil überschreibbar.

Robust gegen Tuner-/Voice-Aussetzer (seit 1.24.2 / 1.25.0)

Ein Yaesu-Abstimmvorgang ist ein nicht quittiertes CAT-Kommando und brachte früher die Verbindung kurz aus dem Tritt (bis hin zu »CAT neu verbinden nötig«). Jetzt fängt die App das ab: ATU-Toggle und Voice-Memory reissen die CAT nicht mehr ab (stiller Wiederholversuch), und nach einem TUNE-Abgleich synchronisiert sich die CAT automatisch & budgetfrei neu — beliebig oft, ohne manuellen Reset. Währenddessen zeigt das Status-Badge kurz »Tuning…« statt einer Fehlermeldung.

CAT teilen (WSJT-X & Co.)

Standardmässig hält HAM-Tools den seriellen Port exklusiv — solange CAT verbunden ist, kommt kein zweites Programm ans Radio. Mit »CAT teilen« läuft beides parallel:

1. Cmd+, → CAT-Tab → Schalter »rigctld für andere Programme offen halten« aktivieren.
2. In HAM-Tools »Start« (CAT verbinden).
3. WSJT-X (oder fldigi, JS8Call …) konfigurieren:
   • Rig: Hamlib NET rigctl
   • Netzwerk-Server: 127.0.0.1:4532
   • PTT-Methode: CAT
   • Abfrageintervall: 1 s

HAM-Tools betreibt seinen eingebauten rigctld dann als lokalen Server (nur 127.0.0.1, kein LAN-Zugriff), an den sich beliebig viele Hamlib-Programme anhängen. Der Server bleibt offen, auch wenn du HAM-Tools' eigene CAT-Verbindung trennst — eine laufende WSJT-X-Session reisst nicht ab. Beendet wird er über »Freigabe beenden« oder beim Schliessen der App.

Band-Sync gratis

Wenn WSJT-X über den geteilten rigctld das Band wechselt, sieht HAM-Tools das beim nächsten Frequenz-Poll. Aktivierst du im DX-Cluster »Band folgt TRX«, ziehen Spot-Liste, Weltkarte und Logbuch-Filter automatisch mit.

Mode-Picker auch ohne CAT nutzbar

Neu in 1.8.10

Mode-Auswahl funktioniert auch ohne aktive CAT-Verbindung — wichtig für Remote-Setups, Reise-Loggen ohne TRX in Reichweite oder das nachträgliche Pflegen von Papier-Logs.

• Mit CAT: Mode-Klick schickt setMode ans Radio, das Radio dreht, der Poll-Loop bestätigt den neuen Wert. Auswahl beschränkt auf Hamlib-Modes: USB, LSB, CW, CWR, AM, FM, RTTY, RTTYR, PKTUSB, PKTLSB.
• Ohne CAT: Mode-Klick setzt den Wert direkt im internen RadioState (USB/LSB werden zu SSB gemappt, PKTUSB/PKTLSB zu DATA, der Rest 1:1). Zusätzlich erscheinen digitale Modes unter einem Divider: FT8, FT4, JT65, JT9, PSK31, JS8, Q65, MSK144. Diese laufen am TRX über PKTUSB-Modulation — Hamlib kennt sie nicht direkt, deshalb sind sie ohne CAT-Verbindung ausgeblendet.

Der Status unter der Frequenz-Anzeige zeigt CAT (grün) oder manuell (grau), damit du jederzeit weisst, woher die aktuellen Werte kommen.

Weitere Hamlib-Modelle (freies Profil)

Dein Radio fehlt in der Modell-Liste? Das mitgelieferte Hamlib kennt rund 300 Modelle, von denen nur die 38 kuratierten als Profil mit Werkseinstellungen hinterlegt sind. Alle anderen erreichst du so:

1. Hersteller → «Weitere Hamlib-Modelle …» wählen. HAM-Tools liest die Modell-Liste aus dem mitgelieferten rigctld (rigctld -l).
2. Im Suchfeld Hersteller, Modell oder Hamlib-Nummer tippen und das Modell im Dropdown wählen — oder die Hamlib-Nr. direkt eintragen und Übernehmen klicken. Modelle, für die es bereits ein kuratiertes Profil gibt, sind entsprechend markiert.
3. HAM-Tools fragt die Fähigkeiten des Modells ab (rigctld --dump-caps) und füllt Baudrate, Datenbits, Parität und Handshake vor. Die Baudrate ist Hamlibs Maximum für das Modell; der erlaubte Bereich wird angezeigt — gleiche den Wert mit der Einstellung an deinem Radio ab.
4. Port wählen, bei Icom-Backend-Modellen ggf. CI-V-Adresse eintragen, Start.

Was beim freien Profil anders ist:

• Keine Band-Plausibilitätsprüfung, kein CAT-Tune-Knopf, keine Unterspannungs-Leistungskorrektur und keine Voice-Keyer-Zeile — diese Extras gibt es nur für die kuratierten Profile.
• Automatisch erkennen probiert nur die kuratierten Profile durch.
• Modelle, die Hamlib über das Netzwerk anspricht (FLRig, SDRConsole, weitere Flex-Slices …), lassen sich hier nicht wählen: starte rigctld dafür selbst und nutze den Weg «Netzwerk (rigctld)». Modelle mit Parallelport oder eigenem Treiber werden abgewiesen.
• Hamlib führt für jedes Backend einen Status (Stable, Beta, Alpha, Untested). Bei Beta und darunter kann es vorkommen, dass Mode oder PTT nicht sauber funktionieren — das ist dann eine Hamlib-Grenze, keine von HAM-Tools. Läuft ein Modell bei dir gut, melde es: daraus wird gern ein kuratiertes Profil.

Das freie Profil wird mit der Konfiguration gespeichert (Multi-Config funktioniert wie gewohnt). Wechselst du zurück auf einen kuratierten Hersteller, gelten wieder dessen Werkseinstellungen.

Hamlib unter der Haube

HAM-Tools bringt eine eigene rigctld-Binary mit (Universal2, in Contents/Helpers/rigctld im App-Bundle). Du brauchst kein separates Hamlib zu installieren.

rigctld wird beim CAT-Start als Subprocess gespawnt mit den passenden Argumenten:

rigctld -m <hamlibRigNumber> -r <port> -s <baud> -C data_bits=8,stop_bits=1,...

Bei ICOM kommt civaddr=0xXX automatisch ans -C-Argument.

Troubleshooting

Symptom	Mögliche Ursache
Badge bleibt grau auf «CAT off», «Start» ausgegraut	Kein Modell bzw. Port gewählt; bei IC-705 WLAN Radio-IP, Benutzer oder Passwort leer; bei Netzwerk (rigctld) ungültiger Port
Badge wechselt auf rot «CAT err»	Port belegt (andere App läuft), Baud passt nicht, Kabel ab — Tipp: »Automatisch erkennen« findet Modell + Baud selbst
Auto-Detect findet nichts	Radio aus, Kabel ab, oder ein anderes Programm hält den seriellen Port — und beim Icom: geänderte CI-V-Adresse (die Suche testet die Werks-Adresse)
Verbunden aber Freq bleibt auf 0	Falsche CI-V (bei ICOM), Radio im falschen Modus
Verbunden aber Mode bleibt auf "—"	Hamlib-Modul für dieses Modell unterstützt kein Mode-Read
Verbindung bricht ab	USB-Adapter-Treiber-Problem — anderes Kabel testen, FTDI-Driver aktualisieren

Bei wiederholbaren Problemen → Bug melden (Cmd+Shift+B) mit Diagnose-Anhang aktiviert.

Transceiver-Menü

In der Menüleiste unter Transceiver:

• Reset CAT (⌃⇧⌘R) — verbindet die aktive Konfig neu
• CAT verbinden bzw. CAT trennen (⇧⌘T)
• TRX-Setup laden — wechselt die aktive Konfig; ist CAT verbunden, wird neu verbunden
• TRX-Setup speichern… — speichert die aktive Konfig unter neuem Namen
• Einstellungen… — öffnet die Einstellungen

Tipps

• Multi-Radio-Shack: für jedes Radio eine Config — Wechsel per Picker, kein Eingabe-Marathon
• Portable: zweite Config mit anderem USB-Adapter-Port (kann je nach USB-Hub variieren)
• Test ohne Hardware: Profile Hamlib Dummy-Rig (Test ohne Hardware) → setzt willkürliche Werte, gut für UI-Tests