# zachadell/1082g-drivecode architecture

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

- Interactive diagram: https://gitdiagram.com/zachadell/1082g-drivecode
- Repository: https://github.com/zachadell/1082g-drivecode

## Overview

1082G is competition-control software for a VEX V5 robot. PROS competition callbacks initialize the robot, then run autonomous or operator control; these modes use LemLib for chassis movement and configured sensors/motors, while the Brain display presents robot graphics and pose information. The README documents the autonomous scoring stages, arcade driving, lift/wrist/claw controls, odometry, and display capabilities. The excerpts do not expose most implementation bodies, so uncertain internal calls are omitted rather than inferred.

Main entry points: [`src/main.cpp`](https://github.com/zachadell/1082g-drivecode/blob/main/src/main.cpp) (Operator Control), [`include/lemlib/chassis/chassis.hpp`](https://github.com/zachadell/1082g-drivecode/blob/main/include/lemlib/chassis/chassis.hpp) (LemLib Chassis), [`src/auton.cpp`](https://github.com/zachadell/1082g-drivecode/blob/main/src/auton.cpp) (Autonomous Routine), [`include/lemlib/chassis/trackingWheel.hpp`](https://github.com/zachadell/1082g-drivecode/blob/main/include/lemlib/chassis/trackingWheel.hpp) (Tracking Odometry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Competition Runtime"]
  node_main["PROS Callbacks<br/>[main.cpp]"]
  node_auton["Autonomous Routine<br/>[auton.cpp]"]
  node_driver["Operator Control<br/>[main.cpp]"]
end

subgraph group_motion["Motion and Sensing"]
  node_config["Robot Configuration<br/>[botconfig.cpp]"]
  node_chassis["LemLib Chassis<br/>[chassis.hpp]"]
  node_odometry["Tracking Odometry<br/>[trackingWheel.hpp]"]
  node_pid["PID Controllers<br/>[pid.hpp]"]
  node_sensors["IMU and Encoders<br/>[imu.hpp]"]
end

subgraph group_mechanisms["Robot Mechanisms"]
  node_drive["Drive Motors<br/>[motor_group.hpp]"]
  node_lift["Lift Mechanism<br/>[botconfig.cpp]"]
  node_wrist["Wrist Mechanism<br/>[botconfig.cpp]"]
  node_claw["Claw Mechanism<br/>[botconfig.cpp]"]
end

subgraph group_interface["Brain Interface"]
  node_display["Pose Display<br/>[auton.cpp]"]
  node_brain["VEX Brain"]
end

node_competition(("Competition Control"))
node_controller(("Driver Controller"))

node_competition -->|"starts modes"| node_main
node_main -.->|"runs autonomous"| node_auton
node_main -->|"runs operator control"| node_driver
node_auton -->|"commands movement"| node_chassis
node_driver -->|"arcade drives"| node_drive
node_driver -->|"controls lift"| node_lift
node_driver -->|"controls wrist"| node_wrist
node_driver -->|"toggles claw"| node_claw
node_controller -->|"provides input"| node_driver
node_config -.->|"configures drivetrain"| node_chassis
node_config -->|"configures sensors"| node_odometry
node_chassis -->|"uses tracking wheels"| node_odometry
node_chassis -->|"uses controllers"| node_pid
node_chassis -->|"controls motors"| node_drive
node_odometry -->|"reads measurements"| node_sensors
node_auton -->|"sequences mechanisms"| node_lift
node_auton -->|"sequences mechanisms"| node_wrist
node_auton -->|"operates claw"| node_claw
node_display -->|"renders status"| node_brain
node_chassis -->|"supplies pose"| node_display
node_main -->|"initializes graphics"| node_display

click node_main "https://github.com/zachadell/1082g-drivecode/blob/main/src/main.cpp"
click node_config "https://github.com/zachadell/1082g-drivecode/blob/main/src/botconfig.cpp"
click node_auton "https://github.com/zachadell/1082g-drivecode/blob/main/src/auton.cpp"
click node_driver "https://github.com/zachadell/1082g-drivecode/blob/main/src/main.cpp"
click node_chassis "https://github.com/zachadell/1082g-drivecode/blob/main/include/lemlib/chassis/chassis.hpp"
click node_odometry "https://github.com/zachadell/1082g-drivecode/blob/main/include/lemlib/chassis/trackingWheel.hpp"
click node_pid "https://github.com/zachadell/1082g-drivecode/blob/main/include/lemlib/pid.hpp"
click node_drive "https://github.com/zachadell/1082g-drivecode/blob/main/include/pros/motor_group.hpp"
click node_sensors "https://github.com/zachadell/1082g-drivecode/blob/main/include/pros/imu.hpp"
click node_lift "https://github.com/zachadell/1082g-drivecode/blob/main/src/botconfig.cpp"
click node_wrist "https://github.com/zachadell/1082g-drivecode/blob/main/src/botconfig.cpp"
click node_claw "https://github.com/zachadell/1082g-drivecode/blob/main/src/botconfig.cpp"
click node_display "https://github.com/zachadell/1082g-drivecode/blob/main/src/auton.cpp"

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_main,node_auton,node_driver toneBlue
class node_config,node_chassis,node_odometry,node_pid,node_sensors toneAmber
class node_drive,node_lift,node_wrist,node_claw toneMint
class node_display,node_brain toneRose
class node_competition,node_controller toneIndigo
```

## Components

### Competition Runtime

- [PROS Callbacks](https://github.com/zachadell/1082g-drivecode/blob/main/src/main.cpp): `src/main.cpp`
- [Autonomous Routine](https://github.com/zachadell/1082g-drivecode/blob/main/src/auton.cpp): `src/auton.cpp`
- [Operator Control](https://github.com/zachadell/1082g-drivecode/blob/main/src/main.cpp): `src/main.cpp`

### Motion and Sensing

- [Robot Configuration](https://github.com/zachadell/1082g-drivecode/blob/main/src/botconfig.cpp): `src/botconfig.cpp`
- [LemLib Chassis](https://github.com/zachadell/1082g-drivecode/blob/main/include/lemlib/chassis/chassis.hpp): `include/lemlib/chassis/chassis.hpp`
- [Tracking Odometry](https://github.com/zachadell/1082g-drivecode/blob/main/include/lemlib/chassis/trackingWheel.hpp): `include/lemlib/chassis/trackingWheel.hpp`
- [PID Controllers](https://github.com/zachadell/1082g-drivecode/blob/main/include/lemlib/pid.hpp): `include/lemlib/pid.hpp`
- [IMU and Encoders](https://github.com/zachadell/1082g-drivecode/blob/main/include/pros/imu.hpp): `include/pros/imu.hpp`

### Robot Mechanisms

- [Drive Motors](https://github.com/zachadell/1082g-drivecode/blob/main/include/pros/motor_group.hpp): `include/pros/motor_group.hpp`
- [Lift Mechanism](https://github.com/zachadell/1082g-drivecode/blob/main/src/botconfig.cpp): `src/botconfig.cpp`
- [Wrist Mechanism](https://github.com/zachadell/1082g-drivecode/blob/main/src/botconfig.cpp): `src/botconfig.cpp`
- [Claw Mechanism](https://github.com/zachadell/1082g-drivecode/blob/main/src/botconfig.cpp): `src/botconfig.cpp`

### Brain Interface

- [Pose Display](https://github.com/zachadell/1082g-drivecode/blob/main/src/auton.cpp): `src/auton.cpp`
- **VEX Brain**

### Other components

- **Competition Control**
- **Driver Controller**

## Connections

- Competition Control → PROS Callbacks: starts modes (evidence: `src/main.cpp`)
- PROS Callbacks → Autonomous Routine: runs autonomous
- PROS Callbacks → Operator Control: runs operator control (evidence: `src/main.cpp`)
- Autonomous Routine → LemLib Chassis: commands movement
- Operator Control → Drive Motors: arcade drives
- Operator Control → Lift Mechanism: controls lift
- Operator Control → Wrist Mechanism: controls wrist
- Operator Control → Claw Mechanism: toggles claw
- Driver Controller → Operator Control: provides input
- Robot Configuration → LemLib Chassis: configures drivetrain
- Robot Configuration → Tracking Odometry: configures sensors
- LemLib Chassis → Tracking Odometry: uses tracking wheels (evidence: `include/lemlib/chassis/chassis.hpp`)
- LemLib Chassis → PID Controllers: uses controllers (evidence: `include/lemlib/chassis/chassis.hpp`)
- LemLib Chassis → Drive Motors: controls motors
- Tracking Odometry → IMU and Encoders: reads measurements
- Autonomous Routine → Lift Mechanism: sequences mechanisms
- Autonomous Routine → Wrist Mechanism: sequences mechanisms
- Autonomous Routine → Claw Mechanism: operates claw
- Pose Display → VEX Brain: renders status
- LemLib Chassis → Pose Display: supplies pose
- PROS Callbacks → Pose Display: initializes graphics (evidence: `src/main.cpp`)
