ARCG-Remote-Station-Software/docs/hardware-station-shell-guide.md

Station Hardware via Shell Scripts

Diese Anleitung beschreibt die stationseitige Hardware-Orchestrierung ueber rms.station.shell.

Das Plugin selbst steuert keine einzelne Komponente direkt, sondern ruft Aktivierungs-/Deaktivierungs-Skripte auf, die typischerweise Relais, Netzteile, TRX und Nebenkomponenten schalten.

Quick Start

grep -E '^(SCRIPT_ROOT|SCRIPT_ACTIVATE|SCRIPT_DEACTIVATE|STATION_SCRIPT_TIMEOUT_MS)=' /etc/remotestation-arcg/remotestation-arcg.env
sudo systemctl restart remotestation-arcg

1) Relevante ENV-Keys

SCRIPT_ROOT=/opt/remotestation
SCRIPT_ACTIVATE=/opt/remotestation/bin/activate.sh
SCRIPT_DEACTIVATE=/opt/remotestation/bin/deactivate.sh
STATION_SCRIPT_TIMEOUT_MS=180000

2) Verhalten

• station.activate ruft SCRIPT_ACTIVATE auf.
• station.deactivate ruft SCRIPT_DEACTIVATE auf.
• Falls Standardskript fehlt, versucht das Plugin Runtime-Fallbacks unter SCRIPT_ROOT/src/....
• Wenn kein Skript konfiguriert ist, wird Aktion als skipped behandelt.

3) Einstellen

1. Skripte separat shellseitig testen.
2. SCRIPT_ROOT so setzen, dass Fallback-Pfade konsistent sind.
3. Timeouts an reale Schaltzeiten anpassen.
4. In Skripten idempotent arbeiten (mehrfaches Ausfuehren darf nicht zerstoeren).

4) Fehlerbilder

• ${KEY} failed: Skriptfehler (Exit != 0 / stderr).
• Standardskript fehlt: Plugin meldet Skip/Fallback.
• Timeout: STATION_SCRIPT_TIMEOUT_MS zu niedrig oder Skript haengt.

5) Sicherheitsregeln

• Skripte muessen TX/PTT-Fail-safe beachten.
• Keine produktiven Zugangsdaten in Skripten oder Repo ablegen.