Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sunsided/stm32f3disco-rust
Rust embedded on the STM32F3-Discovery / STM32F303VC
https://github.com/sunsided/stm32f3disco-rust
accelerometer embedded gyroscope l3gd20 lsm303dlhc magnetometer rust stm32f3 stm32f3-discovery stm32f303vct6 temperature
Last synced: 29 days ago
JSON representation
Rust embedded on the STM32F3-Discovery / STM32F303VC
- Host: GitHub
- URL: https://github.com/sunsided/stm32f3disco-rust
- Owner: sunsided
- License: eupl-1.2
- Created: 2023-06-02T19:24:09.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-07-06T21:01:36.000Z (7 months ago)
- Last Synced: 2024-11-09T08:12:51.983Z (2 months ago)
- Topics: accelerometer, embedded, gyroscope, l3gd20, lsm303dlhc, magnetometer, rust, stm32f3, stm32f3-discovery, stm32f303vct6, temperature
- Language: Rust
- Homepage:
- Size: 1.59 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# STM32F3 Discovery š¦ā”
The LED Roulette example on the [STM32F3 Discovery](https://www.st.com/en/evaluation-tools/stm32f3discovery.html) board,
on steroids,
written in Rust. An experiment to get started with embedded development in Rust, as well as testing the IDE based
development
and debugging experience in JetBrains ~~CLion while using Rust~~ RustRover.
This project covers:
- `probe-rs` flashing and `defmt` logging.
- Driving the user LEDs via a Timer interrupt.
- Querying the LSM303DLHC MEMS IMU via IĀ²C (via [`lsm303dlhc-ng`](https://github.com/sunsided/lsm303dlhc)
and [`lsm303dlhc-registers`](https://github.com/sunsided/lsm303dlhc-registers)).
- Observing the magnetometer's `DRDY` with an `EXTI2_TSC` interrupt.
- Observing the accelerometer's `I1DRDY1` with an `EXTI4` interrupt.
- Querying the L3GD20 MEMS gyroscope via SPI ([`l3gd20-registers`](https://github.com/sunsided/l3gd20-registers)).
- Observing the gyro's `DRDY` with an `EXTI1` interrupt.
- Temperature readings of the sensors are queried at 1Hz as measured by a 1ms `SysTick` interrupt.
- Operating a USB CDC serial port for communication.
- Uses [serial-sensors-proto](https://github.com/sunsided/serial-sensors-proto) to serialize and byte-stuff
the sensor readings and hands them over to [serial-sensors](https://github.com/sunsided/serial-sensors)
for further shenanigans.
Led ring shenanigans:
- The accelerometer is used to have the downwards facing LED light up.
- The magnetometer is used to determine a heading. If the device is pointed away from north,
the light wheel will turn in the appropriate direction. If the device faces north,
the lights will flash.
## Bin features
The sensors are set up to provide data at up to 400 Hz, which can make debugging complicated.
To slow things down, enter `slowpoke` mode:
```shell
cargo run --features=slowpoke
```
## Sensor orientation
The onboard LSM303DLHC's accelerometer sensor seems to be oriented in a left-handed coordinate system:
- X points forward (towards the USB connectors)
- When pointing the USB ports downwards, the sensors reads a positive maximum on the
X axis.
- When pointing the opposite end downwards, the sensor reads a negative maximum on the X axis.
- Y points left
- When pointing the left side downwards, the sensor reads a positive maximum on the Y axis.
- Z points down
- When pointing the bottom side downwards, the sensor reads a positive maximum on the Z axis.
The magnetometer on the other hand - pun not intended - appears to use a right-handed coordinate system :
- X points backward (towards the LEDs)
- When pointing the USB ports towards the earth's magnetic field vector, the sensors reads a negative maximum on the
X axis.
- When pointing the opposite end towards the vector, the sensor reads a positive maximum on the X axis.
- Y points right
- When pointing the right side towards the vector, the sensor reads a positive maximum on the Y axis.
- Z points up
- When pointing the top side towards the vector, the sensor reads a positive maximum on the Z axis.
| Accelerometer | Magnetometer | Gyroscope |
|----------------------------------------------------------|--------------------------------------------------------|------------------------------------|
|  |  |  |
## Flashing & Running
Easy.
```shell
DEFMT_LOG=info cargo run
````
## Requirements
### Target
This project uses the `thumbv7em-none-eabihf` target. Prepare it using:
```shell
rustup target add thumbv7em-none-eabihf
```
### flip-link
Set up [flip-link](https://github.com/knurling-rs/flip-link):
> Adds zero-cost stack overflow protection to your embedded programs.
### probe-rs
Set up [probe-rs](https://probe.rs/), and follow the setup instructions (e.g.
the [Linux udev rules](https://probe.rs/docs/getting-started/probe-setup/#linux%3A-udev-rules)).
---
## Troubleshooting
### Outdated firmware
My STM32F3 Discovery had an outdated version of the ST-Link firmware, and probe-rs refused to work with it:
> probe-rs failed to open the debug probe
> Error processing command: The firmware on the probe is outdated.
Go
to [ST-LINK, ST-LINK/V2, ST-LINK/V2-1, STLINK-V3 boards firmware upgrade](https://www.st.com/en/development-tools/stsw-link007.html)
and download the latest version. Unzip, run the application and follow the instructions.
```shell
java -jar STLinkUpgrade.jar
```
## Invalid SRAM size definition
> Error: The flashing procedure failed for 'target/thumbv7em-none-eabihf/debug/stm32f3disco-led-roulette'.
>
> Caused by:
> 0: Failed to erase flash sector at address 0x08000000.
> 1: Something during the interaction with the core went wrong
> 2: A timeout occurred.
From [this GitHub comment](https://github.com/probe-rs/probe-rs/issues/2496#issuecomment-2154359915):
> The problem is that the chip has 40KB of main SRAM, but the chip definition says 48KB,
> and we try to place the flash loader's stack at the end of that 48KB region.
I went the hard way and installed `probe-rs` from sources:
```shell
cargo install probe-rs-tools --git https://github.com/probe-rs/probe-rs --locked
```