[feat](trx-rs): add FT4 decoder support

Reuse the existing ft8_lib C library (FTX_PROTOCOL_FT4) and FT8 decoder infrastructure to add FT4 decoding across the full stack. Changes: - trx-ft8: add protocol param to ft8_decoder_create; add Ft8Decoder::new_ft4() - trx-core: DecodedMessage::Ft4 variant, AUDIO_MSG_FT4_DECODE (0x14), ft4_decode_enabled/ft4_decode_reset_seq state, SetFt4DecodeEnabled/ ResetFt4Decoder commands, protocol mapping - trx-server: DecoderHistories::ft4, run_ft4_decoder (7.5s slots via now*2/15), run_background_ft4_decoder, history push/replay, decoder task spawn - trx-frontend-http: ft4_history in FrontendRuntimeContext, toggle/clear endpoints, /ft4.js route, bookmark/scheduler/background decode support, DecodeHistoryPayload ft4 field - web: ft4.js plugin (7.5s period timer, reuses FT8 CSS/map infra), FT4 subtab in index.html, app.js dispatch (onServerFt4/Batch, restoreFt4History), decode-history-worker HISTORY_GROUP_KEYS Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Signed-off-by: Stanislaw Grams <stanislawgrams@gmail.com>
2026-03-14 18:50:08 +01:00
parent a1b9b7f762
commit 8eae376c56
25 changed files with 676 additions and 15 deletions
@@ -214,11 +214,13 @@ function applyAuthRestrictions() {
      "ais-clear-btn",
      "vdes-clear-btn",
      "ft8-decode-toggle-btn",
+      "ft4-decode-toggle-btn",
      "wspr-decode-toggle-btn",
      "hf-aprs-decode-toggle-btn",
      "cw-auto",
      "aprs-clear-btn",
      "ft8-clear-btn",
+      "ft4-clear-btn",
      "wspr-clear-btn",
      "cw-clear-btn"
    ];
@@ -2847,6 +2849,13 @@ function render(update) {
    ft8ToggleBtn.style.borderColor = ft8On ? "#00d17f" : "";
    ft8ToggleBtn.style.color = ft8On ? "#00d17f" : "";
  }
+  const ft4ToggleBtn = document.getElementById("ft4-decode-toggle-btn");
+  if (ft4ToggleBtn) {
+    const ft4On = !!update.ft4_decode_enabled;
+    ft4ToggleBtn.textContent = ft4On ? "Disable FT4" : "Enable FT4";
+    ft4ToggleBtn.style.borderColor = ft4On ? "#00d17f" : "";
+    ft4ToggleBtn.style.color = ft4On ? "#00d17f" : "";
+  }
  const wsprToggleBtn = document.getElementById("wspr-decode-toggle-btn");
  if (wsprToggleBtn) {
    const wsprOn = !!update.wspr_decode_enabled;
@@ -7312,6 +7321,7 @@ function updateDecodeStatus(text) {
  const aprs = document.getElementById("aprs-status");
  const cw = document.getElementById("cw-status");
  const ft8 = document.getElementById("ft8-status");
+  const ft4 = document.getElementById("ft4-status");
  setModeBoundDecodeStatus(ais, ["AIS"], "Select AIS mode to decode", text);
  const vdesText = text === "Connected, listening for packets" ? "Connected, listening for bursts" : text;
  setModeBoundDecodeStatus(vdes, ["VDES"], "Select VDES mode to decode", vdesText);
@@ -7319,6 +7329,7 @@ function updateDecodeStatus(text) {
  const cwText = text === "Connected, listening for packets" ? "Connected, listening for CW" : text;
  setModeBoundDecodeStatus(cw, ["CW", "CWR"], "Select CW mode to decode", cwText);
  if (ft8 && ft8.textContent !== "Receiving") ft8.textContent = text;
+  if (ft4 && ft4.textContent !== "Receiving") ft4.textContent = text;
 }
 function dispatchDecodeMessage(msg) {
  if (msg.type === "ais" && window.onServerAis) window.onServerAis(msg);
@@ -7327,6 +7338,7 @@ function dispatchDecodeMessage(msg) {
  if (msg.type === "hf_aprs" && window.onServerHfAprs) window.onServerHfAprs(msg);
  if (msg.type === "cw" && window.onServerCw) window.onServerCw(msg);
  if (msg.type === "ft8" && window.onServerFt8) window.onServerFt8(msg);
+  if (msg.type === "ft4" && window.onServerFt4) window.onServerFt4(msg);
  if (msg.type === "wspr" && window.onServerWspr) window.onServerWspr(msg);
 }

@@ -7355,6 +7367,10 @@ function dispatchDecodeBatch(batch) {
      window.onServerFt8Batch(batch);
      return;
    }
+    if (type === "ft4" && window.onServerFt4Batch) {
+      window.onServerFt4Batch(batch);
+      return;
+    }
    if (type === "wspr" && window.onServerWsprBatch) {
      window.onServerWsprBatch(batch);
      return;
@@ -7425,6 +7441,10 @@ function restoreDecodeHistoryGroup(kind, messages) {
    window.restoreFt8History(messages);
    return;
  }
+  if (kind === "ft4" && window.restoreFt4History) {
+    window.restoreFt4History(messages);
+    return;
+  }
  if (kind === "wspr" && window.restoreWsprHistory) {
    window.restoreWsprHistory(messages);
    return;
@@ -7441,6 +7461,7 @@ function connectDecode() {
  if (window.resetAprsHistoryView) window.resetAprsHistoryView();
  if (window.resetCwHistoryView) window.resetCwHistoryView();
  if (window.resetFt8HistoryView) window.resetFt8HistoryView();
+  if (window.resetFt4HistoryView) window.resetFt4HistoryView();
  if (window.resetWsprHistoryView) window.resetWsprHistoryView();

  // Buffer live messages until history fetch settles so history always appears
@@ -7512,7 +7533,7 @@ function connectDecode() {

  function totalDecodeHistoryMessages(groups) {
    if (!groups || typeof groups !== "object") return 0;
-    return ["ais", "vdes", "aprs", "hf_aprs", "cw", "ft8", "wspr"]
+    return ["ais", "vdes", "aprs", "hf_aprs", "cw", "ft8", "ft4", "wspr"]
      .reduce((sum, key) => sum + (Array.isArray(groups[key]) ? groups[key].length : 0), 0);
  }

@@ -7523,7 +7544,7 @@ function connectDecode() {
      setDecodeHistoryReplayActive(true);
      updateHistoryReplayOverlay();
    }
-    for (const kind of ["ais", "vdes", "aprs", "hf_aprs", "cw", "ft8", "wspr"]) {
+    for (const kind of ["ais", "vdes", "aprs", "hf_aprs", "cw", "ft8", "ft4", "wspr"]) {
      const messages = groups && Array.isArray(groups[kind]) ? groups[kind] : [];
      if (messages.length === 0) continue;
      for (let index = 0; index < messages.length; index += DECODE_HISTORY_WORKER_GROUP_LIMIT) {
@@ -1,5 +1,5 @@
 const textDecoder = typeof TextDecoder === "function" ? new TextDecoder() : null;
-const HISTORY_GROUP_KEYS = ["ais", "vdes", "aprs", "hf_aprs", "cw", "ft8", "wspr"];
+const HISTORY_GROUP_KEYS = ["ais", "vdes", "aprs", "hf_aprs", "cw", "ft8", "ft4", "wspr"];

 function decodeCborUint(view, bytes, state, additional) {
  const offset = state.offset;
@@ -374,6 +374,7 @@
                <label class="bm-decoder-check"><input type="checkbox" id="bm-dec-aprs" value="aprs" /> APRS</label>
                <label class="bm-decoder-check"><input type="checkbox" id="bm-dec-ais" value="ais" /> AIS</label>
                <label class="bm-decoder-check"><input type="checkbox" id="bm-dec-ft8" value="ft8" /> FT8</label>
+                <label class="bm-decoder-check"><input type="checkbox" id="bm-dec-ft4" value="ft4" /> FT4</label>
                <label class="bm-decoder-check"><input type="checkbox" id="bm-dec-wspr" value="wspr" /> WSPR</label>
                <label class="bm-decoder-check"><input type="checkbox" id="bm-dec-hf-aprs" value="hf-aprs" /> HF APRS</label>
              </div>
@@ -425,6 +426,7 @@
        <button class="sub-tab" data-subtab="hf-aprs">HF APRS</button>
        <button class="sub-tab" data-subtab="cw">CW</button>
        <button class="sub-tab" data-subtab="ft8">FT8</button>
+        <button class="sub-tab" data-subtab="ft4">FT4</button>
        <button class="sub-tab" data-subtab="wspr">WSPR</button>
        <button class="sub-tab" data-subtab="rds">RDS</button>
      </div>
@@ -634,6 +636,24 @@
        </div>
        <div id="ft8-messages"></div>
      </div>
+      <div id="subtab-ft4" class="sub-tab-panel" style="display:none;">
+        <div class="ft8-controls">
+          <button id="ft4-decode-toggle-btn" type="button">Enable FT4</button>
+          <button id="ft4-pause-btn" type="button">Pause</button>
+          <button id="ft4-clear-btn" type="button">Clear</button>
+          <input id="ft4-filter" class="ft8-filter" type="text" placeholder="Filter (e.g. CQ, DL4)" />
+          <small id="ft4-status" style="color:var(--text-muted);">Waiting for server decode</small>
+          <small id="ft4-period" style="color:var(--text-muted);">Next slot --s</small>
+        </div>
+        <div class="ft8-header">
+          <span class="ft8-time">Time</span>
+          <span class="ft8-snr">SNR</span>
+          <span class="ft8-dt">DT</span>
+          <span class="ft8-freq">RF</span>
+          <span class="ft8-msg">Message</span>
+        </div>
+        <div id="ft4-messages"></div>
+      </div>
      <div id="subtab-wspr" class="sub-tab-panel" style="display:none;">
        <div class="ft8-controls">
          <button id="wspr-decode-toggle-btn" type="button">Enable WSPR</button>
@@ -910,6 +930,7 @@
  <script src="/aprs.js"></script>
  <script src="/hf-aprs.js"></script>
  <script src="/ft8.js"></script>
+  <script src="/ft4.js"></script>
  <script src="/wspr.js"></script>
  <script src="/cw.js"></script>
  <script src="/bookmarks.js"></script>
@@ -0,0 +1,191 @@
+// --- FT4 Decoder Plugin (server-side decode) ---
+// SPDX-FileCopyrightText: 2026 Stanislaw Grams <stanislawgrams@gmail.com>
+// SPDX-License-Identifier: BSD-2-Clause
+
+function ft8RenderMessage(message) {
+  if (typeof renderFt8Message === "function") return renderFt8Message(message);
+  if (typeof ft8EscapeHtml === "function") return ft8EscapeHtml(message);
+  return message;
+}
+
+const ft4Status = document.getElementById("ft4-status");
+const ft4PeriodEl = document.getElementById("ft4-period");
+const ft4MessagesEl = document.getElementById("ft4-messages");
+const ft4FilterInput = document.getElementById("ft4-filter");
+const ft4PauseBtn = document.getElementById("ft4-pause-btn");
+const FT4_PERIOD_MS = 7500;
+let ft4FilterText = "";
+let ft4MessageHistory = [];
+let ft4Paused = false;
+let ft4BufferedWhilePaused = 0;
+
+function currentFt4HistoryRetentionMs() {
+  return typeof window.getDecodeHistoryRetentionMs === "function"
+    ? window.getDecodeHistoryRetentionMs()
+    : 24 * 60 * 60 * 1000;
+}
+
+function pruneFt4MessageHistory() {
+  const cutoffMs = Date.now() - currentFt4HistoryRetentionMs();
+  ft4MessageHistory = ft4MessageHistory.filter((msg) => Number(msg?._tsMs ?? msg?.ts_ms) >= cutoffMs);
+}
+
+function scheduleFt4Ui(key, job) {
+  if (typeof window.trxScheduleUiFrameJob === "function") {
+    window.trxScheduleUiFrameJob(key, job);
+    return;
+  }
+  job();
+}
+
+function scheduleFt4HistoryRender() { scheduleFt4Ui("ft4-history", () => renderFt4History()); }
+
+function normalizeFt4DisplayFreqHz(freqHz) {
+  const rawHz = Number(freqHz);
+  if (!Number.isFinite(rawHz)) return null;
+  const baseHz = Number.isFinite(window.ft8BaseHz) ? Number(window.ft8BaseHz) : null;
+  if (Number.isFinite(baseHz) && baseHz > 0 && rawHz >= 0 && rawHz < 100000) {
+    return baseHz + rawHz;
+  }
+  return rawHz;
+}
+
+function updateFt4PeriodTimer() {
+  if (!ft4PeriodEl) return;
+  const nowMs = Date.now();
+  const remaining = (FT4_PERIOD_MS - nowMs % FT4_PERIOD_MS) / 1000;
+  ft4PeriodEl.textContent = `Next slot ${remaining.toFixed(1)}s`;
+}
+
+updateFt4PeriodTimer();
+setInterval(updateFt4PeriodTimer, 250);
+
+function renderFt4Row(msg) {
+  const row = document.createElement("div");
+  row.className = "ft8-row";
+  const rawMessage = (msg.message || "").toString();
+  row.dataset.message = rawMessage.toUpperCase();
+  row.dataset.decoder = "ft4";
+  row.dataset.storedFreqHz = Number.isFinite(msg.freq_hz) ? String(msg.freq_hz) : "";
+  const snr = Number.isFinite(msg.snr_db) ? msg.snr_db.toFixed(1) : "--";
+  const dt = Number.isFinite(msg.dt_s) ? msg.dt_s.toFixed(2) : "--";
+  const displayFreqHz = normalizeFt4DisplayFreqHz(msg.freq_hz);
+  const freq = Number.isFinite(displayFreqHz) ? displayFreqHz.toFixed(0) : "--";
+  const renderedMessage = ft8RenderMessage(rawMessage);
+  const tsMs = msg._tsMs ?? msg.ts_ms;
+  const timeStr = tsMs ? new Date(tsMs).toLocaleTimeString([], { hour: "2-digit", minute: "2-digit", second: "2-digit" }) : "--:--:--";
+  row.innerHTML = `<span class="ft8-time">${timeStr}</span><span class="ft8-snr">${snr}</span><span class="ft8-dt">${dt}</span><span class="ft8-freq">${freq}</span><span class="ft8-msg">${renderedMessage}</span>`;
+  return row;
+}
+
+function updateFt4PauseUi() {
+  if (!ft4PauseBtn) return;
+  ft4PauseBtn.textContent = ft4Paused ? "Resume" : "Pause";
+  ft4PauseBtn.classList.toggle("active", ft4Paused);
+}
+
+function renderFt4History() {
+  pruneFt4MessageHistory();
+  if (!ft4MessagesEl || ft4Paused) { updateFt4PauseUi(); return; }
+  const filter = ft4FilterText;
+  const fragment = document.createDocumentFragment();
+  for (let i = 0; i < ft4MessageHistory.length; i++) {
+    const msg = ft4MessageHistory[i];
+    if (filter && !(msg.message || "").toString().toUpperCase().includes(filter)) continue;
+    fragment.appendChild(renderFt4Row(msg));
+  }
+  ft4MessagesEl.replaceChildren(fragment);
+  updateFt4PauseUi();
+}
+
+function addFt4Message(msg) {
+  msg._tsMs = Number.isFinite(msg?.ts_ms) ? Number(msg.ts_ms) : Date.now();
+  ft4MessageHistory.unshift(msg);
+  pruneFt4MessageHistory();
+  if (ft4Paused) { ft4BufferedWhilePaused += 1; updateFt4PauseUi(); return; }
+  scheduleFt4HistoryRender();
+}
+
+function normalizeServerFt4Message(msg) {
+  const raw = (msg.message || "").toString();
+  const locatorDetails = typeof ft8ExtractLocatorDetails === "function" ? ft8ExtractLocatorDetails(raw) : [];
+  const grids = locatorDetails.length > 0
+    ? locatorDetails.map((d) => d.grid)
+    : (typeof ft8ExtractAllGrids === "function" ? ft8ExtractAllGrids(raw) : []);
+  const station = typeof ft8ExtractLikelyCallsign === "function" ? ft8ExtractLikelyCallsign(raw) : null;
+  const rfHz = normalizeFt4DisplayFreqHz(msg.freq_hz);
+  return {
+    raw, grids, station, rfHz, locatorDetails,
+    history: {
+      receiver: window.getDecodeRigMeta ? window.getDecodeRigMeta() : null,
+      ts_ms: msg.ts_ms, snr_db: msg.snr_db, dt_s: msg.dt_s,
+      freq_hz: Number.isFinite(rfHz) ? rfHz : msg.freq_hz,
+      message: msg.message,
+    },
+  };
+}
+
+window.onServerFt4Batch = function(messages) {
+  if (!Array.isArray(messages) || messages.length === 0) return;
+  if (ft4Status) ft4Status.textContent = ft4Paused ? "Paused" : "Receiving";
+  const normalized = [];
+  for (const msg of messages) {
+    const next = normalizeServerFt4Message(msg);
+    if (next.grids.length > 0 && window.ft8MapAddLocator) {
+      window.ft8MapAddLocator(next.raw, next.grids, "ft8", next.station, { ...msg, freq_hz: next.rfHz, locator_details: next.locatorDetails });
+    }
+    next.history._tsMs = Number.isFinite(next.history?.ts_ms) ? Number(next.history.ts_ms) : Date.now();
+    normalized.push(next.history);
+  }
+  normalized.reverse();
+  ft4MessageHistory = normalized.concat(ft4MessageHistory);
+  pruneFt4MessageHistory();
+  if (ft4Paused) { ft4BufferedWhilePaused += messages.length; updateFt4PauseUi(); return; }
+  scheduleFt4HistoryRender();
+};
+
+window.restoreFt4History = function(messages) { window.onServerFt4Batch(messages); };
+window.pruneFt4HistoryView = function() { pruneFt4MessageHistory(); renderFt4History(); };
+
+window.resetFt4HistoryView = function() {
+  if (ft4MessagesEl) ft4MessagesEl.innerHTML = "";
+  ft4MessageHistory = [];
+  ft4BufferedWhilePaused = 0;
+  renderFt4History();
+};
+
+if (ft4FilterInput) {
+  ft4FilterInput.addEventListener("input", () => {
+    ft4FilterText = ft4FilterInput.value.trim().toUpperCase();
+    renderFt4History();
+  });
+}
+
+if (ft4PauseBtn) {
+  ft4PauseBtn.addEventListener("click", () => {
+    ft4Paused = !ft4Paused;
+    if (!ft4Paused) { ft4BufferedWhilePaused = 0; renderFt4History(); } else { updateFt4PauseUi(); }
+  });
+}
+
+document.getElementById("ft4-decode-toggle-btn")?.addEventListener("click", async () => {
+  try { await postPath("/toggle_ft4_decode"); } catch (e) { console.error("FT4 toggle failed", e); }
+});
+
+document.getElementById("ft4-clear-btn")?.addEventListener("click", async () => {
+  try {
+    await postPath("/clear_ft4_decode");
+    window.resetFt4HistoryView();
+  } catch (e) { console.error("FT4 clear failed", e); }
+});
+
+window.onServerFt4 = function(msg) {
+  if (ft4Status) ft4Status.textContent = ft4Paused ? "Paused" : "Receiving";
+  const next = normalizeServerFt4Message(msg);
+  if (next.grids.length > 0 && window.ft8MapAddLocator) {
+    window.ft8MapAddLocator(next.raw, next.grids, "ft8", next.station, { ...msg, freq_hz: next.rfHz, locator_details: next.locatorDetails });
+  }
+  addFt4Message(next.history);
+};
+
+updateFt4PauseUi();