Compare commits
1 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
7b193786d6 |
@@ -1,38 +1,31 @@
|
||||
[target.'cfg(all(target_arch = "arm", target_os = "none"))']
|
||||
# runner = 'arm-none-eabi-gdb -x debug.gdb'
|
||||
[target.thumbv6m-none-eabi]
|
||||
runner = 'arm-none-eabi-gdb'
|
||||
rustflags = [
|
||||
# LLD (shipped with the Rust toolchain) is used as the default linker
|
||||
"-C", "link-arg=-Tlink.x",
|
||||
|
||||
# if you run into problems with LLD switch to the GNU linker by commenting out
|
||||
# this line
|
||||
# "-C", "linker=arm-none-eabi-ld",
|
||||
|
||||
# if you need to link to pre-compiled C libraries provided by a C toolchain
|
||||
# use GCC as the linker by commenting out both lines above and then
|
||||
# uncommenting the three lines below
|
||||
# "-C", "linker=arm-none-eabi-gcc",
|
||||
# "-C", "link-arg=-Wl,-Tlink.x",
|
||||
# "-C", "link-arg=-nostartfiles",
|
||||
"-C", "linker=arm-none-eabi-ld",
|
||||
"-Z", "linker-flavor=ld",
|
||||
]
|
||||
|
||||
# work around rust-lang/cargo#5946
|
||||
[target.thumbv6m-none-eabi]
|
||||
runner = 'arm-none-eabi-gdb -x debug.gdb'
|
||||
|
||||
[target.thumbv7m-none-eabi]
|
||||
runner = 'arm-none-eabi-gdb -x debug.gdb'
|
||||
runner = 'arm-none-eabi-gdb'
|
||||
rustflags = [
|
||||
"-C", "link-arg=-Tlink.x",
|
||||
"-C", "linker=arm-none-eabi-ld",
|
||||
"-Z", "linker-flavor=ld",
|
||||
]
|
||||
|
||||
[target.thumbv7em-none-eabi]
|
||||
runner = 'arm-none-eabi-gdb -x debug.gdb'
|
||||
runner = 'arm-none-eabi-gdb'
|
||||
rustflags = [
|
||||
"-C", "link-arg=-Tlink.x",
|
||||
"-C", "linker=arm-none-eabi-ld",
|
||||
"-Z", "linker-flavor=ld",
|
||||
]
|
||||
|
||||
[target.thumbv7em-none-eabihf]
|
||||
runner = 'arm-none-eabi-gdb -x debug.gdb'
|
||||
# end of workaround
|
||||
|
||||
[build]
|
||||
# Pick one of these compilation targets
|
||||
# target = "thumbv6m-none-eabi" # Cortex-M0 and Cortex-M0+
|
||||
# target = "thumbv7m-none-eabi" # Cortex-M3
|
||||
# target = "thumbv7em-none-eabi" # Cortex-M4 and Cortex-M7 (no FPU)
|
||||
# target = "thumbv7em-none-eabihf" # Cortex-M4F and Cortex-M7F (with FPU)
|
||||
runner = 'arm-none-eabi-gdb'
|
||||
rustflags = [
|
||||
"-C", "link-arg=-Tlink.x",
|
||||
"-C", "linker=arm-none-eabi-ld",
|
||||
"-Z", "linker-flavor=ld",
|
||||
]
|
||||
|
||||
@@ -1,8 +1,5 @@
|
||||
target remote :3333
|
||||
|
||||
# print demangled symbols by default
|
||||
set print asm-demangle on
|
||||
|
||||
monitor arm semihosting enable
|
||||
|
||||
# # send captured ITM to the file itm.fifo
|
||||
1
.github/CODEOWNERS
vendored
1
.github/CODEOWNERS
vendored
@@ -1 +0,0 @@
|
||||
* @rust-embedded/cortex-m
|
||||
4
.github/bors.toml
vendored
4
.github/bors.toml
vendored
@@ -1,4 +0,0 @@
|
||||
block_labels = ["needs-decision"]
|
||||
delete_merged_branches = true
|
||||
required_approvals = 1
|
||||
status = ["continuous-integration/travis-ci/push"]
|
||||
1
.gitignore
vendored
1
.gitignore
vendored
@@ -1,5 +1,4 @@
|
||||
**/*.rs.bk
|
||||
.#*
|
||||
.gdb_history
|
||||
Cargo.lock
|
||||
target/
|
||||
|
||||
52
.travis.yml
52
.travis.yml
@@ -1,52 +0,0 @@
|
||||
language: rust
|
||||
|
||||
matrix:
|
||||
include:
|
||||
- env: TARGET=x86_64-unknown-linux-gnu
|
||||
rust: nightly
|
||||
if: branch = master AND type != pull_request
|
||||
|
||||
- env: TARGET=thumbv6m-none-eabi
|
||||
rust: nightly
|
||||
if: (branch = staging OR branch = trying) OR (type = pull_request AND branch = master)
|
||||
|
||||
- env: TARGET=thumbv7m-none-eabi
|
||||
rust: nightly
|
||||
if: (branch = staging OR branch = trying) OR (type = pull_request AND branch = master)
|
||||
|
||||
- env: TARGET=thumbv7em-none-eabi
|
||||
rust: nightly
|
||||
if: (branch = staging OR branch = trying) OR (type = pull_request AND branch = master)
|
||||
|
||||
- env: TARGET=thumbv7em-none-eabihf
|
||||
rust: nightly
|
||||
if: (branch = staging OR branch = trying) OR (type = pull_request AND branch = master)
|
||||
|
||||
before_install: set -e
|
||||
|
||||
install:
|
||||
- bash ci/install.sh
|
||||
|
||||
script:
|
||||
- bash ci/script.sh
|
||||
|
||||
after_success:
|
||||
- bash ci/after-success.sh
|
||||
|
||||
after_script: set +e
|
||||
|
||||
cache: cargo
|
||||
|
||||
before_cache:
|
||||
# Travis can't cache files that are not readable by "others"
|
||||
- chmod -R a+r $HOME/.cargo
|
||||
|
||||
branches:
|
||||
only:
|
||||
- master
|
||||
- staging
|
||||
- trying
|
||||
|
||||
notifications:
|
||||
email:
|
||||
on_success: never
|
||||
153
CHANGELOG.md
153
CHANGELOG.md
@@ -5,128 +5,6 @@ This project adheres to [Semantic Versioning](http://semver.org/).
|
||||
|
||||
## [Unreleased]
|
||||
|
||||
## [v0.3.4] - 2018-08-27
|
||||
|
||||
### Changed
|
||||
|
||||
- LLD is now used as the default linker.
|
||||
- Updated the troubleshooting guide to reflect the change in the default linker.
|
||||
- Simplified the minimal example.
|
||||
- The examples in this template no longer require `arm-none-eabi-gcc` to build.
|
||||
|
||||
## [v0.3.3] - 2018-08-07
|
||||
|
||||
### Changed
|
||||
|
||||
- Stopped recommending LLD as it requires an unstable feature.
|
||||
|
||||
### Fixed
|
||||
|
||||
- The allocator example. It now uses the `#[alloc_error_handler]` attribute
|
||||
instead of the unstable `oom` lang item.
|
||||
|
||||
## [v0.3.2] - 2018-06-19
|
||||
|
||||
### Fixed
|
||||
|
||||
- Bumped the panic-semihosting dependency to fix some examples when compiling with latest nightly.
|
||||
|
||||
## [v0.3.1] - 2018-05-13
|
||||
|
||||
- Document the standard `main` interface issue in the troubleshooting guide.
|
||||
|
||||
## [v0.3.0] - 2018-05-12
|
||||
|
||||
### Changed
|
||||
|
||||
- [breaking-change] `arm-none-eabi-gcc` is now a mandatory dependency as it's required by the
|
||||
`cortex-m-rt` dependency and also the default linker.
|
||||
|
||||
- Bumped the `cortex-m` and `cortex-m-rt` dependencies to v0.5.0. Updated all the examples to match
|
||||
the new `cortex-m-rt` API.
|
||||
|
||||
- Updated the `allocator` example to compile on a recent nightly.
|
||||
|
||||
- Set the number of codegen-units to 1 when compiling in release mode. This produces smaller and
|
||||
faster binaries.
|
||||
|
||||
### Removed
|
||||
|
||||
- Removed `opt-level = "s"` from `profile.release`. This flag is still unstable.
|
||||
|
||||
## [v0.2.7] - 2018-04-24
|
||||
|
||||
### Changed
|
||||
|
||||
- Bumped the dependency of `cortex-m-rt` to v0.4.0.
|
||||
|
||||
## [v0.2.6] - 2018-04-09
|
||||
|
||||
### Changed
|
||||
|
||||
- The documentation to instruct the user to use Cargo instead of Xargo
|
||||
|
||||
## [v0.2.5] - 2018-02-26
|
||||
|
||||
### Added
|
||||
|
||||
- Comments to Cargo.toml and Xargo.toml to make it easier to try the examples.
|
||||
|
||||
### Fixed
|
||||
|
||||
- The `allocator` example to use the `#[global_allocator]` feature.
|
||||
|
||||
## [v0.2.4] - 2018-01-26
|
||||
|
||||
### Changed
|
||||
|
||||
- Disable ThinLTO which causes extreme binary size bloat. See rust-lang/rust#47770 for details.
|
||||
|
||||
## [v0.2.3] - 2018-01-20
|
||||
|
||||
### Changed
|
||||
|
||||
- Tweaked docs. Instruction steps are now numbered.
|
||||
|
||||
### Removed
|
||||
|
||||
- The `CARGO_INCREMENTAL=1` workaround has been removed since it's now controlled via Cargo.toml and
|
||||
we have the setting disabled in the template.
|
||||
|
||||
## [v0.2.2] - 2018-01-17
|
||||
|
||||
### Added
|
||||
|
||||
- Troubleshooting documentation: how to workaround the "Ignoring packet error, continuing..." GDB
|
||||
error.
|
||||
|
||||
### Changed
|
||||
|
||||
- Disabled incremental compilation and parallel codegen on the dev profile to reduce the changes of
|
||||
running into rust-lang/rust#47074.
|
||||
|
||||
- Bumped the version of the `cortex-m-rt` dependency to v0.3.12.
|
||||
|
||||
## [v0.2.1] - 2017-07-14
|
||||
|
||||
### Added
|
||||
|
||||
- Troubleshooting documentation: how to fix the error of overwriting the
|
||||
`.cargo/config` file when you meant to append text to it.
|
||||
|
||||
### Changed
|
||||
|
||||
- Xargo.toml: Changed the source of the `compiler-builtins` crate from git to
|
||||
the `rust-src` component.
|
||||
|
||||
- Expanded the `device` example to do some I/O.
|
||||
|
||||
## [v0.2.0] - 2017-07-07
|
||||
|
||||
### Changed
|
||||
|
||||
- [breaking-change] Bumped the cortex-m and cortex-m-rt versions to v0.3.0.
|
||||
|
||||
## [v0.1.8] - 2017-05-30
|
||||
|
||||
### Changed
|
||||
@@ -198,25 +76,12 @@ This project adheres to [Semantic Versioning](http://semver.org/).
|
||||
|
||||
- Initial release
|
||||
|
||||
[Unreleased]: https://github.com/rust-embedded/cortex-m-quickstart/compare/v0.3.4...HEAD
|
||||
[v0.3.4]: https://github.com/rust-embedded/cortex-m-quickstart/compare/v0.3.3...v0.3.4
|
||||
[v0.3.3]: https://github.com/rust-embedded/cortex-m-quickstart/compare/v0.3.2...v0.3.3
|
||||
[v0.3.2]: https://github.com/rust-embedded/cortex-m-quickstart/compare/v0.3.1...v0.3.2
|
||||
[v0.3.1]: https://github.com/rust-embedded/cortex-m-quickstart/compare/v0.3.0...v0.3.1
|
||||
[v0.3.0]: https://github.com/rust-embedded/cortex-m-quickstart/compare/v0.2.7...v0.3.0
|
||||
[v0.2.7]: https://github.com/rust-embedded/cortex-m-quickstart/compare/v0.2.6...v0.2.7
|
||||
[v0.2.6]: https://github.com/rust-embedded/cortex-m-quickstart/compare/v0.2.5...v0.2.6
|
||||
[v0.2.5]: https://github.com/rust-embedded/cortex-m-quickstart/compare/v0.2.4...v0.2.5
|
||||
[v0.2.4]: https://github.com/rust-embedded/cortex-m-quickstart/compare/v0.2.3...v0.2.4
|
||||
[v0.2.3]: https://github.com/rust-embedded/cortex-m-quickstart/compare/v0.2.2...v0.2.3
|
||||
[v0.2.2]: https://github.com/rust-embedded/cortex-m-quickstart/compare/v0.2.1...v0.2.2
|
||||
[v0.2.1]: https://github.com/rust-embedded/cortex-m-quickstart/compare/v0.2.0...v0.2.1
|
||||
[v0.2.0]: https://github.com/rust-embedded/cortex-m-quickstart/compare/v0.1.8...v0.2.0
|
||||
[v0.1.8]: https://github.com/rust-embedded/cortex-m-quickstart/compare/v0.1.7...v0.1.8
|
||||
[v0.1.7]: https://github.com/rust-embedded/cortex-m-quickstart/compare/v0.1.6...v0.1.7
|
||||
[v0.1.6]: https://github.com/rust-embedded/cortex-m-quickstart/compare/v0.1.5...v0.1.6
|
||||
[v0.1.5]: https://github.com/rust-embedded/cortex-m-quickstart/compare/v0.1.4...v0.1.5
|
||||
[v0.1.4]: https://github.com/rust-embedded/cortex-m-quickstart/compare/v0.1.3...v0.1.4
|
||||
[v0.1.3]: https://github.com/rust-embedded/cortex-m-quickstart/compare/v0.1.2...v0.1.3
|
||||
[v0.1.2]: https://github.com/rust-embedded/cortex-m-quickstart/compare/v0.1.1...v0.1.2
|
||||
[v0.1.1]: https://github.com/rust-embedded/cortex-m-quickstart/compare/v0.1.0...v0.1.1
|
||||
[Unreleased]: https://github.com/japaric/cortex-m-quickstart/compare/v0.1.8...HEAD
|
||||
[v0.1.8]: https://github.com/japaric/cortex-m-quickstart/compare/v0.1.7...v0.1.8
|
||||
[v0.1.7]: https://github.com/japaric/cortex-m-quickstart/compare/v0.1.6...v0.1.7
|
||||
[v0.1.6]: https://github.com/japaric/cortex-m-quickstart/compare/v0.1.5...v0.1.6
|
||||
[v0.1.5]: https://github.com/japaric/cortex-m-quickstart/compare/v0.1.4...v0.1.5
|
||||
[v0.1.4]: https://github.com/japaric/cortex-m-quickstart/compare/v0.1.3...v0.1.4
|
||||
[v0.1.3]: https://github.com/japaric/cortex-m-quickstart/compare/v0.1.2...v0.1.3
|
||||
[v0.1.2]: https://github.com/japaric/cortex-m-quickstart/compare/v0.1.1...v0.1.2
|
||||
[v0.1.1]: https://github.com/japaric/cortex-m-quickstart/compare/v0.1.0...v0.1.1
|
||||
|
||||
@@ -1,37 +0,0 @@
|
||||
# The Rust Code of Conduct
|
||||
|
||||
## Conduct
|
||||
|
||||
**Contact**: [Cortex-M team](https://github.com/rust-embedded/wg#the-cortex-m-team)
|
||||
|
||||
* We are committed to providing a friendly, safe and welcoming environment for all, regardless of level of experience, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, religion, nationality, or other similar characteristic.
|
||||
* On IRC, please avoid using overtly sexual nicknames or other nicknames that might detract from a friendly, safe and welcoming environment for all.
|
||||
* Please be kind and courteous. There's no need to be mean or rude.
|
||||
* Respect that people have differences of opinion and that every design or implementation choice carries a trade-off and numerous costs. There is seldom a right answer.
|
||||
* Please keep unstructured critique to a minimum. If you have solid ideas you want to experiment with, make a fork and see how it works.
|
||||
* We will exclude you from interaction if you insult, demean or harass anyone. That is not welcome behavior. We interpret the term "harassment" as including the definition in the [Citizen Code of Conduct](http://citizencodeofconduct.org/); if you have any lack of clarity about what might be included in that concept, please read their definition. In particular, we don't tolerate behavior that excludes people in socially marginalized groups.
|
||||
* Private harassment is also unacceptable. No matter who you are, if you feel you have been or are being harassed or made uncomfortable by a community member, please contact one of the channel ops or any of the [Cortex-M team][team] immediately. Whether you're a regular contributor or a newcomer, we care about making this community a safe place for you and we've got your back.
|
||||
* Likewise any spamming, trolling, flaming, baiting or other attention-stealing behavior is not welcome.
|
||||
|
||||
## Moderation
|
||||
|
||||
These are the policies for upholding our community's standards of conduct.
|
||||
|
||||
1. Remarks that violate the Rust standards of conduct, including hateful, hurtful, oppressive, or exclusionary remarks, are not allowed. (Cursing is allowed, but never targeting another user, and never in a hateful manner.)
|
||||
2. Remarks that moderators find inappropriate, whether listed in the code of conduct or not, are also not allowed.
|
||||
3. Moderators will first respond to such remarks with a warning.
|
||||
4. If the warning is unheeded, the user will be "kicked," i.e., kicked out of the communication channel to cool off.
|
||||
5. If the user comes back and continues to make trouble, they will be banned, i.e., indefinitely excluded.
|
||||
6. Moderators may choose at their discretion to un-ban the user if it was a first offense and they offer the offended party a genuine apology.
|
||||
7. If a moderator bans someone and you think it was unjustified, please take it up with that moderator, or with a different moderator, **in private**. Complaints about bans in-channel are not allowed.
|
||||
8. Moderators are held to a higher standard than other community members. If a moderator creates an inappropriate situation, they should expect less leeway than others.
|
||||
|
||||
In the Rust community we strive to go the extra step to look out for each other. Don't just aim to be technically unimpeachable, try to be your best self. In particular, avoid flirting with offensive or sensitive issues, particularly if they're off-topic; this all too often leads to unnecessary fights, hurt feelings, and damaged trust; worse, it can drive people away from the community entirely.
|
||||
|
||||
And if someone takes issue with something you said or did, resist the urge to be defensive. Just stop doing what it was they complained about and apologize. Even if you feel you were misinterpreted or unfairly accused, chances are good there was something you could've communicated better — remember that it's your responsibility to make your fellow Rustaceans comfortable. Everyone wants to get along and we are all here first and foremost because we want to talk about cool technology. You will find that people will be eager to assume good intent and forgive as long as you earn their trust.
|
||||
|
||||
The enforcement policies listed above apply to all official embedded WG venues; including official IRC channels (#rust-embedded); GitHub repositories under rust-embedded; and all forums under rust-embedded.org (forum.rust-embedded.org).
|
||||
|
||||
*Adapted from the [Node.js Policy on Trolling](http://blog.izs.me/post/30036893703/policy-on-trolling) as well as the [Contributor Covenant v1.3.0](https://www.contributor-covenant.org/version/1/3/0/).*
|
||||
|
||||
[team]: https://github.com/rust-embedded/wg#the-cortex-m-team
|
||||
24
Cargo.toml
24
Cargo.toml
@@ -2,31 +2,19 @@
|
||||
authors = ["Jorge Aparicio <jorge@japaric.io>"]
|
||||
categories = ["embedded", "no-std"]
|
||||
description = "A template for building applications for ARM Cortex-M microcontrollers"
|
||||
documentation = "https://rust-embedded.github.io/cortex-m-quickstart/cortex_m_quickstart"
|
||||
keywords = ["arm", "cortex-m", "template"]
|
||||
license = "MIT OR Apache-2.0"
|
||||
name = "cortex-m-quickstart"
|
||||
repository = "https://github.com/japaric/cortex-m-quickstart"
|
||||
version = "0.3.4"
|
||||
version = "0.1.9"
|
||||
|
||||
[dependencies]
|
||||
cortex-m = "0.5.6"
|
||||
cortex-m-rt = "0.5.3"
|
||||
cortex-m-semihosting = "0.3.1"
|
||||
panic-semihosting = "0.4.0"
|
||||
cortex-m = "0.2.7"
|
||||
cortex-m-rt = "0.2.3"
|
||||
|
||||
# Uncomment for the panic example.
|
||||
# panic-itm = "0.3.0"
|
||||
|
||||
# Uncomment for the allocator example.
|
||||
# alloc-cortex-m = "0.3.5"
|
||||
|
||||
# Uncomment for the device example.
|
||||
# [dependencies.stm32f103xx]
|
||||
# features = ["rt"]
|
||||
# version = "0.10.0"
|
||||
[profile.dev]
|
||||
codegen-units = 1
|
||||
|
||||
[profile.release]
|
||||
codegen-units = 1 # better optimizations
|
||||
lto = true
|
||||
debug = true
|
||||
lto = true # better optimizations
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
Copyright (c) 2018
|
||||
Copyright (c) 2017 {{toml-escape author}}
|
||||
|
||||
Permission is hereby granted, free of charge, to any
|
||||
person obtaining a copy of this software and associated
|
||||
|
||||
13
README.md
13
README.md
@@ -2,9 +2,7 @@
|
||||
|
||||
> A template for building applications for ARM Cortex-M microcontrollers
|
||||
|
||||
This project is developed and maintained by the [Cortex-M team][team].
|
||||
|
||||
# [Documentation](https://rust-embedded.github.io/cortex-m-quickstart/cortex_m_quickstart)
|
||||
# [Documentation](https://docs.rs/cortex-m-quickstart)
|
||||
|
||||
# License
|
||||
|
||||
@@ -22,12 +20,3 @@ at your option.
|
||||
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.
|
||||
|
||||
## Code of Conduct
|
||||
|
||||
Contribution to this crate is organized under the terms of the [Rust Code of
|
||||
Conduct][CoC], the maintainer of this crate, the [Cortex-M team][team], promises
|
||||
to intervene to uphold that code of conduct.
|
||||
|
||||
[CoC]: CODE_OF_CONDUCT.md
|
||||
[team]: https://github.com/rust-embedded/wg#the-cortex-m-team
|
||||
|
||||
6
Xargo.toml
Normal file
6
Xargo.toml
Normal file
@@ -0,0 +1,6 @@
|
||||
[dependencies.core]
|
||||
|
||||
[dependencies.compiler_builtins]
|
||||
features = ["mem"]
|
||||
git = "https://github.com/rust-lang-nursery/compiler-builtins"
|
||||
stage = 1
|
||||
3
build.rs
3
build.rs
@@ -12,7 +12,6 @@ fn main() {
|
||||
.unwrap();
|
||||
println!("cargo:rustc-link-search={}", out.display());
|
||||
|
||||
// Only re-run the build script when memory.x is changed,
|
||||
// instead of when any part of the source code changes.
|
||||
println!("cargo:rerun-if-changed=build.rs");
|
||||
println!("cargo:rerun-if-changed=memory.x");
|
||||
}
|
||||
|
||||
@@ -1,20 +0,0 @@
|
||||
set -euxo pipefail
|
||||
|
||||
main() {
|
||||
cargo doc
|
||||
|
||||
mkdir ghp-import
|
||||
|
||||
curl -Ls https://github.com/davisp/ghp-import/archive/master.tar.gz |
|
||||
tar --strip-components 1 -C ghp-import -xz
|
||||
|
||||
./ghp-import/ghp_import.py target/doc
|
||||
|
||||
set +x
|
||||
git push -fq https://$GH_TOKEN@github.com/$TRAVIS_REPO_SLUG.git gh-pages && echo OK
|
||||
}
|
||||
|
||||
# only publish on successful merges to master
|
||||
if [ $TRAVIS_BRANCH = master ] && [ $TRAVIS_PULL_REQUEST = false ] && [ $TARGET = x86_64-unknown-linux-gnu ]; then
|
||||
main
|
||||
fi
|
||||
@@ -1,9 +0,0 @@
|
||||
set -euxo pipefail
|
||||
|
||||
main() {
|
||||
if [ $TARGET != x86_64-unknown-linux-gnu ]; then
|
||||
rustup target add $TARGET
|
||||
fi
|
||||
}
|
||||
|
||||
main
|
||||
72
ci/script.sh
72
ci/script.sh
@@ -1,72 +0,0 @@
|
||||
set -euxo pipefail
|
||||
|
||||
main() {
|
||||
local td=$(mktemp -d)
|
||||
|
||||
git clone . $td
|
||||
pushd $td
|
||||
|
||||
cat >memory.x <<'EOF'
|
||||
MEMORY
|
||||
{
|
||||
FLASH : ORIGIN = 0x08000000, LENGTH = 256K
|
||||
RAM : ORIGIN = 0x20000000, LENGTH = 40K
|
||||
}
|
||||
EOF
|
||||
|
||||
local examples=(
|
||||
crash
|
||||
exception
|
||||
hello
|
||||
minimal
|
||||
panic
|
||||
)
|
||||
for ex in "${examples[@]}"; do
|
||||
cargo build --target $TARGET --example $ex
|
||||
cargo build --target $TARGET --example $ex --release
|
||||
done
|
||||
|
||||
# ITM is not available on Cortex-M0
|
||||
if [ $TARGET != thumbv6m-none-eabi ]; then
|
||||
local ex=itm
|
||||
cargo build --target $TARGET --example $ex
|
||||
cargo build --target $TARGET --example $ex --release
|
||||
|
||||
examples+=( $ex )
|
||||
fi
|
||||
|
||||
# Allocator example needs an extra dependency
|
||||
cat >>Cargo.toml <<'EOF'
|
||||
[dependencies.alloc-cortex-m]
|
||||
version = "0.3.4"
|
||||
EOF
|
||||
|
||||
local ex=allocator
|
||||
cargo build --target $TARGET --example $ex --release
|
||||
|
||||
examples+=( $ex )
|
||||
|
||||
# Device example needs an extra dependency
|
||||
if [ $TARGET = thumbv7m-none-eabi ]; then
|
||||
cat >>Cargo.toml <<'EOF'
|
||||
[dependencies.stm32f103xx]
|
||||
features = ["rt"]
|
||||
version = "0.10.0"
|
||||
EOF
|
||||
|
||||
local ex=device
|
||||
cargo build --target $TARGET --example $ex
|
||||
cargo build --target $TARGET --example $ex --release
|
||||
|
||||
examples+=( $ex )
|
||||
fi
|
||||
|
||||
IFS=,;eval size target/$TARGET/release/examples/"{${examples[*]}}"
|
||||
|
||||
popd
|
||||
rm -rf $td
|
||||
}
|
||||
|
||||
if [ $TARGET != x86_64-unknown-linux-gnu ]; then
|
||||
main
|
||||
fi
|
||||
@@ -1,76 +1,71 @@
|
||||
//! How to use the heap and a dynamic memory allocator
|
||||
//!
|
||||
//! This example depends on the alloc-cortex-m crate so you'll have to add it to your Cargo.toml:
|
||||
//! To compile this example you'll need to build the collections crate as part
|
||||
//! of the Xargo sysroot. To do that change the Xargo.toml file to look like
|
||||
//! this:
|
||||
//!
|
||||
//! ``` text
|
||||
//! [dependencies.core]
|
||||
//! [dependencies.collections] # new
|
||||
//!
|
||||
//! [dependencies.compiler_builtins]
|
||||
//! features = ["mem"]
|
||||
//! git = "https://github.com/rust-lang-nursery/compiler-builtins"
|
||||
//! stage = 1
|
||||
//! ```
|
||||
//!
|
||||
//! This example depends on the alloc-cortex-m crate so you'll have to add it
|
||||
//! to your Cargo.toml:
|
||||
//!
|
||||
//! ``` text
|
||||
//! # or edit the Cargo.toml file manually
|
||||
//! $ cargo add alloc-cortex-m
|
||||
//! ```
|
||||
//!
|
||||
//! ---
|
||||
|
||||
#![feature(alloc)]
|
||||
#![feature(alloc_error_handler)]
|
||||
#![feature(lang_items)]
|
||||
#![no_main]
|
||||
#![feature(collections)]
|
||||
#![feature(used)]
|
||||
#![no_std]
|
||||
|
||||
// This is the allocator crate; you can use a different one
|
||||
extern crate alloc_cortex_m;
|
||||
#[macro_use]
|
||||
extern crate alloc;
|
||||
extern crate cortex_m;
|
||||
extern crate collections;
|
||||
#[macro_use]
|
||||
extern crate cortex_m_rt as rt;
|
||||
extern crate cortex_m_semihosting as sh;
|
||||
extern crate panic_semihosting;
|
||||
extern crate cortex_m;
|
||||
extern crate cortex_m_rt;
|
||||
|
||||
use core::alloc::Layout;
|
||||
use core::fmt::Write;
|
||||
|
||||
use alloc_cortex_m::CortexMHeap;
|
||||
use cortex_m::asm;
|
||||
use rt::ExceptionFrame;
|
||||
use sh::hio;
|
||||
|
||||
// this is the allocator the application will use
|
||||
#[global_allocator]
|
||||
static ALLOCATOR: CortexMHeap = CortexMHeap::empty();
|
||||
fn main() {
|
||||
// Initialize the allocator
|
||||
unsafe {
|
||||
extern "C" {
|
||||
// Start of the heap
|
||||
static mut _sheap: usize;
|
||||
}
|
||||
|
||||
const HEAP_SIZE: usize = 1024; // in bytes
|
||||
// Size of the heap in words (1 word = 4 bytes)
|
||||
// WARNING: The bigger the heap the greater the chance to run into a
|
||||
// stack overflow (collision between the stack and the heap)
|
||||
const SIZE: isize = 256;
|
||||
|
||||
entry!(main);
|
||||
// End of the heap
|
||||
let _eheap = (&mut _sheap as *mut _).offset(SIZE);
|
||||
|
||||
fn main() -> ! {
|
||||
// Initialize the allocator BEFORE you use it
|
||||
unsafe { ALLOCATOR.init(rt::heap_start() as usize, HEAP_SIZE) }
|
||||
alloc_cortex_m::init(&mut _sheap as *mut _, _eheap);
|
||||
}
|
||||
|
||||
// Growable array allocated on the heap
|
||||
let xs = vec![0, 1, 2];
|
||||
|
||||
let mut stdout = hio::hstdout().unwrap();
|
||||
writeln!(stdout, "{:?}", xs).unwrap();
|
||||
|
||||
loop {}
|
||||
hprintln!("{:?}", xs);
|
||||
}
|
||||
|
||||
// define what happens in an Out Of Memory (OOM) condition
|
||||
#[alloc_error_handler]
|
||||
#[no_mangle]
|
||||
pub fn alloc_error(_layout: Layout) -> ! {
|
||||
// As we are not using interrupts, we just register a dummy catch all handler
|
||||
#[allow(dead_code)]
|
||||
#[used]
|
||||
#[link_section = ".rodata.interrupts"]
|
||||
static INTERRUPTS: [extern "C" fn(); 240] = [default_handler; 240];
|
||||
|
||||
extern "C" fn default_handler() {
|
||||
asm::bkpt();
|
||||
|
||||
loop {}
|
||||
}
|
||||
|
||||
exception!(HardFault, hard_fault);
|
||||
|
||||
fn hard_fault(ef: &ExceptionFrame) -> ! {
|
||||
panic!("HardFault at {:#?}", ef);
|
||||
}
|
||||
|
||||
exception!(*, default_handler);
|
||||
|
||||
fn default_handler(irqn: i16) {
|
||||
panic!("Unhandled exception (IRQn = {})", irqn);
|
||||
}
|
||||
|
||||
@@ -1,114 +1,58 @@
|
||||
//! Debugging a crash (exception)
|
||||
//!
|
||||
//! Most crash conditions trigger a hard fault exception, whose handler is defined via
|
||||
//! `exception!(HardFault, ..)`. The `HardFault` handler has access to the exception frame, a
|
||||
//! snapshot of the CPU registers at the moment of the exception.
|
||||
//! The `cortex-m-rt` crate provides functionality for this through a default
|
||||
//! exception handler. When an exception is hit, the default handler will
|
||||
//! trigger a breakpoint and in this debugging context the stacked registers
|
||||
//! are accessible.
|
||||
//!
|
||||
//! This program crashes and the `HardFault` handler prints to the console the contents of the
|
||||
//! `ExceptionFrame` and then triggers a breakpoint. From that breakpoint one can see the backtrace
|
||||
//! that led to the exception.
|
||||
//! In you run the example below, you'll be able to inspect the state of your
|
||||
//! program under the debugger using these commands:
|
||||
//!
|
||||
//! ``` text
|
||||
//! (gdb) continue
|
||||
//! Program received signal SIGTRAP, Trace/breakpoint trap.
|
||||
//! __bkpt () at asm/bkpt.s:3
|
||||
//! 3 bkpt
|
||||
//! ```
|
||||
//! (gdb) # Stacked registers = program state during the crash
|
||||
//! (gdb) print/x *_sr
|
||||
//! $1 = cortex_m::exception::StackedRegisters {
|
||||
//! r0 = 0x2fffffff,
|
||||
//! r1 = 0x2fffffff,
|
||||
//! r2 = 0x0,
|
||||
//! r3 = 0x0,
|
||||
//! r12 = 0x0,
|
||||
//! lr = 0x8000443,
|
||||
//! pc = 0x8000190,
|
||||
//! xpsr = 0x61000200,
|
||||
//! }
|
||||
//!
|
||||
//! (gdb) # What exception was triggered?
|
||||
//! (gdb) print _e
|
||||
//! $2 = cortex_m::exception::Exception::HardFault
|
||||
//!
|
||||
//! (gdb) # Where did we come from?
|
||||
//! (gdb) backtrace
|
||||
//! #0 __bkpt () at asm/bkpt.s:3
|
||||
//! #1 0x080030b4 in cortex_m::asm::bkpt () at $$/cortex-m-0.5.0/src/asm.rs:19
|
||||
//! #2 rust_begin_unwind (args=..., file=..., line=99, col=5) at $$/panic-semihosting-0.2.0/src/lib.rs:87
|
||||
//! #3 0x08001d06 in core::panicking::panic_fmt () at libcore/panicking.rs:71
|
||||
//! #4 0x080004a6 in crash::hard_fault (ef=0x20004fa0) at examples/crash.rs:99
|
||||
//! #5 0x08000548 in UserHardFault (ef=0x20004fa0) at <exception macros>:10
|
||||
//! #6 0x0800093a in HardFault () at asm.s:5
|
||||
//! Backtrace stopped: previous frame identical to this frame (corrupt stack?)
|
||||
//! ```
|
||||
//!
|
||||
//! In the console output one will find the state of the Program Counter (PC) register at the time
|
||||
//! of the exception.
|
||||
//!
|
||||
//! ``` text
|
||||
//! panicked at 'HardFault at ExceptionFrame {
|
||||
//! r0: 0x2fffffff,
|
||||
//! r1: 0x2fffffff,
|
||||
//! r2: 0x080051d4,
|
||||
//! r3: 0x080051d4,
|
||||
//! r12: 0x20000000,
|
||||
//! lr: 0x08000435,
|
||||
//! pc: 0x08000ab6,
|
||||
//! xpsr: 0x61000000
|
||||
//! }', examples/crash.rs:106:5
|
||||
//! ```
|
||||
//!
|
||||
//! This register contains the address of the instruction that caused the exception. In GDB one can
|
||||
//! disassemble the program around this address to observe the instruction that caused the
|
||||
//! exception.
|
||||
//!
|
||||
//! ``` text
|
||||
//! (gdb) disassemble/m 0x08000ab6
|
||||
//! Dump of assembler code for function core::ptr::read_volatile:
|
||||
//! 451 pub unsafe fn read_volatile<T>(src: *const T) -> T {
|
||||
//! 0x08000aae <+0>: sub sp, #16
|
||||
//! 0x08000ab0 <+2>: mov r1, r0
|
||||
//! 0x08000ab2 <+4>: str r0, [sp, #8]
|
||||
//!
|
||||
//! 452 intrinsics::volatile_load(src)
|
||||
//! 0x08000ab4 <+6>: ldr r0, [sp, #8]
|
||||
//! -> 0x08000ab6 <+8>: ldr r0, [r0, #0]
|
||||
//! 0x08000ab8 <+10>: str r0, [sp, #12]
|
||||
//! 0x08000aba <+12>: ldr r0, [sp, #12]
|
||||
//! 0x08000abc <+14>: str r1, [sp, #4]
|
||||
//! 0x08000abe <+16>: str r0, [sp, #0]
|
||||
//! 0x08000ac0 <+18>: b.n 0x8000ac2 <core::ptr::read_volatile+20>
|
||||
//!
|
||||
//! 453 }
|
||||
//! 0x08000ac2 <+20>: ldr r0, [sp, #0]
|
||||
//! 0x08000ac4 <+22>: add sp, #16
|
||||
//! 0x08000ac6 <+24>: bx lr
|
||||
//!
|
||||
//! End of assembler dump.
|
||||
//! ```
|
||||
//!
|
||||
//! `ldr r0, [r0, #0]` caused the exception. This instruction tried to load (read) a 32-bit word
|
||||
//! from the address stored in the register `r0`. Looking again at the contents of `ExceptionFrame`
|
||||
//! we see that the `r0` contained the address `0x2FFF_FFFF` when this instruction was executed.
|
||||
//!
|
||||
//! ---
|
||||
|
||||
#![no_main]
|
||||
#![feature(used)]
|
||||
#![no_std]
|
||||
|
||||
extern crate cortex_m;
|
||||
#[macro_use]
|
||||
extern crate cortex_m_rt as rt;
|
||||
extern crate panic_semihosting;
|
||||
extern crate cortex_m_rt;
|
||||
|
||||
use core::ptr;
|
||||
|
||||
use rt::ExceptionFrame;
|
||||
use cortex_m::asm;
|
||||
|
||||
entry!(main);
|
||||
|
||||
fn main() -> ! {
|
||||
fn main() {
|
||||
// Read an invalid memory address
|
||||
unsafe {
|
||||
// read an address outside of the RAM region; causes a HardFault exception
|
||||
ptr::read_volatile(0x2FFF_FFFF as *const u32);
|
||||
}
|
||||
|
||||
loop {}
|
||||
}
|
||||
|
||||
// define the hard fault handler
|
||||
exception!(HardFault, hard_fault);
|
||||
// As we are not using interrupts, we just register a dummy catch all handler
|
||||
#[allow(dead_code)]
|
||||
#[used]
|
||||
#[link_section = ".rodata.interrupts"]
|
||||
static INTERRUPTS: [extern "C" fn(); 240] = [default_handler; 240];
|
||||
|
||||
fn hard_fault(ef: &ExceptionFrame) -> ! {
|
||||
panic!("HardFault at {:#?}", ef);
|
||||
}
|
||||
|
||||
// define the default exception handler
|
||||
exception!(*, default_handler);
|
||||
|
||||
fn default_handler(irqn: i16) {
|
||||
panic!("Unhandled exception (IRQn = {})", irqn);
|
||||
extern "C" fn default_handler() {
|
||||
asm::bkpt();
|
||||
}
|
||||
|
||||
@@ -1,89 +0,0 @@
|
||||
//! Using a device crate
|
||||
//!
|
||||
//! Crates generated using [`svd2rust`] are referred to as device crates. These crates provide an
|
||||
//! API to access the peripherals of a device.
|
||||
//!
|
||||
//! [`svd2rust`]: https://crates.io/crates/svd2rust
|
||||
//!
|
||||
//! Device crates also provide an `interrupt!` macro (behind the "rt" feature) to register interrupt
|
||||
//! handlers.
|
||||
//!
|
||||
//! This example depends on the [`stm32f103xx`] crate so you'll have to add it to your Cargo.toml.
|
||||
//!
|
||||
//! [`stm32f103xx`]: https://crates.io/crates/stm32f103xx
|
||||
//!
|
||||
//! ```
|
||||
//! $ edit Cargo.toml && tail $_
|
||||
//! [dependencies.stm32f103xx]
|
||||
//! features = ["rt"]
|
||||
//! version = "0.10.0"
|
||||
//! ```
|
||||
//!
|
||||
//! ---
|
||||
|
||||
#![no_main]
|
||||
#![no_std]
|
||||
|
||||
extern crate cortex_m;
|
||||
#[macro_use]
|
||||
extern crate cortex_m_rt as rt;
|
||||
extern crate cortex_m_semihosting as sh;
|
||||
#[macro_use]
|
||||
extern crate stm32f103xx;
|
||||
extern crate panic_semihosting;
|
||||
|
||||
use core::fmt::Write;
|
||||
|
||||
use cortex_m::peripheral::syst::SystClkSource;
|
||||
use rt::ExceptionFrame;
|
||||
use sh::hio::{self, HStdout};
|
||||
use stm32f103xx::Interrupt;
|
||||
|
||||
entry!(main);
|
||||
|
||||
fn main() -> ! {
|
||||
let p = cortex_m::Peripherals::take().unwrap();
|
||||
|
||||
let mut syst = p.SYST;
|
||||
let mut nvic = p.NVIC;
|
||||
|
||||
nvic.enable(Interrupt::EXTI0);
|
||||
|
||||
// configure the system timer to wrap around every second
|
||||
syst.set_clock_source(SystClkSource::Core);
|
||||
syst.set_reload(8_000_000); // 1s
|
||||
syst.enable_counter();
|
||||
|
||||
loop {
|
||||
// busy wait until the timer wraps around
|
||||
while !syst.has_wrapped() {}
|
||||
|
||||
// trigger the `EXTI0` interrupt
|
||||
nvic.set_pending(Interrupt::EXTI0);
|
||||
}
|
||||
}
|
||||
|
||||
// try commenting out this line: you'll end in `default_handler` instead of in `exti0`
|
||||
interrupt!(EXTI0, exti0, state: Option<HStdout> = None);
|
||||
|
||||
fn exti0(state: &mut Option<HStdout>) {
|
||||
if state.is_none() {
|
||||
*state = Some(hio::hstdout().unwrap());
|
||||
}
|
||||
|
||||
if let Some(hstdout) = state.as_mut() {
|
||||
hstdout.write_str(".").unwrap();
|
||||
}
|
||||
}
|
||||
|
||||
exception!(HardFault, hard_fault);
|
||||
|
||||
fn hard_fault(ef: &ExceptionFrame) -> ! {
|
||||
panic!("HardFault at {:#?}", ef);
|
||||
}
|
||||
|
||||
exception!(*, default_handler);
|
||||
|
||||
fn default_handler(irqn: i16) {
|
||||
panic!("Unhandled exception (IRQn = {})", irqn);
|
||||
}
|
||||
@@ -1,64 +0,0 @@
|
||||
//! Overriding an exception handler
|
||||
//!
|
||||
//! You can override an exception handler using the [`exception!`][1] macro.
|
||||
//!
|
||||
//! [1]: https://docs.rs/cortex-m-rt/0.5.0/cortex_m_rt/macro.exception.html
|
||||
//!
|
||||
//! ---
|
||||
|
||||
#![deny(unsafe_code)]
|
||||
#![no_main]
|
||||
#![no_std]
|
||||
|
||||
extern crate cortex_m;
|
||||
#[macro_use]
|
||||
extern crate cortex_m_rt as rt;
|
||||
extern crate cortex_m_semihosting as sh;
|
||||
extern crate panic_semihosting;
|
||||
|
||||
use core::fmt::Write;
|
||||
|
||||
use cortex_m::peripheral::syst::SystClkSource;
|
||||
use cortex_m::Peripherals;
|
||||
use rt::ExceptionFrame;
|
||||
use sh::hio::{self, HStdout};
|
||||
|
||||
entry!(main);
|
||||
|
||||
fn main() -> ! {
|
||||
let p = Peripherals::take().unwrap();
|
||||
let mut syst = p.SYST;
|
||||
|
||||
// configures the system timer to trigger a SysTick exception every second
|
||||
syst.set_clock_source(SystClkSource::Core);
|
||||
syst.set_reload(8_000_000); // period = 1s
|
||||
syst.enable_counter();
|
||||
syst.enable_interrupt();
|
||||
|
||||
loop {}
|
||||
}
|
||||
|
||||
// try commenting out this line: you'll end in `default_handler` instead of in `sys_tick`
|
||||
exception!(SysTick, sys_tick, state: Option<HStdout> = None);
|
||||
|
||||
fn sys_tick(state: &mut Option<HStdout>) {
|
||||
if state.is_none() {
|
||||
*state = Some(hio::hstdout().unwrap());
|
||||
}
|
||||
|
||||
if let Some(hstdout) = state.as_mut() {
|
||||
hstdout.write_str(".").unwrap();
|
||||
}
|
||||
}
|
||||
|
||||
exception!(HardFault, hard_fault);
|
||||
|
||||
fn hard_fault(ef: &ExceptionFrame) -> ! {
|
||||
panic!("HardFault at {:#?}", ef);
|
||||
}
|
||||
|
||||
exception!(*, default_handler);
|
||||
|
||||
fn default_handler(irqn: i16) {
|
||||
panic!("Unhandled exception (IRQn = {})", irqn);
|
||||
}
|
||||
@@ -1,37 +1,24 @@
|
||||
//! Prints "Hello, world!" on the OpenOCD console using semihosting
|
||||
//!
|
||||
//! ---
|
||||
|
||||
#![no_main]
|
||||
#![feature(used)]
|
||||
#![no_std]
|
||||
|
||||
#[macro_use]
|
||||
extern crate cortex_m_rt as rt;
|
||||
extern crate cortex_m_semihosting as sh;
|
||||
extern crate panic_semihosting;
|
||||
extern crate cortex_m;
|
||||
extern crate cortex_m_rt;
|
||||
|
||||
use core::fmt::Write;
|
||||
use cortex_m::asm;
|
||||
|
||||
use rt::ExceptionFrame;
|
||||
use sh::hio;
|
||||
|
||||
entry!(main);
|
||||
|
||||
fn main() -> ! {
|
||||
let mut stdout = hio::hstdout().unwrap();
|
||||
writeln!(stdout, "Hello, world!").unwrap();
|
||||
|
||||
loop {}
|
||||
fn main() {
|
||||
hprintln!("Hello, world!");
|
||||
}
|
||||
|
||||
exception!(HardFault, hard_fault);
|
||||
// As we are not using interrupts, we just register a dummy catch all handler
|
||||
#[allow(dead_code)]
|
||||
#[used]
|
||||
#[link_section = ".rodata.interrupts"]
|
||||
static INTERRUPTS: [extern "C" fn(); 240] = [default_handler; 240];
|
||||
|
||||
fn hard_fault(ef: &ExceptionFrame) -> ! {
|
||||
panic!("HardFault at {:#?}", ef);
|
||||
}
|
||||
|
||||
exception!(*, default_handler);
|
||||
|
||||
fn default_handler(irqn: i16) {
|
||||
panic!("Unhandled exception (IRQn = {})", irqn);
|
||||
extern "C" fn default_handler() {
|
||||
asm::bkpt();
|
||||
}
|
||||
|
||||
@@ -1,54 +1,41 @@
|
||||
//! Sends "Hello, world!" through the ITM port 0
|
||||
//!
|
||||
//! **IMPORTANT** Not all Cortex-M chips support ITM. You'll have to connect the
|
||||
//! microcontroller's SWO pin to the SWD interface. Note that some development
|
||||
//! boards don't provide this option.
|
||||
//!
|
||||
//! ITM is much faster than semihosting. Like 4 orders of magnitude or so.
|
||||
//!
|
||||
//! **NOTE** Cortex-M0 chips don't support ITM.
|
||||
//! You'll need [`itmdump`] to receive the message on the host plus you'll need
|
||||
//! to uncomment OpenOCD's ITM support in `.gdbinit`.
|
||||
//!
|
||||
//! You'll have to connect the microcontroller's SWO pin to the SWD interface. Note that some
|
||||
//! development boards don't provide this option.
|
||||
//!
|
||||
//! You'll need [`itmdump`] to receive the message on the host plus you'll need to uncomment two
|
||||
//! `monitor` commands in the `.gdbinit` file.
|
||||
//!
|
||||
//! [`itmdump`]: https://docs.rs/itm/0.2.1/itm/
|
||||
//!
|
||||
//! ---
|
||||
//! [`itmdump`]: https://docs.rs/itm/0.1.1/itm/
|
||||
|
||||
#![no_main]
|
||||
#![feature(used)]
|
||||
#![no_std]
|
||||
|
||||
#[macro_use]
|
||||
extern crate cortex_m;
|
||||
#[macro_use]
|
||||
extern crate cortex_m_rt as rt;
|
||||
extern crate panic_semihosting;
|
||||
extern crate cortex_m_rt;
|
||||
|
||||
use cortex_m::{asm, Peripherals};
|
||||
use rt::ExceptionFrame;
|
||||
use cortex_m::{asm, interrupt, peripheral};
|
||||
|
||||
entry!(main);
|
||||
fn main() {
|
||||
interrupt::free(
|
||||
|cs| {
|
||||
let itm = peripheral::ITM.borrow(&cs);
|
||||
|
||||
fn main() -> ! {
|
||||
let mut p = Peripherals::take().unwrap();
|
||||
let stim = &mut p.ITM.stim[0];
|
||||
|
||||
iprintln!(stim, "Hello, world!");
|
||||
|
||||
loop {
|
||||
asm::bkpt();
|
||||
}
|
||||
iprintln!(&itm.stim[0], "Hello, world!");
|
||||
},
|
||||
);
|
||||
}
|
||||
|
||||
// define the hard fault handler
|
||||
exception!(HardFault, hard_fault);
|
||||
// As we are not using interrupts, we just register a dummy catch all handler
|
||||
#[allow(dead_code)]
|
||||
#[used]
|
||||
#[link_section = ".rodata.interrupts"]
|
||||
static INTERRUPTS: [extern "C" fn(); 240] = [default_handler; 240];
|
||||
|
||||
fn hard_fault(ef: &ExceptionFrame) -> ! {
|
||||
panic!("HardFault at {:#?}", ef);
|
||||
}
|
||||
|
||||
// define the default exception handler
|
||||
exception!(*, default_handler);
|
||||
|
||||
fn default_handler(irqn: i16) {
|
||||
panic!("Unhandled exception (IRQn = {})", irqn);
|
||||
extern "C" fn default_handler() {
|
||||
asm::bkpt();
|
||||
}
|
||||
|
||||
@@ -1,40 +0,0 @@
|
||||
//! Minimal Cortex-M program
|
||||
//!
|
||||
//! When executed this program will hit the breakpoint set in `main`.
|
||||
//!
|
||||
//! All Cortex-M programs need to:
|
||||
//!
|
||||
//! - Contain the `#![no_main]` and `#![no_std]` attributes. Embedded programs don't use the
|
||||
//! standard Rust `main` interface or the Rust standard (`std`) library.
|
||||
//!
|
||||
//! - Define their entry point using [`entry!`] macro.
|
||||
//!
|
||||
//! [`entry!`]: https://docs.rs/cortex-m-rt/~0.5/cortex_m_rt/macro.entry.html
|
||||
//!
|
||||
//! - Define their panicking behavior, i.e. what happens when `panic!` is called. The easiest way to
|
||||
//! define a panicking behavior is to link to a [panic handler crate][0]
|
||||
//!
|
||||
//! [0]: https://crates.io/keywords/panic-impl
|
||||
|
||||
#![no_main] // <- IMPORTANT!
|
||||
#![no_std]
|
||||
|
||||
extern crate cortex_m;
|
||||
|
||||
#[macro_use(entry)]
|
||||
extern crate cortex_m_rt as rt;
|
||||
|
||||
// makes `panic!` print messages to the host stderr using semihosting
|
||||
extern crate panic_semihosting;
|
||||
|
||||
use cortex_m::asm;
|
||||
|
||||
// the program entry point is ...
|
||||
entry!(main);
|
||||
|
||||
// ... this never ending function
|
||||
fn main() -> ! {
|
||||
loop {
|
||||
asm::bkpt();
|
||||
}
|
||||
}
|
||||
46
examples/override-exception-handler.rs
Normal file
46
examples/override-exception-handler.rs
Normal file
@@ -0,0 +1,46 @@
|
||||
//! Overriding an exception
|
||||
//!
|
||||
//! **NOTE** You have to disable the `cortex-m-rt` crate's "exceptions" feature
|
||||
//! to make this work.
|
||||
|
||||
#![feature(used)]
|
||||
#![no_std]
|
||||
|
||||
extern crate cortex_m;
|
||||
extern crate cortex_m_rt;
|
||||
|
||||
use core::ptr;
|
||||
|
||||
use cortex_m::{asm, exception};
|
||||
|
||||
fn main() {
|
||||
unsafe {
|
||||
// Invalid memory access
|
||||
ptr::read_volatile(0x2FFF_FFFF as *const u32);
|
||||
}
|
||||
}
|
||||
|
||||
extern "C" fn hard_fault(_: exception::HardFault) {
|
||||
// You'll hit this breakpoint rather than the one in cortex-m-rt
|
||||
asm::bkpt()
|
||||
}
|
||||
|
||||
// When the "exceptions" feature is disabled, you'll have to provide this symbol
|
||||
#[allow(dead_code)]
|
||||
#[used]
|
||||
#[link_section = ".rodata.exceptions"]
|
||||
static EXCEPTIONS: exception::Handlers = exception::Handlers {
|
||||
// This is the exception handler override
|
||||
hard_fault: hard_fault,
|
||||
..exception::DEFAULT_HANDLERS
|
||||
};
|
||||
|
||||
// As we are not using interrupts, we just register a dummy catch all handler
|
||||
#[allow(dead_code)]
|
||||
#[used]
|
||||
#[link_section = ".rodata.interrupts"]
|
||||
static INTERRUPTS: [extern "C" fn(); 240] = [default_handler; 240];
|
||||
|
||||
extern "C" fn default_handler() {
|
||||
asm::bkpt();
|
||||
}
|
||||
@@ -1,44 +1,35 @@
|
||||
//! Changing the panic handler
|
||||
//! Redirecting `panic!` messages
|
||||
//!
|
||||
//! The easiest way to change the panic handler is to use a different [panic handler crate][0].
|
||||
//! The `cortex-m-rt` crate provides two options to redirect `panic!` messages
|
||||
//! through these two Cargo features:
|
||||
//!
|
||||
//! [0]: https://crates.io/keywords/panic-impl
|
||||
//! - `panic-over-semihosting`. `panic!` messages will be printed to the OpenOCD
|
||||
//! console using semihosting. This is slow.
|
||||
//!
|
||||
//! ---
|
||||
//! - `panic-over-itm`. `panic!` messages will be send through the ITM port 0.
|
||||
//! This is much faster but requires ITM support on the device.
|
||||
//!
|
||||
//! If neither of these options is specified then the `panic!` message will be
|
||||
//! lost. Note that all `panic!`s will trigger a debugger breakpoint.
|
||||
|
||||
#![no_main]
|
||||
#![feature(used)]
|
||||
#![no_std]
|
||||
|
||||
#[macro_use]
|
||||
extern crate cortex_m_rt as rt;
|
||||
extern crate cortex_m;
|
||||
extern crate cortex_m_rt;
|
||||
|
||||
// Pick one of these two panic handlers:
|
||||
use cortex_m::asm;
|
||||
|
||||
// Reports panic messages to the host stderr using semihosting
|
||||
extern crate panic_semihosting;
|
||||
|
||||
// Logs panic messages using the ITM (Instrumentation Trace Macrocell)
|
||||
// NOTE to use this you need to uncomment the `panic-itm` dependency in Cargo.toml
|
||||
// extern crate panic_itm;
|
||||
|
||||
use rt::ExceptionFrame;
|
||||
|
||||
entry!(main);
|
||||
|
||||
fn main() -> ! {
|
||||
panic!("Oops")
|
||||
fn main() {
|
||||
panic!("Oops");
|
||||
}
|
||||
|
||||
// define the hard fault handler
|
||||
exception!(HardFault, hard_fault);
|
||||
// As we are not using interrupts, we just register a dummy catch all handler
|
||||
#[allow(dead_code)]
|
||||
#[used]
|
||||
#[link_section = ".rodata.interrupts"]
|
||||
static INTERRUPTS: [extern "C" fn(); 240] = [default_handler; 240];
|
||||
|
||||
fn hard_fault(ef: &ExceptionFrame) -> ! {
|
||||
panic!("HardFault at {:#?}", ef);
|
||||
}
|
||||
|
||||
// define the default exception handler
|
||||
exception!(*, default_handler);
|
||||
|
||||
fn default_handler(irqn: i16) {
|
||||
panic!("Unhandled exception (IRQn = {})", irqn);
|
||||
extern "C" fn default_handler() {
|
||||
asm::bkpt();
|
||||
}
|
||||
|
||||
36
examples/register-interrupt-handler.rs
Normal file
36
examples/register-interrupt-handler.rs
Normal file
@@ -0,0 +1,36 @@
|
||||
//! Register an interrupt handler
|
||||
//!
|
||||
//! NOTE Requires a device crate generated using `svd2rust`
|
||||
|
||||
#![feature(used)]
|
||||
#![no_std]
|
||||
|
||||
extern crate cortex_m;
|
||||
extern crate cortex_m_rt;
|
||||
// NOTE this is the device crate
|
||||
extern crate stm32f30x;
|
||||
|
||||
use cortex_m::asm;
|
||||
use stm32f30x::interrupt;
|
||||
|
||||
fn main() {}
|
||||
|
||||
// NOTE each interrupt handler has a different signature
|
||||
extern "C" fn my_interrupt_handler(_ctxt: interrupt::Tim7) {
|
||||
asm::bkpt();
|
||||
}
|
||||
|
||||
extern "C" fn another_interrupt_handler(_ctxt: interrupt::Exti0) {
|
||||
asm::bkpt();
|
||||
}
|
||||
|
||||
// Here we override only two interrupt handlers, the rest of interrupt are
|
||||
// handled by the same interrupt handler
|
||||
#[allow(dead_code)]
|
||||
#[used]
|
||||
#[link_section = ".rodata.interrupts"]
|
||||
static INTERRUPTS: interrupt::Handlers = interrupt::Handlers {
|
||||
Tim7: my_interrupt_handler,
|
||||
Exti0: another_interrupt_handler,
|
||||
..interrupt::DEFAULT_HANDLERS
|
||||
};
|
||||
@@ -5,14 +5,13 @@ set -ex
|
||||
|
||||
main() {
|
||||
local examples=(
|
||||
minimal
|
||||
hello
|
||||
itm
|
||||
panic
|
||||
crash
|
||||
exception
|
||||
register-interrupt-handler
|
||||
override-exception-handler
|
||||
allocator
|
||||
device
|
||||
)
|
||||
|
||||
rm -rf src/examples
|
||||
@@ -20,7 +19,7 @@ main() {
|
||||
mkdir src/examples
|
||||
|
||||
cat >src/examples/mod.rs <<'EOF'
|
||||
//! Examples sorted in increasing degree of complexity
|
||||
//! Examples
|
||||
// Auto-generated. Do not modify.
|
||||
EOF
|
||||
|
||||
|
||||
16
memory.x
16
memory.x
@@ -2,22 +2,18 @@ MEMORY
|
||||
{
|
||||
/* NOTE K = KiBi = 1024 bytes */
|
||||
/* TODO Adjust these memory regions to match your device memory layout */
|
||||
FLASH : ORIGIN = 0x000BAAD0, LENGTH = 0K
|
||||
RAM : ORIGIN = 0xBAAD0000, LENGTH = 0K
|
||||
FLASH : ORIGIN = 0xBAAAAAAD, LENGTH = 0K
|
||||
RAM : ORIGIN = 0xBAAAAAAD, LENGTH = 0K
|
||||
}
|
||||
|
||||
/* This is where the call stack will be allocated. */
|
||||
/* The stack is of the full descending type. */
|
||||
/* You may want to use this variable to locate the call stack and static
|
||||
variables in different memory regions. Below is shown the default value */
|
||||
/* _stack_start = ORIGIN(RAM) + LENGTH(RAM); */
|
||||
/* NOTE Do NOT modify `_stack_start` unless you know what you are doing */
|
||||
_stack_start = ORIGIN(RAM) + LENGTH(RAM);
|
||||
|
||||
/* You can use this symbol to customize the location of the .text section */
|
||||
/* If omitted the .text section will be placed right after the .vector_table
|
||||
section */
|
||||
/* This is required only on microcontrollers that store some configuration right
|
||||
after the vector table */
|
||||
/* This is required only on some microcontrollers that store some configuration
|
||||
right after the vector table */
|
||||
/* _stext = ORIGIN(FLASH) + 0x400; */
|
||||
|
||||
/* Size of the heap (in bytes) */
|
||||
/* _heap_size = 1024; */
|
||||
|
||||
28
src/examples/_0_hello.rs
Normal file
28
src/examples/_0_hello.rs
Normal file
@@ -0,0 +1,28 @@
|
||||
//! Prints "Hello, world!" on the OpenOCD console using semihosting
|
||||
//!
|
||||
//! ```
|
||||
//!
|
||||
//! #![feature(used)]
|
||||
//! #![no_std]
|
||||
//!
|
||||
//! #[macro_use]
|
||||
//! extern crate cortex_m;
|
||||
//! extern crate cortex_m_rt;
|
||||
//!
|
||||
//! use cortex_m::asm;
|
||||
//!
|
||||
//! fn main() {
|
||||
//! hprintln!("Hello, world!");
|
||||
//! }
|
||||
//!
|
||||
//! // As we are not using interrupts, we just register a dummy catch all handler
|
||||
//! #[allow(dead_code)]
|
||||
//! #[used]
|
||||
//! #[link_section = ".rodata.interrupts"]
|
||||
//! static INTERRUPTS: [extern "C" fn(); 240] = [default_handler; 240];
|
||||
//!
|
||||
//! extern "C" fn default_handler() {
|
||||
//! asm::bkpt();
|
||||
//! }
|
||||
//! ```
|
||||
// Auto-generated. Do not modify.
|
||||
@@ -1,67 +0,0 @@
|
||||
//! Minimal Cortex-M program
|
||||
//!
|
||||
//! When executed this program will hit the breakpoint set in `main`.
|
||||
//!
|
||||
//! All Cortex-M programs need to:
|
||||
//!
|
||||
//! - Contain the `#![no_main]` and `#![no_std]` attributes. Embedded programs don't use the
|
||||
//! standard Rust `main` interface or the Rust standard (`std`) library.
|
||||
//!
|
||||
//! - Define their entry point using [`entry!`] macro.
|
||||
//!
|
||||
//! [`entry!`]: https://docs.rs/cortex-m-rt/~0.5/cortex_m_rt/macro.entry.html
|
||||
//!
|
||||
//! - Define their panicking behavior, i.e. what happens when `panic!` is called. The easiest way to
|
||||
//! define a panicking behavior is to link to a [panic handler crate][0]
|
||||
//!
|
||||
//! [0]: https://crates.io/keywords/panic-impl
|
||||
//!
|
||||
//! - Define the `HardFault` handler using the [`exception!`] macro. This handler (function) is
|
||||
//! called when a hard fault exception is raised by the hardware.
|
||||
//!
|
||||
//! [`exception!`]: https://docs.rs/cortex-m-rt/~0.5/cortex_m_rt/macro..html
|
||||
//!
|
||||
//! - Define a default handler using the [`exception!`] macro. This function will be used to handle
|
||||
//! all interrupts and exceptions which have not been assigned a specific handler.
|
||||
//!
|
||||
//! ```
|
||||
//!
|
||||
//! #![no_main] // <- IMPORTANT!
|
||||
//! #![no_std]
|
||||
//!
|
||||
//! extern crate cortex_m;
|
||||
//!
|
||||
//! #[macro_use(entry, exception)]
|
||||
//! extern crate cortex_m_rt as rt;
|
||||
//!
|
||||
//! // makes `panic!` print messages to the host stderr using semihosting
|
||||
//! extern crate panic_semihosting;
|
||||
//!
|
||||
//! use cortex_m::asm;
|
||||
//! use rt::ExceptionFrame;
|
||||
//!
|
||||
//! // the program entry point is ...
|
||||
//! entry!(main);
|
||||
//!
|
||||
//! // ... this never ending function
|
||||
//! fn main() -> ! {
|
||||
//! loop {
|
||||
//! asm::bkpt();
|
||||
//! }
|
||||
//! }
|
||||
//!
|
||||
//! // define the hard fault handler
|
||||
//! exception!(HardFault, hard_fault);
|
||||
//!
|
||||
//! fn hard_fault(ef: &ExceptionFrame) -> ! {
|
||||
//! panic!("HardFault at {:#?}", ef);
|
||||
//! }
|
||||
//!
|
||||
//! // define the default exception handler
|
||||
//! exception!(*, default_handler);
|
||||
//!
|
||||
//! fn default_handler(irqn: i16) {
|
||||
//! panic!("Unhandled exception (IRQn = {})", irqn);
|
||||
//! }
|
||||
//! ```
|
||||
// Auto-generated. Do not modify.
|
||||
@@ -1,41 +0,0 @@
|
||||
//! Prints "Hello, world!" on the OpenOCD console using semihosting
|
||||
//!
|
||||
//! ---
|
||||
//!
|
||||
//! ```
|
||||
//!
|
||||
//! #![no_main]
|
||||
//! #![no_std]
|
||||
//!
|
||||
//! #[macro_use]
|
||||
//! extern crate cortex_m_rt as rt;
|
||||
//! extern crate cortex_m_semihosting as sh;
|
||||
//! extern crate panic_semihosting;
|
||||
//!
|
||||
//! use core::fmt::Write;
|
||||
//!
|
||||
//! use rt::ExceptionFrame;
|
||||
//! use sh::hio;
|
||||
//!
|
||||
//! entry!(main);
|
||||
//!
|
||||
//! fn main() -> ! {
|
||||
//! let mut stdout = hio::hstdout().unwrap();
|
||||
//! writeln!(stdout, "Hello, world!").unwrap();
|
||||
//!
|
||||
//! loop {}
|
||||
//! }
|
||||
//!
|
||||
//! exception!(HardFault, hard_fault);
|
||||
//!
|
||||
//! fn hard_fault(ef: &ExceptionFrame) -> ! {
|
||||
//! panic!("HardFault at {:#?}", ef);
|
||||
//! }
|
||||
//!
|
||||
//! exception!(*, default_handler);
|
||||
//!
|
||||
//! fn default_handler(irqn: i16) {
|
||||
//! panic!("Unhandled exception (IRQn = {})", irqn);
|
||||
//! }
|
||||
//! ```
|
||||
// Auto-generated. Do not modify.
|
||||
45
src/examples/_1_itm.rs
Normal file
45
src/examples/_1_itm.rs
Normal file
@@ -0,0 +1,45 @@
|
||||
//! Sends "Hello, world!" through the ITM port 0
|
||||
//!
|
||||
//! **IMPORTANT** Not all Cortex-M chips support ITM. You'll have to connect the
|
||||
//! microcontroller's SWO pin to the SWD interface. Note that some development
|
||||
//! boards don't provide this option.
|
||||
//!
|
||||
//! ITM is much faster than semihosting. Like 4 orders of magnitude or so.
|
||||
//!
|
||||
//! You'll need [`itmdump`] to receive the message on the host plus you'll need
|
||||
//! to uncomment OpenOCD's ITM support in `.gdbinit`.
|
||||
//!
|
||||
//! [`itmdump`]: https://docs.rs/itm/0.1.1/itm/
|
||||
//!
|
||||
//! ```
|
||||
//!
|
||||
//! #![feature(used)]
|
||||
//! #![no_std]
|
||||
//!
|
||||
//! #[macro_use]
|
||||
//! extern crate cortex_m;
|
||||
//! extern crate cortex_m_rt;
|
||||
//!
|
||||
//! use cortex_m::{asm, interrupt, peripheral};
|
||||
//!
|
||||
//! fn main() {
|
||||
//! interrupt::free(
|
||||
//! |cs| {
|
||||
//! let itm = peripheral::ITM.borrow(&cs);
|
||||
//!
|
||||
//! iprintln!(&itm.stim[0], "Hello, world!");
|
||||
//! },
|
||||
//! );
|
||||
//! }
|
||||
//!
|
||||
//! // As we are not using interrupts, we just register a dummy catch all handler
|
||||
//! #[allow(dead_code)]
|
||||
//! #[used]
|
||||
//! #[link_section = ".rodata.interrupts"]
|
||||
//! static INTERRUPTS: [extern "C" fn(); 240] = [default_handler; 240];
|
||||
//!
|
||||
//! extern "C" fn default_handler() {
|
||||
//! asm::bkpt();
|
||||
//! }
|
||||
//! ```
|
||||
// Auto-generated. Do not modify.
|
||||
@@ -1,58 +0,0 @@
|
||||
//! Sends "Hello, world!" through the ITM port 0
|
||||
//!
|
||||
//! ITM is much faster than semihosting. Like 4 orders of magnitude or so.
|
||||
//!
|
||||
//! **NOTE** Cortex-M0 chips don't support ITM.
|
||||
//!
|
||||
//! You'll have to connect the microcontroller's SWO pin to the SWD interface. Note that some
|
||||
//! development boards don't provide this option.
|
||||
//!
|
||||
//! You'll need [`itmdump`] to receive the message on the host plus you'll need to uncomment two
|
||||
//! `monitor` commands in the `.gdbinit` file.
|
||||
//!
|
||||
//! [`itmdump`]: https://docs.rs/itm/0.2.1/itm/
|
||||
//!
|
||||
//! ---
|
||||
//!
|
||||
//! ```
|
||||
//!
|
||||
//! #![no_main]
|
||||
//! #![no_std]
|
||||
//!
|
||||
//! #[macro_use]
|
||||
//! extern crate cortex_m;
|
||||
//! #[macro_use]
|
||||
//! extern crate cortex_m_rt as rt;
|
||||
//! extern crate panic_semihosting;
|
||||
//!
|
||||
//! use cortex_m::{asm, Peripherals};
|
||||
//! use rt::ExceptionFrame;
|
||||
//!
|
||||
//! entry!(main);
|
||||
//!
|
||||
//! fn main() -> ! {
|
||||
//! let mut p = Peripherals::take().unwrap();
|
||||
//! let stim = &mut p.ITM.stim[0];
|
||||
//!
|
||||
//! iprintln!(stim, "Hello, world!");
|
||||
//!
|
||||
//! loop {
|
||||
//! asm::bkpt();
|
||||
//! }
|
||||
//! }
|
||||
//!
|
||||
//! // define the hard fault handler
|
||||
//! exception!(HardFault, hard_fault);
|
||||
//!
|
||||
//! fn hard_fault(ef: &ExceptionFrame) -> ! {
|
||||
//! panic!("HardFault at {:#?}", ef);
|
||||
//! }
|
||||
//!
|
||||
//! // define the default exception handler
|
||||
//! exception!(*, default_handler);
|
||||
//!
|
||||
//! fn default_handler(irqn: i16) {
|
||||
//! panic!("Unhandled exception (IRQn = {})", irqn);
|
||||
//! }
|
||||
//! ```
|
||||
// Auto-generated. Do not modify.
|
||||
39
src/examples/_2_panic.rs
Normal file
39
src/examples/_2_panic.rs
Normal file
@@ -0,0 +1,39 @@
|
||||
//! Redirecting `panic!` messages
|
||||
//!
|
||||
//! The `cortex-m-rt` crate provides two options to redirect `panic!` messages
|
||||
//! through these two Cargo features:
|
||||
//!
|
||||
//! - `panic-over-semihosting`. `panic!` messages will be printed to the OpenOCD
|
||||
//! console using semihosting. This is slow.
|
||||
//!
|
||||
//! - `panic-over-itm`. `panic!` messages will be send through the ITM port 0.
|
||||
//! This is much faster but requires ITM support on the device.
|
||||
//!
|
||||
//! If neither of these options is specified then the `panic!` message will be
|
||||
//! lost. Note that all `panic!`s will trigger a debugger breakpoint.
|
||||
//!
|
||||
//! ```
|
||||
//!
|
||||
//! #![feature(used)]
|
||||
//! #![no_std]
|
||||
//!
|
||||
//! extern crate cortex_m;
|
||||
//! extern crate cortex_m_rt;
|
||||
//!
|
||||
//! use cortex_m::asm;
|
||||
//!
|
||||
//! fn main() {
|
||||
//! panic!("Oops");
|
||||
//! }
|
||||
//!
|
||||
//! // As we are not using interrupts, we just register a dummy catch all handler
|
||||
//! #[allow(dead_code)]
|
||||
//! #[used]
|
||||
//! #[link_section = ".rodata.interrupts"]
|
||||
//! static INTERRUPTS: [extern "C" fn(); 240] = [default_handler; 240];
|
||||
//!
|
||||
//! extern "C" fn default_handler() {
|
||||
//! asm::bkpt();
|
||||
//! }
|
||||
//! ```
|
||||
// Auto-generated. Do not modify.
|
||||
62
src/examples/_3_crash.rs
Normal file
62
src/examples/_3_crash.rs
Normal file
@@ -0,0 +1,62 @@
|
||||
//! Debugging a crash (exception)
|
||||
//!
|
||||
//! The `cortex-m-rt` crate provides functionality for this through a default
|
||||
//! exception handler. When an exception is hit, the default handler will
|
||||
//! trigger a breakpoint and in this debugging context the stacked registers
|
||||
//! are accessible.
|
||||
//!
|
||||
//! In you run the example below, you'll be able to inspect the state of your
|
||||
//! program under the debugger using these commands:
|
||||
//!
|
||||
//! ```
|
||||
//! (gdb) # Stacked registers = program state during the crash
|
||||
//! (gdb) print/x *_sr
|
||||
//! $1 = cortex_m::exception::StackedRegisters {
|
||||
//! r0 = 0x2fffffff,
|
||||
//! r1 = 0x2fffffff,
|
||||
//! r2 = 0x0,
|
||||
//! r3 = 0x0,
|
||||
//! r12 = 0x0,
|
||||
//! lr = 0x8000443,
|
||||
//! pc = 0x8000190,
|
||||
//! xpsr = 0x61000200,
|
||||
//! }
|
||||
//!
|
||||
//! (gdb) # What exception was triggered?
|
||||
//! (gdb) print _e
|
||||
//! $2 = cortex_m::exception::Exception::HardFault
|
||||
//!
|
||||
//! (gdb) # Where did we come from?
|
||||
//! (gdb) backtrace
|
||||
//! ```
|
||||
//!
|
||||
//! ```
|
||||
//!
|
||||
//! #![feature(used)]
|
||||
//! #![no_std]
|
||||
//!
|
||||
//! extern crate cortex_m;
|
||||
//! extern crate cortex_m_rt;
|
||||
//!
|
||||
//! use core::ptr;
|
||||
//!
|
||||
//! use cortex_m::asm;
|
||||
//!
|
||||
//! fn main() {
|
||||
//! // Read an invalid memory address
|
||||
//! unsafe {
|
||||
//! ptr::read_volatile(0x2FFF_FFFF as *const u32);
|
||||
//! }
|
||||
//! }
|
||||
//!
|
||||
//! // As we are not using interrupts, we just register a dummy catch all handler
|
||||
//! #[allow(dead_code)]
|
||||
//! #[used]
|
||||
//! #[link_section = ".rodata.interrupts"]
|
||||
//! static INTERRUPTS: [extern "C" fn(); 240] = [default_handler; 240];
|
||||
//!
|
||||
//! extern "C" fn default_handler() {
|
||||
//! asm::bkpt();
|
||||
//! }
|
||||
//! ```
|
||||
// Auto-generated. Do not modify.
|
||||
@@ -1,47 +0,0 @@
|
||||
//! Changing the panic handler
|
||||
//!
|
||||
//! The easiest way to change the panic handler is to use a different [panic handler crate][0].
|
||||
//!
|
||||
//! [0]: https://crates.io/keywords/panic-impl
|
||||
//!
|
||||
//! ---
|
||||
//!
|
||||
//! ```
|
||||
//!
|
||||
//! #![no_main]
|
||||
//! #![no_std]
|
||||
//!
|
||||
//! #[macro_use]
|
||||
//! extern crate cortex_m_rt as rt;
|
||||
//!
|
||||
//! // Pick one of these two panic handlers:
|
||||
//!
|
||||
//! // Reports panic messages to the host stderr using semihosting
|
||||
//! extern crate panic_semihosting;
|
||||
//!
|
||||
//! // Logs panic messages using the ITM (Instrumentation Trace Macrocell)
|
||||
//! // extern crate panic_itm;
|
||||
//!
|
||||
//! use rt::ExceptionFrame;
|
||||
//!
|
||||
//! entry!(main);
|
||||
//!
|
||||
//! fn main() -> ! {
|
||||
//! panic!("Oops")
|
||||
//! }
|
||||
//!
|
||||
//! // define the hard fault handler
|
||||
//! exception!(HardFault, hard_fault);
|
||||
//!
|
||||
//! fn hard_fault(ef: &ExceptionFrame) -> ! {
|
||||
//! panic!("HardFault at {:#?}", ef);
|
||||
//! }
|
||||
//!
|
||||
//! // define the default exception handler
|
||||
//! exception!(*, default_handler);
|
||||
//!
|
||||
//! fn default_handler(irqn: i16) {
|
||||
//! panic!("Unhandled exception (IRQn = {})", irqn);
|
||||
//! }
|
||||
//! ```
|
||||
// Auto-generated. Do not modify.
|
||||
@@ -1,118 +0,0 @@
|
||||
//! Debugging a crash (exception)
|
||||
//!
|
||||
//! Most crash conditions trigger a hard fault exception, whose handler is defined via
|
||||
//! `exception!(HardFault, ..)`. The `HardFault` handler has access to the exception frame, a
|
||||
//! snapshot of the CPU registers at the moment of the exception.
|
||||
//!
|
||||
//! This program crashes and the `HardFault` handler prints to the console the contents of the
|
||||
//! `ExceptionFrame` and then triggers a breakpoint. From that breakpoint one can see the backtrace
|
||||
//! that led to the exception.
|
||||
//!
|
||||
//! ``` text
|
||||
//! (gdb) continue
|
||||
//! Program received signal SIGTRAP, Trace/breakpoint trap.
|
||||
//! __bkpt () at asm/bkpt.s:3
|
||||
//! 3 bkpt
|
||||
//!
|
||||
//! (gdb) backtrace
|
||||
//! #0 __bkpt () at asm/bkpt.s:3
|
||||
//! #1 0x080030b4 in cortex_m::asm::bkpt () at $$/cortex-m-0.5.0/src/asm.rs:19
|
||||
//! #2 rust_begin_unwind (args=..., file=..., line=99, col=5) at $$/panic-semihosting-0.2.0/src/lib.rs:87
|
||||
//! #3 0x08001d06 in core::panicking::panic_fmt () at libcore/panicking.rs:71
|
||||
//! #4 0x080004a6 in crash::hard_fault (ef=0x20004fa0) at examples/crash.rs:99
|
||||
//! #5 0x08000548 in UserHardFault (ef=0x20004fa0) at <exception macros>:10
|
||||
//! #6 0x0800093a in HardFault () at asm.s:5
|
||||
//! Backtrace stopped: previous frame identical to this frame (corrupt stack?)
|
||||
//! ```
|
||||
//!
|
||||
//! In the console output one will find the state of the Program Counter (PC) register at the time
|
||||
//! of the exception.
|
||||
//!
|
||||
//! ``` text
|
||||
//! panicked at 'HardFault at ExceptionFrame {
|
||||
//! r0: 0x2fffffff,
|
||||
//! r1: 0x2fffffff,
|
||||
//! r2: 0x080051d4,
|
||||
//! r3: 0x080051d4,
|
||||
//! r12: 0x20000000,
|
||||
//! lr: 0x08000435,
|
||||
//! pc: 0x08000ab6,
|
||||
//! xpsr: 0x61000000
|
||||
//! }', examples/crash.rs:106:5
|
||||
//! ```
|
||||
//!
|
||||
//! This register contains the address of the instruction that caused the exception. In GDB one can
|
||||
//! disassemble the program around this address to observe the instruction that caused the
|
||||
//! exception.
|
||||
//!
|
||||
//! ``` text
|
||||
//! (gdb) disassemble/m 0x08000ab6
|
||||
//! Dump of assembler code for function core::ptr::read_volatile:
|
||||
//! 451 pub unsafe fn read_volatile<T>(src: *const T) -> T {
|
||||
//! 0x08000aae <+0>: sub sp, #16
|
||||
//! 0x08000ab0 <+2>: mov r1, r0
|
||||
//! 0x08000ab2 <+4>: str r0, [sp, #8]
|
||||
//!
|
||||
//! 452 intrinsics::volatile_load(src)
|
||||
//! 0x08000ab4 <+6>: ldr r0, [sp, #8]
|
||||
//! -> 0x08000ab6 <+8>: ldr r0, [r0, #0]
|
||||
//! 0x08000ab8 <+10>: str r0, [sp, #12]
|
||||
//! 0x08000aba <+12>: ldr r0, [sp, #12]
|
||||
//! 0x08000abc <+14>: str r1, [sp, #4]
|
||||
//! 0x08000abe <+16>: str r0, [sp, #0]
|
||||
//! 0x08000ac0 <+18>: b.n 0x8000ac2 <core::ptr::read_volatile+20>
|
||||
//!
|
||||
//! 453 }
|
||||
//! 0x08000ac2 <+20>: ldr r0, [sp, #0]
|
||||
//! 0x08000ac4 <+22>: add sp, #16
|
||||
//! 0x08000ac6 <+24>: bx lr
|
||||
//!
|
||||
//! End of assembler dump.
|
||||
//! ```
|
||||
//!
|
||||
//! `ldr r0, [r0, #0]` caused the exception. This instruction tried to load (read) a 32-bit word
|
||||
//! from the address stored in the register `r0`. Looking again at the contents of `ExceptionFrame`
|
||||
//! we see that the `r0` contained the address `0x2FFF_FFFF` when this instruction was executed.
|
||||
//!
|
||||
//! ---
|
||||
//!
|
||||
//! ```
|
||||
//!
|
||||
//! #![no_main]
|
||||
//! #![no_std]
|
||||
//!
|
||||
//! extern crate cortex_m;
|
||||
//! #[macro_use]
|
||||
//! extern crate cortex_m_rt as rt;
|
||||
//! extern crate panic_semihosting;
|
||||
//!
|
||||
//! use core::ptr;
|
||||
//!
|
||||
//! use rt::ExceptionFrame;
|
||||
//!
|
||||
//! entry!(main);
|
||||
//!
|
||||
//! fn main() -> ! {
|
||||
//! unsafe {
|
||||
//! // read an address outside of the RAM region; causes a HardFault exception
|
||||
//! ptr::read_volatile(0x2FFF_FFFF as *const u32);
|
||||
//! }
|
||||
//!
|
||||
//! loop {}
|
||||
//! }
|
||||
//!
|
||||
//! // define the hard fault handler
|
||||
//! exception!(HardFault, hard_fault);
|
||||
//!
|
||||
//! fn hard_fault(ef: &ExceptionFrame) -> ! {
|
||||
//! panic!("HardFault at {:#?}", ef);
|
||||
//! }
|
||||
//!
|
||||
//! // define the default exception handler
|
||||
//! exception!(*, default_handler);
|
||||
//!
|
||||
//! fn default_handler(irqn: i16) {
|
||||
//! panic!("Unhandled exception (IRQn = {})", irqn);
|
||||
//! }
|
||||
//! ```
|
||||
// Auto-generated. Do not modify.
|
||||
40
src/examples/_4_register_interrupt_handler.rs
Normal file
40
src/examples/_4_register_interrupt_handler.rs
Normal file
@@ -0,0 +1,40 @@
|
||||
//! Register an interrupt handler
|
||||
//!
|
||||
//! NOTE Requires a device crate generated using `svd2rust`
|
||||
//!
|
||||
//! ```
|
||||
//!
|
||||
//! #![feature(used)]
|
||||
//! #![no_std]
|
||||
//!
|
||||
//! extern crate cortex_m;
|
||||
//! extern crate cortex_m_rt;
|
||||
//! // NOTE this is the device crate
|
||||
//! extern crate stm32f30x;
|
||||
//!
|
||||
//! use cortex_m::asm;
|
||||
//! use stm32f30x::interrupt;
|
||||
//!
|
||||
//! fn main() {}
|
||||
//!
|
||||
//! // NOTE each interrupt handler has a different signature
|
||||
//! extern "C" fn my_interrupt_handler(_ctxt: interrupt::Tim7) {
|
||||
//! asm::bkpt();
|
||||
//! }
|
||||
//!
|
||||
//! extern "C" fn another_interrupt_handler(_ctxt: interrupt::Exti0) {
|
||||
//! asm::bkpt();
|
||||
//! }
|
||||
//!
|
||||
//! // Here we override only two interrupt handlers, the rest of interrupt are
|
||||
//! // handled by the same interrupt handler
|
||||
//! #[allow(dead_code)]
|
||||
//! #[used]
|
||||
//! #[link_section = ".rodata.interrupts"]
|
||||
//! static INTERRUPTS: interrupt::Handlers = interrupt::Handlers {
|
||||
//! Tim7: my_interrupt_handler,
|
||||
//! Exti0: another_interrupt_handler,
|
||||
//! ..interrupt::DEFAULT_HANDLERS
|
||||
//! };
|
||||
//! ```
|
||||
// Auto-generated. Do not modify.
|
||||
@@ -1,68 +0,0 @@
|
||||
//! Overriding an exception handler
|
||||
//!
|
||||
//! You can override an exception handler using the [`exception!`][1] macro.
|
||||
//!
|
||||
//! [1]: https://docs.rs/cortex-m-rt/0.5.0/cortex_m_rt/macro.exception.html
|
||||
//!
|
||||
//! ---
|
||||
//!
|
||||
//! ```
|
||||
//!
|
||||
//! #![deny(unsafe_code)]
|
||||
//! #![no_main]
|
||||
//! #![no_std]
|
||||
//!
|
||||
//! extern crate cortex_m;
|
||||
//! #[macro_use]
|
||||
//! extern crate cortex_m_rt as rt;
|
||||
//! extern crate cortex_m_semihosting as sh;
|
||||
//! extern crate panic_semihosting;
|
||||
//!
|
||||
//! use core::fmt::Write;
|
||||
//!
|
||||
//! use cortex_m::peripheral::syst::SystClkSource;
|
||||
//! use cortex_m::Peripherals;
|
||||
//! use rt::ExceptionFrame;
|
||||
//! use sh::hio::{self, HStdout};
|
||||
//!
|
||||
//! entry!(main);
|
||||
//!
|
||||
//! fn main() -> ! {
|
||||
//! let p = Peripherals::take().unwrap();
|
||||
//! let mut syst = p.SYST;
|
||||
//!
|
||||
//! // configures the system timer to trigger a SysTick exception every second
|
||||
//! syst.set_clock_source(SystClkSource::Core);
|
||||
//! syst.set_reload(8_000_000); // period = 1s
|
||||
//! syst.enable_counter();
|
||||
//! syst.enable_interrupt();
|
||||
//!
|
||||
//! loop {}
|
||||
//! }
|
||||
//!
|
||||
//! // try commenting out this line: you'll end in `default_handler` instead of in `sys_tick`
|
||||
//! exception!(SysTick, sys_tick, state: Option<HStdout> = None);
|
||||
//!
|
||||
//! fn sys_tick(state: &mut Option<HStdout>) {
|
||||
//! if state.is_none() {
|
||||
//! *state = Some(hio::hstdout().unwrap());
|
||||
//! }
|
||||
//!
|
||||
//! if let Some(hstdout) = state.as_mut() {
|
||||
//! hstdout.write_str(".").unwrap();
|
||||
//! }
|
||||
//! }
|
||||
//!
|
||||
//! exception!(HardFault, hard_fault);
|
||||
//!
|
||||
//! fn hard_fault(ef: &ExceptionFrame) -> ! {
|
||||
//! panic!("HardFault at {:#?}", ef);
|
||||
//! }
|
||||
//!
|
||||
//! exception!(*, default_handler);
|
||||
//!
|
||||
//! fn default_handler(irqn: i16) {
|
||||
//! panic!("Unhandled exception (IRQn = {})", irqn);
|
||||
//! }
|
||||
//! ```
|
||||
// Auto-generated. Do not modify.
|
||||
50
src/examples/_5_override_exception_handler.rs
Normal file
50
src/examples/_5_override_exception_handler.rs
Normal file
@@ -0,0 +1,50 @@
|
||||
//! Overriding an exception
|
||||
//!
|
||||
//! **NOTE** You have to disable the `cortex-m-rt` crate's "exceptions" feature
|
||||
//! to make this work.
|
||||
//!
|
||||
//! ```
|
||||
//!
|
||||
//! #![feature(used)]
|
||||
//! #![no_std]
|
||||
//!
|
||||
//! extern crate cortex_m;
|
||||
//! extern crate cortex_m_rt;
|
||||
//!
|
||||
//! use core::ptr;
|
||||
//!
|
||||
//! use cortex_m::{asm, exception};
|
||||
//!
|
||||
//! fn main() {
|
||||
//! unsafe {
|
||||
//! // Invalid memory access
|
||||
//! ptr::read_volatile(0x2FFF_FFFF as *const u32);
|
||||
//! }
|
||||
//! }
|
||||
//!
|
||||
//! extern "C" fn hard_fault(_: exception::HardFault) {
|
||||
//! // You'll hit this breakpoint rather than the one in cortex-m-rt
|
||||
//! asm::bkpt()
|
||||
//! }
|
||||
//!
|
||||
//! // When the "exceptions" feature is disabled, you'll have to provide this symbol
|
||||
//! #[allow(dead_code)]
|
||||
//! #[used]
|
||||
//! #[link_section = ".rodata.exceptions"]
|
||||
//! static EXCEPTIONS: exception::Handlers = exception::Handlers {
|
||||
//! // This is the exception handler override
|
||||
//! hard_fault: hard_fault,
|
||||
//! ..exception::DEFAULT_HANDLERS
|
||||
//! };
|
||||
//!
|
||||
//! // As we are not using interrupts, we just register a dummy catch all handler
|
||||
//! #[allow(dead_code)]
|
||||
//! #[used]
|
||||
//! #[link_section = ".rodata.interrupts"]
|
||||
//! static INTERRUPTS: [extern "C" fn(); 240] = [default_handler; 240];
|
||||
//!
|
||||
//! extern "C" fn default_handler() {
|
||||
//! asm::bkpt();
|
||||
//! }
|
||||
//! ```
|
||||
// Auto-generated. Do not modify.
|
||||
@@ -1,79 +1,75 @@
|
||||
//! How to use the heap and a dynamic memory allocator
|
||||
//!
|
||||
//! This example depends on the alloc-cortex-m crate so you'll have to add it to your Cargo.toml:
|
||||
//! To compile this example you'll need to build the collections crate as part
|
||||
//! of the Xargo sysroot. To do that change the Xargo.toml file to look like
|
||||
//! this:
|
||||
//!
|
||||
//! ``` text
|
||||
//! [dependencies.core]
|
||||
//! [dependencies.collections] # new
|
||||
//!
|
||||
//! [dependencies.compiler_builtins]
|
||||
//! features = ["mem"]
|
||||
//! git = "https://github.com/rust-lang-nursery/compiler-builtins"
|
||||
//! stage = 1
|
||||
//! ```
|
||||
//!
|
||||
//! This example depends on the alloc-cortex-m crate so you'll have to add it
|
||||
//! to your Cargo.toml:
|
||||
//!
|
||||
//! ``` text
|
||||
//! # or edit the Cargo.toml file manually
|
||||
//! $ cargo add alloc-cortex-m
|
||||
//! ```
|
||||
//!
|
||||
//! ---
|
||||
//!
|
||||
//! ```
|
||||
//!
|
||||
//! #![feature(alloc)]
|
||||
//! #![feature(global_allocator)]
|
||||
//! #![feature(lang_items)]
|
||||
//! #![no_main]
|
||||
//!
|
||||
//! #![feature(collections)]
|
||||
//! #![feature(used)]
|
||||
//! #![no_std]
|
||||
//!
|
||||
//!
|
||||
//! // This is the allocator crate; you can use a different one
|
||||
//! extern crate alloc_cortex_m;
|
||||
//! #[macro_use]
|
||||
//! extern crate alloc;
|
||||
//! extern crate cortex_m;
|
||||
//! extern crate collections;
|
||||
//! #[macro_use]
|
||||
//! extern crate cortex_m_rt as rt;
|
||||
//! extern crate cortex_m_semihosting as sh;
|
||||
//! extern crate panic_semihosting;
|
||||
//!
|
||||
//! use core::fmt::Write;
|
||||
//!
|
||||
//! use alloc_cortex_m::CortexMHeap;
|
||||
//! extern crate cortex_m;
|
||||
//! extern crate cortex_m_rt;
|
||||
//!
|
||||
//! use cortex_m::asm;
|
||||
//! use rt::ExceptionFrame;
|
||||
//! use sh::hio;
|
||||
//!
|
||||
//! // this is the allocator the application will use
|
||||
//! #[global_allocator]
|
||||
//! static ALLOCATOR: CortexMHeap = CortexMHeap::empty();
|
||||
//!
|
||||
//! const HEAP_SIZE: usize = 1024; // in bytes
|
||||
//!
|
||||
//! entry!(main);
|
||||
//!
|
||||
//! fn main() -> ! {
|
||||
//! // Initialize the allocator BEFORE you use it
|
||||
//! unsafe { ALLOCATOR.init(rt::heap_start() as usize, HEAP_SIZE) }
|
||||
//!
|
||||
//!
|
||||
//! fn main() {
|
||||
//! // Initialize the allocator
|
||||
//! unsafe {
|
||||
//! extern "C" {
|
||||
//! // Start of the heap
|
||||
//! static mut _sheap: usize;
|
||||
//! }
|
||||
//!
|
||||
//! // Size of the heap in words (1 word = 4 bytes)
|
||||
//! // WARNING: The bigger the heap the greater the chance to run into a
|
||||
//! // stack overflow (collision between the stack and the heap)
|
||||
//! const SIZE: isize = 256;
|
||||
//!
|
||||
//! // End of the heap
|
||||
//! let _eheap = (&mut _sheap as *mut _).offset(SIZE);
|
||||
//!
|
||||
//! alloc_cortex_m::init(&mut _sheap as *mut _, _eheap);
|
||||
//! }
|
||||
//!
|
||||
//! // Growable array allocated on the heap
|
||||
//! let xs = vec![0, 1, 2];
|
||||
//!
|
||||
//! let mut stdout = hio::hstdout().unwrap();
|
||||
//! writeln!(stdout, "{:?}", xs).unwrap();
|
||||
//!
|
||||
//! loop {}
|
||||
//! hprintln!("{:?}", xs);
|
||||
//! }
|
||||
//!
|
||||
//! // define what happens in an Out Of Memory (OOM) condition
|
||||
//! #[lang = "oom"]
|
||||
//! #[no_mangle]
|
||||
//! pub fn rust_oom() -> ! {
|
||||
//!
|
||||
//! // As we are not using interrupts, we just register a dummy catch all handler
|
||||
//! #[allow(dead_code)]
|
||||
//! #[used]
|
||||
//! #[link_section = ".rodata.interrupts"]
|
||||
//! static INTERRUPTS: [extern "C" fn(); 240] = [default_handler; 240];
|
||||
//!
|
||||
//! extern "C" fn default_handler() {
|
||||
//! asm::bkpt();
|
||||
//!
|
||||
//! loop {}
|
||||
//! }
|
||||
//!
|
||||
//! exception!(HardFault, hard_fault);
|
||||
//!
|
||||
//! fn hard_fault(ef: &ExceptionFrame) -> ! {
|
||||
//! panic!("HardFault at {:#?}", ef);
|
||||
//! }
|
||||
//!
|
||||
//! exception!(*, default_handler);
|
||||
//!
|
||||
//! fn default_handler(irqn: i16) {
|
||||
//! panic!("Unhandled exception (IRQn = {})", irqn);
|
||||
//! }
|
||||
//! ```
|
||||
// Auto-generated. Do not modify.
|
||||
|
||||
@@ -1,93 +0,0 @@
|
||||
//! Using a device crate
|
||||
//!
|
||||
//! Crates generated using [`svd2rust`] are referred to as device crates. These crates provide an
|
||||
//! API to access the peripherals of a device.
|
||||
//!
|
||||
//! [`svd2rust`]: https://crates.io/crates/svd2rust
|
||||
//!
|
||||
//! Device crates also provide an `interrupt!` macro (behind the "rt" feature) to register interrupt
|
||||
//! handlers.
|
||||
//!
|
||||
//! This example depends on the [`stm32f103xx`] crate so you'll have to add it to your Cargo.toml.
|
||||
//!
|
||||
//! [`stm32f103xx`]: https://crates.io/crates/stm32f103xx
|
||||
//!
|
||||
//! ```
|
||||
//! $ edit Cargo.toml && tail $_
|
||||
//! [dependencies.stm32f103xx]
|
||||
//! features = ["rt"]
|
||||
//! version = "0.10.0"
|
||||
//! ```
|
||||
//!
|
||||
//! ---
|
||||
//!
|
||||
//! ```
|
||||
//!
|
||||
//! #![no_main]
|
||||
//! #![no_std]
|
||||
//!
|
||||
//! extern crate cortex_m;
|
||||
//! #[macro_use]
|
||||
//! extern crate cortex_m_rt as rt;
|
||||
//! extern crate cortex_m_semihosting as sh;
|
||||
//! #[macro_use]
|
||||
//! extern crate stm32f103xx;
|
||||
//! extern crate panic_semihosting;
|
||||
//!
|
||||
//! use core::fmt::Write;
|
||||
//!
|
||||
//! use cortex_m::peripheral::syst::SystClkSource;
|
||||
//! use rt::ExceptionFrame;
|
||||
//! use sh::hio::{self, HStdout};
|
||||
//! use stm32f103xx::Interrupt;
|
||||
//!
|
||||
//! entry!(main);
|
||||
//!
|
||||
//! fn main() -> ! {
|
||||
//! let p = cortex_m::Peripherals::take().unwrap();
|
||||
//!
|
||||
//! let mut syst = p.SYST;
|
||||
//! let mut nvic = p.NVIC;
|
||||
//!
|
||||
//! nvic.enable(Interrupt::EXTI0);
|
||||
//!
|
||||
//! // configure the system timer to wrap around every second
|
||||
//! syst.set_clock_source(SystClkSource::Core);
|
||||
//! syst.set_reload(8_000_000); // 1s
|
||||
//! syst.enable_counter();
|
||||
//!
|
||||
//! loop {
|
||||
//! // busy wait until the timer wraps around
|
||||
//! while !syst.has_wrapped() {}
|
||||
//!
|
||||
//! // trigger the `EXTI0` interrupt
|
||||
//! nvic.set_pending(Interrupt::EXTI0);
|
||||
//! }
|
||||
//! }
|
||||
//!
|
||||
//! // try commenting out this line: you'll end in `default_handler` instead of in `exti0`
|
||||
//! interrupt!(EXTI0, exti0, state: Option<HStdout> = None);
|
||||
//!
|
||||
//! fn exti0(state: &mut Option<HStdout>) {
|
||||
//! if state.is_none() {
|
||||
//! *state = Some(hio::hstdout().unwrap());
|
||||
//! }
|
||||
//!
|
||||
//! if let Some(hstdout) = state.as_mut() {
|
||||
//! hstdout.write_str(".").unwrap();
|
||||
//! }
|
||||
//! }
|
||||
//!
|
||||
//! exception!(HardFault, hard_fault);
|
||||
//!
|
||||
//! fn hard_fault(ef: &ExceptionFrame) -> ! {
|
||||
//! panic!("HardFault at {:#?}", ef);
|
||||
//! }
|
||||
//!
|
||||
//! exception!(*, default_handler);
|
||||
//!
|
||||
//! fn default_handler(irqn: i16) {
|
||||
//! panic!("Unhandled exception (IRQn = {})", irqn);
|
||||
//! }
|
||||
//! ```
|
||||
// Auto-generated. Do not modify.
|
||||
@@ -1,10 +1,9 @@
|
||||
//! Examples sorted in increasing degree of complexity
|
||||
//! Examples
|
||||
// Auto-generated. Do not modify.
|
||||
pub mod _0_minimal;
|
||||
pub mod _1_hello;
|
||||
pub mod _2_itm;
|
||||
pub mod _3_panic;
|
||||
pub mod _4_crash;
|
||||
pub mod _5_exception;
|
||||
pub mod _0_hello;
|
||||
pub mod _1_itm;
|
||||
pub mod _2_panic;
|
||||
pub mod _3_crash;
|
||||
pub mod _4_register_interrupt_handler;
|
||||
pub mod _5_override_exception_handler;
|
||||
pub mod _6_allocator;
|
||||
pub mod _7_device;
|
||||
|
||||
238
src/lib.rs
238
src/lib.rs
@@ -2,34 +2,23 @@
|
||||
//!
|
||||
//! # Dependencies
|
||||
//!
|
||||
//! - Nightly Rust toolchain from 2018-08-28 or newer: `rustup default nightly`
|
||||
//! - Nightly Rust toolchain: `rustup default nightly`
|
||||
//! - ARM linker: `sudo apt-get install binutils-arm-none-eabi`
|
||||
//! - Cargo `clone` subcommand: `cargo install cargo-clone`
|
||||
//! - GDB: `sudo apt-get install gdb-arm-none-eabi` (on Ubuntu)
|
||||
//! - OpenOCD: `sudo apt-get install OpenOCD` (on Ubuntu)
|
||||
//! - GDB: `sudo apt-get install gdb-arm-none-eabi`
|
||||
//! - OpenOCD: `sudo apt-get install OpenOCD`
|
||||
//! - Xargo: `cargo install xargo`
|
||||
//! - [Optional] Cargo `add` subcommand: `cargo install cargo-edit`
|
||||
//!
|
||||
//! # Usage
|
||||
//!
|
||||
//! 0) Figure out the cross compilation *target* to use.
|
||||
//!
|
||||
//! - Use `thumbv6m-none-eabi` for ARM Cortex-M0 and Cortex-M0+
|
||||
//! - Use `thumbv7m-none-eabi` for ARM Cortex-M3
|
||||
//! - Use `thumbv7em-none-eabi` for ARM Cortex-M4 and Cortex-M7 (*no* FPU support)
|
||||
//! - Use `thumbv7em-none-eabihf` for ARM Cortex-M4**F** and Cortex-M7**F** (*with* FPU support)
|
||||
//!
|
||||
//! 1) Install the `rust-std` component for your target, if you haven't done so already
|
||||
//!
|
||||
//! ``` console
|
||||
//! $ rustup target add thumbv7em-none-eabihf
|
||||
//! ```
|
||||
//!
|
||||
//! 2) Clone this crate
|
||||
//! - Clone this crate
|
||||
//!
|
||||
//! ``` text
|
||||
//! $ cargo clone cortex-m-quickstart --vers 0.3.4
|
||||
//! $ cargo clone cortex-m-quickstart && cd $_
|
||||
//! ```
|
||||
//!
|
||||
//! 3) Change the crate name, author and version
|
||||
//! - Change the crate name, author and version
|
||||
//!
|
||||
//! ``` text
|
||||
//! $ edit Cargo.toml && head $_
|
||||
@@ -39,25 +28,28 @@
|
||||
//! version = "0.1.0"
|
||||
//! ```
|
||||
//!
|
||||
//! 4) Specify the memory layout of the target device
|
||||
//! - Specify the memory layout of the target device
|
||||
//!
|
||||
//! **NOTE** board support crates sometimes provide this file for you (check the crate
|
||||
//! documentation). If you are using one that does then remove *both* `memory.x` and `build.rs` from
|
||||
//! the root of this crate.
|
||||
//! (Note that some board support crates may provide this file for you (check
|
||||
//! the crate documentation). If you are using one that does that then remove
|
||||
//! *both* the `memory.x` and `build.rs` files.)
|
||||
//!
|
||||
//! ``` text
|
||||
//! $ cat >memory.x <<'EOF'
|
||||
//! $ edit memory.x && cat $_
|
||||
//! MEMORY
|
||||
//! {
|
||||
//! /* NOTE K = KiBi = 1024 bytes */
|
||||
//! FLASH : ORIGIN = 0x08000000, LENGTH = 256K
|
||||
//! RAM : ORIGIN = 0x20000000, LENGTH = 40K
|
||||
//! }
|
||||
//! EOF
|
||||
//!
|
||||
//! /* This is where the call stack will be allocated. */
|
||||
//! /* The stack is of the full descending type. */
|
||||
//! /* NOTE Do NOT modify `_stack_start` unless you know what you are doing */
|
||||
//! _stack_start = ORIGIN(RAM) + LENGTH(RAM);
|
||||
//! ```
|
||||
//!
|
||||
//! 5) Optionally, set a default build target. This way you don't have to pass `--target` to each
|
||||
//! Cargo invocation.
|
||||
//! - Optionally, set a default build target
|
||||
//!
|
||||
//! ``` text
|
||||
//! $ cat >>.cargo/config <<'EOF'
|
||||
@@ -66,31 +58,35 @@
|
||||
//! EOF
|
||||
//! ```
|
||||
//!
|
||||
//! 6) Optionally, depend on a device, HAL implementation or a board support crate.
|
||||
//! - Very likely, depend on a device or a BSP (Board Support Package) crate.
|
||||
//!
|
||||
//! ``` text
|
||||
//! $ # add a device crate, OR
|
||||
//! # add a device crate, or
|
||||
//! $ cargo add stm32f30x
|
||||
//!
|
||||
//! $ # add a HAL implementation crate, OR
|
||||
//! $ cargo add stm32f30x-hal
|
||||
//!
|
||||
//! $ # add a board support crate
|
||||
//! # add a board support crate
|
||||
//! $ cargo add f3
|
||||
//! ```
|
||||
//!
|
||||
//! 7) Write the application or start from one of the examples
|
||||
//! - Write the application or start from one of the examples
|
||||
//!
|
||||
//! ``` text
|
||||
//! $ rm -r src/* && cp examples/hello.rs src/main.rs
|
||||
//! ```
|
||||
//!
|
||||
//! 8) Build the application
|
||||
//! - Disable incremental compilation. It doesn't work for embedded development.
|
||||
//! You'll hit nonsensical linker errors if you use it.
|
||||
//!
|
||||
//! ``` text
|
||||
//! $ cargo build --release
|
||||
//! $ unset CARGO_INCREMENTAL
|
||||
//! ```
|
||||
//!
|
||||
//! - Build the application
|
||||
//!
|
||||
//! ``` text
|
||||
//! # NOTE this command requires `arm-none-eabi-ld` to be in $PATH
|
||||
//! $ xargo build --release
|
||||
//!
|
||||
//! $ # sanity check
|
||||
//! $ arm-none-eabi-readelf -A target/thumbv7em-none-eabihf/release/demo
|
||||
//! Attribute Section: aeabi
|
||||
//! File Attributes
|
||||
@@ -113,19 +109,22 @@
|
||||
//! Tag_ABI_FP_16bit_format: IEEE 754
|
||||
//! ```
|
||||
//!
|
||||
//! 9) Flash and debug the program
|
||||
//! - Flash the program
|
||||
//!
|
||||
//! ``` text
|
||||
//! $ # Launch OpenOCD on a terminal
|
||||
//! # Launch OpenOCD on a terminal
|
||||
//! $ openocd -f (..)
|
||||
//! ```
|
||||
//!
|
||||
//! ``` text
|
||||
//! $ # Start a debug session in another terminal
|
||||
//! $ arm-none-eabi-gdb target/thumbv7em-none-eabihf/release/demo
|
||||
//! # Start debug session
|
||||
//! $ arm-none-eabi-gdb target/..
|
||||
//! ```
|
||||
//!
|
||||
//! Alternatively, you can use `cargo run` to build, flash and debug the program in a single step.
|
||||
//! **NOTE** As of nightly-2017-05-14 or so and cortex-m-quickstart v0.1.6 you
|
||||
//! can simply run `cargo run` or `cargo run --example $example` to build the
|
||||
//! program, and immediately start a debug session. IOW, it lets you omit the
|
||||
//! `arm-none-eabi-gdb` command.
|
||||
//!
|
||||
//! ``` text
|
||||
//! $ cargo run --example hello
|
||||
@@ -134,28 +133,13 @@
|
||||
//!
|
||||
//! # Examples
|
||||
//!
|
||||
//! Check the [examples module][examples]
|
||||
//!
|
||||
//! [examples]: ./examples/index.html
|
||||
//! Check the [examples module](./examples/index.html)
|
||||
//!
|
||||
//! # Troubleshooting
|
||||
//!
|
||||
//! This section contains fixes for common errors encountered when the
|
||||
//! `cortex-m-quickstart` template is misused.
|
||||
//!
|
||||
//! ## Used the standard `main` interface
|
||||
//!
|
||||
//! Error message:
|
||||
//!
|
||||
//! ``` text
|
||||
//! $ cargo build
|
||||
//! Compiling demo v0.1.0 (file:///home/japaric/tmp/demo)
|
||||
//!
|
||||
//! error: requires `start` lang_item
|
||||
//! ```
|
||||
//!
|
||||
//! Solution: Use `#![no_main]` and `entry!` as shown in the [examples].
|
||||
//!
|
||||
//! ## Forgot to launch an OpenOCD instance
|
||||
//!
|
||||
//! Error message:
|
||||
@@ -176,53 +160,38 @@
|
||||
//! Error message:
|
||||
//!
|
||||
//! ``` text
|
||||
//! $ cargo build
|
||||
//! $ xargo build
|
||||
//! Compiling demo v0.1.0 (file:///home/japaric/tmp/demo)
|
||||
//! error: linking with `rust-lld` failed: exit code: 1
|
||||
//! error: linking with `arm-none-eabi-ld` failed: exit code: 1
|
||||
//! |
|
||||
//! = note: "rust-lld" "-flavor" "gnu" "-L" (..)
|
||||
//! (..)
|
||||
//! = note: rust-lld: error: section '.vector_table' will not fit in region 'FLASH': overflowed by X bytes
|
||||
//! rust-lld: error: section '.vector_table' will not fit in region 'FLASH': overflowed by Y bytes
|
||||
//! (..)
|
||||
//! = note: "arm-none-eabi-ld" "-L" (..)
|
||||
//! = note: arm-none-eabi-ld: address 0xbaaab838 of hello section `.text' is ..
|
||||
//! arm-none-eabi-ld: address 0xbaaab838 of hello section `.text' is ..
|
||||
//! arm-none-eabi-ld:
|
||||
//! Invalid '.rodata.exceptions' section.
|
||||
//! Make sure to place a static with type `cortex_m::exception::Handlers`
|
||||
//! in that section (cf. #[link_section]) ONLY ONCE.
|
||||
//! ```
|
||||
//!
|
||||
//! Solution: Specify your device memory layout in the `memory.x` linker script. See [Usage]
|
||||
//! section.
|
||||
//! Solution: Specify your device memory layout in the `memory.x` linker script.
|
||||
//! See [Usage] section.
|
||||
//!
|
||||
//! ## Didn't set a default build target and forgot to pass `--target` to Cargo
|
||||
//! ## Forgot to set a default build target
|
||||
//!
|
||||
//! Error message:
|
||||
//!
|
||||
//! ``` text
|
||||
//! $ cargo build
|
||||
//! $ xargo build
|
||||
//! (..)
|
||||
//! error: language item required, but not found: `eh_personality`
|
||||
//! Compiling cortex-m-semihosting v0.1.3
|
||||
//! error[E0463]: can't find crate for `std`
|
||||
//!
|
||||
//! error: aborting due to previous error
|
||||
//! ```
|
||||
//!
|
||||
//! Solution: Set a default build target in the `.cargo/config` file (see [Usage] section), or call
|
||||
//! Cargo with `--target` flag: `cargo build --target thumbv7em-none-eabi`.
|
||||
//!
|
||||
//! ## Overwrote the original `.cargo/config` file
|
||||
//!
|
||||
//! You won't get an error message but the output binary will be empty
|
||||
//!
|
||||
//! ``` text
|
||||
//! $ cargo build && echo OK
|
||||
//! OK
|
||||
//!
|
||||
//! $ size target/thumbv7m-none-eabi/debug/app
|
||||
//! text data bss dec hex filename
|
||||
//! 0 0 0 0 0 target/thumbv7m-none-eabi/debug/app
|
||||
//! ```
|
||||
//!
|
||||
//! Solution: You probably overwrote the original `.cargo/config` instead of appending the default
|
||||
//! build target (e.g. `cat >` instead of `cat >>`). The less error prone way to fix this is to
|
||||
//! remove the `.cargo` directory, clone a new copy of the template and then copy the `.cargo`
|
||||
//! directory from that fresh template into your current project. Don't forget to *append* the
|
||||
//! default build target to `.cargo/config`.
|
||||
//! Solution: Set a default build target in the `.cargo/config` file
|
||||
//! (see [Usage] section), or call Xargo with `--target` flag:
|
||||
//! `xargo build --target thumbv7em-none-eabi`.
|
||||
//!
|
||||
//! ## Called OpenOCD with wrong arguments
|
||||
//!
|
||||
@@ -236,23 +205,11 @@
|
||||
//! in procedure 'ocd_bouncer'
|
||||
//! ```
|
||||
//!
|
||||
//! Solution: Correct the OpenOCD arguments. Check the `/usr/share/openocd/scripts` directory (exact
|
||||
//! location varies per distribution / OS) for a list of scripts that can be used.
|
||||
//! Solution: Correct the OpenOCD arguments. Check the
|
||||
//! `/usr/share/openocd/scripts` directory (exact location varies per
|
||||
//! distribution / OS) for a list of scripts that can be used.
|
||||
//!
|
||||
//! ## Forgot to install the `rust-std` component
|
||||
//!
|
||||
//! Error message:
|
||||
//!
|
||||
//! ``` text
|
||||
//! $ cargo build
|
||||
//! error[E0463]: can't find crate for `core`
|
||||
//! |
|
||||
//! = note: the `thumbv7m-none-eabi` target may not be installed
|
||||
//! ```
|
||||
//!
|
||||
//! Solution: call `rustup target add thumbv7m-none-eabi` but with the name of your target
|
||||
//!
|
||||
//! ## Used an old nightly
|
||||
//! ## Used Cargo instead of Xargo
|
||||
//!
|
||||
//! Error message:
|
||||
//!
|
||||
@@ -266,20 +223,44 @@
|
||||
//! error: aborting due to previous error
|
||||
//! ```
|
||||
//!
|
||||
//! Solution: Use a more recent nightly
|
||||
//! Solution: Use `xargo build`.
|
||||
//!
|
||||
//! ## Used the stable toolchain
|
||||
//!
|
||||
//! Error message:
|
||||
//!
|
||||
//! ``` text
|
||||
//! $ cargo build
|
||||
//! error[E0463]: can't find crate for `core`
|
||||
//! |
|
||||
//! = note: the `thumbv7em-none-eabihf` target may not be installed
|
||||
//! $ xargo build
|
||||
//! error: failed to run `rustc` to learn about target-specific information
|
||||
//!
|
||||
//! To learn more, run the command again with --verbose.
|
||||
//! ```
|
||||
//!
|
||||
//! Solution: We are not there yet! Switch to the nightly toolchain with `rustup default nightly`.
|
||||
//! Solution: Switch to the nightly toolchain with `rustup default nightly`.
|
||||
//!
|
||||
//! ## Used `CARGO_INCREMENTAL=1`
|
||||
//!
|
||||
//! Error message:
|
||||
//!
|
||||
//! ``` text
|
||||
//! $ xargo build
|
||||
//! error: linking with `arm-none-eabi-ld` failed: exit code: 1
|
||||
//! |
|
||||
//! = note: "arm-none-eabi-ld" (..)
|
||||
//! = note: arm-none-eabi-ld:
|
||||
//! You must specify the exception handlers.
|
||||
//! Create a non `pub` static variable with type
|
||||
//! `cortex_m::exception::Handlers` and place it in the
|
||||
//! '.rodata.exceptions' section. (cf. #[link_section]). Apply the
|
||||
//! `#[used]` attribute to the variable to make it reach the linker.
|
||||
//! arm-none-eabi-ld:
|
||||
//! Invalid '.rodata.exceptions' section.
|
||||
//! Make sure to place a static with type `cortex_m::exception::Handlers`
|
||||
//! in that section (cf. #[link_section]) ONLY ONCE.
|
||||
//! ```
|
||||
//!
|
||||
//! Solution: `$ unset CARGO_INCREMENAL`. And to be on the safe side, call
|
||||
//! `cargo clean` and thrash the Xargo sysroot: `$ rm -rf ~/.xargo`
|
||||
//!
|
||||
//! ## Used `gdb` instead of `arm-none-eabi-gdb`
|
||||
//!
|
||||
@@ -305,37 +286,6 @@
|
||||
//! ```
|
||||
//!
|
||||
//! Solution: Use `arm-none-eabi-gdb target/..`
|
||||
//!
|
||||
//! # Used a named piped for `itm.fifo`
|
||||
//!
|
||||
//! Error message:
|
||||
//!
|
||||
//! ``` text
|
||||
//! $ cargo run [--example ..]
|
||||
//!
|
||||
//! Reading symbols from target/thumbv7em-none-eabihf/debug/cortex-m-quickstart...done.
|
||||
//! cortex_m_rt::reset_handler ()
|
||||
//! at $REGISTRY/cortex-m-rt-0.3.12/src/lib.rs:330
|
||||
//! 330 unsafe extern "C" fn reset_handler() -> ! {
|
||||
//! semihosting is enabled
|
||||
//! Ignoring packet error, continuing...
|
||||
//! Ignoring packet error, continuing...
|
||||
//! ```
|
||||
//!
|
||||
//! Note that when you reach this point OpenOCD will become unresponsive and you'll have to kill it
|
||||
//! and start a new OpenOCD process before you can invoke `cargo run` / start GDB.
|
||||
//!
|
||||
//! Cause: You uncommented the `monitor tpiu ..` line in `.gdbinit` and are using a named pipe to
|
||||
//! receive the ITM data (i.e. you ran `mkfifo itm.fifo`). This error occurs when `itmdump -f
|
||||
//! itm.fifo` (or equivalent, e.g. `cat itm.fifo`) is not running.
|
||||
//!
|
||||
//! Solution: Run `itmdump -f itm.fifo` (or equivalently `cat itm.fifo`) *before* invoking `cargo
|
||||
//! run` / starting GDB. Note that sometimes `itmdump` will exit when the GDB session ends. In that
|
||||
//! case you'll have to run `itmdump` before you start the next GDB session.
|
||||
//!
|
||||
//! Alternative solution: Use a plain text file instead of a named pipe. In this scenario you omit
|
||||
//! the `mkfifo itm.dump` command. You can use `itmdump`'s *follow* mode (-F) to get named pipe like
|
||||
//! output.
|
||||
|
||||
#![no_std]
|
||||
|
||||
|
||||
Reference in New Issue
Block a user