Skip to content

Update the simulator page for the 2026 AdvantageScope layout #21

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
aschokking wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Update the simulator page for the 2026 AdvantageScope layout #21

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0de0513
Drop the Swerve tab from the simulator page's tab list
aschokking Oct 10, 2026
96a68ee
Describe the 2026 AdvantageScope layout's two tabs
aschokking Oct 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions docs/curriculum/robot-fundamentals/simulator.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,19 +45,19 @@ When you're done it should look like this:
3. Choose **File → Import Layout...** and select `AdvantageScope_layout.json` from the top folder of your XbotEdu repository. This sets up tabs for viewing the robot.
4. Pick a tab at the top of the window.

The tabs the layout gives you:
The layout gives you two views of the robot on the 2026 field:

| Tab | What it shows |
|-----|---------------|
| **2d top view** | The robot on the field from above. The easiest view for most challenges. |
| **3d view** | The same thing in 3D. |
| **Joysticks** | What the robot thinks your controller is doing. Handy when the robot doesn't respond. |
| **Swerve** | Swerve module angles and speeds. Its data sources need setting up before it shows anything -- see the [Advanced Swerve Challenges](/curriculum/challenges/advanced-swerve-challenges). |
| **Table** | Every value the robot code is logging. |
| **Console** | Messages printed by the robot code. |
| **2d top view** | The robot from above. The easiest view for most challenges. |
| **3D Field** | The same thing in 3D. |

Now drive! The robot on screen should move as you use the controller.

::: tip Seeing the raw data
The sidebar on the left lists every value the robot code is logging. Drag any of them into a tab, or onto a new tab from the **+** button, to look at it -- for example the drive motors under `AdvantageKit/DriveSubsystem`.
:::

## Making changes

Your code only updates when the simulator restarts:
Expand All @@ -71,7 +71,7 @@ If AdvantageScope shows no data after a restart, choose **File → Connect to Si
## Troubleshooting

**The robot doesn't move at all.**
Check that **Teleoperated** is selected in the Robot Simulation window -- a disabled robot ignores every input. Then check that your controller is in the **Joystick[0]** slot, not one of the others. The **Joysticks** tab in AdvantageScope shows whether the robot is seeing your input.
Check that **Teleoperated** is selected in the Robot Simulation window -- a disabled robot ignores every input. Then check that your controller is in the **Joystick[0]** slot, not one of the others. In the Robot Simulation window, the axis values under Joystick[0] should change as you move the sticks -- if they don't, the robot isn't getting your input.

**My gamepad isn't listed under System Joysticks.**
Make sure it's plugged in. If it still doesn't appear, stop and restart the simulator.
Expand Down
Loading