# greeneggsandhamseuss/fira-robocup architecture

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

- Interactive diagram: https://gitdiagram.com/greeneggsandhamseuss/fira-robocup
- Repository: https://github.com/greeneggsandhamseuss/fira-robocup

## Overview

This repository is a collection of Python flight programs for a Tello drone, chiefly aimed at finding AprilTags, aligning with gates, and navigating through them. The principal workflow is visible in the flight scripts: obtain drone video and telemetry, detect tags, use search/alignment states to choose motion, then send flight commands. Several files are alternative or evolving controllers rather than separate services. `main.py` additionally uses video-health and braking helpers; `united.py` shows radio messaging. Other integrations and behavior are limited to the excerpts and index references provided.

Main entry points: [`at.py`](https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/at.py) (AprilTag detection), [`main.py`](https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/main.py) (Main controller), [`united.py`](https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/united.py) (United controller), [`actually_the_original_used.py`](https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/actually_the_original_used.py) (Original controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_flight["Flight controllers"]
  node_main["Main controller<br/>[main.py]"]
  node_original["Original controller"]
  node_dawn["New Dawn controller<br/>[newdawn.py]"]
  node_dawntest["Dawn test controller<br/>[newdawntest.py]"]
  node_og["OG controller<br/>[og.py]"]
  node_temporary["Temporary controller<br/>[temporary.py]"]
  node_skibidi["Skibidi controller<br/>[skibiditoilet.py]"]
  node_united["United controller<br/>[united.py]"]
  node_scan["Scanning controller"]
end

subgraph group_vision["Tag vision"]
  node_tagdetector["AprilTag detection<br/>[at.py]"]
end

subgraph group_support["Flight support"]
  node_helpers["Control and video helpers<br/>[utils.py]"]
end

subgraph group_comms["Radio communication"]
  node_radio["ESP32 radio interface"]
end

node_operator(("Operator"))
node_tello["Tello drone"]
node_apriltaglib["AprilTag detector library"]

node_operator -.->|"starts"| node_main
node_main -->|"controls"| node_tello
node_main -->|"detects tags"| node_tagdetector
node_main -->|"uses helpers"| node_helpers
node_tagdetector -->|"detects tags"| node_apriltaglib
node_original -->|"detects tags"| node_tagdetector
node_dawn -->|"detects tags"| node_tagdetector
node_dawntest -->|"detects tags"| node_tagdetector
node_og -->|"detects tags"| node_tagdetector
node_temporary -->|"detects tags"| node_tagdetector
node_skibidi -->|"detects tags"| node_tagdetector
node_united -->|"detects tags"| node_tagdetector
node_scan -->|"controls"| node_tello
node_united -->|"sends and receives"| node_radio

click node_main "https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/main.py"
click node_original "https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/actually_the_original_used.py"
click node_dawn "https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/newdawn.py"
click node_dawntest "https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/newdawntest.py"
click node_og "https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/og.py"
click node_temporary "https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/temporary.py"
click node_skibidi "https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/skibiditoilet.py"
click node_united "https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/united.py"
click node_scan "https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/dronescanningexplanation.py"
click node_tagdetector "https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/at.py"
click node_helpers "https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/utils.py"
click node_radio "https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/drone_communication.py"

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_original,node_dawn,node_dawntest,node_og,node_temporary,node_skibidi,node_united,node_scan toneBlue
class node_tagdetector toneAmber
class node_helpers toneMint
class node_radio toneRose
class node_operator,node_tello,node_apriltaglib toneIndigo
```

## Components

### Flight controllers

- [Main controller](https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/main.py): `main.py`
- [Original controller](https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/actually_the_original_used.py): `actually_the_original_used.py`
- [New Dawn controller](https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/newdawn.py): `newdawn.py`
- [Dawn test controller](https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/newdawntest.py): `newdawntest.py`
- [OG controller](https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/og.py): `og.py`
- [Temporary controller](https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/temporary.py): `temporary.py`
- [Skibidi controller](https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/skibiditoilet.py): `skibiditoilet.py`
- [United controller](https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/united.py): `united.py`
- [Scanning controller](https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/dronescanningexplanation.py): `dronescanningexplanation.py`

### Tag vision

- [AprilTag detection](https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/at.py): `at.py`

### Flight support

- [Control and video helpers](https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/utils.py): `utils.py`

### Radio communication

- [ESP32 radio interface](https://github.com/greeneggsandhamseuss/fira-robocup/blob/main/drone_communication.py): `drone_communication.py`

### Other components

- **Operator**
- **Tello drone**
- **AprilTag detector library**

## Connections

- Operator → Main controller: starts
- Main controller → Tello drone: controls (evidence: `main.py`)
- Main controller → AprilTag detection: detects tags (evidence: `main.py`)
- Main controller → Control and video helpers: uses helpers (evidence: `main.py`)
- AprilTag detection → AprilTag detector library: detects tags (evidence: `at.py`)
- Original controller → AprilTag detection: detects tags (evidence: `actually_the_original_used.py`)
- New Dawn controller → AprilTag detection: detects tags (evidence: `newdawn.py`)
- Dawn test controller → AprilTag detection: detects tags (evidence: `newdawntest.py`)
- OG controller → AprilTag detection: detects tags (evidence: `og.py`)
- Temporary controller → AprilTag detection: detects tags (evidence: `temporary.py`)
- Skibidi controller → AprilTag detection: detects tags (evidence: `skibiditoilet.py`)
- United controller → AprilTag detection: detects tags (evidence: `united.py`)
- Scanning controller → Tello drone: controls (evidence: `dronescanningexplanation.py`)
- United controller → ESP32 radio interface: sends and receives (evidence: `united.py`)
