Skip to content

Stage 1A: Adjustments - #291

Open
Adrianamm wants to merge 20 commits into
frcsoftware:mainfrom
Adrianamm:readthrough
Open

Adrianamm wants to merge 20 commits into
frcsoftware:mainfrom
Adrianamm:readthrough

Conversation

@Adrianamm

@Adrianamm Adrianamm commented Sep 15, 2026 •

Copy link
Copy Markdown
Member

Description

What changed?
Followed 1a and made adjustments

Meta

Merge checklist:

@github-actions github-actions Bot added Curriculum material Curriculum materials, lessons for students, etc stage1 labels Sep 15, 2026
@github-actions

Copy link
Copy Markdown

🌐 Preview URL: https://pr-291-frcsoftware.frcsoftware.workers.dev

@Adrianamm Adrianamm added this to the First Publish milestone Sep 15, 2026
@Adrianamm
Adrianamm marked this pull request as ready for review September 17, 2026 04:02
Comment thread src/content/docs/learning-course/stage1/stage1a/drivetrain-sim.mdx Outdated
Comment thread src/content/docs/learning-course/stage1/stage1a/drivetrain-sim.mdx Outdated
Comment thread src/content/docs/learning-course/stage1/stage1a/kitbot-drivetrain.mdx Outdated
Comment thread src/content/docs/learning-course/stage1/stage1a/kitbot-drivetrain.mdx Outdated
Comment thread src/content/docs/learning-course/stage1/stage1a/kitbot-drivetrain.mdx Outdated
Adrianamm and others added 2 commits September 18, 2026 18:30
Co-authored-by: Andrew Haselton <13470989+roboteer5291@users.noreply.github.com>
@Adrianamm Adrianamm removed this from the First Publish milestone Sep 26, 2026
Create an instance of the `DrivetrainSim` class under the `DifferentialDrive` instance using the left and right Leader motors as inputs.
This class will read the voltage commanded to the motors and, using its physics sim, update the motor controllers with new positions.
The class will then publish the new drivetrain position and additional motor data so it can be viewed in AdvantageScope.
AdvantageScope is a program that is bundled with WPILib, and is used to visualize data sent by the robot.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Why did this line get moved to here?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

because it's the first mention of AScope so I thought it would make more sense to explain it there

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

That makes sense. I'd maybe change it to more have this instance talk about the capabilities of AScope, and have the previous location include the bundled with wpilib bit (so that the user knows they don't have to install it).

Comment thread src/content/docs/learning-course/stage1/stage1a/getting-started.mdx Outdated
Comment thread src/content/docs/learning-course/stage1/stage1a/kitbot-drivetrain.mdx Outdated
Comment thread src/content/docs/learning-course/stage1/stage1a/kitbot-drivetrain.mdx Outdated
Comment thread src/content/docs/learning-course/stage1/stage1a/kitbot-drivetrain.mdx Outdated
Adrianamm and others added 2 commits September 27, 2026 20:47
Co-authored-by: Andrew Haselton <13470989+roboteer5291@users.noreply.github.com>
Comment on lines +16 to +17
While there are some things that can be tested by simulating pure robot code, there are no physical motors to move and respond with new positions.
Instead we use simulation classes that use physics to take the desired input voltage to the motors and estimate how the physical mechanism would respond and update our motor controller instances to match.
Instead, we use simulation classes that use physics to take the desired input voltage to the motors and model how the physical mechanism would respond.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

this says 'while some things can be simulated...instead we simulate motors'.

Comment thread src/content/docs/learning-course/stage1/stage1a/drivetrain-sim.mdx Outdated
Comment thread src/content/docs/learning-course/stage1/stage1a/kitbot-drivetrain.mdx Outdated
Comment thread src/content/docs/learning-course/stage1/stage1a/kitbot-drivetrain.mdx Outdated
Comment thread src/content/docs/learning-course/stage1/stage1a/kitbot-drivetrain.mdx Outdated
WPILib provides a class to convert joystick inputs into commands for the motors to follow called `DifferentialDrive`.

An instance of `DifferentialDrive` should be created under where the motor controllers were declared.
An instance of `DifferentialDrive` should be created under where the motor controllers were first declared.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

nitpick: it should be constructed where they're constructed, since it needs them to have been instantiated. If you try to construct it where they're declared, but they haven't been constructed, you can get an error

Comment thread src/content/docs/learning-course/stage1/stage1a/kitbot-drivetrain.mdx Outdated
Comment thread src/content/docs/learning-course/stage1/stage1a/simple-auto.mdx Outdated
Adrianamm and others added 3 commits September 28, 2026 21:53
Co-authored-by: Tim Winters <twinters007@gmail.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Curriculum material Curriculum materials, lessons for students, etc stage1

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants