ka9q-python 3.18.0__tar.gz → 3.19.0__tar.gz

{ka9q_python-3.18.0 → ka9q_python-3.19.0}/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## [3.19.0] - 2026-06-28
+
+### Removed / Changed — simplify how we look at radiod (defer to RTP)
+
+- **Removed `SlotClock.divergence_sec`** (added in 3.18.0). It recomputed a
+  boundary's UTC from the live, StatusListener-refreshed `channel_info` and
+  compared it to the grid — inviting consumers to re-anchor when the two
+  disagree. In practice a busy radiod's status pair (`gps_time`/`rtp_timesnap`)
+  jitters ~0.45 s and occasionally tears between ~450 ms snapshots, so the check
+  reported large spurious divergences and drove downstream recorders into a
+  re-anchor storm. The `SlotClock` grid is RTP-driven and drift-immune by
+  design; nothing should second-guess it against the noisy status feed.
+
+- **Removed the per-update RTP↔GPS offset-step detection in
+  `ChannelInfo.update_anchor`** (`discovery.py`). It bumped `anchor_epoch` and
+  logged a loud `radiod RTP↔GPS offset STEPPED … (consumers will re-anchor)`
+  WARNING whenever consecutive status snapshots implied a stepped offset — but
+  that "step" was almost always status-feed jitter/tearing, not a real radiod
+  slide (radiod's RTP data path stayed consistent; decodes never stopped).
+  `update_anchor` now simply adopts the latest anchor pair. The `anchor_epoch`,
+  `last_offset_step_sec`, and `anchor_step_threshold_sec` fields remain
+  (vestigial, at their defaults) for backward compatibility.
+
+The principle: **anchor once off radiod's RTP timestamp and defer to it.** A
+genuine radiod restart is still handled downstream via the stream-restored path
+(MultiStream's drop/restore callback), not by polling the status feed for
+divergence. The sigmond recorders (psk/meteor/wspr) drop their matching
+re-anchor machinery in lockstep.
+
 ## [3.18.0] - 2026-06-28
 
 ### Added

{ka9q_python-3.18.0/ka9q_python.egg-info → ka9q_python-3.19.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ka9q-python
-Version: 3.18.0
+Version: 3.19.0
 Summary: Python interface for ka9q-radio control and monitoring
 Author-email: Michael Hauan AC0G <ac0g@hauan.org>
 License: MIT

{ka9q_python-3.18.0 → ka9q_python-3.19.0}/ka9q/discovery.py

@@ -132,9 +132,6 @@ class ChannelInfo:
         ``_anchor_pair``.  Tuple is written first so the atomic snapshot
         is the leading edge of any state change.
         """
-        # Snapshot the previous pair BEFORE overwriting, for step detection.
-        prev = getattr(self, '_anchor_pair', None)
-
         # Atomic pair first — this is the source of truth for
         # transactional readers.
         self._anchor_pair = (gps_time, rtp_timesnap)
@@ -144,36 +141,14 @@ class ChannelInfo:
         # ``.gps_time`` directly sees the current value.
         self.gps_time = gps_time
         self.rtp_timesnap = rtp_timesnap
-
-        # ── Offset-step detection ──
-        # Consecutive snapshots are ~450 ms apart, so the signed 32-bit RTP
-        # delta is tiny (no wrap ambiguity, unlike the projection path in
-        # rtp_to_wallclock).  ``move_sec`` is the change in the RTP→GPS
-        # mapping: ~0 when radiod is consistent, a gross jump when it steps.
-        # Only the StatusListener thread calls update_anchor (single writer),
-        # so the ``anchor_epoch += 1`` read-modify-write is race-free; the
-        # epoch is bumped AFTER ``_anchor_pair`` is published so any reader
-        # that observes the new epoch also reads the new (or newer) anchor.
-        if (
-            prev is not None
-            and prev[0] is not None
-            and prev[1] is not None
-            and self.sample_rate
-        ):
-            d_rtp = int((rtp_timesnap - prev[1]) & 0xFFFFFFFF)
-            if d_rtp > 0x7FFFFFFF:
-                d_rtp -= 0x100000000
-            move_sec = (
-                (gps_time - prev[0]) - d_rtp * 1_000_000_000 / self.sample_rate
-            ) / 1e9
-            if abs(move_sec) > self.anchor_step_threshold_sec:
-                self.last_offset_step_sec = move_sec
-                self.anchor_epoch += 1
-                logger.warning(
-                    "ChannelInfo ssrc=%s: radiod RTP↔GPS offset STEPPED "
-                    "%+.3fs — anchor_epoch=%d (consumers will re-anchor)",
-                    self.ssrc, move_sec, self.anchor_epoch,
-                )
+        # NOTE (2026-06-28): the per-update RTP↔GPS offset-step detection was
+        # removed.  It compared consecutive ~450 ms status snapshots and bumped
+        # ``anchor_epoch`` (with a loud WARNING) on any jump — but a busy
+        # radiod's status pair jitters/tears at that cadence, so it fired
+        # constantly and drove downstream recorders into a re-anchor storm.
+        # We now simply adopt the latest pair and defer to radiod's RTP; the
+        # ``anchor_epoch`` / ``last_offset_step_sec`` fields remain (vestigial,
+        # at their defaults) for backward compatibility.
 
 
 def _create_status_listener_socket(multicast_addr: str, interface: Optional[str] = None) -> socket.socket:

{ka9q_python-3.18.0 → ka9q_python-3.19.0}/ka9q/slot_clock.py

@@ -226,33 +226,3 @@ class SlotClock:
             self._next_boundary_off = start_off + self.cadence_samples
             self._next_index += 1
         return out
-
-    # ── RTP-reference re-validation ──────────────────────────────────
-
-    def divergence_sec(self, channel_info, rtp_to_utc) -> Optional[float]:
-        """Grid-vs-GPS divergence at the next boundary, in seconds.
-
-        Recomputes the next boundary's true UTC straight from radiod's
-        (StatusListener-refreshed) ``channel_info`` via ``rtp_to_utc``
-        and compares it to the grid projection.  A sustained nonzero result
-        means the anchor is stale/wrong — the caller should ``anchor()``
-        again off the fresh reference.  Returns None if it can't be computed.
-
-        ``rtp_to_utc`` is passed in (rather than imported) so the caller binds
-        the exact projector it anchored with; ``ka9q.rtp_to_wallclock`` works
-        too as a deprecated alias of the same function.
-        """
-        if self._anchor_rtp is None or self._next_boundary_off is None:
-            return None
-        boundary_rtp = self.rtp_of_offset(self._next_boundary_off)
-        projected = self.utc_of_offset(self._next_boundary_off)
-        try:
-            ref = rtp_to_utc(
-                boundary_rtp, channel_info, wallclock_hint_sec=projected,
-            )
-        except Exception as exc:  # noqa: BLE001 — detection must not crash audio
-            logger.debug("SlotClock divergence check raised: %s", exc)
-            return None
-        if ref is None:
-            return None
-        return projected - ref

{ka9q_python-3.18.0 → ka9q_python-3.19.0/ka9q_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ka9q-python
-Version: 3.18.0
+Version: 3.19.0
 Summary: Python interface for ka9q-radio control and monitoring
 Author-email: Michael Hauan AC0G <ac0g@hauan.org>
 License: MIT

{ka9q_python-3.18.0 → ka9q_python-3.19.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ka9q-python"
-version = "3.18.0"
+version = "3.19.0"
 description = "Python interface for ka9q-radio control and monitoring"
 readme = "README.md"
 authors = [