1 unstable release
0.2.0 | Oct 17, 2022 |
---|
#1041 in Hardware support
28KB
282 lines
Wokwi server
A CLI tool for launching a wokwi instance for your project.
Installation
Download the prebuilt executables for you platform from the releases pages. Alternatively, if you have Rust installed you can install it via cargo.
cargo install wokwi-server --git https://github.com/MabezDev/wokwi-server --locked
Usage
Only two arguments are required, the target, specified with --target
and the path to your application elf file. Example running the esp-idf blink example on Wokwi:
$ idf.py build # build the application
$ wokwi-server --chip esp32 build/blink.elf # running example opened in the browser!
As a cargo runner
Inside .cargo/config.toml
, add a runner
section to your target
key (cargo reference). Example for the esp32:
runner = "wokwi-server --chip esp32"
Once configured, it's possible to launch and run your application in the Wokwi simulator by running cargo run
.
GDB support
Wokwi exposes a GDB stub which this tool exposes via a TCP connection, see the following vscode configuration as a reference.
{
"type": "gdb",
"request": "attach",
"name": "VsCode: Wokwi Debug",
// change this!
"executable": "${workspaceFolder}/target/xtensa-esp32-espidf/debug/esp-fs-tests",
"target": "127.0.0.1:9333",
"remote": true,
// change this!
"gdbpath": "xtensa-esp32-elf/bin/xtensa-esp32-elf-gdb",
"cwd": "${workspaceRoot}",
"stopAtConnect": true,
"valuesFormatting": "parseText"
}
Dependencies
~28–42MB
~585K SLoC