History

Jesse Braham 39b4db0cf9 Add examples for the `RNG` peripheral for all supported devices		2023-02-28 07:58:38 -08:00
..
.cargo	Support ESP32-C2 with 26MHz Xtal	2022-12-13 05:15:10 -08:00
examples	Add examples for the `RNG` peripheral for all supported devices	2023-02-28 07:58:38 -08:00
ld	Refactor the `clock` module, provide ROM functions via linker scripts (#353 )	2023-01-23 07:12:33 -08:00
src	Make sure to re-export xtensa-lx-rt	2023-02-13 10:09:20 +01:00
build.rs	add support for 26mhz esp32	2023-02-16 16:54:26 +10:30
Cargo.toml	New releases for all HAL packages	2023-02-21 07:43:44 -08:00
README.md	feat: 📝 Update install sections	2022-11-24 08:30:57 -08:00
rust-toolchain.toml	Add a minimal HAL crate for the ESP32 with a serial example	2021-10-21 17:28:02 -07:00

README.md

esp32-hal

no_std HAL for the ESP32 from Espressif. Implements a number of the traits defined by embedded-hal.

This device uses the Xtensa ISA, which is not officially supported by the Rust compiler. In order to develop for this device you must use the Rust compiler fork with Xtensa support found at esp-rs/rust. Refer to the Getting Stared section below for more information.

Documentation

Getting Started

Installing the Rust Compiler

cargo install espup
espup install
# Unix
. $HOME/export-esp.sh
# Windows
%USERPROFILE%\export-esp.ps1

See the Installation chapter of The Rust on ESP Book for more details.

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.