Welcome to the v5gdb user manual! This guide will help you set up a debugger for your VEX V5 project.

v5gdb is alpha software, so details are subject to change. Currently, v5gdb only supports Rust (vexide framework) and C++ (PROS framework) programs, but it is being developed in a framework-independent way that will allow us to add support for C++ (VEXcode framework) later.

If you're new to v5gdb, please read our installation and setup guide for Rust projects.

If you use the PROS framework, there's an installation and setup guide for C++ (PROS) projects too.

Here are some common GDB commands you may find helpful:

• layout src will show you what code is currently running. After running the above command, focus cmd will let you use the up and down arrow keys to quickly select a previous command.
• break fib will set a breakpoint on a function named "fib", and break main.rs:15 will put a breakpoint on line 15 of main.rs.
• step will step execution forward by an single line of code.
• next will step execution forward by an single line of code, and "jump over" function calls.
• monitor help will show the special commands specific to the vexide debugger.
• cont will exit the debug console and continue execution as normal. The debug console session will resume if a breakpoint is hit.
• quit will quit the debugger.
• info locals will show you the values of all the variables in the current function.
• info args will show you the values of all the parameters passed to the current function.
• info frame tells you what function is currently running and what file/line number you're on.
• backtrace tells you what function called the current function, and what function called that one, and so on.
• print can be used to print out certain variables or call functions, like this:
  • Call a function: print my_crate::calculate_number(30, 100, 4)
  • Print a variable or expression: print kp * error
• finish will skip to the end of the current function.

Click here to view the v5gdb internal documentation.

If you have questions about v5gdb, please send us feedback in our discord server.