Pre-Workshop Setup

~30 min at home

Please complete this setup before the workshop day. Our goal is zero time spent on toolchain issues during the workshop itself.

If you run into problems, reach out on the workshop communication channel — we'll help you get sorted before May 18.

If you arrive without a working setup, you'll spend valuable hands-on time debugging your environment instead of learning embedded Rust. The [Wokwi fallback](./wokwi.md) is available, but a native setup is strongly recommended.

What You'll Set Up

  1. Rust toolchain with the RISC-V target for ESP32-C3
  2. espflash for flashing firmware to the board
  3. esp-generate for creating new projects
  4. A test flash to verify everything works end-to-end
  5. Wokwi (optional) as a simulation fallback

Quick Check

Already set up? Run this to verify:

rustup target list --installed | grep riscv32imc
espflash --version

If both commands produce output, you're probably good. Jump to Hardware Verification to confirm with a real flash.