2020-11-17 00:36:16 +08:00
|
|
|
[![QUARTIQ Matrix Chat](https://img.shields.io/matrix/quartiq:matrix.org)](https://matrix.to/#/#quartiq:matrix.org)
|
2021-01-09 02:04:59 +08:00
|
|
|
[![HITL (private)](https://github.com/quartiq/hitl/workflows/Stabilizer/badge.svg)](https://github.com/quartiq/hitl/actions?query=workflow%3AStabilizer)
|
2020-06-16 22:54:40 +08:00
|
|
|
|
2019-03-21 02:32:23 +08:00
|
|
|
# Stabilizer Firmware
|
2019-03-10 20:08:32 +08:00
|
|
|
|
2021-03-03 18:38:28 +08:00
|
|
|
## Hardware
|
|
|
|
|
|
|
|
[![Hardware](https://github.com/sinara-hw/Stabilizer/wiki/Stabilizer_v1.0_top_small.jpg)](https://github.com/sinara-hw/Stabilizer)
|
|
|
|
|
|
|
|
## Applications
|
2019-05-09 22:05:36 +08:00
|
|
|
|
2021-03-03 18:38:28 +08:00
|
|
|
The Stabilizer firmware offeres a library of hardware and software functionality
|
|
|
|
exposing input/output, timing, and digital signal processing features.
|
|
|
|
An application can compose and configure these hardware and software components
|
|
|
|
to implement different use cases. Several applications are provides by default
|
2019-05-09 22:05:36 +08:00
|
|
|
|
2021-03-03 18:38:28 +08:00
|
|
|
### Dual-IIR
|
|
|
|
|
|
|
|
![Flow diagram](stabilizer_pid.svg)
|
2019-04-12 23:43:51 +08:00
|
|
|
|
|
|
|
* dual channel
|
|
|
|
* SPI ADC
|
|
|
|
* SPI DAC
|
2021-03-03 18:38:28 +08:00
|
|
|
* up to 800 kHz rate, timed sampling
|
|
|
|
* down to 2 µs latency
|
2019-04-12 23:43:51 +08:00
|
|
|
* f32 IIR math
|
|
|
|
* generic biquad (second order) IIR filter
|
|
|
|
* anti-windup
|
|
|
|
* derivative kick avoidance
|
2019-05-28 18:15:15 +08:00
|
|
|
|
2021-03-03 18:38:28 +08:00
|
|
|
### Lockin external
|
2019-05-28 18:15:15 +08:00
|
|
|
|
2021-03-03 18:38:28 +08:00
|
|
|
### Lockin internal
|
2019-04-12 23:43:51 +08:00
|
|
|
|
|
|
|
## Minimal bootstrapping documentation
|
|
|
|
|
|
|
|
* Clone or download this
|
2019-06-06 15:40:17 +08:00
|
|
|
* Get [rustup](https://rustup.rs/)
|
|
|
|
* `rustup target add thumbv7em-none-eabihf`
|
|
|
|
* `cargo build --release`
|
2021-03-03 18:38:28 +08:00
|
|
|
* 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.
|
2019-06-06 15:40:17 +08:00
|
|
|
|
2021-02-03 00:33:58 +08:00
|
|
|
### Using Cargo-embed
|
|
|
|
|
|
|
|
* Install `cargo-embed`: `cargo install cargo-embed`
|
|
|
|
* Program the device: `cargo embed --bin dual-iir --release`
|
|
|
|
|
2019-06-06 15:40:17 +08:00
|
|
|
### Using GDB/OpenOCD
|
|
|
|
|
2019-04-12 23:43:51 +08:00
|
|
|
* Get a recent openocd, a JTAG adapter ("st-link" or some clone) and
|
2019-05-29 22:25:45 +08:00
|
|
|
everything connected and permissions setup. Most
|
|
|
|
[Nucleo](https://www.digikey.de/short/p41h4v) boards have a
|
|
|
|
detachable ST-Link v2 and are cheap.[^swd]
|
2019-04-12 23:43:51 +08:00
|
|
|
* 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`
|
2019-05-28 18:15:15 +08:00
|
|
|
|
2019-06-06 15:40:17 +08:00
|
|
|
### Using USB-DFU
|
|
|
|
|
2019-06-07 16:17:50 +08:00
|
|
|
* Install the DFU USB tool (`dfu-util`)
|
2019-06-06 15:40:17 +08:00
|
|
|
* Connect to the Micro USB connector below the RJ45
|
2019-06-07 16:17:50 +08:00
|
|
|
* Short JC2/BOOT
|
2021-03-03 18:38:28 +08:00
|
|
|
* Get [cargo-binutils](https://github.com/rust-embedded/cargo-binutils/)
|
2021-02-02 06:38:41 +08:00
|
|
|
* `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`
|
|
|
|
* `dfu-util -a 0 -s 0x08000000:leave -D dual-iir.bin`
|
2019-06-06 15:40:17 +08:00
|
|
|
|
|
|
|
### Using ST-Link virtual mass storage
|
|
|
|
|
2021-03-03 18:38:28 +08:00
|
|
|
* Get [cargo-binutils](https://github.com/rust-embedded/cargo-binutils/)
|
2021-02-02 06:38:41 +08:00
|
|
|
* `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`
|
2019-06-06 15:40:17 +08:00
|
|
|
* Connect the ST-Link debugger
|
2021-02-02 06:38:41 +08:00
|
|
|
* copy `dual-iir.bin` to the `NODE_H743ZI` USB disk
|
2019-06-06 15:40:17 +08:00
|
|
|
|
2019-05-28 18:15:15 +08:00
|
|
|
## Protocol
|
|
|
|
|
2021-03-03 18:38:28 +08:00
|
|
|
Stabilizer can be configured via MQTT. Refer to
|
2021-02-19 17:57:12 +08:00
|
|
|
[`miniconf`](https://github.com/quartiq/miniconf) for more information about topics.
|
2021-03-03 18:38:28 +08:00
|
|
|
A basic command line interface is available in [`miniconf.py`](miniconf.py).
|