# zhoucan01/ros_ws architecture

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

- Interactive diagram: https://gitdiagram.com/zhoucan01/ros_ws
- Repository: https://github.com/zhoucan01/ros_ws

## Overview

This repository is a RoboMaster robot software workspace: ROS 2 packages provide robot I/O, sensing, navigation, behavior, and Gazebo simulation. The principal operational path is sensor/command input through ROS nodes and navigation or behavior components to robot commands; the tree also shows robot-description generation and simulation support. Groups reflect those product areas, not a verified single runtime pipeline. The README is empty, and many source files were not sampled, so only directly indexed relationships are connected; other subsystem links are omitted.

Main entry points: [`src/sdformat_tools/sdformat_tools/urdf_generator.py`](https://github.com/zhoucan01/ros_ws/blob/main/src/sdformat_tools/sdformat_tools/urdf_generator.py) (URDF Generator), [`src/pb2025_sentry_nav/livox_ros_driver2/src/comm/pub_handler.cpp`](https://github.com/zhoucan01/ros_ws/blob/main/src/pb2025_sentry_nav/livox_ros_driver2/src/comm/pub_handler.cpp) (Lidar Publisher), [`src/sentry_bt/src/sentry_bt_node.cpp`](https://github.com/zhoucan01/ros_ws/blob/main/src/sentry_bt/src/sentry_bt_node.cpp) (Sentry Behavior Node), [`src/algo_master/include/algo_master/serialport.hpp`](https://github.com/zhoucan01/ros_ws/blob/main/src/algo_master/include/algo_master/serialport.hpp) (Serial Port)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_robot_io["Robot I/O"]
  node_algo_node["Algorithm Node"]
  node_serial_port["Serial Port<br/>[serialport.hpp]"]
  node_circular_buffer["Circular Buffer"]
  node_base_node["Robot Base"]
  node_transports["UART / UDP"]
end

subgraph group_perception["Sensing &amp; Localization"]
  node_livox_api["Livox SDK API<br/>[livox_lidar_api.h]"]
  node_livox_comm["Lidar Communications<br/>[comm.h]"]
  node_livox_publish["Lidar Publisher<br/>[pub_handler.cpp]"]
  node_point_lio["Point LIO<br/>[laserMapping.cpp]"]
  node_small_point_lio["Small Point LIO"]
  node_terrain_analysis["Terrain Analysis"]
end

subgraph group_navigation["Navigation"]
  node_nav_bringup["Navigation Launches"]
  node_nav_plugins["Nav2 Plugins"]
  node_pursuit_controller["Omni Pursuit"]
end

subgraph group_behavior["Behavior &amp; Control"]
  node_sentry_node["Sentry Behavior Node<br/>[sentry_bt_node.cpp]"]
  node_topic_blackboard["Topic Blackboard"]
  node_anti_autoaim["Anti-Autoaim Behavior<br/>[anti_autoaim.hpp]"]
  node_task_manager["Task Manager<br/>[task_manager.cpp]"]
end

subgraph group_simulation["Description &amp; Simulation"]
  node_gimbal_controller["Gimbal Controller"]
  node_chassis_controller["Chassis Controller"]
  node_shooter_controller["Shooter Controller"]
  node_robot_description["Robot Description Launch"]
  node_urdf_generator["URDF Generator<br/>[urdf_generator.py]"]
  node_sdf_converter["SDF Converter<br/>[sdf2urdf.py]"]
  node_sim_spawn["Simulation Spawner"]
end

node_algo_node -->|"uses"| node_serial_port
node_serial_port -->|"buffers bytes"| node_circular_buffer
node_livox_publish -->|"uses communications"| node_livox_comm
node_livox_publish -->|"uses SDK"| node_livox_api
node_sentry_node -->|"uses"| node_topic_blackboard
node_sentry_node -->|"uses"| node_anti_autoaim
node_pursuit_controller -.->|"Nav2 plugin role"| node_nav_plugins
node_nav_bringup -.->|"configures"| node_nav_plugins
node_gimbal_controller -.->|"parallel control"| node_chassis_controller
node_robot_description -->|"invokes"| node_urdf_generator
node_urdf_generator -->|"converts via"| node_sdf_converter
node_sim_spawn -->|"uses"| node_urdf_generator

click node_algo_node "https://github.com/zhoucan01/ros_ws/blob/main/src/algo_master/src/algo_master_node.cpp"
click node_serial_port "https://github.com/zhoucan01/ros_ws/blob/main/src/algo_master/include/algo_master/serialport.hpp"
click node_circular_buffer "https://github.com/zhoucan01/ros_ws/blob/main/src/algo_master/include/algo_master/circular_buffer.hpp"
click node_base_node "https://github.com/zhoucan01/ros_ws/blob/main/src/rmoss_core/rmoss_base/src/simple_robot_base_node.cpp"
click node_transports "https://github.com/zhoucan01/ros_ws/tree/main/src/rmoss_core/rmoss_base/src/transporter_driver"
click node_livox_api "https://github.com/zhoucan01/ros_ws/blob/main/src/pb2025_sentry_nav/livox_ros_driver2/Livox-SDK2/include/livox_lidar_api.h"
click node_livox_comm "https://github.com/zhoucan01/ros_ws/blob/main/src/pb2025_sentry_nav/livox_ros_driver2/src/comm/comm.h"
click node_livox_publish "https://github.com/zhoucan01/ros_ws/blob/main/src/pb2025_sentry_nav/livox_ros_driver2/src/comm/pub_handler.cpp"
click node_point_lio "https://github.com/zhoucan01/ros_ws/blob/main/src/pb2025_sentry_nav/point_lio/src/laserMapping.cpp"
click node_small_point_lio "https://github.com/zhoucan01/ros_ws/blob/main/src/pb2025_sentry_nav/small_point_lio/src/small_point_lio/small_point_lio.cpp"
click node_terrain_analysis "https://github.com/zhoucan01/ros_ws/blob/main/src/pb2025_sentry_nav/terrain_analysis/src/terrainAnalysis.cpp"
click node_nav_bringup "https://github.com/zhoucan01/ros_ws/tree/main/src/pb2025_sentry_nav/pb2025_nav_bringup/launch"
click node_nav_plugins "https://github.com/zhoucan01/ros_ws/tree/main/src/pb2025_sentry_nav/pb_nav2_plugins"
click node_pursuit_controller "https://github.com/zhoucan01/ros_ws/blob/main/src/pb2025_sentry_nav/pb_omni_pid_pursuit_controller/src/omni_pid_pursuit_controller.cpp"
click node_sentry_node "https://github.com/zhoucan01/ros_ws/blob/main/src/sentry_bt/src/sentry_bt_node.cpp"
click node_topic_blackboard "https://github.com/zhoucan01/ros_ws/blob/main/src/sentry_bt/src/behaviors/topics2blackboard.cpp"
click node_anti_autoaim "https://github.com/zhoucan01/ros_ws/blob/main/src/sentry_bt/include/sentry_bt/anti_autoaim.hpp"
click node_task_manager "https://github.com/zhoucan01/ros_ws/blob/main/src/rmoss_core/rmoss_util/src/task_manager.cpp"
click node_gimbal_controller "https://github.com/zhoucan01/ros_ws/blob/main/src/rmoss_gazebo/rmoss_gz_base/src/gimbal_controller.cpp"
click node_chassis_controller "https://github.com/zhoucan01/ros_ws/blob/main/src/rmoss_gazebo/rmoss_gz_base/src/chassis_controller.cpp"
click node_shooter_controller "https://github.com/zhoucan01/ros_ws/blob/main/src/rmoss_gazebo/rmoss_gz_base/src/shooter_controller.cpp"
click node_robot_description "https://github.com/zhoucan01/ros_ws/blob/main/src/pb2025_robot_description/launch/robot_description_launch.py"
click node_urdf_generator "https://github.com/zhoucan01/ros_ws/blob/main/src/sdformat_tools/sdformat_tools/urdf_generator.py"
click node_sdf_converter "https://github.com/zhoucan01/ros_ws/blob/main/src/sdformat_tools/sdformat_tools/sdf2urdf.py"
click node_sim_spawn "https://github.com/zhoucan01/ros_ws/blob/main/src/rmu_gazebo_simulator/rmu_gazebo_simulator/launch/spawn_robots.launch.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_algo_node,node_serial_port,node_circular_buffer,node_base_node,node_transports toneBlue
class node_livox_api,node_livox_comm,node_livox_publish,node_point_lio,node_small_point_lio,node_terrain_analysis toneAmber
class node_nav_bringup,node_nav_plugins,node_pursuit_controller toneMint
class node_sentry_node,node_topic_blackboard,node_anti_autoaim,node_task_manager toneRose
class node_gimbal_controller,node_chassis_controller,node_shooter_controller,node_robot_description,node_urdf_generator,node_sdf_converter,node_sim_spawn toneIndigo
```

## Components

### Robot I/O

- [Algorithm Node](https://github.com/zhoucan01/ros_ws/blob/main/src/algo_master/src/algo_master_node.cpp): `src/algo_master/src/algo_master_node.cpp`
- [Serial Port](https://github.com/zhoucan01/ros_ws/blob/main/src/algo_master/include/algo_master/serialport.hpp): `src/algo_master/include/algo_master/serialport.hpp`
- [Circular Buffer](https://github.com/zhoucan01/ros_ws/blob/main/src/algo_master/include/algo_master/circular_buffer.hpp): `src/algo_master/include/algo_master/circular_buffer.hpp`
- [Robot Base](https://github.com/zhoucan01/ros_ws/blob/main/src/rmoss_core/rmoss_base/src/simple_robot_base_node.cpp): `src/rmoss_core/rmoss_base/src/simple_robot_base_node.cpp`
- [UART / UDP](https://github.com/zhoucan01/ros_ws/tree/main/src/rmoss_core/rmoss_base/src/transporter_driver): `src/rmoss_core/rmoss_base/src/transporter_driver`

### Sensing & Localization

- [Livox SDK API](https://github.com/zhoucan01/ros_ws/blob/main/src/pb2025_sentry_nav/livox_ros_driver2/Livox-SDK2/include/livox_lidar_api.h): `src/pb2025_sentry_nav/livox_ros_driver2/Livox-SDK2/include/livox_lidar_api.h`
- [Lidar Communications](https://github.com/zhoucan01/ros_ws/blob/main/src/pb2025_sentry_nav/livox_ros_driver2/src/comm/comm.h): `src/pb2025_sentry_nav/livox_ros_driver2/src/comm/comm.h`
- [Lidar Publisher](https://github.com/zhoucan01/ros_ws/blob/main/src/pb2025_sentry_nav/livox_ros_driver2/src/comm/pub_handler.cpp): `src/pb2025_sentry_nav/livox_ros_driver2/src/comm/pub_handler.cpp`
- [Point LIO](https://github.com/zhoucan01/ros_ws/blob/main/src/pb2025_sentry_nav/point_lio/src/laserMapping.cpp): `src/pb2025_sentry_nav/point_lio/src/laserMapping.cpp`
- [Small Point LIO](https://github.com/zhoucan01/ros_ws/blob/main/src/pb2025_sentry_nav/small_point_lio/src/small_point_lio/small_point_lio.cpp): `src/pb2025_sentry_nav/small_point_lio/src/small_point_lio/small_point_lio.cpp`
- [Terrain Analysis](https://github.com/zhoucan01/ros_ws/blob/main/src/pb2025_sentry_nav/terrain_analysis/src/terrainAnalysis.cpp): `src/pb2025_sentry_nav/terrain_analysis/src/terrainAnalysis.cpp`

### Navigation

- [Navigation Launches](https://github.com/zhoucan01/ros_ws/tree/main/src/pb2025_sentry_nav/pb2025_nav_bringup/launch): `src/pb2025_sentry_nav/pb2025_nav_bringup/launch`
- [Nav2 Plugins](https://github.com/zhoucan01/ros_ws/tree/main/src/pb2025_sentry_nav/pb_nav2_plugins): `src/pb2025_sentry_nav/pb_nav2_plugins`
- [Omni Pursuit](https://github.com/zhoucan01/ros_ws/blob/main/src/pb2025_sentry_nav/pb_omni_pid_pursuit_controller/src/omni_pid_pursuit_controller.cpp): `src/pb2025_sentry_nav/pb_omni_pid_pursuit_controller/src/omni_pid_pursuit_controller.cpp`

### Behavior & Control

- [Sentry Behavior Node](https://github.com/zhoucan01/ros_ws/blob/main/src/sentry_bt/src/sentry_bt_node.cpp): `src/sentry_bt/src/sentry_bt_node.cpp`
- [Topic Blackboard](https://github.com/zhoucan01/ros_ws/blob/main/src/sentry_bt/src/behaviors/topics2blackboard.cpp): `src/sentry_bt/src/behaviors/topics2blackboard.cpp`
- [Anti-Autoaim Behavior](https://github.com/zhoucan01/ros_ws/blob/main/src/sentry_bt/include/sentry_bt/anti_autoaim.hpp): `src/sentry_bt/include/sentry_bt/anti_autoaim.hpp`
- [Task Manager](https://github.com/zhoucan01/ros_ws/blob/main/src/rmoss_core/rmoss_util/src/task_manager.cpp): `src/rmoss_core/rmoss_util/src/task_manager.cpp`

### Description & Simulation

- [Gimbal Controller](https://github.com/zhoucan01/ros_ws/blob/main/src/rmoss_gazebo/rmoss_gz_base/src/gimbal_controller.cpp): `src/rmoss_gazebo/rmoss_gz_base/src/gimbal_controller.cpp`
- [Chassis Controller](https://github.com/zhoucan01/ros_ws/blob/main/src/rmoss_gazebo/rmoss_gz_base/src/chassis_controller.cpp): `src/rmoss_gazebo/rmoss_gz_base/src/chassis_controller.cpp`
- [Shooter Controller](https://github.com/zhoucan01/ros_ws/blob/main/src/rmoss_gazebo/rmoss_gz_base/src/shooter_controller.cpp): `src/rmoss_gazebo/rmoss_gz_base/src/shooter_controller.cpp`
- [Robot Description Launch](https://github.com/zhoucan01/ros_ws/blob/main/src/pb2025_robot_description/launch/robot_description_launch.py): `src/pb2025_robot_description/launch/robot_description_launch.py`
- [URDF Generator](https://github.com/zhoucan01/ros_ws/blob/main/src/sdformat_tools/sdformat_tools/urdf_generator.py): `src/sdformat_tools/sdformat_tools/urdf_generator.py`
- [SDF Converter](https://github.com/zhoucan01/ros_ws/blob/main/src/sdformat_tools/sdformat_tools/sdf2urdf.py): `src/sdformat_tools/sdformat_tools/sdf2urdf.py`
- [Simulation Spawner](https://github.com/zhoucan01/ros_ws/blob/main/src/rmu_gazebo_simulator/rmu_gazebo_simulator/launch/spawn_robots.launch.py): `src/rmu_gazebo_simulator/rmu_gazebo_simulator/launch/spawn_robots.launch.py`

## Connections

- Algorithm Node → Serial Port: uses (evidence: `src/algo_master/src/algo_master_node.cpp`)
- Serial Port → Circular Buffer: buffers bytes (evidence: `src/algo_master/include/algo_master/serialport.hpp`)
- Lidar Publisher → Lidar Communications: uses communications
- Lidar Publisher → Livox SDK API: uses SDK
- Sentry Behavior Node → Topic Blackboard: uses (evidence: `src/sentry_bt/src/sentry_bt_node.cpp`)
- Sentry Behavior Node → Anti-Autoaim Behavior: uses (evidence: `src/sentry_bt/src/sentry_bt_node.cpp`)
- Omni Pursuit → Nav2 Plugins: Nav2 plugin role
- Navigation Launches → Nav2 Plugins: configures
- Gimbal Controller → Chassis Controller: parallel control
- Robot Description Launch → URDF Generator: invokes (evidence: `src/pb2025_robot_description/launch/robot_description_launch.py`)
- URDF Generator → SDF Converter: converts via (evidence: `src/sdformat_tools/sdformat_tools/urdf_generator.py`)
- Simulation Spawner → URDF Generator: uses (evidence: `src/rmu_gazebo_simulator/rmu_gazebo_simulator/launch/spawn_robots.launch.py`)
