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

63 lines
2.1 KiB
Markdown

# TX Power Control Hardware
Diese Anleitung beschreibt die TX-Power-Steuerung ueber `rms.tx.control.native`.
## Quick Start
```bash
grep -E '^(TX_ENABLE_CMD|TX_DISABLE_CMD|TX_STATUS_CMD|TX_CONTROL_TIMEOUT_MS|TX_STATE_PATH)=' /etc/remotestation-arcg/remotestation-arcg.env
sudo systemctl restart remotestation-arcg
curl -sS -H "Authorization: Bearer <token>" -X POST http://127.0.0.1:8080/v1/openwebrx/tx/enable
curl -sS -H "Authorization: Bearer <token>" http://127.0.0.1:8080/v1/openwebrx/tx/status
curl -sS -H "Authorization: Bearer <token>" -X POST http://127.0.0.1:8080/v1/openwebrx/tx/disable
```
## 1) Funktionsprinzip
- `enableTx` fuehrt `TX_ENABLE_CMD` aus.
- `disableTx` fuehrt `TX_DISABLE_CMD` aus.
- `getTxState` nutzt bevorzugt `TX_STATUS_CMD`; Fallback ist `TX_STATE_PATH` (JSON).
Default-Kommandos (wenn nicht ueberschrieben):
- `/opt/remotestation/bin/tx-control.sh enable`
- `/opt/remotestation/bin/tx-control.sh disable`
- `/opt/remotestation/bin/tx-control.sh status`
## 2) Relevante ENV-Keys
```env
TX_ENABLE_CMD=
TX_DISABLE_CMD=
TX_STATUS_CMD=
TX_CONTROL_TIMEOUT_MS=20000
TX_STATE_PATH=/opt/remotestation-arcg/shared/data/tx-state.json
```
## 3) Bedienung
- API:
- `POST /v1/openwebrx/tx/enable`
- `POST /v1/openwebrx/tx/disable`
- `GET /v1/openwebrx/tx/status`
Hinweis: TX-Power ist getrennt von PTT. PTT wird ueber `rms.microham` verwaltet.
## 4) Einstellen und Kalibrieren
1. Enable/Disable-Kommandos zuerst auf Shell-Ebene pruefen.
2. `TX_STATUS_CMD` auf klaren Rueckgabewert trimmen (`on/off`, `1/0`, `true/false`).
3. Wenn Statuskommando nicht stabil ist, JSON-Fallback (`TX_STATE_PATH`) bewusst nutzen.
4. Zeitlimit `TX_CONTROL_TIMEOUT_MS` nur bei echter Hardwarelatenz anpassen.
## 5) Fehlerbilder
- `TX enable command missing` / `TX disable command missing`: ENV fehlt.
- `TX enable failed` / `TX disable failed`: Kommando liefert Fehler.
- Status falsch trotz Schalten: `TX_STATUS_CMD` und Zustandsquelle pruefen.
## 6) Sicherheitsregeln
- Verwende fail-safe Standard: bei Unsicherheit TX auf OFF.
- Keine produktiven Schalt-Backends oder Zugangsdaten ins Repo committen.