# slingshot-20240-2026-2027/lawnmower-v1 architecture

> Architecture diagram of the GitHub repository slingshot-20240-2026-2027/lawnmower-v1, 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/slingshot-20240-2026-2027/lawnmower-v1
- Repository: https://github.com/slingshot-20240-2026-2027/lawnmower-v1

## Overview

This is the FTC Robot Controller Android application and a team-specific robot program. The primary workflow is for a team to create or select an OpMode, run it through the controller, and use it to control the competition robot. The repository also documents Blocks and OnBot Java programming, and includes samples and team-side Pedro Pathing tuning procedures. The graph separates controller startup, programming entry points, team behavior, and tuning. The sampled files show the tuning registrations and some runtime responsibilities; SDK internals and most documented capabilities are represented only at subsystem level.

Main entry points: [`TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/Tuning.java`](https://github.com/slingshot-20240-2026-2027/lawnmower-v1/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/Tuning.java) (Tuning registrations), [`FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`](https://github.com/slingshot-20240-2026-2027/lawnmower-v1/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java) (Controller activity), [`FtcRobotController`](https://github.com/slingshot-20240-2026-2027/lawnmower-v1/tree/master/FtcRobotController) (Controller app), [`TeamCode/src/main/java/org/firstinspires/ftc/teamcode`](https://github.com/slingshot-20240-2026-2027/lawnmower-v1/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode) (Team OpModes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_controller["Controller runtime"]
  node_controller_app["Controller app"]
  node_activity["Controller activity"]
  node_permissions["Permission validation"]
  node_opmode_register["OpMode registration"]
end

subgraph group_programming["Programming"]
  node_blocks["Blocks programming"]
  node_onbot["OnBot Java"]
  node_android_java["Android Studio Java"]
  node_samples["Sample OpModes"]
end

subgraph group_team["Team robot code"]
  node_team_opmodes["Team OpModes"]
  node_teleop["Team teleop<br/>[TeleOp.java]"]
end

subgraph group_tuning["Robot tuning"]
  node_tuning_entry["Tuning registrations<br/>[Tuning.java]"]
  node_constants["Robot configuration<br/>[Constants.java]"]
  node_foresight["Foresight calibration"]
  node_mecanum["Mecanum setup<br/>[MecanumTuner.java]"]
  node_pinpoint["Pinpoint setup<br/>[PinpointTuner.java]"]
  node_tests["Path and drive tests<br/>[Tests.java]"]
  node_other_tuners["Other tuner procedures"]
end

node_driver(("Robot operator"))
node_hardware["Robot hardware"]
node_robot["Competition robot"]

node_driver -->|"operates"| node_controller_app
node_controller_app -.->|"starts through"| node_activity
node_activity -.->|"validates permissions"| node_permissions
node_activity -->|"references registration"| node_opmode_register
node_driver -->|"programs with"| node_blocks
node_driver -->|"programs with"| node_onbot
node_driver -->|"programs with"| node_android_java
node_android_java -->|"adapts examples"| node_samples
node_android_java -->|"writes robot code"| node_team_opmodes
node_team_opmodes -.->|"includes"| node_teleop
node_tuning_entry -->|"creates"| node_foresight
node_tuning_entry -->|"creates"| node_mecanum
node_tuning_entry -->|"creates"| node_pinpoint
node_tuning_entry -->|"creates"| node_tests
node_tuning_entry -->|"uses configuration"| node_constants
node_tuning_entry -.->|"also registers"| node_other_tuners
node_foresight -.->|"tunes against"| node_hardware
node_mecanum -.->|"tests motors"| node_hardware
node_pinpoint -.->|"tunes localization"| node_hardware
node_tests -.->|"tests driving"| node_hardware
node_teleop -.->|"controls"| node_robot

click node_controller_app "https://github.com/slingshot-20240-2026-2027/lawnmower-v1/tree/master/FtcRobotController"
click node_activity "https://github.com/slingshot-20240-2026-2027/lawnmower-v1/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java"
click node_permissions "https://github.com/slingshot-20240-2026-2027/lawnmower-v1/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/PermissionValidatorWrapper.java"
click node_opmode_register "https://github.com/slingshot-20240-2026-2027/lawnmower-v1/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcOpModeRegister.java"
click node_samples "https://github.com/slingshot-20240-2026-2027/lawnmower-v1/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples"
click node_team_opmodes "https://github.com/slingshot-20240-2026-2027/lawnmower-v1/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode"
click node_teleop "https://github.com/slingshot-20240-2026-2027/lawnmower-v1/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/TeleOp.java"
click node_tuning_entry "https://github.com/slingshot-20240-2026-2027/lawnmower-v1/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/Tuning.java"
click node_constants "https://github.com/slingshot-20240-2026-2027/lawnmower-v1/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/Constants.java"
click node_foresight "https://github.com/slingshot-20240-2026-2027/lawnmower-v1/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/procedures/ForesightTuner.java"
click node_mecanum "https://github.com/slingshot-20240-2026-2027/lawnmower-v1/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/procedures/MecanumTuner.java"
click node_pinpoint "https://github.com/slingshot-20240-2026-2027/lawnmower-v1/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/procedures/PinpointTuner.java"
click node_tests "https://github.com/slingshot-20240-2026-2027/lawnmower-v1/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/procedures/Tests.java"
click node_other_tuners "https://github.com/slingshot-20240-2026-2027/lawnmower-v1/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/procedures"

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_app,node_activity,node_permissions,node_opmode_register toneBlue
class node_blocks,node_onbot,node_android_java,node_samples toneAmber
class node_team_opmodes,node_teleop toneMint
class node_tuning_entry,node_constants,node_foresight,node_mecanum,node_pinpoint,node_tests,node_other_tuners toneRose
class node_driver,node_hardware,node_robot toneIndigo
```

## Components

### Controller runtime

- [Controller app](https://github.com/slingshot-20240-2026-2027/lawnmower-v1/tree/master/FtcRobotController): `FtcRobotController`
- [Controller activity](https://github.com/slingshot-20240-2026-2027/lawnmower-v1/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 validation](https://github.com/slingshot-20240-2026-2027/lawnmower-v1/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 registration](https://github.com/slingshot-20240-2026-2027/lawnmower-v1/blob/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcOpModeRegister.java): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcOpModeRegister.java`

### Programming

- **Blocks programming**
- **OnBot Java**
- **Android Studio Java**
- [Sample OpModes](https://github.com/slingshot-20240-2026-2027/lawnmower-v1/tree/master/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples): `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples`

### Team robot code

- [Team OpModes](https://github.com/slingshot-20240-2026-2027/lawnmower-v1/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode`
- [Team teleop](https://github.com/slingshot-20240-2026-2027/lawnmower-v1/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/TeleOp.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/TeleOp.java`

### Robot tuning

- [Tuning registrations](https://github.com/slingshot-20240-2026-2027/lawnmower-v1/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/Tuning.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/Tuning.java`
- [Robot configuration](https://github.com/slingshot-20240-2026-2027/lawnmower-v1/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/Constants.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/Constants.java`
- [Foresight calibration](https://github.com/slingshot-20240-2026-2027/lawnmower-v1/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/procedures/ForesightTuner.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/procedures/ForesightTuner.java`
- [Mecanum setup](https://github.com/slingshot-20240-2026-2027/lawnmower-v1/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/procedures/MecanumTuner.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/procedures/MecanumTuner.java`
- [Pinpoint setup](https://github.com/slingshot-20240-2026-2027/lawnmower-v1/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/procedures/PinpointTuner.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/procedures/PinpointTuner.java`
- [Path and drive tests](https://github.com/slingshot-20240-2026-2027/lawnmower-v1/blob/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/procedures/Tests.java): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/procedures/Tests.java`
- [Other tuner procedures](https://github.com/slingshot-20240-2026-2027/lawnmower-v1/tree/master/TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/procedures): `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/procedures`

### Other components

- **Robot operator**
- **Robot hardware**
- **Competition robot**

## Connections

- Robot operator → Controller app: operates (evidence: `README.md`)
- Controller app → Controller activity: starts through (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/PermissionValidatorWrapper.java`)
- Controller activity → Permission validation: validates permissions (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`)
- Controller activity → OpMode registration: references registration (evidence: `FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java`)
- Robot operator → Blocks programming: programs with (evidence: `README.md`)
- Robot operator → OnBot Java: programs with (evidence: `README.md`)
- Robot operator → Android Studio Java: programs with (evidence: `README.md`)
- Android Studio Java → Sample OpModes: adapts examples (evidence: `README.md`)
- Android Studio Java → Team OpModes: writes robot code (evidence: `README.md`)
- Team OpModes → Team teleop: includes
- Tuning registrations → Foresight calibration: creates (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/Tuning.java`)
- Tuning registrations → Mecanum setup: creates (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/Tuning.java`)
- Tuning registrations → Pinpoint setup: creates (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/Tuning.java`)
- Tuning registrations → Path and drive tests: creates (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/Tuning.java`)
- Tuning registrations → Robot configuration: uses configuration (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/Tuning.java`)
- Tuning registrations → Other tuner procedures: also registers (evidence: `TeamCode/src/main/java/org/firstinspires/ftc/teamcode/Auton/pedro/Tuning.java`)
- Foresight calibration → Robot hardware: tunes against
- Mecanum setup → Robot hardware: tests motors
- Pinpoint setup → Robot hardware: tunes localization
- Path and drive tests → Robot hardware: tests driving
- Team teleop → Competition robot: controls
