# team254/frc-2019-offseason-public architecture

> Architecture diagram of the GitHub repository team254/frc-2019-offseason-public, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/team254/frc-2019-offseason-public
- Repository: https://github.com/team254/frc-2019-offseason-public

## Overview

This repository is the Team 254 FRC 2019 offseason robot: software for a swerve-drive robot with a Backlash superstructure. Its product workflow spans operator control, autonomous selection, periodic robot/subsystem execution, vision and robot-state updates, and coordinated motion of the drive and game-piece mechanisms. The available excerpts show selected wiring and motion-control details; many runtime connections and the autonomous mode’s actions are unsampled, so those links are omitted rather than inferred.

Main entry points: [`src/main/java/com/team254/frc2019/subsystems/ServoMotorSubsystem.java`](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/subsystems/ServoMotorSubsystem.java) (Servo Motor Base), [`src/main/java/com/team254/lib/motion/ProfileFollower.java`](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/lib/motion/ProfileFollower.java) (Profile Follower), [`src/main/java/com/team254/frc2019/subsystems/LimelightManager.java`](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/subsystems/LimelightManager.java) (Limelight Manager), [`src/main/java/com/team254/frc2019/statemachines/SuperstructureCommands.java`](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/statemachines/SuperstructureCommands.java) (Superstructure Commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Robot Runtime"]
  node_main["Robot Startup<br/>[Main.java]"]
  node_robot["Robot Lifecycle<br/>[Robot.java]"]
  node_controls["Control Boards<br/>[ControlBoard.java]"]
  node_manager["Subsystem Manager"]
  node_looper["Periodic Looper<br/>[Looper.java]"]
  node_ilooper["Loop Registry<br/>[ILooper.java]"]
  node_loop["Loop Contract<br/>[Loop.java]"]
end

subgraph group_autonomy["Autonomous Control"]
  node_auto_selector["Auto Selector"]
  node_auto_executor["Auto Executor"]
  node_auto_base["Auto Mode Base<br/>[AutoModeBase.java]"]
  node_camera_mode["Camera Drive Mode"]
end

subgraph group_vision["Vision and State"]
  node_limelight_manager["Limelight Manager"]
  node_limelight["Limelight<br/>[Limelight.java]"]
  node_robot_state["Robot State<br/>[RobotState.java]"]
  node_state_estimator["State Estimator"]
end

subgraph group_mechanisms["Drive and Superstructure"]
  node_drive["Swerve Drive<br/>[Drive.java]"]
  node_superstructure["Superstructure"]
  node_elevator["Elevator<br/>[Elevator.java]"]
  node_wrist["Wrist<br/>[Wrist.java]"]
  node_end_effector["End Effector<br/>[EndEffector.java]"]
  node_commands["Superstructure Commands"]
  node_servo["Servo Motor Base"]
  node_ss_state["Superstructure State"]
  node_ss_constants["Superstructure Constants"]
end

subgraph group_motion["Motion and Geometry"]
  node_pose["2D Pose<br/>[Pose2d.java]"]
  node_rotation["2D Rotation<br/>[Rotation2d.java]"]
  node_translation["2D Translation<br/>[Translation2d.java]"]
  node_profile_follower["Profile Follower"]
  node_setpoint_generator["Setpoint Generator"]
  node_motion_constraints["Motion Constraints"]
  node_motion_goal["Motion Goal"]
  node_motion_state["Motion State<br/>[MotionState.java]"]
end

node_operator(("Operator"))

node_main -->|"starts"| node_robot
node_operator -.->|"provides input"| node_controls
node_robot -.->|"coordinates"| node_manager
node_manager -->|"registers loops"| node_ilooper
node_looper -->|"implements"| node_ilooper
node_ilooper -->|"registers"| node_loop
node_robot -.->|"selects mode"| node_auto_selector
node_auto_selector -.->|"starts mode"| node_auto_executor
node_auto_executor -->|"runs"| node_auto_base
node_auto_base -.->|"specializes"| node_camera_mode
node_limelight_manager -->|"manages"| node_limelight
node_limelight_manager -->|"adds vision updates"| node_robot_state
node_limelight_manager -->|"checks height"| node_elevator
node_state_estimator -.->|"updates state"| node_robot_state
node_commands -->|"sets goal"| node_superstructure
node_commands -->|"reads piece"| node_end_effector
node_commands -->|"creates setpoint"| node_ss_state
node_wrist -->|"uses state"| node_ss_state
node_servo -->|"generates setpoints"| node_setpoint_generator
node_servo -->|"configures"| node_motion_constraints
node_servo -->|"plans toward"| node_motion_goal
node_servo -->|"updates from"| node_motion_state
node_profile_follower -->|"uses"| node_setpoint_generator
node_profile_follower -->|"uses"| node_motion_constraints
node_profile_follower -->|"uses"| node_motion_goal
node_profile_follower -->|"uses"| node_motion_state
node_pose -->|"composes"| node_translation
node_pose -->|"composes"| node_rotation
node_rotation -->|"rotates"| node_translation

click node_main "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/Main.java"
click node_robot "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/Robot.java"
click node_controls "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/controlboard/ControlBoard.java"
click node_manager "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/SubsystemManager.java"
click node_looper "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/loops/Looper.java"
click node_ilooper "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/loops/ILooper.java"
click node_loop "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/loops/Loop.java"
click node_auto_selector "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/AutoModeSelector.java"
click node_auto_executor "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/auto/AutoModeExecutor.java"
click node_auto_base "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/auto/modes/AutoModeBase.java"
click node_camera_mode "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/auto/modes/DriveByCameraMode.java"
click node_limelight_manager "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/subsystems/LimelightManager.java"
click node_limelight "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/subsystems/Limelight.java"
click node_robot_state "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/RobotState.java"
click node_state_estimator "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/subsystems/RobotStateEstimator.java"
click node_drive "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/subsystems/Drive.java"
click node_superstructure "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/subsystems/Superstructure.java"
click node_elevator "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/subsystems/Elevator.java"
click node_wrist "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/subsystems/Wrist.java"
click node_end_effector "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/subsystems/EndEffector.java"
click node_commands "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/statemachines/SuperstructureCommands.java"
click node_servo "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/subsystems/ServoMotorSubsystem.java"
click node_ss_state "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/states/SuperstructureState.java"
click node_ss_constants "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/states/SuperstructureConstants.java"
click node_pose "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/lib/geometry/Pose2d.java"
click node_rotation "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/lib/geometry/Rotation2d.java"
click node_translation "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/lib/geometry/Translation2d.java"
click node_profile_follower "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/lib/motion/ProfileFollower.java"
click node_setpoint_generator "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/lib/motion/SetpointGenerator.java"
click node_motion_constraints "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/lib/motion/MotionProfileConstraints.java"
click node_motion_goal "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/lib/motion/MotionProfileGoal.java"
click node_motion_state "https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/lib/motion/MotionState.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_robot,node_controls,node_manager,node_looper,node_ilooper,node_loop toneBlue
class node_auto_selector,node_auto_executor,node_auto_base,node_camera_mode toneAmber
class node_limelight_manager,node_limelight,node_robot_state,node_state_estimator toneMint
class node_drive,node_superstructure,node_elevator,node_wrist,node_end_effector,node_commands,node_servo,node_ss_state,node_ss_constants toneRose
class node_pose,node_rotation,node_translation,node_profile_follower,node_setpoint_generator,node_motion_constraints,node_motion_goal,node_motion_state,node_operator toneIndigo
```

## Components

### Robot Runtime

- [Robot Startup](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/Main.java): `src/main/java/com/team254/frc2019/Main.java`
- [Robot Lifecycle](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/Robot.java): `src/main/java/com/team254/frc2019/Robot.java`
- [Control Boards](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/controlboard/ControlBoard.java): `src/main/java/com/team254/frc2019/controlboard/ControlBoard.java`
- [Subsystem Manager](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/SubsystemManager.java): `src/main/java/com/team254/frc2019/SubsystemManager.java`
- [Periodic Looper](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/loops/Looper.java): `src/main/java/com/team254/frc2019/loops/Looper.java`
- [Loop Registry](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/loops/ILooper.java): `src/main/java/com/team254/frc2019/loops/ILooper.java`
- [Loop Contract](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/loops/Loop.java): `src/main/java/com/team254/frc2019/loops/Loop.java`

### Autonomous Control

- [Auto Selector](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/AutoModeSelector.java): `src/main/java/com/team254/frc2019/AutoModeSelector.java`
- [Auto Executor](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/auto/AutoModeExecutor.java): `src/main/java/com/team254/frc2019/auto/AutoModeExecutor.java`
- [Auto Mode Base](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/auto/modes/AutoModeBase.java): `src/main/java/com/team254/frc2019/auto/modes/AutoModeBase.java`
- [Camera Drive Mode](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/auto/modes/DriveByCameraMode.java): `src/main/java/com/team254/frc2019/auto/modes/DriveByCameraMode.java`

### Vision and State

- [Limelight Manager](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/subsystems/LimelightManager.java): `src/main/java/com/team254/frc2019/subsystems/LimelightManager.java`
- [Limelight](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/subsystems/Limelight.java): `src/main/java/com/team254/frc2019/subsystems/Limelight.java`
- [Robot State](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/RobotState.java): `src/main/java/com/team254/frc2019/RobotState.java`
- [State Estimator](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/subsystems/RobotStateEstimator.java): `src/main/java/com/team254/frc2019/subsystems/RobotStateEstimator.java`

### Drive and Superstructure

- [Swerve Drive](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/subsystems/Drive.java): `src/main/java/com/team254/frc2019/subsystems/Drive.java`
- [Superstructure](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/subsystems/Superstructure.java): `src/main/java/com/team254/frc2019/subsystems/Superstructure.java`
- [Elevator](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/subsystems/Elevator.java): `src/main/java/com/team254/frc2019/subsystems/Elevator.java`
- [Wrist](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/subsystems/Wrist.java): `src/main/java/com/team254/frc2019/subsystems/Wrist.java`
- [End Effector](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/subsystems/EndEffector.java): `src/main/java/com/team254/frc2019/subsystems/EndEffector.java`
- [Superstructure Commands](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/statemachines/SuperstructureCommands.java): `src/main/java/com/team254/frc2019/statemachines/SuperstructureCommands.java`
- [Servo Motor Base](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/subsystems/ServoMotorSubsystem.java): `src/main/java/com/team254/frc2019/subsystems/ServoMotorSubsystem.java`
- [Superstructure State](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/states/SuperstructureState.java): `src/main/java/com/team254/frc2019/states/SuperstructureState.java`
- [Superstructure Constants](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/frc2019/states/SuperstructureConstants.java): `src/main/java/com/team254/frc2019/states/SuperstructureConstants.java`

### Motion and Geometry

- [2D Pose](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/lib/geometry/Pose2d.java): `src/main/java/com/team254/lib/geometry/Pose2d.java`
- [2D Rotation](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/lib/geometry/Rotation2d.java): `src/main/java/com/team254/lib/geometry/Rotation2d.java`
- [2D Translation](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/lib/geometry/Translation2d.java): `src/main/java/com/team254/lib/geometry/Translation2d.java`
- [Profile Follower](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/lib/motion/ProfileFollower.java): `src/main/java/com/team254/lib/motion/ProfileFollower.java`
- [Setpoint Generator](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/lib/motion/SetpointGenerator.java): `src/main/java/com/team254/lib/motion/SetpointGenerator.java`
- [Motion Constraints](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/lib/motion/MotionProfileConstraints.java): `src/main/java/com/team254/lib/motion/MotionProfileConstraints.java`
- [Motion Goal](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/lib/motion/MotionProfileGoal.java): `src/main/java/com/team254/lib/motion/MotionProfileGoal.java`
- [Motion State](https://github.com/team254/frc-2019-offseason-public/blob/master/src/main/java/com/team254/lib/motion/MotionState.java): `src/main/java/com/team254/lib/motion/MotionState.java`

### Other components

- **Operator**

## Connections

- Robot Startup → Robot Lifecycle: starts (evidence: `src/main/java/com/team254/frc2019/Main.java`)
- Operator → Control Boards: provides input
- Robot Lifecycle → Subsystem Manager: coordinates
- Subsystem Manager → Loop Registry: registers loops (evidence: `src/main/java/com/team254/frc2019/SubsystemManager.java`)
- Periodic Looper → Loop Registry: implements (evidence: `src/main/java/com/team254/frc2019/loops/Looper.java`)
- Loop Registry → Loop Contract: registers (evidence: `src/main/java/com/team254/frc2019/loops/ILooper.java`)
- Robot Lifecycle → Auto Selector: selects mode
- Auto Selector → Auto Executor: starts mode
- Auto Executor → Auto Mode Base: runs (evidence: `src/main/java/com/team254/frc2019/auto/AutoModeExecutor.java`)
- Auto Mode Base → Camera Drive Mode: specializes
- Limelight Manager → Limelight: manages (evidence: `src/main/java/com/team254/frc2019/subsystems/LimelightManager.java`)
- Limelight Manager → Robot State: adds vision updates (evidence: `src/main/java/com/team254/frc2019/subsystems/LimelightManager.java`)
- Limelight Manager → Elevator: checks height (evidence: `src/main/java/com/team254/frc2019/subsystems/LimelightManager.java`)
- State Estimator → Robot State: updates state
- Superstructure Commands → Superstructure: sets goal (evidence: `src/main/java/com/team254/frc2019/statemachines/SuperstructureCommands.java`)
- Superstructure Commands → End Effector: reads piece (evidence: `src/main/java/com/team254/frc2019/statemachines/SuperstructureCommands.java`)
- Superstructure Commands → Superstructure State: creates setpoint (evidence: `src/main/java/com/team254/frc2019/statemachines/SuperstructureCommands.java`)
- Wrist → Superstructure State: uses state (evidence: `src/main/java/com/team254/frc2019/planners/TuckPlanner.java`)
- Servo Motor Base → Setpoint Generator: generates setpoints (evidence: `src/main/java/com/team254/frc2019/subsystems/ServoMotorSubsystem.java`)
- Servo Motor Base → Motion Constraints: configures (evidence: `src/main/java/com/team254/frc2019/subsystems/ServoMotorSubsystem.java`)
- Servo Motor Base → Motion Goal: plans toward (evidence: `src/main/java/com/team254/frc2019/subsystems/ServoMotorSubsystem.java`)
- Servo Motor Base → Motion State: updates from (evidence: `src/main/java/com/team254/frc2019/subsystems/ServoMotorSubsystem.java`)
- Profile Follower → Setpoint Generator: uses (evidence: `src/main/java/com/team254/lib/motion/ProfileFollower.java`)
- Profile Follower → Motion Constraints: uses (evidence: `src/main/java/com/team254/lib/motion/ProfileFollower.java`)
- Profile Follower → Motion Goal: uses (evidence: `src/main/java/com/team254/lib/motion/ProfileFollower.java`)
- Profile Follower → Motion State: uses (evidence: `src/main/java/com/team254/lib/motion/ProfileFollower.java`)
- 2D Pose → 2D Translation: composes (evidence: `src/main/java/com/team254/lib/geometry/Pose2d.java`)
- 2D Pose → 2D Rotation: composes (evidence: `src/main/java/com/team254/lib/geometry/Pose2d.java`)
- 2D Rotation → 2D Translation: rotates (evidence: `src/main/java/com/team254/lib/geometry/Rotation2d.java`)
