Rig2Cast Lib – Alternative zu Hamlib?

Rig2Cast Lib ist ein Open-Source-Framework, das in C# für die .NET 8-Plattform geschrieben wurde und zur Steuerung von Amateurfunk-Transceivern dient. Der Autor DeXTeRGT hat es als modulare Grundlage für Desktop-Anwendungen, Webschnittstellen, Hintergrunddienste und Netzwerkclients konzipiert – mit eigener Radioabstraktion, sicherem Multi-Client-Betrieb, modularen Treibern einzelner Modelle, Erkennung der Gerätefähigkeiten und optionalen Protokolladaptern.

Warum wurde Rig2Cast Lib entwickelt und ist es notwendig?

Hamlib slúži rádioamatérskej komunite mimoriadne dobre – podporuje impozantné množstvo rádií a predstavuje desaťročia skúseností s CAT Protokollen und physischer Hardware. Seine native Architektur in C integriert sich jedoch laut dem Autor nicht immer auf natürliche Weise in verwaltete .NET-Anwendungen. Die Verwendung von C# erfordert normalerweise native Binärdateien, plattformabhängige Bereitstellungen, eine interoperable Schicht und zusätzliche Synchronisation rund um den gemeinsamen Zugriff auf das Radio. Moderne Anwendungen müssen zudem häufig ein Radio sicher mehreren Clients gleichzeitig über native APIs, REST, gRPC, TCP, Desktop-Anwendungen und Webschnittstellen zugänglich machen.

Rig2Cast Lib geht dieses Problem aus einer neuen architektonischen Richtung an. Der Autor betont ausdrücklich, dass es sich nicht um einen Ersatz für Hamlib oder um eine direkte Portierung (Zeile für Zeile) nach C# handelt – es ist eine unabhängige Neubewertung der Steuerung von Radios für moderne .NET-Anwendungen. Die offizielle Dokumentation des Herstellers ist die Autorität für die Implementierung des CAT-Protokolls; Hamlib dient als nützliche Referenz für das erwartete Verhalten und als wichtiges Ziel der Kompatibilität, doch die Architektur und Implementierung von Rig2Cast entwickelt sich unabhängig von den verfügbaren CAT-Protokollen der Radios.

Das Ziel ist es nicht, mit Hamlib zu konkurrieren oder ihn zu diskreditieren. Hamlib bleibt ein wichtiges Projekt, eine unschätzbare Quelle an Erfahrungen und ein bedeutendes Ziel der Kompatibilität. Rig2Cast untersucht die Steuerung von Funkgeräten, die speziell für modernes .NET entwickelt wurde: asynchron, modular, gerätefähigkeitsgesteuert, sicher für mehrere Clients, unabhängig von der Transportschicht und einfach erweiterbar.

Ein Gerät und mehrere darauf zugreifende Software

Die physische CAT-Verbindung ist im Wesentlichen sequenziell – mehrere Anwendungen können nicht sicher gleichzeitig beliebige Befehle an denselben seriellen Port senden. Rig2Cast bietet daher einen verwalteten Befehlsplaner für das physische Radio. Mehrere logische Clients können gleichzeitig arbeiten, während die CAT-Kommunikation selbst seriell, geordnet und geschützt bleibt.

Jede Anwendung oder Netzwerkverbindung erhält eine eigene logische Identität und Sitzung. Die Laufzeit bietet Rollen und Berechtigungen für Clients, geordnetes Ausführen von Befehlen mit Prioritäten, exklusive Operationen, zeitlich begrenzten Zugriff auf sensible Operationen, Sitzung bereinigen nach der Trennung und sichere Koordination zwischen konkurrierenden Clients. Zusammengesetzte Änderungen können auf der Ebene der Funkoperationen transaktional sein - zum Beispiel kann die Änderung des Modus und der Bandbreite unter exklusiver Kontrolle erfolgen, sodass ein anderer Client keinen Befehl zwischen diesen beiden Änderungen einfügen kann.Sendeoperationen haben zusätzlichen Schutz und werden nicht wie gewöhnliche Setzbefehle (Setter) verarbeitet.

Die gleiche verwaltete Radioinstanz ist für die Unterstützung optionaler Schnittstellen bestimmt: natives C# API, REST API (geplant), gRPC (geplant), reichhaltigere native TCP-Protokolle (geplant), einen mit Hamlib rigctld kompatiblen Adapter (verfügbare erste Implementierung) und Desktop- sowie Webanwendungen oder Hintergrunddienste. Es handelt sich um Adapter rund um dasselbe Laufzeit- und Fähigkeitsmodell – die CAT-Logik des Herstellers bleibt innerhalb des Radio-Controllers, anstatt über jedes API und Benutzerinterface dupliziert zu werden.

Mögliche Kompatibilität mit Hamlib

Rig2Cast enthält einen separaten, optionalen TCP-Adapter, der mit rigctld kompatibel ist. Bestehende Hamlib-kompatible Clients können sich verbinden, während Rig2Cast im Hintergrund das physische Radio, logische Sessions und den seriellen CAT-Zugang verwaltet. Der aktuelle Adapter unterstützt mehrere gleichzeitige TCP-Clients und Befehle für Frequenz und aktives VFO, Betriebsmodus und modusabhängige Bandbreite, Split-Betrieb und das Lesen des PTT-Status, kurze und lange Befehlsformen sowie erweiterte Antworten.

Der Adapter hört standardmäßig auf der Loopback-Schnittstelle und arbeitet im Nur-Lese-Modus – das Schreiben muss ausdrücklich erlaubt werden, und PTT-Schreibvorgänge bleiben in diesem anfänglichen kompatiblen Adapter nicht verfügbar. Ziel ist praktische Kompatibilität, ohne das Sicherheitsmodell von Rig2Cast zu schwächen. Das Framework ist außerdem nicht auf das Legacy-Protokoll rigctld beschränkt – neue Funktionen können über das native C# API und zukünftige REST-, gRPC-, TCP-, Desktop- oder Webadapter verfügbar bleiben, auch wenn es dafür keinen Hamlib-Befehl gibt.

Aktueller Status und Download

Das Projekt befindet sich in der Phase aktiver früher Entwicklung – Architektur und funktioneller 'vertikaler Schnitt' (vertical slice) für Yaesu FTDX10 sind fertig, aber die öffentliche API ist noch nicht stabil. FTDX10 ist der erste unterstützte und physisch getestete Transceiver mit Abdeckung für Identifikation, Frequenz VFO A/B, Betriebsmodi, Split-Betrieb, CAT PTT, Filter, Verstärkung AF/RF, potlačovača šumu, RIT/XIT, S-metra a ďalších meračov. Súčasne prebieha aj počiatočná podpora rodiny Elecraft K3/K3S/KX3/KX2, implementiert gemäß der offiziellen Dokumentation des Herstellers, mit einer Basis-Schicht, die auf dem physischen K3S validiert wurde.

Der Quellcode, die Dokumentation und die Anleitung zum Zusammenbauen sind im Repository verfügbar DeXTeRGT/Rig2CastLib auf GitHub. Der Build erfordert das .NET 8 SDK und funktioniert unter Windows und Linux; für die Arbeit ohne physisches Radio ist auch ein FTDX10-Simulator enthalten. Der Autor gibt offen an, dass ein wesentlicher Teil des Codes, der Tests und der Dokumentation mit Hilfe von KI-Unterstützung unter menschlicher Aufsicht entstanden ist – Anforderungen, architektonische Ausrichtungen, Sicherheitsentscheidungen und endgültige technische Entscheidungen bleiben unter der Kontrolle des Projektinhabers, wobei der generierte Code denselben Kontroll-, Kompilierungs-, Test- und Validierungsprozess gegen das physische Radio durchläuft wie jeder andere Beitrag.