# persevere-5962/robotcode_v2 architecture

> Architecture diagram of the GitHub repository persevere-5962/robotcode_v2, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/persevere-5962/robotcode_v2
- Repository: https://github.com/persevere-5962/robotcode_v2

## Overview

This is 2026 FRC robot-control software. The main workflow is operator input mapped by RobotContainer into drive, intake, and scoring commands; commands control drivetrain and mechanisms, while vision supports pose estimation and telemetry reports robot state. The repository also includes simulation and match-timing/scoring utilities. Relationships are limited to README statements, sampled excerpts, and SOURCE INDEX references; unsampled subsystems are represented only where their paths are present in the tree.

Main entry points: [`src/main/java/frc/robot/commands/AimAndShootCommand.java`](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/commands/AimAndShootCommand.java) (Aim And Shoot), [`src/main/java/frc/robot/Robot.java`](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/Robot.java) (Robot Lifecycle), [`src/main/java/frc/robot/sim/SimDeviceManager.java`](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/sim/SimDeviceManager.java) (Device Simulation), [`src/main/java/frc/robot/RobotContainer.java`](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/RobotContainer.java) (Controls And Bindings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Robot Runtime"]
  node_main["Program Entry<br/>[Main.java]"]
  node_robot["Robot Lifecycle<br/>[Robot.java]"]
  node_container["Controls And Bindings"]
end

subgraph group_drive["Drive And Vision"]
  node_drive_commands["Drive Commands<br/>[AbsoluteDrive.java]"]
  node_swerve["Swerve Drive"]
  node_vision["Vision Pose<br/>[Vision.java]"]
  node_vision_filter["Vision Filter<br/>[VisionFilter.java]"]
end

subgraph group_scoring["Intake And Scoring"]
  node_aim_shoot["Aim And Shoot"]
  node_mechanism_commands["Mechanism Commands"]
  node_shooter["Shooter<br/>[Shooter.java]"]
  node_indexer["Indexer<br/>[Indexer.java]"]
  node_agitator["Agitator<br/>[Agitator.java]"]
  node_intake["Intake Systems<br/>[IntakeRoller.java]"]
end

subgraph group_support["Telemetry And Utilities"]
  node_shot_calc["Shot Calculator"]
  node_hub_timing["Hub Shift Timing"]
  node_telemetry["Telemetry Collection"]
  node_safe_log["Safe Logging<br/>[SafeLog.java]"]
  node_tuning["Dashboard Tuning<br/>[TunableNumber.java]"]
  node_jam["Jam Detection<br/>[JamProtection.java]"]
end

subgraph group_simulation["Simulation"]
  node_simulation["Device Simulation"]
  node_scenarios["Simulation Scenarios"]
end

node_driver(("Operator"))

node_main -->|"starts"| node_robot
node_driver -->|"provides input"| node_container
node_container -->|"binds controls"| node_drive_commands
node_container -->|"binds controls"| node_aim_shoot
node_container -->|"binds controls"| node_mechanism_commands
node_drive_commands -->|"controls"| node_swerve
node_aim_shoot -->|"aims with"| node_swerve
node_aim_shoot -->|"sets speed"| node_shooter
node_aim_shoot -->|"feeds"| node_indexer
node_aim_shoot -->|"feeds"| node_agitator
node_aim_shoot -->|"calculates shot"| node_shot_calc
node_swerve -->|"uses vision"| node_vision
node_vision -->|"filters poses"| node_vision_filter
node_shooter -->|"reads parameters"| node_tuning
node_indexer -->|"updates detection"| node_jam
node_agitator -->|"updates detection"| node_jam
node_robot -->|"initializes"| node_telemetry
node_telemetry -->|"records outputs"| node_safe_log
node_robot -->|"initializes teleop"| node_hub_timing
node_robot -->|"initializes"| node_simulation
node_robot -->|"creates runner"| node_scenarios
node_simulation -->|"simulates device"| node_shooter
node_simulation -->|"simulates device"| node_indexer
node_simulation -->|"simulates device"| node_intake
node_simulation -->|"simulates device"| node_agitator

click node_main "https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/Main.java"
click node_robot "https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/Robot.java"
click node_container "https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/RobotContainer.java"
click node_drive_commands "https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/commands/swervedrive/drivebase/AbsoluteDrive.java"
click node_swerve "https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/subsystems/swervedrive/SwerveSubsystem.java"
click node_vision "https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/subsystems/swervedrive/Vision.java"
click node_vision_filter "https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/subsystems/swervedrive/VisionFilter.java"
click node_aim_shoot "https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/commands/AimAndShootCommand.java"
click node_mechanism_commands "https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/commands/IntakeParallel.java"
click node_shooter "https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/subsystems/Shooter.java"
click node_indexer "https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/subsystems/Indexer.java"
click node_agitator "https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/subsystems/Agitator.java"
click node_intake "https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/subsystems/IntakeRoller.java"
click node_shot_calc "https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/util/ShotCalculator.java"
click node_hub_timing "https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/util/HubShiftEngine.java"
click node_telemetry "https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/telemetry/TelemetryManager.java"
click node_safe_log "https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/telemetry/SafeLog.java"
click node_tuning "https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/util/TunableNumber.java"
click node_jam "https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/util/JamProtection.java"
click node_simulation "https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/sim/SimDeviceManager.java"
click node_scenarios "https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/sim/SimScenarioRunner.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_container toneBlue
class node_drive_commands,node_swerve,node_vision,node_vision_filter toneAmber
class node_aim_shoot,node_mechanism_commands,node_shooter,node_indexer,node_agitator,node_intake toneMint
class node_shot_calc,node_hub_timing,node_telemetry,node_safe_log,node_tuning,node_jam toneRose
class node_simulation,node_scenarios,node_driver toneIndigo
```

## Components

### Robot Runtime

- [Program Entry](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/Main.java): `src/main/java/frc/robot/Main.java`
- [Robot Lifecycle](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/Robot.java): `src/main/java/frc/robot/Robot.java`
- [Controls And Bindings](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/RobotContainer.java): `src/main/java/frc/robot/RobotContainer.java`

### Drive And Vision

- [Drive Commands](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/commands/swervedrive/drivebase/AbsoluteDrive.java): `src/main/java/frc/robot/commands/swervedrive/drivebase/AbsoluteDrive.java`
- [Swerve Drive](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/subsystems/swervedrive/SwerveSubsystem.java): `src/main/java/frc/robot/subsystems/swervedrive/SwerveSubsystem.java`
- [Vision Pose](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/subsystems/swervedrive/Vision.java): `src/main/java/frc/robot/subsystems/swervedrive/Vision.java`
- [Vision Filter](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/subsystems/swervedrive/VisionFilter.java): `src/main/java/frc/robot/subsystems/swervedrive/VisionFilter.java`

### Intake And Scoring

- [Aim And Shoot](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/commands/AimAndShootCommand.java): `src/main/java/frc/robot/commands/AimAndShootCommand.java`
- [Mechanism Commands](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/commands/IntakeParallel.java): `src/main/java/frc/robot/commands/IntakeParallel.java`
- [Shooter](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/subsystems/Shooter.java): `src/main/java/frc/robot/subsystems/Shooter.java`
- [Indexer](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/subsystems/Indexer.java): `src/main/java/frc/robot/subsystems/Indexer.java`
- [Agitator](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/subsystems/Agitator.java): `src/main/java/frc/robot/subsystems/Agitator.java`
- [Intake Systems](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/subsystems/IntakeRoller.java): `src/main/java/frc/robot/subsystems/IntakeRoller.java`

### Telemetry And Utilities

- [Shot Calculator](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/util/ShotCalculator.java): `src/main/java/frc/robot/util/ShotCalculator.java`
- [Hub Shift Timing](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/util/HubShiftEngine.java): `src/main/java/frc/robot/util/HubShiftEngine.java`
- [Telemetry Collection](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/telemetry/TelemetryManager.java): `src/main/java/frc/robot/telemetry/TelemetryManager.java`
- [Safe Logging](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/telemetry/SafeLog.java): `src/main/java/frc/robot/telemetry/SafeLog.java`
- [Dashboard Tuning](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/util/TunableNumber.java): `src/main/java/frc/robot/util/TunableNumber.java`
- [Jam Detection](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/util/JamProtection.java): `src/main/java/frc/robot/util/JamProtection.java`

### Simulation

- [Device Simulation](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/sim/SimDeviceManager.java): `src/main/java/frc/robot/sim/SimDeviceManager.java`
- [Simulation Scenarios](https://github.com/persevere-5962/robotcode_v2/blob/main/src/main/java/frc/robot/sim/SimScenarioRunner.java): `src/main/java/frc/robot/sim/SimScenarioRunner.java`

### Other components

- **Operator**

## Connections

- Program Entry → Robot Lifecycle: starts (evidence: `src/main/java/frc/robot/Main.java`)
- Operator → Controls And Bindings: provides input (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Controls And Bindings → Drive Commands: binds controls (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Controls And Bindings → Aim And Shoot: binds controls (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Controls And Bindings → Mechanism Commands: binds controls (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Drive Commands → Swerve Drive: controls (evidence: `src/main/java/frc/robot/commands/swervedrive/drivebase/AbsoluteDrive.java`)
- Aim And Shoot → Swerve Drive: aims with (evidence: `src/main/java/frc/robot/commands/AimAndShootCommand.java`)
- Aim And Shoot → Shooter: sets speed (evidence: `src/main/java/frc/robot/commands/AimAndShootCommand.java`)
- Aim And Shoot → Indexer: feeds (evidence: `src/main/java/frc/robot/commands/AimAndShootCommand.java`)
- Aim And Shoot → Agitator: feeds (evidence: `src/main/java/frc/robot/commands/AimAndShootCommand.java`)
- Aim And Shoot → Shot Calculator: calculates shot (evidence: `src/main/java/frc/robot/commands/AimAndShootCommand.java`)
- Swerve Drive → Vision Pose: uses vision (evidence: `src/main/java/frc/robot/subsystems/swervedrive/SwerveSubsystem.java`)
- Vision Pose → Vision Filter: filters poses (evidence: `src/main/java/frc/robot/subsystems/swervedrive/Vision.java`)
- Shooter → Dashboard Tuning: reads parameters (evidence: `src/main/java/frc/robot/subsystems/Shooter.java`)
- Indexer → Jam Detection: updates detection (evidence: `src/main/java/frc/robot/subsystems/Indexer.java`)
- Agitator → Jam Detection: updates detection (evidence: `src/main/java/frc/robot/subsystems/Agitator.java`)
- Robot Lifecycle → Telemetry Collection: initializes (evidence: `src/main/java/frc/robot/Robot.java`)
- Telemetry Collection → Safe Logging: records outputs (evidence: `src/main/java/frc/robot/telemetry/TelemetryManager.java`)
- Robot Lifecycle → Hub Shift Timing: initializes teleop (evidence: `src/main/java/frc/robot/Robot.java`)
- Robot Lifecycle → Device Simulation: initializes (evidence: `src/main/java/frc/robot/Robot.java`)
- Robot Lifecycle → Simulation Scenarios: creates runner (evidence: `src/main/java/frc/robot/Robot.java`)
- Device Simulation → Shooter: simulates device (evidence: `src/main/java/frc/robot/sim/SimDeviceManager.java`)
- Device Simulation → Indexer: simulates device (evidence: `src/main/java/frc/robot/sim/SimDeviceManager.java`)
- Device Simulation → Intake Systems: simulates device (evidence: `src/main/java/frc/robot/sim/SimDeviceManager.java`)
- Device Simulation → Agitator: simulates device (evidence: `src/main/java/frc/robot/sim/SimDeviceManager.java`)
