Use GDB to debug Arduino and Raspberry Pi Pico code directly in the Wokwi simulator. Launch web-based GDB sessions, step through code, set breakpoints and inspect variables.
GDB is a powerful source code debugger. You can use it to debug your Arduino and Raspberry Pi Pico code in Wokwi.
In the prompt that opens, type “GDB”, and select “Start Web GDB Session (debug build)”.
3
Wait for GDB to load
A new browser tab will open with the GDB prompt. If this is the first time you are using this feature, it may take up to 30 seconds for GDB to fully load.
When GDB is ready, you’ll get the following prompt:
0x00000000 in __vectors ()(gdb)
At this point you can type GDB commands. For instance, suppose you want to run your program line-by-line, starting from setup(). First, type tbreak setup and c to start the program and run it until the beginning of setup():
(gdb) tbreak setupTemporary breakpoint 1 at 0x2ca: file sketch.ino, line 28.(gdb) cContinuing.Temporary breakpoint 1, setup () at sketch.ino:2828 pinMode(LED_BUILTIN, OUTPUT);(gdb)
At this point, type layout src to show the source code of your program, and type next to execute the next line of source code. You can then type next repeatedly to go over the code line by line.
If you want to print the value of some variable, use the print command. For example, if you have a variable called ledIndex, type print ledIndex to print the value of that variable.
See many examples of useful GDB commands and features
Running GDB in the Browser
Learn how GDB works in the browser (optional technical deep dive)
It takes time to learn about all the different GDB features and to use them efficiently, but it can get very powerful even with just a few basic commands.
