Go to file

bors[bot] 97afdb5783 Merge #360 360: deps: fix rtt-logger->rtt-target, cleanup, bump cortex-m r=jordens a=jordens Co-authored-by: Robert Jördens <rj@quartiq.de>		2021-05-14 05:17:45 +00:00
.cargo	set target-cpu=cortex-m7, MSRV 1.52.0, use probe-run	2021-05-13 11:58:36 +02:00
.github	Refactoring lockin binaries	2021-05-06 13:08:10 +02:00
ad9959	build(deps): bump embedded-hal from 0.2.4 to 0.2.5	2021-05-13 17:15:34 +00:00
doc	cargo: tweak	2019-03-29 19:34:31 +01:00
dsp	remove unused dependencies	2021-05-12 13:09:22 +02:00
hitl	hitl: kill probe-run cleanly	2021-05-13 12:27:42 +02:00
src	deps: fix rtt-logger->rtt-target, cleanup, bump cortex-m	2021-05-14 07:16:47 +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
Cargo.lock	deps: fix rtt-logger->rtt-target, cleanup, bump cortex-m	2021-05-14 07:16:47 +02:00
Cargo.toml	deps: fix rtt-logger->rtt-target, cleanup, bump cortex-m	2021-05-14 07:16:47 +02:00
cargosha256-dual-iir.nix	update cargosha256	2021-03-31 15:22:24 +08:00
CHANGELOG.md	refine panic handler and add some logging info	2021-05-13 15:18:22 +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
memory.x	Marking AXISRAM as NOLOAD	2020-11-24 16:46:14 +01:00
miniconf.py	Updating docs and logger	2021-05-05 17:32:07 +02:00
openocd.gdb	Removing invalid GDB command	2021-01-29 10:18:47 +01:00
README.md	refine panic handler and add some logging info	2021-05-13 15:18:22 +02:00
requirements.txt	Adding requirements file	2021-04-07 14:04:11 +02: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
stabilizer.cfg	working	2019-03-18 13:10:00 +00:00

README.md

Stabilizer Firmware

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

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

ST-Link virtual mass storage

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.