# plano-west-robotics/rip-decode architecture

> Architecture diagram of the GitHub repository plano-west-robotics/rip-decode, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/plano-west-robotics/rip-decode
- Repository: https://github.com/plano-west-robotics/rip-decode

## Overview

This repository combines the FTC Android Robot Controller app with team-specific robot code. The main operator workflow is a driver selecting and running a TeleOp or Autonomous OpMode: TeleOp reads gamepad input and commands robot subsystems, while Autonomous runs paths and state transitions that command mechanisms. The team code also includes AprilTag vision, odometry support, reusable hardware/control wrappers, and path-following tuning tools. The graph focuses on these product runtime areas; several links are limited to the excerpts and SOURCE INDEX references provided.

Main entry points: [`TeamCode/src/main/java/org/firstinspires/ftc/teamcode/hardware/Hardware.java`](https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/hardware/Hardware.java) (Robot hardware map), [`TeamCode/src/main/java/org/firstinspires/ftc/teamcode/teleop/comp/ExampleTeleOp.java`](https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/teleop/comp/ExampleTeleOp.java) (Team TeleOp), [`TeamCode/src/main/java/org/firstinspires/ftc/teamcode/auton/comp/CloseAutoClassified.java`](https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/auton/comp/CloseAutoClassified.java) (Classified autonomous), [`TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/Outtake.java`](https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/Outtake.java) (Outtake)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Robot runtime"]
  node_controller["FTC Controller"]
  node_opmodes["OpMode registration"]
end

subgraph group_control["Operator control"]
  node_teleop["Team TeleOp<br/>[ExampleTeleOp.java]"]
  node_base_teleop["TeleOp base<br/>[BaseTeleOp.java]"]
  node_gamepads["Gamepad controls<br/>[Gamepads.java]"]
  node_drive["Field-centric drive"]
  node_intake["Intake<br/>[Intake.java]"]
  node_outtake["Outtake<br/>[Outtake.java]"]
end

subgraph group_auto["Autonomous"]
  node_autonomous["Classified autonomous"]
  node_state_machine["State machine<br/>[BaseState.java]"]
  node_path_tuning["Path tuning<br/>[Tuning.java]"]
end

subgraph group_hardware["Hardware and sensing"]
  node_hardware["Robot hardware map<br/>[Hardware.java]"]
  node_motors["Motor wrapper<br/>[MotorWrapper.java]"]
  node_drivetrain["Drivetrain motors"]
  node_april_tags["AprilTag webcam"]
  node_pinpoint["Pinpoint odometry"]
end

subgraph group_support["Reusable support"]
  node_drawing["Path drawing<br/>[Drawing.java]"]
  node_mechanism_states["Shooter states<br/>[Shooter.java]"]
end

node_driver(("Driver"))
node_robot_devices{{"Robot devices"}}

node_driver -->|"selects OpMode"| node_controller
node_controller -->|"registers"| node_opmodes
node_teleop -->|"reads controls"| node_gamepads
node_teleop -->|"commands"| node_drive
node_teleop -->|"commands"| node_intake
node_teleop -->|"commands"| node_outtake
node_base_teleop -->|"uses"| node_gamepads
node_base_teleop -->|"initializes"| node_hardware
node_hardware -->|"constructs"| node_motors
node_hardware -->|"constructs"| node_drivetrain
node_hardware -->|"configures"| node_pinpoint
node_hardware -->|"maps devices"| node_robot_devices
node_outtake -->|"uses hardware"| node_hardware
node_outtake -->|"controls motors"| node_motors
node_teleop -->|"uses vision"| node_april_tags
node_april_tags -->|"gets webcam"| node_hardware
node_autonomous -->|"runs states"| node_state_machine
node_autonomous -->|"commands scoring"| node_outtake
node_autonomous -->|"uses vision"| node_april_tags
node_autonomous -->|"initializes"| node_drawing
node_mechanism_states -->|"uses framework"| node_state_machine
node_path_tuning -->|"uses drawing"| node_drawing
node_robot_devices -.->|"controlled by"| node_controller

click node_controller "https://github.com/plano-west-robotics/rip-decode/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java"
click node_opmodes "https://github.com/plano-west-robotics/rip-decode/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcOpModeRegister.java"
click node_teleop "https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/teleop/comp/ExampleTeleOp.java"
click node_base_teleop "https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/teleop/BaseTeleOp.java"
click node_gamepads "https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/core/control/Gamepads.java"
click node_drive "https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/FieldCentricDrive.java"
click node_intake "https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/Intake.java"
click node_outtake "https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/Outtake.java"
click node_autonomous "https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/auton/comp/CloseAutoClassified.java"
click node_state_machine "https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/stateMachine/BaseState.java"
click node_path_tuning "https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/pedroPathing/Tuning.java"
click node_hardware "https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/hardware/Hardware.java"
click node_motors "https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/core/wrappers/MotorWrapper.java"
click node_drivetrain "https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/hardware/DrivetrainMotors.java"
click node_april_tags "https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/AprilTagWebcam.java"
click node_pinpoint "https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/pinpointFiles/GoBildaPinpointDriver.java"
click node_drawing "https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/pedroPathing/Drawing.java"
click node_mechanism_states "https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/stateMachine/Shooter.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_controller,node_opmodes toneBlue
class node_teleop,node_base_teleop,node_gamepads,node_drive,node_intake,node_outtake toneAmber
class node_autonomous,node_state_machine,node_path_tuning toneMint
class node_hardware,node_motors,node_drivetrain,node_april_tags,node_pinpoint toneRose
class node_drawing,node_mechanism_states,node_driver,node_robot_devices toneIndigo
```

## Components

### Robot runtime

- [FTC Controller](https://github.com/plano-west-robotics/rip-decode/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`
- [OpMode registration](https://github.com/plano-west-robotics/rip-decode/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcOpModeRegister.java): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcOpModeRegister.java`

### Operator control

- [Team TeleOp](https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/teleop/comp/ExampleTeleOp.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/teleop/comp/ExampleTeleOp.java`
- [TeleOp base](https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/teleop/BaseTeleOp.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/teleop/BaseTeleOp.java`
- [Gamepad controls](https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/core/control/Gamepads.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/core/control/Gamepads.java`
- [Field-centric drive](https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/FieldCentricDrive.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/FieldCentricDrive.java`
- [Intake](https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/Intake.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/Intake.java`
- [Outtake](https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/Outtake.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/Outtake.java`

### Autonomous

- [Classified autonomous](https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/auton/comp/CloseAutoClassified.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/auton/comp/CloseAutoClassified.java`
- [State machine](https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/stateMachine/BaseState.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/stateMachine/BaseState.java`
- [Path tuning](https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/pedroPathing/Tuning.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/pedroPathing/Tuning.java`

### Hardware and sensing

- [Robot hardware map](https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/hardware/Hardware.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/hardware/Hardware.java`
- [Motor wrapper](https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/core/wrappers/MotorWrapper.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/core/wrappers/MotorWrapper.java`
- [Drivetrain motors](https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/hardware/DrivetrainMotors.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/hardware/DrivetrainMotors.java`
- [AprilTag webcam](https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/AprilTagWebcam.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/AprilTagWebcam.java`
- [Pinpoint odometry](https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/pinpointFiles/GoBildaPinpointDriver.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/pinpointFiles/GoBildaPinpointDriver.java`

### Reusable support

- [Path drawing](https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/pedroPathing/Drawing.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/pedroPathing/Drawing.java`
- [Shooter states](https://github.com/plano-west-robotics/rip-decode/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/stateMachine/Shooter.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/stateMachine/Shooter.java`

### Other components

- **Driver**
- **Robot devices**

## Connections

- Driver → FTC Controller: selects OpMode
- FTC Controller → OpMode registration: registers (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`)
- Team TeleOp → Gamepad controls: reads controls (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/teleop/comp/ExampleTeleOp.java`)
- Team TeleOp → Field-centric drive: commands (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/teleop/comp/ExampleTeleOp.java`)
- Team TeleOp → Intake: commands (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/teleop/comp/ExampleTeleOp.java`)
- Team TeleOp → Outtake: commands (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/teleop/comp/ExampleTeleOp.java`)
- TeleOp base → Gamepad controls: uses (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/teleop/BaseTeleOp.java`)
- TeleOp base → Robot hardware map: initializes (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/teleop/BaseTeleOp.java`)
- Robot hardware map → Motor wrapper: constructs (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/hardware/Hardware.java`)
- Robot hardware map → Drivetrain motors: constructs (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/hardware/Hardware.java`)
- Robot hardware map → Pinpoint odometry: configures (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/hardware/Hardware.java`)
- Robot hardware map → Robot devices: maps devices (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/hardware/Hardware.java`)
- Outtake → Robot hardware map: uses hardware (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/Outtake.java`)
- Outtake → Motor wrapper: controls motors (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/Outtake.java`)
- Team TeleOp → AprilTag webcam: uses vision (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/teleop/comp/ExampleTeleOp.java`)
- AprilTag webcam → Robot hardware map: gets webcam (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/AprilTagWebcam.java`)
- Classified autonomous → State machine: runs states (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/auton/comp/CloseAutoClassified.java`)
- Classified autonomous → Outtake: commands scoring (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/auton/comp/CloseAutoClassified.java`)
- Classified autonomous → AprilTag webcam: uses vision (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/auton/comp/CloseAutoClassified.java`)
- Classified autonomous → Path drawing: initializes (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/auton/comp/CloseAutoClassified.java`)
- Shooter states → State machine: uses framework (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/stateMachine/Shooter.java`)
- Path tuning → Path drawing: uses drawing (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/pedroPathing/Tuning.java`)
- Robot devices → FTC Controller: controlled by
