README.md

Raw Rust bindings for the ESP IDF SDK

Highlights

• Build is cargo driven and automatically downloads & configures everything by default; no need to download the ESP IDF SDK manually, or set up a C toolchain
• Supports both native ESP IDF build (default), as well as a PlatformIO build
• Option to use in a mixed Rust/C project. Check the documentation in the esp-idf-template crate

You might want to also check out the type safe Rust wrappes built on top of these raw bndings:

• Type safe wrappers for ESP IDF Services
• Type safe wrappers for ESP IDF Drivers

Note
esp-idf-sys's build script will download the esp-idf, its gcc toolchain, and build it. To show progress and build information about this process run cargo with the -vv (very verbose) flag, so that build script output is also displayed. This is especially useful since the initial build will take a while.

Build Prerequisites

Follow the Prerequisites section in the esp-idf-template crate.

Customizing how the ESP IDF SDK is built

Read the documentation here.

More information

For more information, check out:

• The Rust on ESP Book
• The ESP Embedded Training
• The esp-idf-template project
• The esp-idf-svc project
• The esp-idf-hal project
• The embedded-svc project
• The embedded-hal project
• The Rust for Xtensa toolchain
• The Rust-with-STD demo project