Go to file
Robert Jördens 50ea2f360c Merge branch 'master' into rj/visibility-cleanup
* master: (34 commits)
  miniconf: update example usage
  apps: spi isrs are spi errors
  pounder/timestamp: docs updatew
  pll: update tests and benches
  pll: merge advance into update (like rpll)
  pll: add advance()
  pounder_timestamper: use input capture prescaler
  Revert "Revert "pounder timestmper: don't use DMA""
  miniconf: add some checks, simplify
  miniconf.py: make retain an option
  refactor flatten_closures
  clippy recursion
  fix a few clippy lints on files that are touched
  Revert "pounder timestmper: don't use DMA"
  pounder timestmper: don't use DMA
  lockin: dma fence
  lockin: port to fast double buffered DMA
  dma: implement overflow checking
  pounder: clippy
  pounder: add comment on channel enum
  ...
2021-06-04 11:59:54 +02:00
.cargo remove duplicate linker option 2021-05-13 15:22:44 +02:00
.github Refactoring lockin binaries 2021-05-06 13:08:10 +02:00
ad9959 pounder: clippy 2021-05-31 20:41:18 +02:00
doc cargo: tweak 2019-03-29 19:34:31 +01:00
dsp Merge branch 'master' into rj/visibility-cleanup 2021-06-04 11:59:54 +02:00
hitl hitl: kill probe-run cleanly 2021-05-13 12:27:42 +02:00
src Merge branch 'master' into rj/visibility-cleanup 2021-06-04 11:59:54 +02:00
.gitignore Update .gitignore 2021-02-02 18:03:46 +01:00
.rustfmt.toml travis: clippy and rustfmt 2019-11-24 15:10:01 +01:00
CHANGELOG.md refine panic handler and add some logging info 2021-05-13 15:18:22 +02:00
Cargo.lock Merge branch 'master' into rj/visibility-cleanup 2021-06-04 11:59:54 +02:00
Cargo.toml dma: implement overflow checking 2021-06-01 13:11:16 +02:00
Embed.toml Adding Embed.toml file 2021-02-02 17:34:49 +01:00
LICENSE readme, license 2019-03-20 18:33:35 +00:00
README.md refine panic handler and add some logging info 2021-05-13 15:18:22 +02:00
build.rs itcm: implement in rust and execute during setup() 2021-05-14 17:23:38 +02:00
cargosha256-dual-iir.nix update cargosha256 2021-03-31 15:22:24 +08:00
memory.x memory.x: remove comment about old cortex-m-rt 2021-04-29 16:45:30 +02:00
miniconf.py miniconf: update example usage 2021-06-04 11:05:49 +02:00
openocd.gdb Removing invalid GDB command 2021-01-29 10:18:47 +01:00
requirements.txt Adding requirements file 2021-04-07 14:04:11 +02:00
stabilizer.cfg working 2019-03-18 13:10:00 +00:00
stabilizer_pid.png png 2019-05-09 16:40:35 +02:00
stabilizer_pid.svg README: diagram and photo 2019-05-09 16:05:36 +02:00

README.md

QUARTIQ Matrix Chat Continuous Integration Stabilizer HITL [Nightly]

Stabilizer Firmware

Hardware

Hardware

Applications

This firmware offers a library of hardware and software functionality targeting the use of the Stabilizer hardware in various digital signal processing applications commonly occurring in Quantum Technology. It provides abstractions over the fast analog inputs and outputs, time stamping, Pounder DDS interfaces and a collection of tailored and optimized digital signal processing algorithms (IIR, FIR, Lockin, PLL, reciprocal PLL, Unwrapper, Lowpass, Cosine-Sine, Atan2). An application can compose and configure these hardware and software components to implement different use cases. Several applications are provides by default:

Dual-IIR

Flow diagram

  • dual channel
  • SPI ADC
  • SPI DAC
  • up to 800 kHz rate, timed sampling
  • down to 2 µs latency
  • f32 IIR math
  • generic biquad (second order) IIR filter
  • anti-windup
  • derivative kick avoidance

Lockin

  • Up to 800 kHz sampling
  • Up to 400 kHz modulation frequency
  • Reciprocal PLL for external reference
  • Internal reference
  • Adjustable PLL and locking time constants
  • Adjustable phase offset and harmonic index
  • Different output modes (in-phase, quadrature, magnitude, log2 power, phase, frequency)

Minimal bootstrapping documentation

  • Clone or download this
  • Get rustup
  • Minimum supported Rust version (MSRV) is 1.52.0
  • Install target support: rustup target add thumbv7em-none-eabihf
  • Install probe-run: cargo install probe-run
  • cargo run --release --bin dual-iir
  • When using debug (non --release) mode, increase the sample interval significantly. The added error checking code and missing optimizations may lead to the code missing deadlines and panicing.

Alternative flashing tools

Cargo-embed

  • Install cargo-embed: cargo install cargo-embed
  • Program the device: cargo embed --bin dual-iir --release

GDB/OpenOCD

  • Get a recent openocd, a JTAG adapter ("st-link" or some clone) and everything connected and permissions setup. Most Nucleo boards have a detachable ST-Link v2 and are cheap.[^swd]
  • Get a multiarch gdb (or a cross arm gdb and edit .cargo/config accordingly)
  • openocd -f stabilizer.cfg and leave it running
  • cargo run --release

USB-DFU

  • Get cargo-binutils
  • cargo objcopy --release --bin dual-iir -- -O binary dual-iir.bin or arm-none-eabi-objcopy -O binary target/thumbv7em-none-eabihf/release/dual-iir dual-iir.bin
  • Install the DFU USB tool (dfu-util)
  • Connect to the Micro USB connector below the RJ45
  • Short JC2/BOOT
  • dfu-util -a 0 -s 0x08000000:leave -D dual-iir.bin
  • Prepare dual-iir.bin like above
  • Connect the ST-Link debugger
  • Copy dual-iir.bin to the NODE_H743ZI virtual mass storage device

Protocol

Stabilizer can be configured via MQTT. Refer to miniconf for more information about topics. A basic command line interface is available in miniconf.py. Telemetry is published via MQTT as well.