Wokwi Fallback

The workshop is designed for real hardware — that's the experience. Use this fallback only if your hardware setup fails and you can't resolve it before the workshop.

GitHub Codespace with Wokwi

The easiest way to get a working simulation environment is to use the Simplified Embedded Rust book project, which includes a pre-configured devcontainer with Wokwi support for the ESP32-C3.

Steps

1. Go to the Simplified Embedded Rust book project branch
2. Click Code → Codespaces → Create codespace on project
3. Wait for the devcontainer to build (this includes the Rust toolchain and Wokwi extension)
4. Replace the code in src/main.rs with your workshop exercise code
5. Build and run in the Wokwi simulator

The Wokwi board definition in this repo simulates the ESP32-C3. Pin assignments may not exactly match the uFerris board — check the simulation diagram and adjust as needed.

Switching to Hardware

If your hardware issue gets resolved during the workshop, you can switch to real hardware at any time by simply flashing with espflash instead of running the simulator. The code is the same — only the deployment target changes.