OpenShack Handbuch Erweitert

Netzwerk-Ports

Wenn Sie die Remote Station nutzen, öffnen mehrere ihrer Integrationsfunktionen lokale Netzwerk-Ports auf Ihrem PC, damit andere Programme — Ihr Logger, eine Hamlib-Anwendung, WaveLog oder PSTRotator — mit OpenShack kommunizieren können. Standardmäßig binden diese an Loopback (127.0.0.1), sind also nur vom selben PC aus erreichbar und niemals aus dem Internet.

Normalerweise müssen Sie sich darüber keine Gedanken machen. Die Tabelle ist für die seltenen Fälle gedacht, in denen eine Portnummer mit einem anderen Programm kollidiert oder Ihre Firewall/Ihr Virenschutz eine lokale Verbindung blockiert. Die meisten Ports lassen sich unter Remote Station → Settings ändern; einige sind fest.

ℹ️ An das LAN statt an Loopback binden
Die Listener für Client-CAT, rigctld, TRX-Emulator und WaveLog-QSO haben jeweils eine Lausch-IP-Auswahl neben dem Port. Belassen Sie sie auf localhost (Standard), damit sie PC-lokal bleiben, oder wählen Sie eine der LAN-Adressen Ihres PCs, damit ein anderer Computer in Ihrem Netzwerk sie erreichen kann. Die WaveLog-Gateway-Endpunkte (54321 / 54322) sind die Ausnahme — sie sind immer fest auf Loopback.

Host-Seite (der PC am Funkgerät)

Auf dem Host verbindet sich OpenShack zu Diensten, die bereits auf demselben PC laufen (Ihre CAT-Software, rigctld oder PSTRotator), sowie zu Stationsgeräten im Netzwerk wie OM-Power-Endstufen.

VerwendungProtokollStandard-PortÄnderbar?
CAT-Proxy → CAT/TCP-Server Ihres GerätsTCP9700Ja — Host CAT (TCP)
rigctld-Proxy → laufender rigctldTCP4532Ja — rigctld Host-Port
von OpenShack gestarteter rigctld (dessen Lausch-Port)TCP4532Ja — rigctld Lausch-Port
Antennenrotor → PSTRotator (Befehle senden; ein Port-Paar je eingerichtetem Rotor, bis zu vier)UDP12000Ja — Port je Rotor
Antennenrotor ← PSTRotator (Azimut-Updates)UDP12001Folgt dem Port des Rotors + 1
OM-Power-Endstufe (eingebauter LAN-Anschluss; eine Verbindung je eingerichteter Endstufe, bis zu vier)TCP10001Ja — Port je Endstufe

Client-Seite (Ihr entfernter Standort)

Auf dem Client lauscht OpenShack, damit Ihre Logging- und Digimode-Programme sich so verbinden können, als wäre das Funkgerät lokal.

VerwendungProtokollStandard-PortÄnderbar?
CAT-Port für Ihren Logger (z. B. N1MM+)TCP4573Ja — Client CAT (TCP)
rigctld-Port für Hamlib-AnwendungenTCP4532Ja — Client rigctld-Port
TRX-Emulator (TS-2000) für Contest-LoggerTCP4574Ja — TRX-Emulator-Port
WaveLog-QSO-Upload von MSHV / WSJT-XUDP4575Ja — WaveLog-QSO-Port
WaveLog Gateway — QSY-/Abstimm-BefehleHTTP54321Fest
WaveLog Gateway — Live-GerätestatusWebSocket54322Fest
Winkey-Proxy für N1MM+ CWVirtueller COMCOM-Port, kein Netzwerk-Port
ℹ️ Die Remote-Verbindung selbst nutzt andere Ports
Die obige Tabelle betrifft nur lokale Programme, die auf demselben PC mit OpenShack kommunizieren. Die eigentliche Audio-/CW-/CAT-Verbindung zwischen Host und Client handelt Netzwerkpfad und Ports automatisch aus. Für diese Seite — UDP-Portbereiche, Portweiterleitung im Router und IPv6 — siehe So verbessern Sie Ihre Latenz.

Fensterpositionen

OpenShack merkt sich Position und Größe jedes Fensters ganz von allein. Öffnen Sie es das nächste Mal, sitzt es wieder genau dort, wo Sie es verlassen haben. Die gespeicherten Positionen sind an Ihre aktuelle Monitor-Konfiguration gekoppelt — wechseln Sie das Setup (z. B. von zwei Bildschirmen auf einen), pflegt OpenShack für jede Konfiguration einen eigenen Satz Positionen.

Dateispeicherort

Alle Fensterpositionen stehen im lokalen Datenordner in einer einzigen JSON-Datei:

Den Ordner öffnen Sie am schnellsten mit Win+R: %LocalAppData%\DL2CC-STUDIO\WindowStates einfügen und Enter drücken, oder über die DATA-Schaltfläche im Abschnitt Lokalen Datenordner finden.

Fensterpositionen zurücksetzen

Landet ein Fenster mal außerhalb des sichtbaren Bereichs, hat es eine krumme Größe oder ist das Layout sonst irgendwie aus dem Ruder gelaufen — alle Positionen lassen sich mit wenigen Handgriffen zurücksetzen:

  1. OpenShack komplett beenden.
  2. In den oben genannten Ordner wechseln.
  3. windowstates.json löschen.
  4. OpenShack neu starten — alle Fenster öffnen wieder an ihren Standardpositionen.
💡 Tipp
Die Datei zu löschen ist völlig harmlos. OpenShack legt beim nächsten Öffnen und Schließen von Fenstern automatisch eine neue an.

Mitgelieferte virtuelle Audio- und COM-Ports

Wenn Sie die Remote Station als Client betreiben, möchten Sie oft, dass Fremdsoftware — ein Digimode-Decoder, ein Contest-Logger oder eine WinKey-Anwendung — mit dem entfernten Funkgerät so kommuniziert, als wäre es lokal angeschlossen. Das Setup von OpenShack kann die dafür nötigen Hilfstreiber gleich mit installieren:

  • VB-Audio VB-CABLE — verbindet Audio zwischen OpenShack und Digimode-Programmen (WSJT-X, MSHV, FLDigi, …).
  • com0com-Portpaare — verbinden COM/seriell zwischen OpenShack und Software, die nur COM spricht (CAT, TS-2000-Emulator, WinKey).
ℹ️ Kein separater Kauf von VSPE oder Virtual Audio Cable nötig
Wählen Sie im Setup die Optionen für VB-CABLE und com0com, dann werden die benötigten virtuellen Audio- und COM-Schnittstellen angelegt. Andere kompatible Virtual-Audio- oder Virtual-COM-Lösungen können Sie bei Spezial-Setups weiter nutzen, für den normalen OpenShack-Workflow sind sie aber nicht mehr erforderlich.

VB-Audio VB-CABLE

Wenn Sie die Option im Setup auswählen, zeigt Windows danach zwei Audiogeräte namens CABLE Input und CABLE Output (VB-Audio Virtual Cable). Eventuell ist ein Neustart nötig, bevor diese Geräte zuverlässig erscheinen.

  • Empfang (Remote-TRX → Decoder): Das Digimode-Programm nimmt von CABLE Output auf.
  • Senden (Encoder → Remote-TRX): Das Digimode-Programm spielt seine Töne auf CABLE Input aus.

Die Namen wirken zunächst vertauscht, beschreiben aber die Enden des Kabels: Ein Programm spielt Audio in CABLE Input hinein, ein anderes nimmt dasselbe Audio von CABLE Output auf. Wählen Sie in den Audio-Einstellungen von OpenShack die dazu passenden Geräte, je nachdem ob Sie Empfangsaudio, Sendetöne oder beides routen möchten.

Hinweis zu VB-CABLE als Donationware
VB-CABLE ist Donationware von www.vb-cable.com; freiwillige Beiträge sind willkommen. Das OpenShack-Setup installiert das VB-Audio-Paket als Komfortfunktion, damit Digimode-Software ohne zusätzliche Handarbeit funktioniert.
💡 Höhere Bitrate für Digimode
Starke OPUS-Kompression bei niedriger Bitrate kann genau die Töne verwischen, auf die ein Digimode-Decoder angewiesen ist. Wenn die Dekodierung unzuverlässig ist, wählen Sie ein OPUS-Preset mit höherer Bitrate.

com0com-Portpaare

Wenn Sie die Option im Setup auswählen, legt OpenShack drei com0com-Portpaare an. Jedes Paar hat eine OpenShack-Seite und eine Seite für externe Software. In der bevorzugten Standardbelegung wird der ungerade Port in OpenShack verwendet und der darauf folgende gerade Port im externen Programm.

VerwendungOpenShack-SeiteSeite für externe Software
CAT-BridgeCOM21COM22 (WSJT-X / Logger)
TRX-Emulator / TSEMUCOM23COM24 (externe Software)
Winkey-Proxy / EmulatorCOM25COM26 (N1MM+ / Logger-Winkey)

Falls einer der bevorzugten Ports bereits belegt war, vergibt Windows freie Ersatz-Ports. Die tatsächliche Zuordnung speichert das Setup hier; diese Datei ist für Ihren PC maßgeblich:

%LocalAppData%\DL2CC-STUDIO\Setup\virtual-com-ports.txt
%LocalAppData%\DL2CC-STUDIO\Setup\setup-notes.txt
ℹ️ com0com-Werkzeuge sind für Support gedacht
Das Setup kopiert außerdem com0com-Launcher nach %LocalAppData%\DL2CC-STUDIO\Setup\com0com. Normale Anwender müssen diese Werkzeuge nach dem Setup nicht starten. Sie sind für Kontrolle, Support und fortgeschrittene manuelle Änderungen gedacht; Änderungen dort können virtuelle COM-Geräte entfernen und neu anlegen.

Konfiguration von Drittsoftware

Dieser Abschnitt sammelt konkrete Setup-Beispiele für Programme, die mit OpenShack zusammenarbeiten. Die Beispiele gehen davon aus, dass die Remote Station als Client läuft und OpenShack die lokalen Schnittstellen bereitstellt, mit denen sich das externe Programm verbindet: Audio über VB-CABLE, CAT über einen virtuellen COM-Port oder TCP-Listener und fertige QSOs über den WaveLog-UDP-Listener.

ℹ️ Nur lokale Ports
Die hier gezeigten Adressen verwenden 127.0.0.1. MSHV spricht damit nur mit Programmen auf demselben Windows-PC. Die eigentliche Remote-Verbindung zum Funkgerät läuft weiterhin über die Remote Station von OpenShack.

MSHV

MSHV lässt sich mit OpenShack für Digimode-Betrieb nutzen. In einem typischen Setup liefert OpenShack das Empfangsaudio der Remote Station über ein virtuelles Audiokabel an MSHV, stellt CAT/PTT über die clientseitige TRX-/CAT-Schnittstelle bereit und übernimmt geloggte QSOs aus MSHV zur Weitergabe an WaveLog.

  1. Audio über ein virtuelles Audiokabel führen. In MSHV stellen Sie die empfangende Input Devices-Seite auf die Aufnahme-Seite des Kabels (CABLE Output im Screenshot) und die sendende Output Devices-Seite auf die Wiedergabe-Seite des Kabels (CABLE Input im Screenshot).
  2. In OpenShack den clientseitigen WaveLog-QSO-UDP-Listener aktivieren. Die Standardadresse ist 127.0.0.1, der Standard-UDP-Port ist 4575.
  3. In MSHV die Netzwerk-/ADIF-Broadcast-Einstellungen öffnen, Enable Logged QSO ADIF aktivieren, Server auf 127.0.0.1 setzen und als Port 4575 eintragen.
  4. Die Rig-Steuerung in MSHV auf den lokalen CAT-Pfad von OpenShack legen. Bei der bevorzugten Belegung der mitgelieferten com0com-Ports wählen Sie in MSHV die Seite für externe Software des TRX-Emulator-/TSEMU-Paares: normalerweise COM24. OpenShack nutzt die passende DL2CC-Seite, normalerweise COM23. Falls das Setup Ersatz-Ports vergeben hat, nehmen Sie die Werte aus virtual-com-ports.txt. Bei einem TCP-Listener verwenden Sie stattdessen die passende localhost-Adresse und den Port aus den Client-Einstellungen von OpenShack.
MSHV Sound Settings mit CABLE Input als Ausgabegerät und CABLE Output als Eingabegerät
MSHV Sound Settings — der Decoder hört auf CABLE Output, während MSHV seine Sendetöne an CABLE Input ausgibt

Die Gerätenamen wirken zuerst vertauscht, sind aber Windows-Audio-Endpunkte: Programme spielen Audio in CABLE Input hinein, andere Programme nehmen dasselbe Audio von CABLE Output auf. Wählen Sie in OpenShack die dazu passenden Audiogeräte, damit Empfangsaudio bei MSHV ankommt und die Sendetöne von MSHV zurück zum Audioeingang der Remote Station gehen. Für reine Empfangs-/Dekodiertests reicht die Eingangsseite in MSHV; zum Senden braucht es zusätzlich die Ausgangsseite und funktionierendes PTT/CAT.

MSHV UDP Broadcast Settings mit Logged QSO ADIF, Server 127.0.0.1 und Port 4575
MSHV UDP Broadcast Settings — Enable Logged QSO ADIF sendet fertige QSOs als ADIF an OpenShack auf 127.0.0.1:4575

Die grüne Statuszeile bestätigt, dass MSHV das lokale UDP-Ziel erreicht. In diesem Beispiel werden Enable Logged QSO und Enable Decoded Text für den WaveLog-Upload über OpenShack nicht benötigt; wichtig ist Enable Logged QSO ADIF.

MSHV Interface Control mit COM23, 115200 Baud, PTT Via CAT COMMAND und Kenwood TS-890S Rig-Auswahl
MSHV Interface Control — CAT/PTT läuft über die ausgewählte lokale Schnittstelle; verwenden Sie die externe Seite aus den Setup-Notizen, normalerweise COM24 für das TRX-Emulator-Paar

Das Feld Port rechts ist die CAT-Schnittstelle, die MSHV öffnet. Mit dem mitgelieferten com0com-Paar öffnet MSHV die externe Seite und OpenShack die DL2CC-Seite. PTT Via CAT COMMAND weist MSHV an, den Sender über CAT zu tasten, statt RTS/DTR-Leitungen umzuschalten. Das Netzwerkfeld links wird in diesem COM-Port-Beispiel nicht gebraucht und darf deshalb getrennt bleiben. Der Screenshot zeigt, wo der Port eingestellt wird; verwenden Sie die tatsächlichen Portnummern aus Ihren Setup-Notizen, falls sie abweichen.

💡 Alle drei Wege einzeln prüfen
Wenn etwas nicht funktioniert: Audio, CAT-Frequenzanzeige, PTT und QSO-Upload getrennt testen. MSHV-Dekodierung bestätigt den VB-CABLE-Empfangsweg, ein kurzer Sendetest bestätigt den VB-CABLE-Ausgangs- und PTT-Weg, Frequenz-/Mode-Polling bestätigt CAT, und ein geloggtes Test-QSO bestätigt den UDP-ADIF-Weg zu OpenShack und WaveLog.

OpenShack aktualisieren

OpenShack prüft bei jedem Start, ob eine neuere Version vorliegt. Ist eine verfügbar, erscheint unten im Haupt-Dashboard ein blauer Hinweisbalken mit dem Text „New version X.Y.Z available (you have A.B.C)“, dazu ein Download-Link und ein Details…-Link, der die Release Notes öffnet. Der Balken ist nur eine Erinnerung — heruntergeladen oder verändert wird nichts, solange Sie sich nicht zum Update entscheiden. Mit dem × rechts blenden Sie ihn aus; beim nächsten Start ist er wieder da, solange das Update noch aussteht.

ℹ️ Update an Ort und Stelle — Ihre Einstellungen bleiben
Wenn Sie eine neue Version über die alte installieren, bleibt alles erhalten: Lizenz, Rufzeichen, Secrets und gespeicherte Stationen, Audiogeräte, Fensterpositionen und sämtliche weiteren Einstellungen. Sie müssen vorher nichts notieren oder exportieren.
  1. Schließen Sie alle OpenShack-Fenster. Beenden Sie auf diesem PC die App, damit während der Installation keine Dateien in Benutzung sind.
  2. Laden Sie das neue Setup von https://dl2cc.de/download herunter — entweder über den Download-Link im Hinweisbalken oder indem Sie die Seite im Browser öffnen.
  3. Deinstallieren Sie die alte Version nicht. Starten Sie einfach das heruntergeladene Setup. Es installiert über die vorhandene Version an Ort und Stelle und übernimmt all Ihre Einstellungen.
  4. Starten Sie OpenShack. Im Dashboard steht jetzt die neue Versionsnummer, und der Hinweisbalken ist weg.
⚠️ Host: Die Windows-Firewall-Abfrage kann nach einem Update wiederkommen
Windows knüpft seine Firewall-Freigabe an die genaue Programmdatei, deshalb kann eine aktualisierte Version wie eine ganz neue App wirken. Auf dem Host sehen Sie beim ersten Verbinden nach dem Update möglicherweise erneut den Windows-Sicherheit-Dialog mit der Frage, ob die App auf öffentliche und private Netzwerke zugreifen darf. Das ist normal — klicken Sie auf Zulassen, damit der Remote-Betrieb weiterläuft. Sie kann nach jeder neuen Version einmal pro PC erscheinen. Siehe Windows-Firewall-Warnung auf der Seite Remote Station.

Die OpenShack Box hat ihre eigene Firmware, die getrennt von der App aktualisiert wird. OpenShack zeigt dafür einen passenden orangefarbenen Balken „Device firmware update available“ im Dashboard, wenn Ihre Box neue Firmware braucht — siehe Firmware-Updates weiter unten.

Firmware-Updates

Die Firmware der OpenShack Box lässt sich direkt im Browser aktualisieren — über den Web-Flasher unter openshack.com/apps/webflash. Box per USB anschließen, Link öffnen, Gerät auswählen, flashen — fertig.

⚠️ OpenShack vor dem Flashen schließen
Der Web-Flasher spricht die Box über deren USB-COM-Port an, und Windows lässt immer nur ein Programm gleichzeitig auf diesen Port zugreifen. Schließen Sie OpenShack vollständig (alle Fenster), bevor Sie den Flash-Vorgang starten — läuft die App noch, hält sie den COM-Port belegt und der Flasher kommt nicht an die Box heran.

Sie müssen nicht selbst nach Firmware-Updates schauen. Solange Ihre Box angeschlossen ist, vergleicht OpenShack beim Start deren Firmware mit der aktuellen Version. Gibt es eine neuere, erscheint unten im Haupt-Dashboard ein orangefarbener Balken „Device firmware update available“ mit einem Update firmware-Link, der gleich den Web-Flasher öffnet. Spielen Sie die Firmware nur dann auf, wenn dieser Balken es anzeigt — sonst ist kein Update nötig.

DL2CC Firmware-Web
              Flasher
Firmware-Web-Flasher unter openshack.com/apps/webflash — Box-Firmware direkt aus dem Browser neu aufspielen

Deinstallation

Um OpenShack zu entfernen, deinstallieren Sie die Anwendung und löschen — für eine vollständige Bereinigung — ihren lokalen Datenordner. Die optionalen Treiber werden separat entfernt (siehe unten); das Deinstallieren von OpenShack entfernt sie nicht.

Anwendung entfernen

  1. OpenShack schließen.
  2. Windows-Einstellungen → Apps → Installierte Apps öffnen.
  3. OpenShack suchen, auf ⋯ → Deinstallieren klicken und den Anweisungen folgen.

Lokalen Datenordner entfernen (optional)

Die Deinstallation der Anwendung lässt Ihre Einstellungen, gespeicherten Remote-Stationen, Fensterlayouts, Protokolle und Setup-Marker im lokalen Datenordner zurück. Um diese ebenfalls zu entfernen, löschen Sie:

%LOCALAPPDATA%\DL2CC-STUDIO

Fügen Sie den Pfad in die Adressleiste des Windows-Explorers ein (oder drücken Sie Win+R, tippen ihn ein und drücken Enter) und löschen Sie dann den Ordner OpenShack. Siehe Lokalen Datenordner finden für Details.

⚠️ Dies löscht Ihre Konfiguration
Das Löschen des Ordners entfernt Ihre gespeicherten Einstellungen und gemerkten Remote-Stationen. Behalten Sie ihn, wenn Sie neu installieren und Ihre Konfiguration zurückhaben möchten.

Optionale Treiber entfernen

Diese Treiber sind optional und möglicherweise nicht auf Ihrem PC installiert. Sie entfernen sie separat — nicht durch das Deinstallieren von OpenShack. Siehe auch Mitgelieferte virtuelle Audio- und COM-Ports weiter oben.

Silicon Labs CP210x / CP2102 Treiber

Verwenden Sie den Windows-Geräte-Manager:

  1. Geräte-Manager öffnen.
  2. Das Silicon-Labs-CP210x-Gerät unter Anschlüsse (COM & LPT) oder USB-Controller suchen.
  3. Rechtsklick → Gerät deinstallieren.
  4. Bietet Windows Die Treibersoftware für dieses Gerät löschen an, wählen Sie das nur, wenn der Treiber nicht für andere CP210x-Geräte benötigt wird.

VB-Audio VB-CABLE

Verwenden Sie erneut das VB-Audio-Setup-Tool:

  1. VBCABLE_Setup_x64.exe als Administrator ausführen.
  2. Die Option zum Deinstallieren / Entfernen wählen.
  3. Danach Windows neu starten.

Die Readme von VB-Audio weist darauf hin, dass auch nach der Deinstallation ein Neustart erforderlich ist — ebenso wie nach der Installation.

com0com (virtuelle COM-Ports)

Verwenden Sie die Windows-Apps oder den com0com-Uninstaller aus dem Startmenü:

  1. Windows-Einstellungen → Apps → Installierte Apps öffnen.
  2. Null-modem emulator (com0com) entfernen (oder die com0com-Verknüpfung Uninstall im Startmenü ausführen).
⚠️ Das Entfernen von com0com löscht die virtuellen COM-Paare
Das Entfernen von com0com entfernt auch seine virtuellen COM-Paare, sodass die OpenShack-Zuordnungen (COM21/22, COM23/24, COM25/26 oder etwaige Ersatz-Paare) verschwinden. Die Datei %LOCALAPPDATA%\DL2CC-STUDIO\Setup\VirtualComPorts.json bleibt möglicherweise als veraltete Diagnosedatei zurück, aber die Erkennung des Installers prüft, ob die Ports noch existieren, sodass eine spätere Neuinstallation sie bei Bedarf neu anlegt.
🛠️ Hinweis für Support
com0com unterstützt auch eine stille Deinstallation über die installierte uninstall.exe /S. Das ist für Administratoren / Support gedacht, nicht für den normalen Gebrauch.
OpenShack