# decagonatorftc-26/ftcrobotcontroller architecture

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

- Interactive diagram: https://gitdiagram.com/decagonatorftc-26/ftcrobotcontroller
- Repository: https://github.com/decagonatorftc-26/ftcrobotcontroller

## Overview

This is the FTC Android Robot Controller application and its team-facing examples, used to run a competition robot. The principal workflow is an operator launching the controller, configuring or selecting an OpMode, then running robot code that reads inputs and controls configured hardware. The README also documents Blocks, OnBot Java, and Android Studio as programming routes, and the samples cover teleop, autonomous, sensors, and vision. The sampled controller activity shows setup and registration touchpoints; several runtime subsystems are represented by their existing directories because their implementation was not excerpted.

Main entry points: [`FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`](https://github.com/decagonatorftc-26/ftcrobotcontroller/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java) (Controller activity), [`FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal`](https://github.com/decagonatorftc-26/ftcrobotcontroller/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal) (OpMode runtime), [`FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcOpModeRegister.java`](https://github.com/decagonatorftc-26/ftcrobotcontroller/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcOpModeRegister.java) (OpMode registration), [`FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples`](https://github.com/decagonatorftc-26/ftcrobotcontroller/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples) (Telemetry and feedback)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_controller["Controller app"]
  node_controller_activity["Controller activity"]
  node_permission_gate["Permission gate"]
  node_robot_service["Robot controller service"]
  node_robot_config["Robot configuration"]
end

subgraph group_programming["Programming and modes"]
  node_blocks["Blocks programming"]
  node_onbot["OnBot Java"]
  node_teamcode["Team OpModes"]
  node_opmode_registration["OpMode registration"]
end

subgraph group_robot["Robot operation"]
  node_opmode_runtime["OpMode runtime"]
  node_hardware["Robot hardware"]
  node_telemetry["Telemetry and feedback"]
end

subgraph group_examples["Examples and utilities"]
  node_samples["Sample OpModes"]
  node_hardware_test["Hardware test utility"]
  node_gamepad_test["Gamepad test utility"]
end

node_operator(("Robot operator"))
node_driver_station(("Driver Station"))

node_operator -.->|"launches"| node_controller_activity
node_controller_activity -->|"checks permissions"| node_permission_gate
node_permission_gate -->|"starts after validation"| node_controller_activity
node_controller_activity -->|"binds service"| node_robot_service
node_controller_activity -->|"loads active config"| node_robot_config
node_controller_activity -->|"creates register"| node_opmode_registration
node_controller_activity -->|"sets Blocks context"| node_blocks
node_controller_activity -->|"initializes helper"| node_onbot
node_driver_station -.->|"controls remotely"| node_robot_service
node_teamcode -.->|"provides OpModes"| node_opmode_registration
node_opmode_registration -.->|"registers modes"| node_opmode_runtime
node_opmode_runtime -.->|"operates devices"| node_hardware
node_opmode_runtime -.->|"reports status"| node_telemetry
node_samples -.->|"demonstrates control"| node_hardware
node_hardware_test -->|"tests devices"| node_hardware
node_hardware_test -->|"reports readings"| node_telemetry
node_gamepad_test -->|"displays controls"| node_telemetry
node_driver_station -.->|"provides gamepads"| node_gamepad_test

click node_controller_activity "https://github.com/decagonatorftc-26/ftcrobotcontroller/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java"
click node_permission_gate "https://github.com/decagonatorftc-26/ftcrobotcontroller/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/PermissionValidatorWrapper.java"
click node_robot_service "https://github.com/decagonatorftc-26/ftcrobotcontroller/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal"
click node_robot_config "https://github.com/decagonatorftc-26/ftcrobotcontroller/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal"
click node_blocks "https://github.com/decagonatorftc-26/ftcrobotcontroller/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal"
click node_onbot "https://github.com/decagonatorftc-26/ftcrobotcontroller/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal"
click node_teamcode "https://github.com/decagonatorftc-26/ftcrobotcontroller/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode"
click node_opmode_registration "https://github.com/decagonatorftc-26/ftcrobotcontroller/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcOpModeRegister.java"
click node_opmode_runtime "https://github.com/decagonatorftc-26/ftcrobotcontroller/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal"
click node_hardware "https://github.com/decagonatorftc-26/ftcrobotcontroller/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal"
click node_telemetry "https://github.com/decagonatorftc-26/ftcrobotcontroller/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples"
click node_samples "https://github.com/decagonatorftc-26/ftcrobotcontroller/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples"
click node_hardware_test "https://github.com/decagonatorftc-26/ftcrobotcontroller/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/utilities/UtilityTestHardware.java"
click node_gamepad_test "https://github.com/decagonatorftc-26/ftcrobotcontroller/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/utilities/UtilityTestGamepad.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_activity,node_permission_gate,node_robot_service,node_robot_config toneBlue
class node_blocks,node_onbot,node_teamcode,node_opmode_registration toneAmber
class node_opmode_runtime,node_hardware,node_telemetry toneMint
class node_samples,node_hardware_test,node_gamepad_test toneRose
class node_operator,node_driver_station toneIndigo
```

## Components

### Controller app

- [Controller activity](https://github.com/decagonatorftc-26/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/decagonatorftc-26/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`
- [Robot controller service](https://github.com/decagonatorftc-26/ftcrobotcontroller/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal`
- [Robot configuration](https://github.com/decagonatorftc-26/ftcrobotcontroller/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal`

### Programming and modes

- [Blocks programming](https://github.com/decagonatorftc-26/ftcrobotcontroller/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal`
- [OnBot Java](https://github.com/decagonatorftc-26/ftcrobotcontroller/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal`
- [Team OpModes](https://github.com/decagonatorftc-26/ftcrobotcontroller/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode`
- [OpMode registration](https://github.com/decagonatorftc-26/ftcrobotcontroller/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcOpModeRegister.java): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcOpModeRegister.java`

### Robot operation

- [OpMode runtime](https://github.com/decagonatorftc-26/ftcrobotcontroller/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal`
- [Robot hardware](https://github.com/decagonatorftc-26/ftcrobotcontroller/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal`
- [Telemetry and feedback](https://github.com/decagonatorftc-26/ftcrobotcontroller/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples`

### Examples and utilities

- [Sample OpModes](https://github.com/decagonatorftc-26/ftcrobotcontroller/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples`
- [Hardware test utility](https://github.com/decagonatorftc-26/ftcrobotcontroller/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/decagonatorftc-26/ftcrobotcontroller/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**
- **Driver Station**

## Connections

- Robot operator → Controller activity: launches (evidence: `README.md`)
- Controller activity → Permission gate: checks permissions (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`)
- Permission gate → Controller activity: starts after validation (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/PermissionValidatorWrapper.java`)
- Controller activity → Robot controller service: binds service (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`)
- Controller activity → Robot configuration: loads active config (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`)
- Controller activity → OpMode registration: creates register (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`)
- Controller activity → Blocks programming: sets Blocks context (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`)
- Controller activity → OnBot Java: initializes helper (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`)
- Driver Station → Robot controller service: controls remotely (evidence: `README.md`)
- Team OpModes → OpMode registration: provides OpModes
- OpMode registration → OpMode runtime: registers modes (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`)
- OpMode runtime → Robot hardware: operates devices (evidence: `README.md`)
- OpMode runtime → Telemetry and feedback: reports status
- Sample OpModes → Robot hardware: demonstrates control (evidence: `README.md`)
- Hardware test utility → Robot hardware: tests devices (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/utilities/UtilityTestHardware.java`)
- Hardware test utility → Telemetry and feedback: reports readings (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/utilities/UtilityTestHardware.java`)
- Gamepad test utility → Telemetry and feedback: displays controls (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/utilities/UtilityTestGamepad.java`)
- Driver Station → Gamepad test utility: provides gamepads
