esp8266-hal

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.

Setting up the compiler

• setup the xtensa rust compiler.

$ git clone https://github.com/MabezDev/rust-xtensa $ cd rust-xtensa $ ./configure --experimental-targets=Xtens $ ./x.py build

• link the custom rust build into rustup

$ rustup toolchain link xtensa /path/to/rust-xtensa/build/x86_64-unknown-linux-gnu/stage1

• install the xtensa-lx106-elf toolchain from the espressif web site.

$ mkdir ~/esp $ tar -xzf ~/Downloads/xtensa-lx106-elf-linux64-1.22.0-100-ge567ec7-5.2.0.tar.gz -C ~/esp $ PATH="$PATH:$HOME/esp/xtensa-lx106-elf/bin"

• install cargo-espflash

$ cargo install cargo-espflash

Flashing the examples

Once you have your rust compiler and toolchain bits setup you can flash the examples using

$ cargo +xtensa espflash --release --example blinky --tool cargo /dev/ttyUSB0

License

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.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.