Files
ARCG-Remote-Station-Software/docs/hardware-rfroute-guide.md

1.8 KiB

RF Route Hardware (Relais / Antennenpfad)

Diese Anleitung beschreibt die RF-Route-Steuerung ueber rms.rfroute.shell.

Quick Start

grep -E '^(RFROUTE_CMD_TX|RFROUTE_CMD_RX|RFROUTE_CMD_DRAHT|RFROUTE_CMD_BEAM|RFROUTE_CMD_WRTC|RFROUTE_TIMEOUT_MS)=' /etc/remotestation-arcg/remotestation-arcg.env
sudo systemctl restart remotestation-arcg

1) Unterstuetzte Routen

Das Plugin kennt diese Route-Keys:

  • tx, rx
  • on, off
  • draht, beam, wrtc

Je Route wird ein Shell-Kommando aus ENV ausgefuehrt.

2) Relevante ENV-Keys

RFROUTE_CMD_TX=
RFROUTE_CMD_RX=
RFROUTE_CMD_ON=
RFROUTE_CMD_OFF=
RFROUTE_CMD_DRAHT=
RFROUTE_CMD_BEAM=
RFROUTE_CMD_WRTC=
RFROUTE_TIMEOUT_MS=15000
RFROUTE_DEFAULT=rx

3) Bedienung

Die Route wird serverseitig ueber Capability rfroute.set gesetzt. In der UI erscheinen die Optionen als Schaltergruppe.

Wichtig im Betrieb:

  • Umschalten ist bei aktivem TX serverseitig gesperrt (TX-Safety).
  • Im OpenWebRX-Flow werden Route-Folgen und Fail-Safe-Wechsel (z. B. auf rx) zusaetzlich serverseitig erzwungen.

4) Einstellen / Kalibrieren

  1. Jede Route einzeln auf Shell-Ebene verifizieren.
  2. Sicherstellen, dass rx ein echter Empfangspfad ist.
  3. Sicherstellen, dass tx nur im gewuenschten TX-Pfad landet.
  4. Bei Multi-Antennen (draht/beam/wrtc) klare Mapping-Tabelle pflegen.
  5. Timeouts nur bei echten Geraetelatenzen erhoehen.

5) Fehlerbilder

  • RFROUTE_CMD_<ROUTE> fehlt: Kommando fuer angeforderte Route fehlt.
  • rfroute command failed: Shell-Kommando liefert Fehlercode/Stderr.
  • Route schaltet, aber Wirkung falsch: Relais-Mapping (Hardwareverdrahtung) pruefen.

6) Sicherheitsregeln

  • Keine Schaltkommandos committen, die sensible Host-/Credential-Daten enthalten.
  • TX/RX-Safety-Pfade regelmaessig mit realer Hardware pruefen.