How amov-lab/prometheus works
Prometheus is a ROS/PX4 companion-computer platform for autonomous UAV development, with related UGV control, planning, perception, communications, and simulation modules. The principal operational path is a command entering the UAV controller, which publishes setpoints to the flight stack; its controller choices and parameter support are visible in the sampled headers. The README documents planning and detection as major capabilities, but their runtime wiring is not shown in the excerpts, so those branches are represented without asserted call sequences. The repository tree and README support subsystem coverage; unsampled links remain unverified.
Main entry points: uav_controller.cpp UAV controller · pos_controller_PID.h Position controllers · controller_utils.h Controller utilities · ugv_controller.cpp UGV controller
Components 16
Vehicle control
- UAV controller
Modules/uav_control/src/uav_controller.cpp - Position controllers
Modules/uav_control/include/Position_Controller/pos_controller_PID.h - Controller utilities
Modules/uav_control/include/Position_Controller/controller_utils.h - UGV controller
Modules/ugv_control/src/ugv_controller.cpp
Motion planning
- Global planning
Modules/motion_planning/global_planner/src/global_planner.cpp - Local planning
Modules/motion_planning/local_planner/src/local_planner.cpp - Min-snap trajectories
Modules/motion_planning/min_snap_trajectory/min_snap/src/min_snap_generator.cpp - Swarm replanning
Modules/ego_planner_swarm/plan_manage/src/planner_manager.cpp
Perception
- LiDAR odometry
Modules/FAST_LIO/src/laserMapping.cpp - Object detection
Modules/ego_planner_swarm/drone_detect/src/drone_detector.cpp - Ellipse detection
Modules/future_aircraft/src/ellipse_detector/ellipse_detector.cpp
Communication and simulation
- ROS communication
Modules/communication/src/communication_bridge.cpp - Parameter manager
Modules/communication/src/param_manager.cpp - AirSim physics
Simulator/airsim_simulator/airsim_ros/AirLib/include/physics/FastPhysicsEngine.hpp
Other components
- Operator / ROS
- PX4 / MAVROS
Connections 15
- Operator / ROS → UAV controller: sends commands
- UAV controller → PX4 / MAVROS: publishes setpoints
Modules/uav_control/src/uav_controller.cpp - UAV controller → Position controllers: selects controller
- Position controllers → Controller utilities: uses utilities
Modules/uav_control/include/Position_Controller/pos_controller_PID.h - UAV controller → Parameter manager: uses parameters
- Operator / ROS → UGV controller: sends commands
- Operator / ROS → Global planning: requests planning
- Operator / ROS → Local planning: requests planning
- Operator / ROS → Min-snap trajectories: requests trajectory
- Operator / ROS → Swarm replanning: requests replanning
- Operator / ROS → LiDAR odometry: provides sensor data
- Operator / ROS → Object detection: requests detection
- Operator / ROS → Ellipse detection: requests detection
- Operator / ROS → ROS communication: exchanges messages
- Operator / ROS → AirSim physics: simulates flight