# 16788-theencryptedgentlemen/ftcrobotcontroller architecture

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

- Interactive diagram: https://gitdiagram.com/16788-theencryptedgentlemen/ftcrobotcontroller
- Repository: https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller

## Overview

This is an FTC Android robot-controller project with team-specific teleoperated and autonomous robot programs, plus a goBILDA Pinpoint odometry driver and example. The principal workflow is a driver or autonomous OpMode initializing robot hardware, then issuing drivetrain and mechanism commands while using odometry/IMU feedback and telemetry. The graph emphasizes that runtime path and the documented Pinpoint capability; source excerpts are partial, so links for unsampled OpModes and vision are not asserted.

Main entry points: [`TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robots/CompetitionRobot.java`](https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robots/CompetitionRobot.java) (Competition robot), [`TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robots/DrivetrainTest.java`](https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robots/DrivetrainTest.java) (Test robot), [`TeamCode/src/main/java/org/firstinspires/ftc/teamcode/autonomousclasses/BezierCurveRoute.java`](https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/autonomousclasses/BezierCurveRoute.java) (Bezier route), [`TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robotparts/MecanumDrivetrain.java`](https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robotparts/MecanumDrivetrain.java) (Mecanum drive)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["FTC runtime"]
  node_controller["Controller app"]
  node_permission["Permission gate"]
  node_display["Telemetry display<br/>[Display.java]"]
end

subgraph group_modes["Robot modes"]
  node_opmodes["Driver OpModes"]
  node_auto["Autonomous routes"]
end

subgraph group_hardware["Robot hardware"]
  node_competition["Competition robot"]
  node_testrobot["Test robot"]
  node_drive["Mecanum drive"]
  node_imu["IMU wrapper<br/>[Imu.java]"]
end

subgraph group_navigation["Navigation and vision"]
  node_curve["Bezier route"]
  node_checkpoints["Route geometry<br/>[CheckPoints.java]"]
  node_odometry["Pinpoint odometry"]
  node_pinpoint["Pinpoint driver"]
  node_vision["Marker pipelines"]
end

node_operator(("Driver / team"))
node_robotdevices{{"Robot devices"}}

node_operator -.->|"starts"| node_controller
node_controller -->|"validates permissions"| node_permission
node_controller -.->|"registers OpModes"| node_opmodes
node_opmodes -.->|"initializes"| node_testrobot
node_auto -->|"uses robot"| node_testrobot
node_curve -->|"commands robot"| node_competition
node_curve -->|"generates checkpoints"| node_checkpoints
node_competition -->|"constructs"| node_drive
node_competition -->|"constructs"| node_imu
node_competition -->|"constructs"| node_odometry
node_competition -->|"reports initialization"| node_display
node_testrobot -->|"constructs"| node_drive
node_testrobot -->|"constructs"| node_odometry
node_testrobot -->|"reports initialization"| node_display
node_drive -->|"gets turn correction"| node_imu
node_drive -->|"sets motor power"| node_robotdevices
node_imu -.->|"reads orientation"| node_robotdevices
node_odometry -->|"wraps driver"| node_pinpoint
node_pinpoint -->|"reads odometry sensor"| node_robotdevices
node_curve -->|"reads position"| node_odometry
node_curve -->|"reads heading"| node_imu

click node_controller "https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java"
click node_permission "https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/PermissionValidatorWrapper.java"
click node_opmodes "https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/drivercontrolled"
click node_auto "https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/autonomousroutes"
click node_curve "https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/autonomousclasses/BezierCurveRoute.java"
click node_checkpoints "https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/autonomousclasses/CheckPoints.java"
click node_competition "https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robots/CompetitionRobot.java"
click node_testrobot "https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robots/DrivetrainTest.java"
click node_drive "https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robotparts/MecanumDrivetrain.java"
click node_imu "https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robotparts/Imu.java"
click node_odometry "https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robotparts/PinPointOdometry.java"
click node_pinpoint "https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/GoBildaPinpointDriver.java"
click node_vision "https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/pipelines"
click node_display "https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/otherclasses/Display.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_permission,node_display toneBlue
class node_opmodes,node_auto toneAmber
class node_competition,node_testrobot,node_drive,node_imu toneMint
class node_curve,node_checkpoints,node_odometry,node_pinpoint,node_vision toneRose
class node_operator,node_robotdevices toneIndigo
```

## Components

### FTC runtime

- [Controller app](https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/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/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/PermissionValidatorWrapper.java): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/PermissionValidatorWrapper.java`
- [Telemetry display](https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/otherclasses/Display.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/otherclasses/Display.java`

### Robot modes

- [Driver OpModes](https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/drivercontrolled): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/drivercontrolled`
- [Autonomous routes](https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/autonomousroutes): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/autonomousroutes`

### Robot hardware

- [Competition robot](https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robots/CompetitionRobot.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robots/CompetitionRobot.java`
- [Test robot](https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robots/DrivetrainTest.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robots/DrivetrainTest.java`
- [Mecanum drive](https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robotparts/MecanumDrivetrain.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robotparts/MecanumDrivetrain.java`
- [IMU wrapper](https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robotparts/Imu.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robotparts/Imu.java`

### Navigation and vision

- [Bezier route](https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/autonomousclasses/BezierCurveRoute.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/autonomousclasses/BezierCurveRoute.java`
- [Route geometry](https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/autonomousclasses/CheckPoints.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/autonomousclasses/CheckPoints.java`
- [Pinpoint odometry](https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robotparts/PinPointOdometry.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robotparts/PinPointOdometry.java`
- [Pinpoint driver](https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/GoBildaPinpointDriver.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/GoBildaPinpointDriver.java`
- [Marker pipelines](https://github.com/16788-theencryptedgentlemen/ftcrobotcontroller/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/pipelines): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/pipelines`

### Other components

- **Driver / team**
- **Robot devices**

## Connections

- Driver / team → Controller app: starts (evidence: `README.md`)
- Controller app → Permission gate: validates permissions (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`)
- Controller app → Driver OpModes: registers OpModes
- Driver OpModes → Test robot: initializes (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/drivercontrolled/DriverControlledLinearOpmode.java`)
- Autonomous routes → Test robot: uses robot (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/autonomousroutes/ShootingBallsBlue.java`)
- Bezier route → Competition robot: commands robot (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/autonomousclasses/BezierCurveRoute.java`)
- Bezier route → Route geometry: generates checkpoints (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/autonomousclasses/BezierCurveRoute.java`)
- Competition robot → Mecanum drive: constructs (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robots/CompetitionRobot.java`)
- Competition robot → IMU wrapper: constructs (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robots/CompetitionRobot.java`)
- Competition robot → Pinpoint odometry: constructs (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robots/CompetitionRobot.java`)
- Competition robot → Telemetry display: reports initialization (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robots/CompetitionRobot.java`)
- Test robot → Mecanum drive: constructs (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robots/DrivetrainTest.java`)
- Test robot → Pinpoint odometry: constructs (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robots/DrivetrainTest.java`)
- Test robot → Telemetry display: reports initialization (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robots/DrivetrainTest.java`)
- Mecanum drive → IMU wrapper: gets turn correction (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robotparts/MecanumDrivetrain.java`)
- Mecanum drive → Robot devices: sets motor power (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/robotparts/MecanumDrivetrain.java`)
- IMU wrapper → Robot devices: reads orientation
- Pinpoint odometry → Pinpoint driver: wraps driver (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/GoBildaPinpointDriver.java`)
- Pinpoint driver → Robot devices: reads odometry sensor (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/GoBildaPinpointDriver.java`)
- Bezier route → Pinpoint odometry: reads position (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/autonomousclasses/BezierCurveRoute.java`)
- Bezier route → IMU wrapper: reads heading (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/autonomousclasses/BezierCurveRoute.java`)
