Skip to content

Add Robot Simulator and AdvantageScope documentation - #159

Draft
TaylerUva with Copilot wants to merge 5 commits into
mainfrom
copilot/setup-simulator-connection
Draft

Add Robot Simulator and AdvantageScope documentation#159
TaylerUva with Copilot wants to merge 5 commits into
mainfrom
copilot/setup-simulator-connection

Conversation

Copilot AI commented Jan 30, 2026

Copy link
Copy Markdown
Contributor
  • Move Quick Reference section to top of document
  • Remove redundant horizontal rules
  • Update AdvantageScope opening method to use WPILib command palette
  • Correct connection instructions based on AdvantageScope documentation
  • Update table to clarify visualization differences
  • Remove redundant bullet points
  • Simplify connection sections and remove unnecessary subsections
  • Add Mac keyboard shortcuts to Quick Reference
  • Take updated screenshot

Summary

Successfully addressed all review feedback:

  • Quick Reference moved to top for easy access
  • AdvantageScope opening corrected to use WPILib command palette
  • Connection instructions updated based on actual AdvantageScope UI (Live Sources → NetworkTables)
  • Removed redundant content throughout document
  • Updated comparison table for better clarity
  • Added Mac keyboard shortcuts in Quick Reference

Screenshot: https://github.com/user-attachments/assets/7b9fa5cb-317e-42f8-b3cf-aee51be1f906

Original prompt

This section details on the original issue you should resolve

<issue_title>Setting up and connecting to simulator</issue_title>
<issue_description>What sim is

What advantage scope is

Which is which?

How to connect sim in advantage scope

How to connect robot to advantage scope</issue_description>

<agent_instructions>Additional context:
https://docs.wpilib.org/en/stable/docs/software/wpilib-tools/robot-simulation/introduction.html

https://docs.advantagescope.org</agent_instructions>

Comments on the Issue (you are @copilot in this section)


💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Copilot AI and others added 2 commits January 30, 2026 18:30
Co-authored-by: TaylerUva <8679670+TaylerUva@users.noreply.github.com>
…placeholder note

Co-authored-by: TaylerUva <8679670+TaylerUva@users.noreply.github.com>
Copilot AI changed the title [WIP] Add setup process for connecting to simulator in Advantage Scope Add Robot Simulator and AdvantageScope documentation Jan 30, 2026
Copilot AI requested a review from TaylerUva January 30, 2026 18:32

@TaylerUva TaylerUva left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is some redundant content. Changing headings and order may help reduce redundancy. Quick reference should be at the top

- **Test Without Hardware**: Run and debug your code without needing the actual robot
- **Rapid Iteration**: Make code changes and test them immediately without deploying to hardware
- **Safe Testing**: Test dangerous or complex scenarios without risking damage to the robot
- **Physics Simulation**: Simulates robot physics including drivetrain movement, motor behavior, and sensor readings

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- **Physics Simulation**: Simulates robot physics including drivetrain movement, motor behavior, and sensor readings

- During early development before the robot is built
- Testing autonomous routines and path following
- Debugging sensor logic and state machines
- Training new programmers without requiring robot access

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Training new programmers without requiring robot access


### When to Use AdvantageScope:
- Debugging robot behavior during testing
- Verifying swerve offsets (swoffsets)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Verifying swerve offsets (swoffsets)

| Feature | Robot Simulator (Sim) | AdvantageScope |
|---------|----------------------|----------------|
| **Purpose** | Runs robot code without hardware | Visualizes and analyzes robot data |
| **Built Into** | WPILib / VS Code | Standalone application |

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| **Built Into** | WPILib / VS Code | Standalone application |

| **Purpose** | Runs robot code without hardware | Visualizes and analyzes robot data |
| **Built Into** | WPILib / VS Code | Standalone application |
| **Primary Use** | Testing code execution and logic | Viewing telemetry and debugging |
| **3D Visualization** | Basic physics simulation | Advanced 3D robot visualization |

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| **3D Visualization** | Basic physics simulation | Advanced 3D robot visualization |
| **Visualization** | Raw NetworkTables Data | Advanced 3D robot visualization |


#### 4. Visualize Your Data
1. Navigate to the **3D Field** tab to see your robot on the field
2. Use the **Swerve** tab to view swerve drive states (if applicable)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
2. Use the **Swerve** tab to view swerve drive states (if applicable)

Comment on lines +130 to +137
#### 3. Connect to the Robot
1. Click on the **connection icon** in the top-left corner
2. Select **Robot** or **Team Number** as the connection type
3. Enter your team number (e.g., `3255`)
- AdvantageScope will automatically calculate the robot's IP address: `10.TE.AM.2` (e.g., `10.32.55.2` for team 3255)
- Alternatively, you can manually enter the IP address
4. Click **Connect**
5. You should see a green indicator when connected successfully

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Corrected connection instructions to use "Live Sources" → "NetworkTables" in the left sidebar with team number/IP entry. Commit 1ed06ab.


#### 4. View Live Robot Data
1. Navigate to the **3D Field** tab to see your robot's live position
2. Use the **Swerve** tab to verify swerve module alignment and offsets

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
2. Use the **Swerve** tab to verify swerve module alignment and offsets

Comment on lines +151 to +157
**Direct IP Connection**:
- Robot over USB: `172.22.11.2`
- Robot over WiFi: `10.TE.AM.2` (e.g., `10.32.55.2`)

**mDNS Connection**:
- Use `roboRIO-3255-FRC.local` (replace 3255 with your team number)
- May not work on all networks

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
**Direct IP Connection**:
- Robot over USB: `172.22.11.2`
- Robot over WiFi: `10.TE.AM.2` (e.g., `10.32.55.2`)
**mDNS Connection**:
- Use `roboRIO-3255-FRC.local` (replace 3255 with your team number)
- May not work on all networks

Comment on lines +147 to +149
**Team Number Connection** (Recommended):
- Enter your team number: `3255`
- AdvantageScope automatically resolves to: `10.32.55.2`

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Corrected connection instructions to use "Live Sources" → "NetworkTables" in the left sidebar. Removed incorrect connection options section. Commit 1ed06ab.

…ope opening method, correct connection instructions, remove redundant sections

Co-authored-by: TaylerUva <8679670+TaylerUva@users.noreply.github.com>

Copilot AI commented Jan 31, 2026

Copy link
Copy Markdown
Contributor Author

There is some redundant content. Changing headings and order may help reduce redundancy. Quick reference should be at the top

Moved Quick Reference to the top and removed redundant horizontal rules and content throughout the document. Commit 1ed06ab.

Screenshot: https://github.com/user-attachments/assets/7b9fa5cb-317e-42f8-b3cf-aee51be1f906

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • docs.advantagescope.org
    • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node /home/REDACTED/work/_temp/ghcca-node/node/bin/node --enable-source-maps /home/REDACTED/work/_temp/copilot-developer-action-main/dist/index.js (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Co-authored-by: TaylerUva <8679670+TaylerUva@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Setting up and connecting to simulator

2 participants