https://github.com/rubberduck203/stm32f3-discovery-quickstart
Template to develop bare metal Rust applications for STM32F3DISCOVERY board
https://github.com/rubberduck203/stm32f3-discovery-quickstart
cargo-template cortex-m4 no-std rust
Last synced: 5 months ago
JSON representation
Template to develop bare metal Rust applications for STM32F3DISCOVERY board
- Host: GitHub
- URL: https://github.com/rubberduck203/stm32f3-discovery-quickstart
- Owner: rubberduck203
- License: apache-2.0
- Created: 2020-01-01T14:19:27.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2021-06-16T11:38:59.000Z (over 4 years ago)
- Last Synced: 2025-03-31T00:41:18.315Z (6 months ago)
- Topics: cargo-template, cortex-m4, no-std, rust
- Language: Rust
- Size: 202 KB
- Stars: 12
- Watchers: 3
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# `stm32f3-discovery-quickstart`
Template to develop bare metal Rust applications for the [STM32F3DISCOVERY][stm32f3discovery] board.
Utilizes the [stm32f3-discovery board support crate](https://crates.io/crates/stm32f3-discovery).
## Dependencies
To build embedded programs using this template you'll need:
- Rust 1.31 or a newer toolchain.
- The `cargo generate` subcommand. [Installation
instructions][cargo-generate-install].
- `rust-std` components (pre-compiled `core` crate) for the ARM Cortex-M
target.
``` console
$ cargo install cargo-generate
$ rustup target add thumbv7em-none-eabihf
```
## Using this template
**NOTE**: This is the very short version that only covers building programs. For
the long version, which additionally covers flashing, running and debugging
programs, check [the embedded Rust book][book] and [the Discover book][discovery-book].
``` console
$ cargo generate --git https://github.com/rubberduck203/stm32f3-discovery-quickstart
Project Name: app
Creating project called `app`...
Done! New project created /tmp/app
$ cd app
$ cargo build
```
## Examples
For examples, see the [examples directory of the stm32f3-discovery repository](https://github.com/rubberduck203/stm32f3-discovery/tree/master/examples).
## VS Code
This template includes launch configurations for debugging CortexM programs with Visual Studio Code located in the `.vscode/` directory.
See [.vscode/README.md](./.vscode/README.md) for more information.
If you're not using VS Code, you can safely delete the directory from the generated project.
# License
This template is licensed under either of
- Apache License, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (http://opensource.org/licenses/MIT)
at your option.
## Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.
## Attributions
This project is based on and forked from the [cortex-m-quickstart][cortex-m-quickstart] project.
[stm32f3discovery]: https://www.st.com/en/evaluation-tools/stm32f3discovery.html#
[cortex-m-quickstart]: https://github.com/rust-embedded/cortex-m-quickstart
[book]: https://rust-embedded.github.io/book
[discovery-book]: https://rust-embedded.github.io/discovery/
[cargo-generate-install]: https://github.com/ashleygwilliams/cargo-generate#installation