# yong-uno/drone architecture

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

- Interactive diagram: https://gitdiagram.com/yong-uno/drone
- Repository: https://github.com/yong-uno/drone

## Overview

This is STM32F4 robot-control firmware. Its principal workflow is to read operator input, compute gimbal and shooter motor commands, and transmit them over CAN; the README specifically documents RS05/DM4310 CAN control. The tree also shows sensor, display/referee UI, and USB/VPC capabilities. Source evidence is partial: the excerpts show peripheral initialization and shooter control, while most application wiring is unsampled, so uncertain links are dashed and marked unverified.

Main entry points: [`User/Application/shoot/shoot_control.c`](https://github.com/yong-uno/drone/blob/main/User/Application/shoot/shoot_control.c) (Shooter control), [`User/BSP/CAN/bsp_can.c`](https://github.com/yong-uno/drone/blob/main/User/BSP/CAN/bsp_can.c) (CAN board driver), [`User/BSP/UART/dbus.c`](https://github.com/yong-uno/drone/blob/main/User/BSP/UART/dbus.c) (Remote input), [`Core/Src/freertos.c`](https://github.com/yong-uno/drone/blob/main/Core/Src/freertos.c) (RTOS tasks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Startup and RTOS"]
  node_main["Firmware startup<br/>[main.c]"]
  node_freertos["RTOS tasks<br/>[freertos.c]"]
end

subgraph group_control["Robot control"]
  node_gimbal["Gimbal control"]
  node_shoot["Shooter control<br/>[shoot_control.c]"]
  node_switch["Control switch<br/>[control_switch.c]"]
  node_pid["PID algorithms<br/>[pid.c]"]
  node_status["Robot status<br/>[robot_status.c]"]
end

subgraph group_io["Board I/O"]
  node_dbus["Remote input<br/>[dbus.c]"]
  node_can["CAN board driver<br/>[bsp_can.c]"]
  node_iic["I2C board driver<br/>[bsp_iic.c]"]
  node_spi["BMI088 SPI driver<br/>[bsp_spi_bmi088.c]"]
  node_usb["USB CDC interface<br/>[usbd_cdc_if.c]"]
end

subgraph group_devices["Devices and UI"]
  node_rs05["RS05 motor protocol<br/>[RS05.cpp]"]
  node_sensor["IMU sensors<br/>[bmi088.c]"]
  node_display["Display task<br/>[display.c]"]
  node_oled["SSD1306 display<br/>[ssd1306.c]"]
  node_referee["Referee UI<br/>[dev_referee_ui.c]"]
  node_vpc["VPC connectivity<br/>[vpc.cpp]"]
end

node_operator(("Operator"))
node_external(("USB host"))

node_operator -.->|"sends input"| node_dbus
node_dbus -.->|"provides controls"| node_shoot
node_dbus -.->|"provides controls"| node_gimbal
node_freertos -.->|"runs task"| node_shoot
node_freertos -.->|"runs task"| node_gimbal
node_shoot -.->|"calculates control"| node_pid
node_shoot -->|"sends motor commands"| node_can
node_gimbal -.->|"uses CAN driver"| node_can
node_can -->|"uses motor protocol"| node_rs05
node_sensor -.->|"uses SPI driver"| node_spi
node_sensor -.->|"uses I2C driver"| node_iic
node_display -->|"renders display"| node_oled
node_referee -.->|"exchanges referee UI"| node_external
node_external -.->|"connects USB"| node_usb
node_usb -->|"passes data"| node_vpc
node_main -.->|"initializes CAN"| node_can
node_main -.->|"starts scheduler"| node_freertos

click node_main "https://github.com/yong-uno/drone/blob/main/Core/Src/main.c"
click node_freertos "https://github.com/yong-uno/drone/blob/main/Core/Src/freertos.c"
click node_gimbal "https://github.com/yong-uno/drone/blob/main/User/Application/gimbal/gimbal_control_pitch.cpp"
click node_shoot "https://github.com/yong-uno/drone/blob/main/User/Application/shoot/shoot_control.c"
click node_switch "https://github.com/yong-uno/drone/blob/main/User/Application/control_switch/control_switch.c"
click node_pid "https://github.com/yong-uno/drone/blob/main/User/Modules/Algorithm/PID/pid.c"
click node_status "https://github.com/yong-uno/drone/blob/main/User/Modules/robot_status/robot_status.c"
click node_dbus "https://github.com/yong-uno/drone/blob/main/User/BSP/UART/dbus.c"
click node_can "https://github.com/yong-uno/drone/blob/main/User/BSP/CAN/bsp_can.c"
click node_rs05 "https://github.com/yong-uno/drone/blob/main/User/Modules/RS05/RS05.cpp"
click node_sensor "https://github.com/yong-uno/drone/blob/main/User/Modules/bmi088/bmi088.c"
click node_iic "https://github.com/yong-uno/drone/blob/main/User/BSP/IIC/bsp_iic.c"
click node_spi "https://github.com/yong-uno/drone/blob/main/User/BSP/SPI/spi_bmi088/bsp_spi_bmi088.c"
click node_display "https://github.com/yong-uno/drone/blob/main/User/Application/display/display.c"
click node_oled "https://github.com/yong-uno/drone/blob/main/User/Modules/ssd1306/ssd1306.c"
click node_referee "https://github.com/yong-uno/drone/blob/main/User/Modules/ui/dev_referee_ui.c"
click node_vpc "https://github.com/yong-uno/drone/blob/main/User/Application/VPC/vpc.cpp"
click node_usb "https://github.com/yong-uno/drone/blob/main/USB_DEVICE/App/usbd_cdc_if.c"

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_freertos toneBlue
class node_gimbal,node_shoot,node_switch,node_pid,node_status toneAmber
class node_dbus,node_can,node_iic,node_spi,node_usb toneMint
class node_rs05,node_sensor,node_display,node_oled,node_referee,node_vpc toneRose
class node_operator,node_external toneIndigo
```

## Components

### Startup and RTOS

- [Firmware startup](https://github.com/yong-uno/drone/blob/main/Core/Src/main.c): `Core/Src/main.c`
- [RTOS tasks](https://github.com/yong-uno/drone/blob/main/Core/Src/freertos.c): `Core/Src/freertos.c`

### Robot control

- [Gimbal control](https://github.com/yong-uno/drone/blob/main/User/Application/gimbal/gimbal_control_pitch.cpp): `User/Application/gimbal/gimbal_control_pitch.cpp`
- [Shooter control](https://github.com/yong-uno/drone/blob/main/User/Application/shoot/shoot_control.c): `User/Application/shoot/shoot_control.c`
- [Control switch](https://github.com/yong-uno/drone/blob/main/User/Application/control_switch/control_switch.c): `User/Application/control_switch/control_switch.c`
- [PID algorithms](https://github.com/yong-uno/drone/blob/main/User/Modules/Algorithm/PID/pid.c): `User/Modules/Algorithm/PID/pid.c`
- [Robot status](https://github.com/yong-uno/drone/blob/main/User/Modules/robot_status/robot_status.c): `User/Modules/robot_status/robot_status.c`

### Board I/O

- [Remote input](https://github.com/yong-uno/drone/blob/main/User/BSP/UART/dbus.c): `User/BSP/UART/dbus.c`
- [CAN board driver](https://github.com/yong-uno/drone/blob/main/User/BSP/CAN/bsp_can.c): `User/BSP/CAN/bsp_can.c`
- [I2C board driver](https://github.com/yong-uno/drone/blob/main/User/BSP/IIC/bsp_iic.c): `User/BSP/IIC/bsp_iic.c`
- [BMI088 SPI driver](https://github.com/yong-uno/drone/blob/main/User/BSP/SPI/spi_bmi088/bsp_spi_bmi088.c): `User/BSP/SPI/spi_bmi088/bsp_spi_bmi088.c`
- [USB CDC interface](https://github.com/yong-uno/drone/blob/main/USB_DEVICE/App/usbd_cdc_if.c): `USB_DEVICE/App/usbd_cdc_if.c`

### Devices and UI

- [RS05 motor protocol](https://github.com/yong-uno/drone/blob/main/User/Modules/RS05/RS05.cpp): `User/Modules/RS05/RS05.cpp`
- [IMU sensors](https://github.com/yong-uno/drone/blob/main/User/Modules/bmi088/bmi088.c): `User/Modules/bmi088/bmi088.c`
- [Display task](https://github.com/yong-uno/drone/blob/main/User/Application/display/display.c): `User/Application/display/display.c`
- [SSD1306 display](https://github.com/yong-uno/drone/blob/main/User/Modules/ssd1306/ssd1306.c): `User/Modules/ssd1306/ssd1306.c`
- [Referee UI](https://github.com/yong-uno/drone/blob/main/User/Modules/ui/dev_referee_ui.c): `User/Modules/ui/dev_referee_ui.c`
- [VPC connectivity](https://github.com/yong-uno/drone/blob/main/User/Application/VPC/vpc.cpp): `User/Application/VPC/vpc.cpp`

### Other components

- **Operator**
- **USB host**

## Connections

- Operator → Remote input: sends input
- Remote input → Shooter control: provides controls
- Remote input → Gimbal control: provides controls
- RTOS tasks → Shooter control: runs task
- RTOS tasks → Gimbal control: runs task
- Shooter control → PID algorithms: calculates control
- Shooter control → CAN board driver: sends motor commands (evidence: `User/Application/shoot/shoot_control.c`)
- Gimbal control → CAN board driver: uses CAN driver (evidence: `User/Application/gimbal/gimbal_control_pitch.cpp`)
- CAN board driver → RS05 motor protocol: uses motor protocol (evidence: `User/BSP/CAN/bsp_can.c`)
- IMU sensors → BMI088 SPI driver: uses SPI driver
- IMU sensors → I2C board driver: uses I2C driver
- Display task → SSD1306 display: renders display (evidence: `User/Application/display/display.c`)
- Referee UI → USB host: exchanges referee UI
- USB host → USB CDC interface: connects USB
- USB CDC interface → VPC connectivity: passes data (evidence: `USB_DEVICE/App/usbd_cdc_if.c`)
- Firmware startup → CAN board driver: initializes CAN (evidence: `Core/Src/main.c`)
- Firmware startup → RTOS tasks: starts scheduler
