bfb416b85b
261: MQTT settings and telemetry r=ryan-summers a=ryan-summers This PR replaces https://github.com/quartiq/stabilizer/pull/242 This PR addresses #149 by exposing a simple MQTT-based settings interface **TODO**: - [x] Resolve mutable ownership issues in the `MqttInterface` - [x] Expand settings interface to `lockin.rs` - [x] Add all settings (not yet supported by `miniconf`) - [x] ~~Finalize and publish the `miniconf` package~~ Deferred to the future. - [x] Move `MqttInterface`-like behaviors over to `miniconf` - [x] Move smoltcp-nal to a separate crate - [x] Test on hardware - [x] ~~Implement stabilizer telemetry~~: Deferred to future Co-authored-by: Ryan Summers <ryan.summers@vertigo-designs.com> Co-authored-by: Robert Jördens <rj@quartiq.de> |
||
---|---|---|
.cargo | ||
.github | ||
ad9959 | ||
doc | ||
dsp | ||
src | ||
.gitignore | ||
.rustfmt.toml | ||
Cargo.lock | ||
Cargo.toml | ||
cargosha256-dual-iir.nix | ||
CHANGELOG.md | ||
Embed.toml | ||
LICENSE | ||
memory.x | ||
openocd.gdb | ||
README.md | ||
stabilizer_pid.png | ||
stabilizer_pid.svg | ||
stabilizer.cfg |
Stabilizer Firmware
Features
- dual channel
- SPI ADC
- SPI DAC
- 500 kHz rate, timed sampling
- 2 µs latency, unmatched between channels
- f32 IIR math
- generic biquad (second order) IIR filter
- anti-windup
- derivative kick avoidance
Limitations/TODOs
- Fixed AFE gains
- The IP and MAC address are hardcoded
- Expose configurable limits
- 100Base-T only
- Digital IO, GPIO header, AFE header, EEM header are not handled
Hardware
See https://github.com/sinara-hw/Stabilizer
Minimal bootstrapping documentation
- Clone or download this
- Get rustup
- Get cargo-binutils
rustup target add thumbv7em-none-eabihf
cargo build --release
- Do not try the debug (default) mode. It is guaranteed to panic.
Using Cargo-embed
- Install
cargo-embed
:cargo install cargo-embed
- Program the device:
cargo embed --bin dual-iir --release
Using 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.1
- Get a multiarch
gdb
(or a cross arm gdb and edit.cargo/config
accordingly) openocd -f stabilizer.cfg
and leave it runningcargo run --release
Using USB-DFU
- Install the DFU USB tool (
dfu-util
) - Connect to the Micro USB connector below the RJ45
- Short JC2/BOOT
cargo objcopy --release --bin dual-iir -- -O binary dual-iir.bin
orarm-none-eabi-objcopy -O binary target/thumbv7em-none-eabihf/release/dual-iir dual-iir.bin
dfu-util -a 0 -s 0x08000000:leave -D dual-iir.bin
Using ST-Link virtual mass storage
cargo objcopy --release --bin dual-iir -- -O binary dual-iir.bin
orarm-none-eabi-objcopy -O binary target/thumbv7em-none-eabihf/release/dual-iir dual-iir.bin
- Connect the ST-Link debugger
- copy
dual-iir.bin
to theNODE_H743ZI
USB disk
Protocol
Stabilizer can be configured via MQTT under the topic stabilizer/settings/<setting>
. Refer to
miniconf
for more information about topics.
-
Build a cable: connect a standard 8 conductor ribbon with the wires numbered
1-8
to the pins on the St-Link v2 single row 2.54mm connector as647513(82)
((i)
marks an unused wire) and to the 1.27mm dual row on Stabilizer as657483x2x1
(x
marks an unused pin, enumeration is standard for dual row, as in the schematic). It's just folding the ribbon between wires5
and6
. The signals on the ribbon are thenNRST,TDI,TDO,TCK,TMS,3V3,GND,GND
. ↩︎