Stepping Through a Project in VRC Virtual Skills

The Project Stepping feature provides the user with important visual cues that help troubleshoot or better understand a project's flow. When a project is run, Moby, the Hero Bot, will run as instructed, but it may not be how the user intended. Having the ability to see the blocks being executed one step at a time gives the user a better visual of which blocks may be causing the error.

The following article will cover:


How to Use the Project Stepping Feature

step.png

Select the step button located at the top right of the VEXcode V5 toolbar.

first_block.png

Once selected, a green highlight will appear around the “when started“ block to indicate where the program is beginning, and then immediately moves to highlight the first block in the stack. The highlight will stay on the first block after “when started” until the step button is selected again.

Note: the highlight will immediately move past a [Comment] block, because [Comment] blocks do not change the project or blocks surrounding it.

second_block.png

Select the step button again to run the block that is highlighted. Once the block has been executed, the next block will become highlighted.

Continue to use the step button to run through the project one block at a time.


Debugging with the Project Stepping Feature

example_w_mistake.png

The Project Stepping feature slows down the flow of the project and provides immediate visual feedback. This allows the user to go through the project one block at a time to observe behavior and correct mistakes.

In this example, the intention is for Moby to pick up and score a Mobile Goal. However there is a wrong parameter in the project, and the Mobile Goal will not be placed in the Alliance Home Zone.

highlighted_mistake_block.png

mistake_visual.png

Run the project step by step using the Project Stepping feature until a mistake is observed.

highlighted_parameter.png

highlighted_correct_parameter.png

Correct the mistake.

The mistake in this example was that Moby was coded to drive forward 100 millimeters (mm), however this distance is not far enough to reach the Alliance Home Zone. The parameter should be changed to 600 millimeters (mm) instead of 100.

final_block.png

correct_score.png

Then run the project again from the beginning using the Project Stepping feature. Repeat this process until the project runs correctly.