An experimental hardware abstraction layer for the esp8266 written in Rust.
Contributions are welcome :)
Join in on the discussion: https://matrix.to/#/#esp-rs:matrix.org!
An example project using the crate can be found here.
In order to build Rust for the Xtensa architecture, you must use the esp-rs/rust compiler fork.
This can be installed via the installation scripts and pre-built artifacts found in the esp-rs/rust-build repository. Alternatively, you can build and install the compiler from source.
For more information relating to the Rust compiler fork please refer to the Installing Rust section of The Rust on ESP Book.
$ curl -LO https://raw.githubusercontent.com/esp-rs/rust-build/main/install-rust-toolchain.sh
$ chmod +x install-rust-toolchain.sh
$ ./install-rust-toolchain.sh
PS> Invoke-WebRequest https://raw.githubusercontent.com/esp-rs/rust-build/main/Install-RustToolchain.ps1 -OutFile Install-RustToolchain.ps1
PS> .\Install-RustToolchain.ps1
Alternatively you might build the project in the container where image already contains pre-installed Rust and ESP-IDF.
$ podman run --device /dev/ttyUSB0 -it docker.io/espressif/idf-rust
This container is lacking the utilities for the ESP8266, but you can install them using these instructions inside the container:
$ apt update && apt install gcc-xtensa-lx106 binutils-xtensa-lx106
Once you have the Rust compiler fork installed you can flash the examples using cargo-espflash:
$ cargo install cargo-espflash
$ cargo espflash --release --example blinky /dev/ttyUSB0
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.