061045999b
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>
23 lines
1.5 KiB
Markdown
23 lines
1.5 KiB
Markdown
# 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).
|