- Implements the traits of embedded-hal
V0.2as well as those of
V1.0- both blocking and async
- Supports almost all ESP IDF drivers: GPIO, SPI, I2C, TIMER, PWM, I2S, UART, etc.
- Blocking and
asyncmode for each driver (
asyncsupport in progress)
(For baremetal Rust ESP projects please check
Follow the Prerequisites section in the
The examples could be built and flashed conveniently with
cargo-espflash. To run e.g. the
ledc_simple on an e.g. ESP32-C3:
(Swap the Rust target and example name with the target corresponding for your ESP32 MCU and with the example you would like to build)
cargo-espflash < v2.0:
$ ESP_IDF_VERSION=release/v4.4 cargo espflash --target riscv32imc-esp-espidf --example ledc_simple --monitor /dev/ttyUSB0
cargo-espflash > v2.0:
$ ESP_IDF_VERSION=release/v4.4 cargo espflash flash --target riscv32imc-esp-espidf --example ledc_simple --monitor
In order to run the examples on other chips you will most likely need to adapt at least the used pins.
esp-idf-template project. Everything would be arranged and built for you automatically - no need to manually clone the ESP IDF repository.
For more information, check out:
- The Rust on ESP Book
- The ESP Embedded Training
- The Rust for Xtensa toolchain
- The Rust-with-STD demo project
Each chip has a number of GPIO pins which are generally used by the
SPI1 peripherals in order to connect external PSRAM and/or SPI Flash memory. The datasheets explicitly state that these are not recommended for use, however this crate includes them anyways for completeness.
Please refer to the table below to determine the pins which are not recommended for use for your chip.
|ESP32||6 - 11, 16 - 17|
|ESP32-C2||12 - 17|
|ESP32-C3||12 - 17|
|ESP32-C6||24 - 30|
|ESP32-H2||15 - 21|
|ESP32-S2||26 - 32|
|ESP32-S3||26 - 32, 33 - 37*|
* When using Octal Flash and/or Octal PSRAM