85 lines
2.8 KiB
Markdown
85 lines
2.8 KiB
Markdown
# microHAM U3 (PTT + TX Audio)
|
|
|
|
Diese Anleitung beschreibt Betrieb, Einstellung und Basis-Kalibrierung der microHAM-Anbindung ueber das Plugin `rms.microham`.
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
ls -l /dev/rms-microham-u3
|
|
arecord -l
|
|
ffmpeg -version
|
|
|
|
grep -E '^(MICROHAM_DEVICE|MICROHAM_PTT_COMMANDS_ENABLED|MICROHAM_AUDIO_ALSA_DEVICE|MICROHAM_AUDIO_INPUT_MIME)=' /etc/remotestation-arcg/remotestation-arcg.env
|
|
sudo systemctl restart remotestation-arcg
|
|
curl -sS -H "Authorization: Bearer <token>" http://127.0.0.1:8080/v1/openwebrx/tx/status
|
|
```
|
|
|
|
## 1) Hardware und Voraussetzungen
|
|
|
|
- Device: typischerweise `/dev/rms-microham-u3`
|
|
- Audio-Backend: `ffmpeg` + gueltiges ALSA Capture-Device (`MICROHAM_AUDIO_ALSA_DEVICE`)
|
|
- Optional fuer Batch-PTT-Down mit Frequenz/Mode: `rigctl`
|
|
|
|
## 2) Relevante ENV-Keys
|
|
|
|
```env
|
|
MICROHAM_DEVICE=/dev/rms-microham-u3
|
|
|
|
MICROHAM_PTT_COMMANDS_ENABLED=true
|
|
MICROHAM_PTT_DOWN_CMD=
|
|
MICROHAM_PTT_UP_CMD=
|
|
MICROHAM_PTT_TIMEOUT_MS=5000
|
|
|
|
MICROHAM_PTT_APPLY_BAND_STATE=true
|
|
MICROHAM_PTT_RIGCTL_MODEL=3023
|
|
MICROHAM_PTT_RIGCTL_BAUD=19200
|
|
MICROHAM_PTT_RIGCTL_SETCONF=rts_state=OFF,dtr_state=OFF
|
|
|
|
MICROHAM_AUDIO_ENABLED=true
|
|
MICROHAM_AUDIO_ALSA_DEVICE=plughw:CARD=CODEC,DEV=0
|
|
MICROHAM_AUDIO_INPUT_MIME=webm
|
|
MICROHAM_AUDIO_CHUNK_MS=100
|
|
MICROHAM_AUDIO_STOP_ON_DISCONNECT=true
|
|
MICROHAM_AUDIO_SESSION_TIMEOUT_MS=120000
|
|
MICROHAM_AUDIO_FFMPEG_PATH=/usr/bin/ffmpeg
|
|
MICROHAM_AUDIO_FFMPEG_EXTRA_ARGS=
|
|
```
|
|
|
|
## 3) Bedienung (Runtime)
|
|
|
|
- PTT down: `POST /v1/openwebrx/ptt/down`
|
|
- PTT up: `POST /v1/openwebrx/ptt/up`
|
|
- TX Status inkl. PTT-Konfiguration: `GET /v1/openwebrx/tx/status`
|
|
- Audio-WS (Plugin-Pfad): `/v1/openwebrx/plugin/audio/ws`
|
|
|
|
Hinweis: PTT und TX-Power sind getrennt. TX-Power kommt aus `tx.control`, PTT aus `rms.microham`.
|
|
|
|
## 4) Einstellen und Kalibrieren
|
|
|
|
### PTT
|
|
|
|
1. Erst sichere `pttUp`/`pttDown` Kommandos setzen.
|
|
2. `MICROHAM_PTT_COMMANDS_ENABLED=true` aktivieren.
|
|
3. Falls Band-/Mode-konsistentes PTT gewuenscht: `MICROHAM_PTT_APPLY_BAND_STATE=true`.
|
|
4. Bei Instabilitaet `MICROHAM_PTT_TIMEOUT_MS` moderat erhoehen (nicht exzessiv).
|
|
|
|
### Audio
|
|
|
|
1. `MICROHAM_AUDIO_ALSA_DEVICE` mit `arecord -l` auf reales Capture-Device setzen.
|
|
2. `MICROHAM_AUDIO_INPUT_MIME` auf den Client abstimmen (`webm` oder `ogg`).
|
|
3. Bei Dropouts/Artefakten:
|
|
- `MICROHAM_AUDIO_CHUNK_MS` leicht erhoehen (z. B. 100 -> 120/140)
|
|
- zusaetzliche ffmpeg-Args nur kontrolliert setzen.
|
|
|
|
## 5) Typische Fehlerbilder
|
|
|
|
- `MICROHAM_PTT_COMMANDS_ENABLED must be true`: PTT nicht aktiviert.
|
|
- `MICROHAM_PTT_DOWN_CMD missing`/`UP_CMD missing`: Kommandos fehlen (wenn kein Batch-Pfad genutzt).
|
|
- `invalid microham device path`: ungueltiger Device-String.
|
|
- Audio startet nicht: `ffmpeg` fehlt oder ALSA-Device falsch.
|
|
|
|
## 6) Sicherheitsregeln
|
|
|
|
- Immer zuerst PTT-up/Fail-safe testen, dann PTT-down.
|
|
- Keine Live-Credentials oder host-spezifische sensible Werte in dieses Repo schreiben.
|