# wust-rm/awakening architecture

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

- Interactive diagram: https://gitdiagram.com/wust-rm/awakening
- Repository: https://github.com/wust-rm/awakening

## Overview

AWAKENING is a RoboMaster vision and decision system. Camera input feeds task-specific perception and state estimation, then aiming or sentry logic produces control/debug outputs; separate runtime entry points support standard, sentry, and radar operation. The README documents additional rune, radar, ROS 2, Rerun, and remote-Web capabilities. Edges use README architecture statements or visible runtime references; several subsystem implementations were not sampled, so their internal links are documented at subsystem level rather than inferred from imports alone.

Main entry points: [`src/runtime/standard.cpp`](https://github.com/wust-rm/awakening/blob/main/src/runtime/standard.cpp) (Standard runtime), [`src/runtime/sentry.cpp`](https://github.com/wust-rm/awakening/blob/main/src/runtime/sentry.cpp) (Sentry runtime), [`src/runtime/radar_detect.cpp`](https://github.com/wust-rm/awakening/blob/main/src/runtime/radar_detect.cpp) (Radar runtime), [`src/tasks/auto_aim/armor_detect`](https://github.com/wust-rm/awakening/tree/main/src/tasks/auto_aim/armor_detect) (Armor detection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime entry points"]
  node_standard["Standard runtime<br/>[standard.cpp]"]
  node_sentry["Sentry runtime<br/>[sentry.cpp]"]
  node_radar_runtime["Radar runtime<br/>[radar_detect.cpp]"]
end

subgraph group_vision["Vision tasks"]
  node_auto_aim_detect["Armor detection"]
  node_auto_aim_track["Armor tracking<br/>[armor_target.cpp]"]
  node_auto_buff_detect["Rune detection"]
  node_auto_buff_track["Rune tracking<br/>[rune_target.cpp]"]
  node_omni["Omnidirectional sensing<br/>[armor_omni.hpp]"]
  node_radar_detect["Radar perception<br/>[detector.cpp]"]
  node_lidar_location["LiDAR localization<br/>[lidar_location.cpp]"]
end

subgraph group_decision["Control and radar"]
  node_auto_aim_control["Aim control<br/>[very_aimer.cpp]"]
  node_auto_buff_control["Rune control<br/>[rune_aimer.cpp]"]
  node_sentry_brain["Sentry decisions"]
end

subgraph group_infra["I/O and visualization"]
  node_camera["Camera drivers"]
  node_inference["Neural inference"]
  node_radar_io["Radar protocol"]
  node_web_task["Web debug output<br/>[web.cpp]"]
  node_web_server["Remote Web service<br/>[web.py]"]
  node_ros["ROS 2 interface"]
  node_rerun["Rerun visualization<br/>[recorder.cpp]"]
end

node_operator(("Operator"))
node_sensors(("Robot sensors"))
node_robot(("Robot actuators"))

node_operator -->|"selects mode"| node_standard
node_operator -->|"selects mode"| node_sentry
node_operator -->|"selects mode"| node_radar_runtime
node_sensors -.->|"provide images"| node_camera
node_camera -->|"supply frames"| node_standard
node_standard -->|"runs perception"| node_auto_aim_detect
node_standard -->|"runs perception"| node_auto_buff_detect
node_sentry -->|"runs perception"| node_auto_aim_detect
node_sentry -->|"runs perception"| node_auto_buff_detect
node_standard -->|"runs tracking"| node_auto_aim_track
node_auto_aim_detect -->|"updates tracks"| node_auto_aim_track
node_auto_aim_track -->|"supplies target"| node_auto_aim_control
node_auto_aim_detect -->|"uses inference"| node_inference
node_standard -->|"runs tracking"| node_auto_buff_track
node_auto_buff_detect -->|"updates tracks"| node_auto_buff_track
node_auto_buff_track -->|"supplies target"| node_auto_buff_control
node_auto_buff_detect -->|"uses inference"| node_inference
node_sentry -->|"runs decisions"| node_sentry_brain
node_sentry -->|"runs sensing"| node_omni
node_radar_runtime -->|"runs perception"| node_radar_detect
node_radar_runtime -->|"runs localization"| node_lidar_location
node_radar_runtime -->|"uses protocol"| node_radar_io
node_standard -.->|"publishes debug"| node_web_task
node_sentry -->|"writes debug"| node_web_task
node_web_task -.->|"shares debug data"| node_web_server
node_operator -->|"views remotely"| node_web_server
node_standard -.->|"supports ROS 2"| node_ros
node_sentry -.->|"supports ROS 2"| node_ros
node_standard -.->|"records visualization"| node_rerun
node_sentry -.->|"records visualization"| node_rerun
node_auto_aim_control -.->|"outputs aim commands"| node_robot
node_auto_buff_control -.->|"outputs aim commands"| node_robot
node_sentry_brain -.->|"issues decisions"| node_robot

click node_standard "https://github.com/wust-rm/awakening/blob/main/src/runtime/standard.cpp"
click node_sentry "https://github.com/wust-rm/awakening/blob/main/src/runtime/sentry.cpp"
click node_radar_runtime "https://github.com/wust-rm/awakening/blob/main/src/runtime/radar_detect.cpp"
click node_camera "https://github.com/wust-rm/awakening/tree/main/src/utils/drivers"
click node_inference "https://github.com/wust-rm/awakening/tree/main/src/utils/net_detector"
click node_auto_aim_detect "https://github.com/wust-rm/awakening/tree/main/src/tasks/auto_aim/armor_detect"
click node_auto_aim_track "https://github.com/wust-rm/awakening/blob/main/src/tasks/auto_aim/armor_track/armor_target.cpp"
click node_auto_aim_control "https://github.com/wust-rm/awakening/blob/main/src/tasks/auto_aim/armor_control/very_aimer.cpp"
click node_auto_buff_detect "https://github.com/wust-rm/awakening/tree/main/src/tasks/auto_buff/rune_detect"
click node_auto_buff_track "https://github.com/wust-rm/awakening/blob/main/src/tasks/auto_buff/rune_track/rune_target.cpp"
click node_auto_buff_control "https://github.com/wust-rm/awakening/blob/main/src/tasks/auto_buff/rune_control/rune_aimer.cpp"
click node_omni "https://github.com/wust-rm/awakening/blob/main/src/tasks/auto_aim/armor_omni.hpp"
click node_sentry_brain "https://github.com/wust-rm/awakening/tree/main/src/tasks/sentry_brain"
click node_radar_detect "https://github.com/wust-rm/awakening/blob/main/src/tasks/radar_detect/detector.cpp"
click node_lidar_location "https://github.com/wust-rm/awakening/blob/main/src/tasks/radar_detect/lidar_location.cpp"
click node_radar_io "https://github.com/wust-rm/awakening/tree/main/src/tasks/radar_io"
click node_web_task "https://github.com/wust-rm/awakening/blob/main/src/tasks/base/web.cpp"
click node_web_server "https://github.com/wust-rm/awakening/blob/main/web.py"
click node_ros "https://github.com/wust-rm/awakening/tree/main/src/_rcl"
click node_rerun "https://github.com/wust-rm/awakening/blob/main/src/_rerun/recorder.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_standard,node_sentry,node_radar_runtime toneBlue
class node_auto_aim_detect,node_auto_aim_track,node_auto_buff_detect,node_auto_buff_track,node_omni,node_radar_detect,node_lidar_location toneAmber
class node_auto_aim_control,node_auto_buff_control,node_sentry_brain toneMint
class node_camera,node_inference,node_radar_io,node_web_task,node_web_server,node_ros,node_rerun toneRose
class node_operator,node_sensors,node_robot toneIndigo
```

## Components

### Runtime entry points

- [Standard runtime](https://github.com/wust-rm/awakening/blob/main/src/runtime/standard.cpp): `src/runtime/standard.cpp`
- [Sentry runtime](https://github.com/wust-rm/awakening/blob/main/src/runtime/sentry.cpp): `src/runtime/sentry.cpp`
- [Radar runtime](https://github.com/wust-rm/awakening/blob/main/src/runtime/radar_detect.cpp): `src/runtime/radar_detect.cpp`

### Vision tasks

- [Armor detection](https://github.com/wust-rm/awakening/tree/main/src/tasks/auto_aim/armor_detect): `src/tasks/auto_aim/armor_detect`
- [Armor tracking](https://github.com/wust-rm/awakening/blob/main/src/tasks/auto_aim/armor_track/armor_target.cpp): `src/tasks/auto_aim/armor_track/armor_target.cpp`
- [Rune detection](https://github.com/wust-rm/awakening/tree/main/src/tasks/auto_buff/rune_detect): `src/tasks/auto_buff/rune_detect`
- [Rune tracking](https://github.com/wust-rm/awakening/blob/main/src/tasks/auto_buff/rune_track/rune_target.cpp): `src/tasks/auto_buff/rune_track/rune_target.cpp`
- [Omnidirectional sensing](https://github.com/wust-rm/awakening/blob/main/src/tasks/auto_aim/armor_omni.hpp): `src/tasks/auto_aim/armor_omni.hpp`
- [Radar perception](https://github.com/wust-rm/awakening/blob/main/src/tasks/radar_detect/detector.cpp): `src/tasks/radar_detect/detector.cpp`
- [LiDAR localization](https://github.com/wust-rm/awakening/blob/main/src/tasks/radar_detect/lidar_location.cpp): `src/tasks/radar_detect/lidar_location.cpp`

### Control and radar

- [Aim control](https://github.com/wust-rm/awakening/blob/main/src/tasks/auto_aim/armor_control/very_aimer.cpp): `src/tasks/auto_aim/armor_control/very_aimer.cpp`
- [Rune control](https://github.com/wust-rm/awakening/blob/main/src/tasks/auto_buff/rune_control/rune_aimer.cpp): `src/tasks/auto_buff/rune_control/rune_aimer.cpp`
- [Sentry decisions](https://github.com/wust-rm/awakening/tree/main/src/tasks/sentry_brain): `src/tasks/sentry_brain`

### I/O and visualization

- [Camera drivers](https://github.com/wust-rm/awakening/tree/main/src/utils/drivers): `src/utils/drivers`
- [Neural inference](https://github.com/wust-rm/awakening/tree/main/src/utils/net_detector): `src/utils/net_detector`
- [Radar protocol](https://github.com/wust-rm/awakening/tree/main/src/tasks/radar_io): `src/tasks/radar_io`
- [Web debug output](https://github.com/wust-rm/awakening/blob/main/src/tasks/base/web.cpp): `src/tasks/base/web.cpp`
- [Remote Web service](https://github.com/wust-rm/awakening/blob/main/web.py): `web.py`
- [ROS 2 interface](https://github.com/wust-rm/awakening/tree/main/src/_rcl): `src/_rcl`
- [Rerun visualization](https://github.com/wust-rm/awakening/blob/main/src/_rerun/recorder.cpp): `src/_rerun/recorder.cpp`

### Other components

- **Operator**
- **Robot sensors**
- **Robot actuators**

## Connections

- Operator → Standard runtime: selects mode
- Operator → Sentry runtime: selects mode
- Operator → Radar runtime: selects mode
- Robot sensors → Camera drivers: provide images
- Camera drivers → Standard runtime: supply frames (evidence: `src/runtime/standard.cpp`)
- Standard runtime → Armor detection: runs perception (evidence: `src/runtime/standard.cpp`)
- Standard runtime → Rune detection: runs perception (evidence: `src/runtime/standard.cpp`)
- Sentry runtime → Armor detection: runs perception (evidence: `src/runtime/sentry.cpp`)
- Sentry runtime → Rune detection: runs perception (evidence: `src/runtime/sentry.cpp`)
- Standard runtime → Armor tracking: runs tracking
- Armor detection → Armor tracking: updates tracks
- Armor tracking → Aim control: supplies target
- Armor detection → Neural inference: uses inference
- Standard runtime → Rune tracking: runs tracking
- Rune detection → Rune tracking: updates tracks
- Rune tracking → Rune control: supplies target
- Rune detection → Neural inference: uses inference
- Sentry runtime → Sentry decisions: runs decisions (evidence: `src/runtime/sentry.cpp`)
- Sentry runtime → Omnidirectional sensing: runs sensing (evidence: `src/runtime/sentry.cpp`)
- Radar runtime → Radar perception: runs perception
- Radar runtime → LiDAR localization: runs localization
- Radar runtime → Radar protocol: uses protocol
- Standard runtime → Web debug output: publishes debug
- Sentry runtime → Web debug output: writes debug (evidence: `src/runtime/sentry.cpp`)
- Web debug output → Remote Web service: shares debug data
- Operator → Remote Web service: views remotely
- Standard runtime → ROS 2 interface: supports ROS 2 (evidence: `src/runtime/standard.cpp`)
- Sentry runtime → ROS 2 interface: supports ROS 2 (evidence: `src/runtime/sentry.cpp`)
- Standard runtime → Rerun visualization: records visualization
- Sentry runtime → Rerun visualization: records visualization
- Aim control → Robot actuators: outputs aim commands
- Rune control → Robot actuators: outputs aim commands
- Sentry decisions → Robot actuators: issues decisions
