ka9q-python 3.7.0__tar.gz → 3.7.1__tar.gz

{ka9q_python-3.7.0 → ka9q_python-3.7.1}/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [3.7.1] - 2026-04-12
+
+### Fixed
+
+- **S16BE/S16LE audio parsing in `RadiodStream`**: `_parse_samples()` always decoded audio-mode RTP payloads as float32, regardless of the channel's actual encoding. When encoding was S16BE (used by FT4/FT8 channels at 12 kHz), a 240-byte payload containing 120 int16 samples was misinterpreted as 60 float32 values. The `PacketResequencer` then reported a 120-sample gap on every packet (~2500 gaps/minute), reducing stream completeness to ~37% and making the stream unusable for downstream consumers like `decode_ft8`. Now dispatches on `channel.encoding`: S16BE (`>i2`), S16LE (`<i2`), F32BE (`>f4`), and default F32LE (`np.float32`). All int16 formats are normalized to float32 (÷32768) in the callback.
+- **`ManagedStream` now accepts `encoding` parameter**: Added `encoding: int = 0` to `__init__()`, passed through to both `ensure_channel()` call sites (initial provisioning and stream restoration). Without this, `ManagedStream` would re-provision a channel without encoding on restore, causing format mismatches. Clients using non-default encoding (S16BE, S16LE, F32BE) should pass `encoding=` to the constructor. This eliminates the need for hf-timestd's `RobustManagedStream` workaround.
+
+### Client migration
+
+- **Clients using `ManagedStream` with non-default encoding**: Pass `encoding=<int>` to the constructor. Example: `ManagedStream(control=ctl, frequency_hz=14.074e6, preset="usb", sample_rate=12000, encoding=2)` for S16BE.
+- **Clients using bare `RadiodStream` with S16BE/S16LE**: No code change needed — samples are now correctly decoded to float32 in the callback. Note that if client code was compensating for the old bug (e.g., manually byte-swapping), that workaround should be removed.
+- **hf-timestd**: Can replace `RobustManagedStream` (stream_recorder_v2.py lines 40-195) with `ka9q.ManagedStream(encoding=Encoding.F32)` and delete the wrapper class.
+
+---
+
 ## [3.7.0] - 2026-04-12
 
 ### Changed

{ka9q_python-3.7.0/ka9q_python.egg-info → ka9q_python-3.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ka9q-python
-Version: 3.7.0
+Version: 3.7.1
 Summary: Python interface for ka9q-radio control and monitoring
 Home-page: https://github.com/mijahauan/ka9q-python
 Author: Michael Hauan AC0G

{ka9q_python-3.7.0 → ka9q_python-3.7.1}/ka9q/managed_stream.py

@@ -123,6 +123,7 @@ class ManagedStream:
         agc_enable: int = 0,
         gain: float = 0.0,
         destination: Optional[str] = None,
+        encoding: int = 0,
         on_samples: Optional[SampleCallback] = None,
         on_stream_dropped: Optional[StreamDroppedCallback] = None,
         on_stream_restored: Optional[StreamRestoredCallback] = None,
@@ -135,7 +136,7 @@ class ManagedStream:
     ):
         """
         Initialize ManagedStream.
-        
+
         Args:
             control: RadiodControl instance for channel management
             frequency_hz: Center frequency in Hz
@@ -144,6 +145,7 @@ class ManagedStream:
             agc_enable: Enable AGC (0=off, 1=on)
             gain: Manual gain in dB (when AGC off)
             destination: RTP destination multicast address (optional)
+            encoding: Output encoding (0=none, 1=S16LE, 2=S16BE, 4=F32LE, etc.)
             on_samples: Callback(samples, quality) for sample delivery
             on_stream_dropped: Callback(reason) when stream drops
             on_stream_restored: Callback(channel) when stream is restored
@@ -161,6 +163,7 @@ class ManagedStream:
         self._agc_enable = agc_enable
         self._gain = gain
         self._destination = destination
+        self._encoding = encoding
         
         # Callbacks
         self._on_samples = on_samples
@@ -232,6 +235,7 @@ class ManagedStream:
             agc_enable=self._agc_enable,
             gain=self._gain,
             destination=self._destination,
+            encoding=self._encoding,
         )
         
         # Start the underlying stream
@@ -414,6 +418,7 @@ class ManagedStream:
                 agc_enable=self._agc_enable,
                 gain=self._gain,
                 destination=self._destination,
+                encoding=self._encoding,
                 timeout=self._restore_interval_sec * 2,  # Give it some time
             )
             

{ka9q_python-3.7.0 → ka9q_python-3.7.1}/ka9q/stream.py

@@ -350,7 +350,7 @@ class RadiodStream:
             ).isoformat()
     
     def _parse_samples(self, payload: bytes) -> Optional[np.ndarray]:
-        """Parse samples from RTP payload."""
+        """Parse samples from RTP payload based on channel encoding."""
         try:
             if self._is_iq:
                 # IQ mode: float32 interleaved I/Q -> complex64
@@ -362,9 +362,23 @@ class RadiodStream:
                 samples = floats[0::2] + 1j * floats[1::2]
                 return samples.astype(np.complex64)
             else:
-                # Audio mode: float32 mono
-                return np.frombuffer(payload, dtype=np.float32)
-                
+                # Audio mode: parse according to encoding
+                enc = getattr(self.channel, 'encoding', 0)
+                if enc == 2:
+                    # S16BE: 16-bit big-endian signed integers -> float32
+                    int16_samples = np.frombuffer(payload, dtype='>i2')
+                    return (int16_samples / 32768.0).astype(np.float32)
+                elif enc == 1:
+                    # S16LE: 16-bit little-endian signed integers -> float32
+                    int16_samples = np.frombuffer(payload, dtype='<i2')
+                    return (int16_samples / 32768.0).astype(np.float32)
+                else:
+                    # F32LE (4), F32BE (8), or default: float32
+                    if enc == 8:
+                        return np.frombuffer(payload, dtype='>f4').astype(np.float32)
+                    else:
+                        return np.frombuffer(payload, dtype=np.float32)
+
         except Exception as e:
             logger.error(f"Failed to parse payload: {e}")
             return None

{ka9q_python-3.7.0 → ka9q_python-3.7.1/ka9q_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ka9q-python
-Version: 3.7.0
+Version: 3.7.1
 Summary: Python interface for ka9q-radio control and monitoring
 Home-page: https://github.com/mijahauan/ka9q-python
 Author: Michael Hauan AC0G

{ka9q_python-3.7.0 → ka9q_python-3.7.1}/pyproject.toml

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