Safe Rust wrappers for the drivers in the ESP IDF SDK
V0.2
as well as those of V1.0.alpha
async
mode for each driver (async
support in progress)You might want to also check out the ESP IDF Services wrappers, and the raw bindings to ESP IDF in the esp-idf-sys crate!
(For baremetal Rust ESP projects please check esp-hal.)
Follow the Prerequisites section in the esp-idf-template
crate.
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)
with cargo-esptool v1.7:
$ ESP_IDF_VERSION=release/v4.4 cargo espflash --target riscv32imc-esp-espidf --example ledc_simple --monitor /dev/ttyUSB0
with cargo-esptool 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.
Use the 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:
Each chip has a number of GPIO pins which are generally used by the SPI0
and 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.
Chip | GPIOs |
---|---|
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
Author: esp-rs
Source: https://github.com/esp-rs/esp-idf-hal
License: Apache-2.0, MIT licenses found