Rust Toolchain Setup

1. Install Rust

If you don't have Rust installed yet:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Follow the prompts and accept the defaults. After installation, restart your terminal or run:

source $HOME/.cargo/env

Verify:

rustc --version
cargo --version

The ESP32-C3 uses a RISC-V architecture. Add the target:

rustup target add riscv32imc-unknown-none-elf

espflash is used to flash firmware to ESP32 chips and monitor serial output:

cargo install espflash

This may take a few minutes to compile. Verify:

espflash --version

esp-generate creates new ESP32 Rust projects from templates:

cargo install esp-generate

Let's make sure everything works together:

esp-generate --chip esp32c3 hello-uferris
cd hello-uferris

When prompted, select:

The project should generate without errors.

cargo build --release

This first build will take a while as it downloads and compiles dependencies. Subsequent builds are fast.

If `cargo build --release` completes without errors, your toolchain is ready. Next: [Hardware Verification](./hardware.md).

This is normal for the first install — Rust compiles from source. Grab a coffee.

Make sure you're using a recent rustup:

rustup self update
rustup update
rustup target add riscv32imc-unknown-none-elf

You may need to add your user to the dialout group for serial port access (this matters for the next step):

sudo usermod -a -G dialout $USER

Log out and back in for this to take effect.