Files
ARCG-Remote-Station-Software/docs/plugins/rms-wavelog-cat.md
ARCG Admin (Claude) 061045999b fix(wavelog): push live tuned frequency, not just band center
The CAT push only fired on band select (band center). Fine-tuning inside
OpenWebRX did not update Wavelog. Hook the per-operator live-state updates
(/v1/openwebrx/plugin/live-state) so the actual tuned frequency/mode is
pushed, trailing-debounced (WAVELOG_MIN_INTERVAL_MS, default 3000 ms) so
tuning does not flood the Wavelog API. Band-select push kept as immediate
feedback on band change.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-10-22 21:16:17 +02:00

1.5 KiB
Raw Blame History

rms.wavelog.cat

  • Zweck: Aktuelle Stationsfrequenz/-mode an ein Wavelog-Logbuch melden (CAT Radio API). Pushed POST <baseUrl>/index.php/api/radio mit dem per-Operator Wavelog-API-Key, sodass die Frequenz im persoenlichen Wavelog-Konto des aktiven Operators landet (cat.user_id = Key-Besitzer).
  • Capabilities: logging.cat.publish.
  • Aktionen: publish mit Input { frequencyHz, mode, apiKey, baseUrl?, radioName? }.
  • Wichtige Settings/ENV:
    • baseUrl / WAVELOG_BASE_URL – URL der Wavelog-Instanz (ohne Slash am Ende). Leer = deaktiviert.
    • radioName / WAVELOG_RADIO_NAME – Anzeigename in Wavelog (Default RMS Remote).
    • timeoutMs / WAVELOG_TIMEOUT_MS – HTTP-Timeout (Default 8000).
  • Ausloeser:
    • Bandwechsel (/v1/openwebrx/bands/select): sofortiger Push der Band-Mittenfrequenz (centerFreqHz + startMod).
    • Live-Tuning in OpenWebRX (/v1/openwebrx/plugin/live-state): Push der tatsaechlich getunten Frequenz/Mode des aktiven Operators, gedrosselt (Trailing-Debounce, WAVELOG_MIN_INTERVAL_MS, Default 3000 ms) damit Feintunen die API nicht flutet.
    • Beides best-effort: Fehler brechen den jeweiligen Flow nie ab.
  • Key-Ablage: pro Benutzer in users.json (wavelogApiKey), setzbar via PUT /v1/me/wavelog-key und sichtbar im OpenWebRX-Panel. Kein Key im Repo – der Key ist Laufzeit-/Benutzerdatum.
  • Mode-Mapping: usb|lsb|ssb → SSB, cw|cwr → CW, fm|nfm|wfm → FM, am|sam → AM, sonst Rohwert in Grossbuchstaben (Wavelog mappt gaengige Rig-Aliase selbst).