playfulfence / esp-etch-a-sketch

esp-etch-a-sketch 🦀

Wokwi-example how to create a simple Etch-a-Sketch game with joystick and 8x8 LED Dot Matrix Display (check this example also) is initialised for ESP32

Instructions

Build

cargo build --target xtensa-esp32-none-elf --release

Execution with VSCode Wokwi extension

Except of extension itself, you will need two files to execute the simulatuion inside of your VSCode IDE:

• wokwi.toml
• diagram.json

Both of them are already provided in this repo and you can edit them as needed.

F1 -> Wokwi: Start simulation

In case you will have additional questions - feel free to open an issue 😉

Description

There's a short example that shows, how to create simple famous Etch-A-Sketch game with 8x8 LED Matrix display on different Espressif boards (ESP32, ESP32S2, ESP32C3) in bare-metal, this config is for ESP32 in terms of example, but you can find brief instructions for other chips below

P.S. : You can edit string at line 92 😉

Tips for other chips

For esp32c3 board target (and corresponding changes for paths in wokwi.toml) is:

riscv32imac-unknown-none-elf

Board type in diagram.toml is:

"type": "board-esp32-c3-devkitm-1"

---

For esp32s2 board target (and corresponding changes for paths in wokwi.toml) is:

xtensa-esp32s2-none-elf

Board type in diagram.toml is:

"type": "board-esp32-s2-devkitm-1""

---

For esp32s3 board target (and corresponding changes for paths in wokwi.toml) is:

xtensa-esp32s3-none-elf

Board type in diagram.toml is:

"type": "board-esp32-s3-devkitc-1"

Troubleshooting

• For xtensa targets you need to have esp-idf exported in your terminal
• In case of errors, related to esp-hal driver - try to play with dependencies versions on Cargo.toml. Sometimes there're a lot of breaking or light changes, that can affect building process

esp-etch-a-sketch's Issues

can't build this project

OS: windows 11
Default host: x86_64-pc-windows-msvc
installed toolchains

stable-x86_64-pc-windows-msvc (default)
nightly-2022-03-10-x86_64-pc-windows-msvc
nightly-x86_64-pc-windows-msvc
esp
1.63.0-x86_64-pc-windows-msvc

active toolchain

esp (overridden by 'D:\Dev\ESP32\esp-etch-a-sketch\rust-toolchain.toml')
rustc 1.68.0-nightly (4651851b1 2023-03-07) (1.68.0.0)

i was using cmd cargo build --target xtensa-esp32-none-elf --release and get this