How zju-fast-lab/fast-drone-250 works
Fast-Drone-250 is a ROS-based autonomous quadrotor platform, combining VINS-Fusion state estimation, depth-camera mapping, Ego-Planner navigation, and PX4 flight control. Its documented operational flow brings up the camera and estimator, validates odometry and mapping, launches planning, then runs the controller for automatic takeoff and trajectory execution. The tree also includes simulation, visualization, and supporting interfaces. Some runtime modules were not sampled, so links between subsystems are shown only where the README explicitly documents them; internal edges use visible source references.
Main entry points: planner_manager.cpp Planner Manager · estimator.cpp VINS Estimator · base_realsense_node.cpp RealSense Driver · ego_replan_fsm.cpp Planner FSM
Components 23
Sensing and Mapping
- RealSense Driver
src/realflight_modules/realsense-ros/realsense2_camera/src/base_realsense_node.cpp - Grid Map
src/planner/plan_env/src/grid_map.cpp - Ray Casting
src/planner/plan_env/src/raycast.cpp - Object Predictor
src/planner/plan_env/src/obj_predictor.cpp
State Estimation
- VINS Estimator
src/realflight_modules/VINS-Fusion/vins_estimator/src/estimator/estimator.cpp - Feature Manager
src/realflight_modules/VINS-Fusion/vins_estimator/src/estimator/feature_manager.cpp - Feature Tracker
src/realflight_modules/VINS-Fusion/vins_estimator/src/featureTracker/feature_tracker.cpp - Camera Models
src/realflight_modules/VINS-Fusion/camera_models/src/camera_models/CameraFactory.cc - Loop Fusion
src/realflight_modules/VINS-Fusion/loop_fusion/src/pose_graph.cpp - Global Fusion
src/realflight_modules/VINS-Fusion/global_fusion/src/globalOpt.cpp
Planning and Trajectory
- Planner FSM
src/planner/plan_manage/src/ego_replan_fsm.cpp - Planner Manager
src/planner/plan_manage/src/planner_manager.cpp - Dynamic A Star
src/planner/path_searching/src/dyn_a_star.cpp - B-spline Optimizer
src/planner/bspline_opt/src/bspline_optimizer.cpp - Trajectory Server
src/planner/plan_manage/src/traj_server.cpp
Flight Control
- PX4 Control FSM
src/realflight_modules/px4ctrl/src/PX4CtrlFSM.cpp - Linear Controller
src/realflight_modules/px4ctrl/src/controller.cpp
Simulation and Tools
- Quadrotor Simulator
src/uav_simulator/so3_quadrotor_simulator/src/quadrotor_simulator_so3.cpp - Map Generator
src/uav_simulator/mockamap/src/maps.cpp - TCP ROS Bridge
src/planner/rosmsg_tcp_bridge/src/bridge_node.cpp - Odometry Visualization
src/uav_simulator/odom_visualization/src/odom_visualization.cpp
Other components
- Operator
- PX4 Flight Controller
Connections 21
- Operator → RealSense Driver: launches driver
- Operator → Planner FSM: launches planner
- Operator → PX4 Control FSM: starts takeoff
- RealSense Driver → VINS Estimator: provides camera data
- VINS Estimator → Planner FSM: provides odometry
- RealSense Driver → Grid Map: provides depth input
- Planner FSM → PX4 Control FSM: supplies trajectory
- PX4 Control FSM → Linear Controller: computes control
- Linear Controller → PX4 Flight Controller: commands vehicle
- VINS Estimator → Feature Manager: uses feature tracks
src/realflight_modules/VINS-Fusion/vins_estimator/src/estimator/feature_manager.cpp - Feature Manager → Feature Tracker: uses parameters
- VINS Estimator → Camera Models: uses calibration
- Loop Fusion → Global Fusion: fuses global pose
- Planner Manager → Grid Map: queries occupancy
- B-spline Optimizer → Grid Map: checks occupancy
src/planner/bspline_opt/src/bspline_optimizer.cpp - Planner Manager → Dynamic A Star: searches path
- Planner Manager → B-spline Optimizer: optimizes trajectory
- Planner Manager → Trajectory Server: publishes trajectory
- Map Generator → Quadrotor Simulator: supplies simulated scene
- Operator → Quadrotor Simulator: runs simulation
- Quadrotor Simulator → Odometry Visualization: publishes odometry