python-aaronia 0.13.0__tar.gz → 0.13.3__tar.gz

{python_aaronia-0.13.0 → python_aaronia-0.13.3}/CHANGELOG.md

@@ -4,6 +4,47 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [v0.13.3] - 2026-11-10
+
+### Added
+- `SpectranSource::new_with_options`, `SpectranSourceBuilder::listen_only`, `spectran_source_builder_listen_only`, SoapySDR `listen_only` device arg, and Python `SpectranSource.listen_only` to connect to HTTP streams without issuing `/remoteconfig` or `/control` tuning writes.
+- `SdkSink` and `SpectranSink` serial selection (`device_serial` / `spectran_sink_builder_device_serial`) plus C ABI TX controls (`spectran_sink_set_center_frequency_hz`, `spectran_sink_set_sample_rate_hz`, `spectran_sink_set_trans_gain_db`, `spectran_sink_get_master_stream_time_ns`) and full SoapySDR TX frequency, sample-rate, gain, serial, and burst-timestamp support.
+- `AARONIA_NATIVE_SDK=ON` enabled by default on 64-bit Linux and Windows SoapySDR builds (including CI and release artifacts), and crate-root re-exports completed across `sdr-aaronia-rs`.
+
+### Fixed
+- Wrapped all 48 `extern "C" spectran_*` entry points in `catch_unwind`, made `FFI_RUNTIME` initialization fallible and `LocalSet`-safe, saturated `Instant` read deadlines, and tightened `SpectranSource *` pointer typing and alignment checks in `include/spectran.h` and `src/c_api.rs`.
+- Serialized concurrent `&self` C++ config-tree queries on `NativeSdk` via `device_query_lock`, bounded `num * stride` and validated `fp32` alignment and negative `packet.size` in `read_samples_within`, guarded null config nodes and NUL-terminated device serials, preserved SDK refcounts and intentionally leaked `libloading::Library` on failed teardown, rolled back partial device/packet state on errors, supported `iqtransceiver` RX mode, and reset carry buffers on `set_rf_span_hz`.
+- Replaced `PySpectranSource` `RefCell` state with a `Mutex` acquired exclusively inside `py.detach(...)` and detached the GIL with a bounded `shutdown_timeout` in `Drop`, eliminating re-entrant borrow panics, `pyo3-log` ABBA GIL deadlocks, and runtime teardown hangs; declared `numpy` and optional `pyarrow` dependencies in `python-aaronia/pyproject.toml`.
+- Eliminated the `StreamParser::skip_bytes` black-hole DoS when binary packet headers exceed `MAX_BINARY_PAYLOAD` by resynchronizing via `find_next_header`, sanitized `NaN`/`±Inf` binary floats to `0.0`, trimmed trailing URL slashes, validated `http`/`https` schemes, skipped redundant `/remoteconfig` writes + 500 ms sleeps on HTTP reconnect, dynamically discovered `Block_*` nodes while tolerating unlicensed `/remoteconfig`, and supported wideband V6 HTTP sample rates.
+- Flushed queued HTTP TX batches before `FutureSDR` sink teardown instead of aborting in-flight frames, and fixed `SdkSinkBlock` zero-burst livelocks, monotonic burst timestamp scheduling, and `io.call_again` signaling.
+- Added single-wavelet-block decompression support for compressed `.rtsa` `Spectra` chunks, pinned default multi-substream file cursor reads/seeks to the primary sub-stream, skipped non-IQ `Spectra` chunks in `SpectranSource` file reads, and stepped up out of `<install>/sdk` when locating RTSA XML configs and `RTSAFileTool`.
+- Mounted `.dmg` disk images via `hdiutil` in `packaging/homebrew/soapy-aaronia.rb` with architecture guards and dynamic SoapySDR module ABI detection.
+- Updated `rustls` (`0.23.46`), `rustls-webpki` (`0.103.16`), `tokio` (`1.54.1`), `webpki-root-certs` (`1.0.12`), and `async-executor` (`1.14.1`) in `Cargo.lock` to resolve RustSec advisories and yanked crate entries.
+
+## [v0.13.2] - 2026-10-15
+
+### Fixed
+- `HttpEndpointsClient` now configures `.no_proxy()` on `reqwest::Client`, preventing corporate/system `HTTP_PROXY` environment variables from hijacking localhost or LAN RTSA-Suite connections.
+- `HttpSource` (`FutureSDR` block) wraps its async `init`/`work` bodies in a poll-scoped Tokio context guard (`WithTokioHandle`) instead of calling `Handle::block_on`, preventing nested runtime panics when driven inside a Tokio worker thread.
+- `HttpSource::apply_initial_tune` now falls back to `/control` (`configure_capture`) when `/remoteconfig` returns HTTP 200 without applying `center_frequency_hz` or `decimation_index` (unlicensed `/remoteconfig`; see https://aaronia.com/en/software-licence-remote-config) as well as on transport errors.
+- Guarded HTTP streaming metadata and sample payloads (`float16`, `float32`, spectrum, and JSON paths) against non-finite (`NaN`/`±Inf`) values so corrupt headers or sample words cannot poison downstream DSP state or observed stream geometry.
+- `NativeSdkSource` now clears carry-over sample buffers on `configure_iq_receiver_with_options`, uses precision-preserving `epoch_seconds_to_nanos` for `last_timestamp_ns`, populates `device_mode` in `device_capabilities`, and prevents empty or invalid-stride packets from prematurely latching `got_packet` during deadline reads.
+- `SpectranSource::read_samples` now honours `config.read_timeout` on the `NativeSdk` backend via `read_samples_deadline`, validates finite tuning inputs across all backends, and clears stale `rf_span_hz`/`decimation_factor` overrides when `set_sample_rate_hz` is called.
+- Hardened RTSA chunk parsers (`STRM`, `SAMP`, `SSTR`, `ANTA`, `MDTT`) with minimum header size checks to reject truncated chunk headers before seeking.
+- `SpectranSeifyDevice` now uses `tokio::task::block_in_place` when called from a multi-thread Tokio runtime, recovers poisoned mutex locks, and reports observed file/stream frequencies in `frequency()`.
+- `python-aaronia` now clears `force_source_type` when `http_base_url` or `file_path` is reset to `None`, and stops any active stream on `start_streaming` re-entry or `Drop`.
+- macOS SoapySDR release artifacts are now packaged as `.dmg` disk images instead of `.tar.gz`, and macOS Python wheels build cleanly without the Linux/Windows-only `native-sdk` feature.
+
+## [v0.13.1] - 2026-10-08
+
+### Added
+- `NativeSdkSource::configure_sweepsa_with_reference_level` applies an optional
+  reference level to native spectrum sweeps, backported from Specola's vendor
+  update. Explicit levels require valid SDK bounds and are checked before any
+  configuration write; unsupported/missing settings fail instead of being ignored.
+  The existing `SweepsaConfig` layout and `configure_sweepsa` API remain compatible.
+
+
 ## [v0.13.0] - 2026-10-08
 
 ### Added

{python_aaronia-0.13.0 → python_aaronia-0.13.3}/Cargo.lock

@@ -376,9 +376,9 @@ dependencies = [
 
 [[package]]
 name = "async-executor"
-version = "1.14.0"
+version = "1.14.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c96bf972d85afc50bf5ab8fe2d54d1586b4e0b46c97c50a0c9e71e2f7bcd812a"
+checksum = "f426a31126c735126297bc5ea7a521263c9faff4f63ca415267ee625651c4f37"
 dependencies = [
  "async-task",
  "concurrent-queue",
@@ -703,9 +703,9 @@ checksum = "f079e83a288787bcd14a6aea84cee5c87a67c5a3e660c30f557a3d24761b3527"
 
 [[package]]
 name = "chacha20"
-version = "0.10.1"
+version = "0.10.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d524456ba66e72eb8b115ff89e01e497f8e6d11d78b70b1aa13c0fbd97540a81"
+checksum = "65c35e4b699c7e15ccbe7ee35c005e4fc0a278d22238a2857e6ce2dadeda1b06"
 dependencies = [
  "cfg-if",
  "cpufeatures 0.3.0",
@@ -3049,7 +3049,7 @@ dependencies = [
 
 [[package]]
 name = "python-aaronia"
-version = "0.13.0"
+version = "0.13.3"
 dependencies = [
  "arrow",
  "num-complex",
@@ -3431,9 +3431,9 @@ dependencies = [
 
 [[package]]
 name = "rustls"
-version = "0.23.45"
+version = "0.23.46"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0d41d731c7d2f962d1ccc364cec258de3c0e93b38c2fb3ba97ac74513048d634"
+checksum = "48e13bd8c0e9365c43cfa5c9e8f9ad49d3c8444926c9aac819e0e4dc503c8fdf"
 dependencies = [
  "aws-lc-rs",
  "once_cell",
@@ -3494,9 +3494,9 @@ checksum = "f87165f0995f63a9fbeea62b64d10b4d9d8e78ec6d7d51fb2125fda7bb36788f"
 
 [[package]]
 name = "rustls-webpki"
-version = "0.103.14"
+version = "0.103.16"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0527518605e68109d875e248ea259b6758801cf165e4b2c2733ae3b51f12535a"
+checksum = "4443b1b6d39d7c663139942cc4558262562d2c84123bb6282ef177009ca8b281"
 dependencies = [
  "aws-lc-rs",
  "ring",
@@ -3578,7 +3578,7 @@ checksum = "94143f37725109f92c262ed2cf5e59bce7498c01bcc1502d7b9afe439a4e9f49"
 
 [[package]]
 name = "sdr-aaronia-rs"
-version = "0.13.0"
+version = "0.13.3"
 dependencies = [
  "anyhow",
  "bitflags 2.13.1",
@@ -4289,9 +4289,9 @@ checksum = "1f3ccbac311fea05f86f61904b462b55fb3df8837a366dfc601a0161d0532f20"
 
 [[package]]
 name = "tokio"
-version = "1.53.1"
+version = "1.54.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "202caea871b69668250d242070849eb495be178ed697a3e98aebce5bc81a0bed"
+checksum = "b52fd3255258d26fac7264ab5a76b53c13367136dc011d3d6ad4f8ed070396a3"
 dependencies = [
  "bytes",
  "libc",
@@ -4784,9 +4784,9 @@ dependencies = [
 
 [[package]]
 name = "webpki-root-certs"
-version = "1.0.9"
+version = "1.0.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b96554aa2acc8ccdb7e1c9a58a7a68dd5d13bccc69cd124cb09406db612a1c9b"
+checksum = "293198dcebfb821155b5092ab94b5a82ff180eddd7241df3bd6e66a4ffd1a585"
 dependencies = [
  "rustls-pki-types",
 ]

{python_aaronia-0.13.0 → python_aaronia-0.13.3}/Cargo.toml

@@ -2,7 +2,7 @@
 name = "sdr-aaronia-rs"
 description = "Unified Rust interface for Aaronia Spectran Spectrum Analyzers / SDRs, featuring Python bindings, a SoapySDR plugin, HTTP streaming, and native SDK support."
 license = "GPL-3.0-or-later"
-version = "0.13.0"
+version = "0.13.3"
 edition = "2024"
 repository = "https://github.com/isaacbentley/sdr-aaronia-rs"
 readme = "README.md"
@@ -75,6 +75,7 @@ tokio = { version = "1.43", features = ["rt-multi-thread", "macros", "time", "sy
 [[bench]]
 name = "parse_int16_packet"
 harness = false
+required-features = ["http"]
 
 [[bench]]
 name = "deinterleave_dual_iq"
@@ -83,21 +84,64 @@ harness = false
 [[bench]]
 name = "decompress_block"
 harness = false
+required-features = ["file"]
 
 [[bench]]
 name = "rtsa_open_and_read"
 harness = false
+required-features = ["file"]
+
+# Feature guards for integration tests so `cargo check/test --all-targets`
+# succeeds under every isolated `--no-default-features --features <feat>`
+# permutation.
+[[test]]
+name = "c_api_test"
+required-features = ["ffi"]
+
+[[test]]
+name = "http_mock_test"
+required-features = ["http"]
+
+[[test]]
+name = "http_resilience_test"
+required-features = ["http", "file"]
 
-# `http_sink_test` drives a FutureSDR flowgraph and imports
-# `sdr_aaronia_rs::http_sink`, both of which only exist under the
-# `futuresdr` feature. Without this guard `cargo clippy --all-targets` and
-# `cargo test --all-targets` fail to compile on a default checkout with
-# `cannot find module or crate futuresdr`. (`tests/native_sdk_load.rs`
-# needs no entry — it guards itself with an inner `#![cfg(...)]`.)
 [[test]]
 name = "http_sink_test"
 required-features = ["futuresdr"]
 
+[[test]]
+name = "integration_test"
+required-features = ["http", "file"]
+
+[[test]]
+name = "live_smoke"
+required-features = ["http", "file"]
+
+[[test]]
+name = "native_sdk_live"
+required-features = ["native-sdk", "http", "file", "ffi"]
+
+[[test]]
+name = "properties"
+required-features = ["http", "file"]
+
+[[test]]
+name = "rtsa_negative_test"
+required-features = ["file"]
+
+[[test]]
+name = "test_cw_mag"
+required-features = ["file"]
+
+[[test]]
+name = "test_cw_meta"
+required-features = ["file"]
+
+[[test]]
+name = "wire_contract"
+required-features = ["http"]
+
 [features]
 default    = ["http", "file", "ffi"]
 http       = ["dep:reqwest", "dep:tokio", "dep:serde", "dep:serde_json",
@@ -110,12 +154,16 @@ native-sdk = ["dep:libloading", "dep:widestring"]
 
 [[example]]
 name = "noaa_scanner"
-required-features = ["futuresdr", "http"]
+required-features = ["futuresdr", "http", "file"]
 
 [[example]]
 name = "native_sdk_basic"
 required-features = ["native-sdk"]
 
+[[example]]
+name = "native_sdk_transmit"
+required-features = ["native-sdk"]
+
 [[example]]
 name = "dump_metadata"
 required-features = ["file"]
@@ -126,11 +174,11 @@ required-features = ["http"]
 
 [[example]]
 name = "http_iq_quickstart"
-required-features = ["http"]
+required-features = ["http", "file"]
 
 [[example]]
 name = "read_rtsa_file"
-required-features = ["file"]
+required-features = ["http", "file"]
 
 
 [target.'cfg(any(target_os = "windows", target_os = "linux"))'.dependencies]

{python_aaronia-0.13.0 → python_aaronia-0.13.3}/PKG-INFO

@@ -1,11 +1,14 @@
 Metadata-Version: 2.4
 Name: python-aaronia
-Version: 0.13.0
+Version: 0.13.3
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
 Classifier: Topic :: Communications :: Ham Radio
 Classifier: Topic :: Scientific/Engineering
+Requires-Dist: numpy>=1.24
+Requires-Dist: pyarrow>=14.0 ; extra == 'arrow'
+Provides-Extra: arrow
 Summary: Python bindings for sdr-aaronia-rs (Aaronia SPECTRAN V6 SDR source)
 License: GPL-3.0-or-later
 Requires-Python: >=3.9

{python_aaronia-0.13.0 → python_aaronia-0.13.3}/docs/SDKSPEC.md

@@ -6,6 +6,14 @@ The Aaronia Real-Time Spectrum Analyzer (RTSA) Vendor Software Development Kit (
 
 > **Status & attribution.** This document is a *community-compiled* reference, **not** an official Aaronia specification. It is assembled from Aaronia's official open-source sample code, public posts on the Aaronia V6 forum, vendor SDK headers, and empirical analysis. Where these disagree, the vendor's own materials are authoritative. See [Sources and Attribution](#sources-and-attribution) for the upstream, vendor-published references.
 
+## Sweep reference level (0.13.1)
+
+Use `configure_sweepsa_with_reference_level(&config, Some(-50.0))` to apply a
+reference level in dBm. `None` preserves the previous setting, as the existing
+`configure_sweepsa` call does. Explicit levels are validated against SDK metadata
+before any sweep geometry is changed. This additive method carries Specola's
+vendor functionality without adding a field to the public `SweepsaConfig` struct.
+
 ## Current driver behavior (0.13)
 
 See [Native SDK compatibility and qualification](NATIVE_SDK_COMPATIBILITY.md)

{python_aaronia-0.13.0 → python_aaronia-0.13.3}/examples/native_sdk_basic.rs

@@ -15,7 +15,8 @@
 
 #[cfg(all(
     feature = "native-sdk",
-    any(target_os = "windows", target_os = "linux")
+    any(target_os = "windows", target_os = "linux"),
+    target_pointer_width = "64"
 ))]
 fn main() -> anyhow::Result<()> {
     use sdr_aaronia_rs::native_sdk::NativeSdkSource;
@@ -129,7 +130,8 @@ fn main() -> anyhow::Result<()> {
 
 #[cfg(not(all(
     feature = "native-sdk",
-    any(target_os = "windows", target_os = "linux")
+    any(target_os = "windows", target_os = "linux"),
+    target_pointer_width = "64"
 )))]
 fn main() {
     println!("This example requires the 'native-sdk' feature and Windows or Linux.");

{python_aaronia-0.13.0 → python_aaronia-0.13.3}/examples/native_sdk_qualification.rs

@@ -2,7 +2,8 @@
 //! Run only with the radio released by other apps; no TX is opened.
 #[cfg(all(
     feature = "native-sdk",
-    any(target_os = "windows", target_os = "linux")
+    any(target_os = "windows", target_os = "linux"),
+    target_pointer_width = "64"
 ))]
 #[tokio::main(flavor = "current_thread")]
 async fn main() -> anyhow::Result<()> {
@@ -87,7 +88,8 @@ async fn main() -> anyhow::Result<()> {
 }
 #[cfg(not(all(
     feature = "native-sdk",
-    any(target_os = "windows", target_os = "linux")
+    any(target_os = "windows", target_os = "linux"),
+    target_pointer_width = "64"
 )))]
 fn main() {
     eprintln!("Requires native-sdk on Windows or Linux");

{python_aaronia-0.13.0 → python_aaronia-0.13.3}/examples/native_sdk_transmit.rs

@@ -11,7 +11,8 @@
 
 #[cfg(all(
     feature = "native-sdk",
-    any(target_os = "windows", target_os = "linux")
+    any(target_os = "windows", target_os = "linux"),
+    target_pointer_width = "64"
 ))]
 #[tokio::main]
 async fn main() -> anyhow::Result<()> {
@@ -139,7 +140,8 @@ async fn main() -> anyhow::Result<()> {
 
 #[cfg(not(all(
     feature = "native-sdk",
-    any(target_os = "windows", target_os = "linux")
+    any(target_os = "windows", target_os = "linux"),
+    target_pointer_width = "64"
 )))]
 fn main() {
     println!("This example requires the 'native-sdk' feature and Windows or Linux.");

{python_aaronia-0.13.0 → python_aaronia-0.13.3}/include/spectran.h

@@ -142,8 +142,8 @@ void spectran_source_builder_device_serial(SpectranSourceBuilder* builder, const
 void spectran_source_builder_force_source_type(SpectranSourceBuilder *builder,
                                               int source_type);
 
-/* Whether the native SDK library is present, by the search the builder
- * uses; does not load it. */
+/* Whether the native SDK backend is compiled into this binary and the
+ * vendor SDK library is present on disk; does not load it. */
 bool spectran_sdk_installed(void);
 
 /* Alias-free bandwidth (Hz) delivered at an IQ sample rate; smaller than
@@ -169,10 +169,19 @@ void spectran_source_builder_read_timeout_us(SpectranSourceBuilder* builder, uin
 // Automatic reconnection of the HTTP sample stream (default true). When
 // false, a dropped stream ends the session and later reads error out.
 void spectran_source_builder_auto_reconnect(SpectranSourceBuilder* builder, bool enabled);
+// Passive HTTP mode (default false). When true, never writes to /control or
+// /remoteconfig, allowing read-only attachment to shared or unlicensed servers.
+void spectran_source_builder_listen_only(SpectranSourceBuilder* builder, bool enabled);
 SpectranSource* spectran_source_build(SpectranSourceBuilder* builder);
 
 // --- SpectranSource FFI --- //
 //
+// Thread-safety contract: a `SpectranSource*` handle is NOT internally
+// synchronized. All calls targeting the same `SpectranSource*` (including
+// reads, retunes, capability/sensor queries, and free) MUST be serialized
+// by the caller (single thread at a time). Separate `SpectranSource*` or
+// `HttpEndpointsClient*` handles may be used concurrently on separate threads.
+//
 // Read return codes: >= 0 samples read; -1 generic error (details via
 // spectran_last_error); -3 timeout — a private convention of this API,
 // chosen so SoapySDR wrappers can map it 1:1 onto SOAPY_SDR_TIMEOUT.
@@ -218,12 +227,11 @@ SpectranFfiError spectran_source_set_clock_source(SpectranSource* source, const
 FfiSourceInfo* spectran_source_get_source_info(SpectranSource* source);
 void spectran_source_info_free(FfiSourceInfo* info);
 
-// Read the device's declared capabilities. BLOCKING: two control-plane
-// GETs, so call it once and cache. Returns NULL only for a null source
-// or when called from a current-thread tokio runtime; a device that
-// cannot be asked yields a struct with every field absent. Answers for
-// the HTTP backend — file and native-SDK sources report nothing, having
-// no equivalent surface to ask.
+// Read the device's declared capabilities. BLOCKING: control-plane or
+// SDK queries, so call it once and cache. Returns NULL only for a null
+// source or when called from a current-thread tokio runtime; a device
+// that cannot be asked yields a struct with every field absent. Answers
+// for both the HTTP and native-SDK backends; file sources report nothing.
 FfiDeviceCapabilities* spectran_source_get_capabilities(SpectranSource* source);
 void spectran_source_capabilities_free(FfiDeviceCapabilities* caps);
 
@@ -269,16 +277,25 @@ void spectran_sink_builder_free(SpectranSinkBuilder* builder);
 void spectran_sink_builder_center_frequency_hz(SpectranSinkBuilder* builder, double hz);
 void spectran_sink_builder_sample_rate_hz(SpectranSinkBuilder* builder, double hz);
 void spectran_sink_builder_trans_gain_db(SpectranSinkBuilder* builder, double db);
+void spectran_sink_builder_device_serial(SpectranSinkBuilder* builder, const char* serial);
 SpectranSink* spectran_sink_build(SpectranSinkBuilder* builder);
 void spectran_sink_free(SpectranSink* sink);
-// Loads the native SDK, opens the first matching device, configures
+// Thread-safety contract: like SpectranSource*, a SpectranSink* handle has no
+// internal lock and must be accessed by at most one thread at a time.
+//
+// Loads the native SDK, opens the matching device, configures
 // the IQ transmitter from the builder settings, and starts the TX
 // stream. Blocking.
 SpectranFfiError spectran_sink_initialize(SpectranSink* sink);
 SpectranFfiError spectran_sink_stop_streaming(SpectranSink* sink);
+SpectranFfiError spectran_sink_set_center_frequency_hz(SpectranSink* sink, double hz);
+SpectranFfiError spectran_sink_set_sample_rate_hz(SpectranSink* sink, double hz);
+SpectranFfiError spectran_sink_set_trans_gain_db(SpectranSink* sink, double db);
+bool spectran_sink_get_master_stream_time_ns(SpectranSink* sink, int64_t* out_time_ns);
 // start_time_s / end_time_s are in device MASTER STREAM TIME seconds,
 // not wall-clock epoch time. Samples use the same FfiComplex layout as
-// the read path.
+// the read path. Pass samples == NULL with num_samples == 0 for a 0-sample
+// startup/shutdown sync packet.
 SpectranFfiError spectran_sink_write_samples(
     SpectranSink* sink,
     int32_t channel,
@@ -295,9 +312,9 @@ HttpEndpointsClient* spectran_endpoints_client_new(const char* base_url);
 void spectran_endpoints_client_free(HttpEndpointsClient* client);
 FfiServerInfo* spectran_endpoints_client_get_info(HttpEndpointsClient* client);
 
-/* Fill *out with the device's live sensors through a standalone client,
- * off the streaming source's read lock. Same reading and return contract
- * as spectran_source_get_sensors. */
+/* Fill *out with the device's live sensors through a standalone client
+ * (safe to call concurrently while another thread owns a SpectranSource*).
+ * Same reading and return contract as spectran_source_get_sensors. */
 bool spectran_endpoints_client_get_sensors(HttpEndpointsClient* client, FfiDeviceSensors* out);
 void spectran_server_info_free(FfiServerInfo* info);
 SpectranFfiError spectran_endpoints_client_control_streaming(HttpEndpointsClient* client, bool start);
@@ -306,9 +323,9 @@ SpectranFfiError spectran_endpoints_client_control_recording(HttpEndpointsClient
 // --- General FFI Utilities --- //
 
 /* Additive native SDK APIs; existing struct layouts remain unchanged. */
-char *spectran_source_capabilities_json(void *source);
-SpectranFfiError spectran_source_rf_span_range(void *source, double *min_hz, double *max_hz);
-SpectranFfiError spectran_source_set_rf_span_hz(void *source, double hz);
+char *spectran_source_capabilities_json(SpectranSource *source);
+SpectranFfiError spectran_source_rf_span_range(SpectranSource *source, double *min_hz, double *max_hz);
+SpectranFfiError spectran_source_set_rf_span_hz(SpectranSource *source, double hz);
 SpectranFfiError spectran_source_builder_native_options(SpectranSourceBuilder *builder,
     const char *family, const char *mode, double rf_span_hz, const char *clock, uint32_t decimation);
 

python_aaronia-0.13.3/packaging/homebrew/soapy-aaronia.rb

@@ -0,0 +1,76 @@
+# Homebrew formula for the Aaronia SoapySDR plugin.
+#
+# Lives here so it is versioned with the code it installs. To publish it,
+# copy this file into a tap repository named homebrew-tap, as
+# Formula/soapy-aaronia.rb, and users get:
+#
+#     brew install <owner>/tap/soapy-aaronia
+#
+# At each release, update `version`, both `sha256` values (from the
+# release archives) and nothing else. `brew audit --strict soapy-aaronia`
+# checks the formula before publishing.
+class SoapyAaronia < Formula
+  desc "SoapySDR plugin for Aaronia SPECTRAN V6 spectrum analyzers"
+  homepage "https://github.com/isaacbentley/sdr-aaronia-rs"
+  version "0.13.3"
+  license "GPL-3.0-or-later"
+
+  # Prebuilt modules: the plugin statically links its Rust core, so there
+  # is nothing to build here and no Rust toolchain to depend on.
+  on_macos do
+    depends_on arch: :arm64
+
+    on_arm do
+      url "https://github.com/isaacbentley/sdr-aaronia-rs/releases/download/v#{version}/SoapyAaronia-#{version}-macos-arm64.dmg",
+          using: :nounzip
+      sha256 "REPLACE_WITH_SHA256_OF_MACOS_ARM64_ARCHIVE"
+    end
+  end
+
+  on_linux do
+    depends_on arch: :x86_64
+
+    on_intel do
+      url "https://github.com/isaacbentley/sdr-aaronia-rs/releases/download/v#{version}/SoapyAaronia-#{version}-linux-x86_64.tar.gz"
+      sha256 "REPLACE_WITH_SHA256_OF_LINUX_X86_64_ARCHIVE"
+    end
+  end
+
+  depends_on "soapysdr"
+
+  def install
+    # Discover SoapySDR's module ABI version dynamically rather than
+    # hardcoding "0.8" across future SoapySDR releases.
+    info = Utils.safe_popen_read(Formula["soapysdr"].opt_bin/"SoapySDRUtil", "--info")
+    abi = info[/ABI Version:\s*v?([0-9]+\.[0-9]+)/i, 1] || "0.8"
+    mod_dir = lib/"SoapySDR/modules#{abi}"
+
+    if OS.mac?
+      dmg = Dir["*.dmg"].first
+      odie "No .dmg archive found in buildpath" unless dmg
+      mountpoint = buildpath/"dmg_mount"
+      mountpoint.mkpath
+      system "hdiutil", "attach", "-nobrowse", "-readonly", "-mountpoint", mountpoint, dmg
+      begin
+        so_file = Pathname.glob(mountpoint/"**/libaaroniaSupport.so").first
+        odie "libaaroniaSupport.so not found inside mounted DMG" unless so_file
+        mod_dir.install so_file
+        install_doc = Pathname.glob(mountpoint/"**/INSTALL.md").first
+        doc.install install_doc if install_doc
+      ensure
+        system "hdiutil", "detach", mountpoint, "-force"
+      end
+    else
+      so_file = Pathname.glob("**/libaaroniaSupport.so").first
+      odie "libaaroniaSupport.so not found in archive" unless so_file
+      mod_dir.install so_file
+      install_doc = Pathname.glob("**/INSTALL.md").first
+      doc.install install_doc if install_doc
+    end
+  end
+
+  test do
+    # Proves the module loads into SoapySDR rather than merely existing.
+    assert_match "aaronia", shell_output("#{Formula["soapysdr"].opt_bin}/SoapySDRUtil --check=aaronia")
+  end
+end

{python_aaronia-0.13.0 → python_aaronia-0.13.3}/pyproject.toml

@@ -17,6 +17,10 @@ classifiers = [
 ]
 # Version comes from python-aaronia/Cargo.toml (single source of truth).
 dynamic = ["version"]
+dependencies = ["numpy>=1.24"]
+
+[project.optional-dependencies]
+arrow = ["pyarrow>=14.0"]
 
 # A real command, so checking a setup needs no code:
 #   aaronia-doctor http://localhost:54664

{python_aaronia-0.13.0 → python_aaronia-0.13.3}/python-aaronia/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "python-aaronia"
-version = "0.13.0"
+version = "0.13.3"
 edition = "2024"
 description = "Python bindings for sdr-aaronia-rs (Aaronia SPECTRAN V6 SDR source)"
 license = "GPL-3.0-or-later"

{python_aaronia-0.13.0 → python_aaronia-0.13.3}/python-aaronia/aaronia.pyi

@@ -108,6 +108,9 @@ class SpectranConfig:
     (default 30.0). Must be positive and finite."""
     auto_reconnect: bool
     """Reconnect the HTTP stream after a drop (default ``True``)."""
+    listen_only: bool
+    """Stream from an HTTP server without issuing ``/control`` or
+    ``/remoteconfig`` writes (default ``False``)."""
 
 class SpectranSource:
     """A streaming IQ source.
@@ -136,8 +139,9 @@ class SpectranSource:
         a truncated capture is not mistaken for a finished one.
         """
 
-    def start_streaming(self, config: SpectranConfig) -> None:
-        """Connect to the backend selected by ``config`` and start streaming.
+    def start_streaming(self, config: Optional[SpectranConfig] = None) -> None:
+        """Connect to the backend selected by ``config`` (or the previous
+        configuration when omitted) and start streaming.
 
         Raises ``SpectranConnectionError`` if the endpoint is
         unreachable, ``ValueError`` for invalid configuration, and
@@ -234,6 +238,7 @@ def open(
     format: Optional[WireFormat] = None,
     scale: Optional[float] = None,
     read_timeout_s: Optional[float] = None,
+    listen_only: bool = False,
 ) -> SpectranSource:
     """Open a source and start streaming, in one call.