fredr/esp-template

A minimal esp-hal application template for use with cargo-generate

esp-template

A minimalist template for use with cargo-generate to create no_std applications targeting Espressif's line of SoCs and modules. At present this template supports the ESP32, ESP32-C2, ESP32-C3, ESP32-S2, and ESP32-S3; additional devices will be added as they become available.

To generate a project using this template:

cargo generate -a esp-rs/esp-template

After running the command, there will be a few prompts:

• Project Name: Name of the crate.

• Which MCU to target?: SoC model.

• Enable allocations via the esp-alloc crate?: Adds esp-alloc dependency, and initializes the heap.

• Configure project to use Dev Containers (VS Code, GitHub Codespaces and Gitpod)?: Adds support for:

  • VS Code Dev Containers
  • GitHub Codespaces
  • Gitpod

  Dev Containers also have integration with Wokwi simulator and allow flashing from the container using web flash.

For a more detailed explanation about the template see Understanding esp-template chapter of The Rust on ESP Book.

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.