microHAM U3 (PTT + TX Audio)

Diese Anleitung beschreibt Betrieb, Einstellung und Basis-Kalibrierung der microHAM-Anbindung ueber das Plugin rms.microham.

Quick Start

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

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

Erst sichere pttUp/pttDown Kommandos setzen.
MICROHAM_PTT_COMMANDS_ENABLED=true aktivieren.
Falls Band-/Mode-konsistentes PTT gewuenscht: MICROHAM_PTT_APPLY_BAND_STATE=true.
Bei Instabilitaet MICROHAM_PTT_TIMEOUT_MS moderat erhoehen (nicht exzessiv).

Audio

MICROHAM_AUDIO_ALSA_DEVICE mit arecord -l auf reales Capture-Device setzen.
MICROHAM_AUDIO_INPUT_MIME auf den Client abstimmen (webm oder ogg).
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.

2.8 KiB Raw Blame History