Skip to content

Session 4 Reference

🎮 Xbox controller map

Control CommandXboxController Axis or button Value
Left stick X getLeftX() axis 0 -1 left to 1 right
Left stick Y getLeftY() axis 1 -1 forward to 1 back
Right stick X getRightX() axis 4 -1 left to 1 right
Right stick Y getRightY() axis 5 -1 forward to 1 back
Left trigger getLeftTriggerAxis() axis 2 0 to 1
Right trigger getRightTriggerAxis() axis 3 0 to 1
A, B, X, Y a(), b(), x(), y() 1, 2, 3, 4 Trigger
Bumpers leftBumper(), rightBumper() 5, 6 Trigger
Back, Start back(), start() 7, 8 Trigger

🔘 Trigger methods

Method Runs the command
onTrue(cmd) Once, when the button is pressed
whileTrue(cmd) While held; stops on release
toggleOnTrue(cmd) Press to start, press again to stop
onFalse(cmd) Once, when released

🔁 Command lifecycle

Method The scheduler calls it
constructor Once, at new. Store parameters, addRequirements
initialize() Once, each time the command starts
execute() Every 20 ms while it runs
isFinished() Every 20 ms, after execute(). Return true to stop
end(boolean interrupted) Once, when it stops. interrupted is true if something else stopped it

ArcadeDriveCommand skips initialize() because it has nothing to set up.

⏱️ Timer

import edu.wpi.first.wpilibj.Timer;

private final Timer m_timer = new Timer();
m_timer.restart();              // back to zero and running
m_timer.get();                  // seconds since restart
m_timer.hasElapsed(1.5);        // true once 1.5 s have passed
Timer.getFPGATimestamp();       // the robot's clock, in seconds, no object needed

🧰 Small commands without a class

Factory Meaning
subsystem.runOnce(() -> ...) Do this once
subsystem.run(() -> ...) Do this every loop until interrupted
subsystem.startEnd(() -> start, () -> end) Do the first at start, the second when it stops
Commands.print("text") Print a line, then finish
cmd.withTimeout(seconds) cmd, but stop it after that many seconds

🖥️ Sim GUI

Panel Use
Robot State Pick the mode. This is your Driver Station
Timing How long the program has been running
System Joysticks Drag a controller or Keyboard 0 to a slot in Joysticks
PWM Outputs Motor speeds by channel
DIO Digital pins: 3 is the yellow LED, 1 the green LED
Encoders Session 5: type in a distance to fake wheel travel
NetworkTables Everything published with SmartDashboard

Keyboard 0 defaults: W / S axis 1, A / D axis 0, Z X C V buttons 1-4.

⌨️ Commands

./gradlew test                       # in the Codespace
git fetch origin && git checkout yourname/session-4   # on the laptop
./gradlew simulateJava               # on the laptop: opens the Sim GUI
./gradlew simulateJava -Pheadless    # on the laptop, no GUI