This crate is an old EXPERIMENT and has been archived. All the goodies have landed in upstream cortex-m-rt and Cortex-M development is possible on the stable as of Rust 1.30.
-- @japaric, 2018-12-08
The closest we are to embedded no-std binaries on stable Rust
This is a minimal re-implementation of cortex-m-rt that replaces most of the unstable features
used there with stable counterparts. There's no loss in the main functionality provided by
cortex-m-rt but there's quite a drastic change in the interface presented to the end user cf.
the examples directory.
- Booting
- Initializing RAM (.bss+.data)
- Valid vector table (for simplicity, device specific interrupts have been omitted in this experiment)
- Individually overriding an exception handler
- Declaring a default exception handler
- Assembly via external assembly files
All that works without optimization (+ incr. comp and parallel codegen), with optimization and with LTO.
For more details about how and why this differs from cortex-m-rt check the embedonomicon.
This doesn't work on stable yet.
There's only one unstable features that still ties this experiment to nightly: the panic_fmt
lang item. We hope that we'll have stable replacement for it by the time the 2018 edition is
released.
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
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.