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

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

@@ -4,6 +4,16 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [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.1}/Cargo.lock

@@ -3049,7 +3049,7 @@ dependencies = [
 
 [[package]]
 name = "python-aaronia"
-version = "0.13.0"
+version = "0.13.1"
 dependencies = [
  "arrow",
  "num-complex",
@@ -3578,7 +3578,7 @@ checksum = "94143f37725109f92c262ed2cf5e59bce7498c01bcc1502d7b9afe439a4e9f49"
 
 [[package]]
 name = "sdr-aaronia-rs"
-version = "0.13.0"
+version = "0.13.1"
 dependencies = [
  "anyhow",
  "bitflags 2.13.1",

{python_aaronia-0.13.0 → python_aaronia-0.13.1}/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.1"
 edition = "2024"
 repository = "https://github.com/isaacbentley/sdr-aaronia-rs"
 readme = "README.md"

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-aaronia
-Version: 0.13.0
+Version: 0.13.1
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)

{python_aaronia-0.13.0 → python_aaronia-0.13.1}/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.1}/python-aaronia/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "python-aaronia"
-version = "0.13.0"
+version = "0.13.1"
 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.1}/src/native_sdk.rs

@@ -2205,7 +2205,21 @@ impl NativeSdkSource {
     /// > tolerance in [`Self::configure_iq_receiver`] — so verify the
     /// > resulting device state before relying on this in production.
     pub unsafe fn configure_sweepsa(&mut self, config: &SweepsaConfig) -> Result<()> {
+        unsafe { self.configure_sweepsa_with_reference_level(config, None) }
+    }
+
+    /// Configure a spectrum sweep with an optional reference level in dBm.
+    /// Existing SweepsaConfig struct literals remain compatible. An explicit
+    /// level requires ConfigInfo bounds and is validated before any writes.
+    pub unsafe fn configure_sweepsa_with_reference_level(
+        &mut self,
+        config: &SweepsaConfig,
+        reference_level_dbm: Option<f64>,
+    ) -> Result<()> {
         unsafe {
+            if reference_level_dbm.is_some_and(|level| !level.is_finite()) {
+                return Err(Error::Config("reference level must be finite".into()));
+            }
             let device = self
                 .device
                 .as_mut()
@@ -2213,6 +2227,29 @@ impl NativeSdkSource {
 
             let mut root = self.client.get_config_root(device)?;
 
+            // Keep the validated node so a missing/unsupported explicit setting
+            // cannot be silently ignored after changing the sweep geometry.
+            let reference = if let Some(level) = reference_level_dbm {
+                let mut node = self
+                    .client
+                    .find_config(device, &mut root, "main/reflevel")?;
+                let info = self.client.get_config_info(device, &mut node)?;
+                let bounds = crate::capabilities::ValueRange::new(
+                    info.min_value,
+                    info.max_value,
+                    info.step_value,
+                )
+                .ok_or_else(|| Error::Config("reference level bounds are unknown".into()))?;
+                if !bounds.contains(level) {
+                    return Err(Error::Config(format!(
+                        "reference level {level} is outside {bounds:?}"
+                    )));
+                }
+                Some((node, level))
+            } else {
+                None
+            };
+
             if let Ok(mut config_node) =
                 self.client.find_config(device, &mut root, "main/startfreq")
             {
@@ -2241,6 +2278,11 @@ impl NativeSdkSource {
                 info!("Set sweepsa vbw to {} Hz", config.vbw);
             }
 
+            if let Some((mut node, level)) = reference {
+                self.client.set_config_float(device, &mut node, level)?;
+                info!("Set sweepsa reference level to {} dBm", level);
+            }
+
             Ok(())
         }
     }

{python_aaronia-0.13.0 → python_aaronia-0.13.1}/src/native_sdk_lifecycle_tests.rs

@@ -1,9 +1,10 @@
 //! SDK lifecycle fault injection. No Aaronia installation or USB device.
 use super::*;
-use std::cell::RefCell;
+use std::cell::{Cell, RefCell};
 thread_local! {
     static CALLS: RefCell<Vec<&'static str>> = const { RefCell::new(Vec::new()) };
     static FAIL: RefCell<Vec<&'static str>> = const { RefCell::new(Vec::new()) };
+    static CONFIG_AVAILABLE: Cell<bool> = const { Cell::new(false) };
 }
 fn call(name: &'static str) -> u32 {
     CALLS.with(|calls| calls.borrow_mut().push(name));
@@ -14,6 +15,7 @@ fn call(name: &'static str) -> u32 {
     }
 }
 fn reset(fail: &[&'static str]) {
+    CONFIG_AVAILABLE.with(|available| available.set(false));
     CALLS.with(|calls| calls.borrow_mut().clear());
     FAIL.with(|failed| *failed.borrow_mut() = fail.to_vec());
 }
@@ -88,7 +90,14 @@ unsafe extern "C" fn mock_config_root(
     _device: *mut AARTSAAPI_Device,
     _config: *mut AARTSAAPI_Config,
 ) -> u32 {
-    AARTSAAPI_ERROR_NOT_FOUND
+    if CONFIG_AVAILABLE.with(Cell::get) {
+        unsafe {
+            (*_config).d = std::ptr::dangling_mut::<u8>().cast();
+        }
+        AARTSAAPI_OK
+    } else {
+        AARTSAAPI_ERROR_NOT_FOUND
+    }
 }
 unsafe extern "C" fn mock_config_health(
     _device: *mut AARTSAAPI_Device,
@@ -123,14 +132,21 @@ unsafe extern "C" fn mock_config_find(
     _config: *mut AARTSAAPI_Config,
     _path: *const WideChar,
 ) -> u32 {
-    AARTSAAPI_ERROR_NOT_FOUND
+    if CONFIG_AVAILABLE.with(Cell::get) {
+        unsafe {
+            (*_config).d = std::ptr::dangling_mut::<u8>().cast();
+        }
+        AARTSAAPI_OK
+    } else {
+        AARTSAAPI_ERROR_NOT_FOUND
+    }
 }
 unsafe extern "C" fn mock_config_set_float(
     _device: *mut AARTSAAPI_Device,
     _config: *mut AARTSAAPI_Config,
     _value: f64,
 ) -> u32 {
-    AARTSAAPI_ERROR_NOT_FOUND
+    call("config_write")
 }
 unsafe extern "C" fn mock_config_set_string(
     _device: *mut AARTSAAPI_Device,
@@ -159,7 +175,15 @@ unsafe extern "C" fn mock_config_get_info(
     _config: *mut AARTSAAPI_Config,
     _info: *mut AARTSAAPI_ConfigInfo,
 ) -> u32 {
-    AARTSAAPI_ERROR_NOT_FOUND
+    if !CONFIG_AVAILABLE.with(Cell::get) {
+        return AARTSAAPI_ERROR_NOT_FOUND;
+    }
+    unsafe {
+        (*_info).min_value = -55.0;
+        (*_info).max_value = 23.0;
+        (*_info).step_value = 0.5;
+    }
+    AARTSAAPI_OK
 }
 unsafe extern "C" fn mock_config_get_float(
     _device: *mut AARTSAAPI_Device,
@@ -372,3 +396,44 @@ fn sdk_shutdown_waits_for_the_last_initialized_client() {
     }
     assert_eq!(calls(), vec!["init_with_path", "shutdown"]);
 }
+
+#[test]
+fn sweep_reference_level_is_checked_before_any_write() {
+    for level in [f64::NAN, f64::INFINITY, -56.0, 24.0] {
+        reset(&[]);
+        CONFIG_AVAILABLE.with(|available| available.set(true));
+        let mut source = source(false, false);
+        assert!(
+            unsafe {
+                source.configure_sweepsa_with_reference_level(&Default::default(), Some(level))
+            }
+            .is_err()
+        );
+        assert!(!calls().contains(&"config_write"));
+    }
+    reset(&[]);
+    CONFIG_AVAILABLE.with(|available| available.set(true));
+    let mut source = source(false, false);
+    unsafe {
+        source
+            .configure_sweepsa_with_reference_level(&Default::default(), Some(-50.0))
+            .unwrap();
+    }
+    assert_eq!(
+        calls()
+            .iter()
+            .filter(|&&call| call == "config_write")
+            .count(),
+        5
+    );
+}
+#[test]
+fn missing_explicit_sweep_reference_metadata_fails_before_writes() {
+    reset(&[]);
+    let mut source = source(false, false);
+    assert!(
+        unsafe { source.configure_sweepsa_with_reference_level(&Default::default(), Some(-50.0)) }
+            .is_err()
+    );
+    assert!(!calls().contains(&"config_write"));
+}

{python_aaronia-0.13.0 → python_aaronia-0.13.1}/tests/spec_coverage.rs

@@ -38,6 +38,18 @@ struct InvariantRow {
 }
 
 const ENFORCED: &[InvariantRow] = &[
+    InvariantRow {
+        area: Area::Sdk,
+        invariant: "explicit sweep reference levels are finite and bounded before any write",
+        test_fn: "sweep_reference_level_is_checked_before_any_write",
+        test_file: "src/native_sdk_lifecycle_tests.rs",
+    },
+    InvariantRow {
+        area: Area::Sdk,
+        invariant: "missing explicit sweep reference metadata fails before geometry writes",
+        test_fn: "missing_explicit_sweep_reference_metadata_fails_before_writes",
+        test_file: "src/native_sdk_lifecycle_tests.rs",
+    },
     InvariantRow {
         area: Area::Sdk,
         invariant: "Teardown attempts stop, disconnect, close; errors are not swallowed",