# plano-west-robotics/rip-biobuzz architecture

> Architecture diagram of the GitHub repository plano-west-robotics/rip-biobuzz, 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-biobuzz
- Repository: https://github.com/plano-west-robotics/rip-biobuzz

## Overview

This repository is the FTC Android Robot Controller SDK plus a team-specific BIOBUZZ robot program. The principal workflow is operator input through a registered TeleOp, gamepad normalization and drive calculations, then hardware commands to the robot. The SDK also provides controller startup, OpMode registration, hardware diagnostics, and extensive sample OpModes, including autonomous, sensor, and vision examples. The source excerpts establish the team drive path and some controller startup wiring; sample capabilities are represented from the README, without asserting unshown implementation links.

Main entry points: [`FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples`](https://github.com/plano-west-robotics/rip-biobuzz/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples) (Sample OpModes), [`TeamCode/src/main/java/org/firstinspires/ftc/teamcode/hardware/DrivetrainMotors.java`](https://github.com/plano-west-robotics/rip-biobuzz/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/hardware/DrivetrainMotors.java) (Drive And Actuators), [`TeamCode/src/main/java/org/firstinspires/ftc/teamcode/core/control/Gamepads.java`](https://github.com/plano-west-robotics/rip-biobuzz/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/core/control/Gamepads.java) (Gamepad Controls), [`TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/FieldCentricDrive.java`](https://github.com/plano-west-robotics/rip-biobuzz/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/FieldCentricDrive.java) (Field-Centric Drive)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_controller["Robot Controller"]
  node_activity["Controller Activity"]
  node_permissions["Permission Gate"]
  node_registry["OpMode Registry"]
end

subgraph group_team["Team Robot Code"]
  node_teleop["Team TeleOp"]
  node_base["TeleOp Base<br/>[BaseTeleOp.java]"]
  node_gamepads["Gamepad Controls<br/>[Gamepads.java]"]
  node_fielddrive["Field-Centric Drive"]
  node_robotdrive["Robot-Centric Drive"]
  node_hardware["Robot Hardware<br/>[Hardware.java]"]
  node_motors["Drive And Actuators"]
end

subgraph group_samples["SDK Samples"]
  node_samples["Sample OpModes"]
  node_auto["Autonomous Examples"]
  node_vision["Vision Examples"]
  node_sensors["Sensor Examples"]
end

subgraph group_diagnostics["Hardware Diagnostics"]
  node_testhardware["Test Hardware Utility"]
  node_testgamepad["Gamepad Test Utility"]
end

node_operator(("Robot Operator"))
node_robot{{"Robot Devices"}}

node_operator -.->|"operates"| node_activity
node_activity -->|"checks permissions"| node_permissions
node_activity -->|"creates registry"| node_registry
node_operator -.->|"provides controls"| node_teleop
node_teleop -->|"updates input"| node_gamepads
node_teleop -->|"updates drive"| node_robotdrive
node_robotdrive -->|"reads controls"| node_gamepads
node_robotdrive -->|"sets power"| node_motors
node_motors -->|"commands actuators"| node_robot
node_base -->|"initializes hardware"| node_hardware
node_base -->|"updates input"| node_gamepads
node_hardware -->|"creates drivetrain"| node_motors
node_fielddrive -->|"reads controls"| node_gamepads
node_fielddrive -->|"uses IMU"| node_hardware
node_fielddrive -->|"sets power"| node_motors
node_operator -->|"selects device"| node_testhardware
node_testhardware -->|"tests devices"| node_robot
node_operator -.->|"tests controls"| node_testgamepad
node_operator -->|"uses examples"| node_samples
node_samples -->|"includes"| node_auto
node_samples -->|"includes"| node_vision
node_samples -->|"includes"| node_sensors

click node_activity "https://github.com/plano-west-robotics/rip-biobuzz/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java"
click node_permissions "https://github.com/plano-west-robotics/rip-biobuzz/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/PermissionValidatorWrapper.java"
click node_registry "https://github.com/plano-west-robotics/rip-biobuzz/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcOpModeRegister.java"
click node_teleop "https://github.com/plano-west-robotics/rip-biobuzz/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/teleop/comp/RobotCentricComp.java"
click node_base "https://github.com/plano-west-robotics/rip-biobuzz/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/teleop/BaseTeleOp.java"
click node_gamepads "https://github.com/plano-west-robotics/rip-biobuzz/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/core/control/Gamepads.java"
click node_fielddrive "https://github.com/plano-west-robotics/rip-biobuzz/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/FieldCentricDrive.java"
click node_robotdrive "https://github.com/plano-west-robotics/rip-biobuzz/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/RobotCentricDrive.java"
click node_hardware "https://github.com/plano-west-robotics/rip-biobuzz/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/hardware/Hardware.java"
click node_motors "https://github.com/plano-west-robotics/rip-biobuzz/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/hardware/DrivetrainMotors.java"
click node_testhardware "https://github.com/plano-west-robotics/rip-biobuzz/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/utilities/UtilityTestHardware.java"
click node_testgamepad "https://github.com/plano-west-robotics/rip-biobuzz/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/utilities/UtilityTestGamepad.java"
click node_samples "https://github.com/plano-west-robotics/rip-biobuzz/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples"
click node_auto "https://github.com/plano-west-robotics/rip-biobuzz/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples"
click node_vision "https://github.com/plano-west-robotics/rip-biobuzz/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples"
click node_sensors "https://github.com/plano-west-robotics/rip-biobuzz/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples"

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_activity,node_permissions,node_registry toneBlue
class node_teleop,node_base,node_gamepads,node_fielddrive,node_robotdrive,node_hardware,node_motors toneAmber
class node_samples,node_auto,node_vision,node_sensors toneMint
class node_testhardware,node_testgamepad toneRose
class node_operator,node_robot toneIndigo
```

## Components

### Robot Controller

- [Controller Activity](https://github.com/plano-west-robotics/rip-biobuzz/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`
- [Permission Gate](https://github.com/plano-west-robotics/rip-biobuzz/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/PermissionValidatorWrapper.java): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/PermissionValidatorWrapper.java`
- [OpMode Registry](https://github.com/plano-west-robotics/rip-biobuzz/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcOpModeRegister.java): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcOpModeRegister.java`

### Team Robot Code

- [Team TeleOp](https://github.com/plano-west-robotics/rip-biobuzz/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/teleop/comp/RobotCentricComp.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/teleop/comp/RobotCentricComp.java`
- [TeleOp Base](https://github.com/plano-west-robotics/rip-biobuzz/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-biobuzz/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-biobuzz/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/FieldCentricDrive.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/FieldCentricDrive.java`
- [Robot-Centric Drive](https://github.com/plano-west-robotics/rip-biobuzz/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/RobotCentricDrive.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/RobotCentricDrive.java`
- [Robot Hardware](https://github.com/plano-west-robotics/rip-biobuzz/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/hardware/Hardware.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/hardware/Hardware.java`
- [Drive And Actuators](https://github.com/plano-west-robotics/rip-biobuzz/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/hardware/DrivetrainMotors.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/hardware/DrivetrainMotors.java`

### SDK Samples

- [Sample OpModes](https://github.com/plano-west-robotics/rip-biobuzz/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples`
- [Autonomous Examples](https://github.com/plano-west-robotics/rip-biobuzz/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples`
- [Vision Examples](https://github.com/plano-west-robotics/rip-biobuzz/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples`
- [Sensor Examples](https://github.com/plano-west-robotics/rip-biobuzz/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples`

### Hardware Diagnostics

- [Test Hardware Utility](https://github.com/plano-west-robotics/rip-biobuzz/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/utilities/UtilityTestHardware.java): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/utilities/UtilityTestHardware.java`
- [Gamepad Test Utility](https://github.com/plano-west-robotics/rip-biobuzz/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/utilities/UtilityTestGamepad.java): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/utilities/UtilityTestGamepad.java`

### Other components

- **Robot Operator**
- **Robot Devices**

## Connections

- Robot Operator → Controller Activity: operates
- Controller Activity → Permission Gate: checks permissions (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`)
- Controller Activity → OpMode Registry: creates registry (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`)
- Robot Operator → Team TeleOp: provides controls
- Team TeleOp → Gamepad Controls: updates input (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/teleop/comp/RobotCentricComp.java`)
- Team TeleOp → Robot-Centric Drive: updates drive (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/teleop/comp/RobotCentricComp.java`)
- Robot-Centric Drive → Gamepad Controls: reads controls (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/RobotCentricDrive.java`)
- Robot-Centric Drive → Drive And Actuators: sets power (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/RobotCentricDrive.java`)
- Drive And Actuators → Robot Devices: commands actuators (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/hardware/DrivetrainMotors.java`)
- TeleOp Base → Robot Hardware: initializes hardware (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/teleop/BaseTeleOp.java`)
- TeleOp Base → Gamepad Controls: updates input (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/teleop/BaseTeleOp.java`)
- Robot Hardware → Drive And Actuators: creates drivetrain (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/hardware/Hardware.java`)
- Field-Centric Drive → Gamepad Controls: reads controls (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/FieldCentricDrive.java`)
- Field-Centric Drive → Robot Hardware: uses IMU (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/FieldCentricDrive.java`)
- Field-Centric Drive → Drive And Actuators: sets power (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/subsystems/FieldCentricDrive.java`)
- Robot Operator → Test Hardware Utility: selects device (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/utilities/UtilityTestHardware.java`)
- Test Hardware Utility → Robot Devices: tests devices (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/utilities/UtilityTestHardware.java`)
- Robot Operator → Gamepad Test Utility: tests controls
- Robot Operator → Sample OpModes: uses examples (evidence: `README.md`)
- Sample OpModes → Autonomous Examples: includes (evidence: `README.md`)
- Sample OpModes → Vision Examples: includes (evidence: `README.md`)
- Sample OpModes → Sensor Examples: includes (evidence: `README.md`)
