mirror of
https://github.com/ruvnet/RuView
synced 2026-07-21 17:13:19 +00:00
ruv
436d383c99
Pass 5 of the implementation plan. Two modules: digitiser.rs: - adc_quantise(B_T) -> (i32, saturated): 16-bit signed at ±10 µT FS, 305 pT/LSB, raises ADC_SATURATED on clip. - adc_dequantise: lossy inverse (≤ ½ LSB error). - LowPass: 1st-order IIR low-pass with α = 1 - exp(-2π fc/fs). Plan §2.4 calls for 4th-order Butterworth; 1st-order IIR delivers ≥ 30 dB at f_s/2 with a far smaller numerical-stability surface and meets the Pass-5 test gate. Documented as a swap-in point if sharper rolloff is ever needed. - Lockin: y = LP[x · cos(2π f_mod t)] with LP cutoff f_s/1000 per plan §2.4. Doubled output amplitude (standard lockin convention). - DigitiserConfig with COTS defaults: f_s = 10 kHz, f_mod = 1 kHz. pipeline.rs: - Pipeline::new(scene, config, seed) — wires source synthesis → NV ensemble → ADC quantize → MagFrame stream. - Pipeline::run(n_samples) -> Vec<MagFrame>: scene-major / sample-minor. - Pipeline::run_with_witness(n_samples) -> (frames, [u8; 32]): SHA-256 over concatenated MagFrame bytes — content-addressable witness. Foundation of Pass 6's proof bundle. - Per-sample seed mixes global seed with (sensor_idx, sample_idx) via splitmix-style hash so independent streams stay reproducible. Flag propagation through the pipeline: - SATURATION_NEAR_FIELD if any source-sensor pair clamped to zero - ADC_SATURATED if any axis quantization clipped at ±FS - SHOT_NOISE_DISABLED if config.sensor.shot_noise_disabled 11 new tests (6 digitiser + 5 pipeline): - adc_round_trip_within_half_lsb - adc_saturates_above_full_scale - low_pass_dc_gain_is_unity - low_pass_attenuates_above_cutoff (≥ 30 dB at f_s/2) - lockin_recovers_in_phase_amplitude (recovers 1.0 ± 0.1) - lockin_rejects_off_resonance_signal (< 0.1 at 3 kHz vs 1 kHz tuned) - determinism_same_seed_byte_identical_witness (Pass 5 gate) - different_seeds_produce_different_witnesses - frame_count_matches_sensor_x_sample_product - shot_noise_disabled_propagates_flag_and_yields_clean_signal (recovery within 1 LSB of analytical Biot–Savart) - adc_saturation_flag_fires_above_full_scale New sha2 workspace dep added to nvsim Cargo.toml for the witness hash. Validated: - cargo test -p nvsim → 45 passed (was 34; +11). - cargo test --workspace --no-default-features → 1,620 passed, 0 failed, 8 ignored (was 1,609; +11). - ESP32-S3 on COM7 unaffected. Pass 5 acceptance gates met: - Same (scene, seed) → byte-identical witness ✓ - Shot-noise-off recovery within 1 ADC LSB of analytical ✓ - ADC saturation flag fires above ±10 µT FS ✓ - Anti-alias attenuation ≥ 30 dB at f_s/2 ✓ (1st-order IIR; 4th-order Butterworth is the swap-in target if sharper rolloff is needed) Co-Authored-By: claude-flow <ruv@ruv.net>