How krisikas/pickme_drone works
PickmeDrone is a ROS 2/PX4 autonomous-drone platform. A mission client issues flight and navigation requests to the offboard coordinator; it validates and tracks targets, streams control commands to PX4, and exposes flight status. Odometry bridges PX4 and ROS coordinate frames. The repository also documents RGB-D perception/SLAM, simulation, and Foxglove telemetry as major capabilities. Perception and deployment wiring is described in the README, but its implementation was not sampled, so those links are documented rather than inferred from source.
Main entry points: offboard_node.cpp Flight coordinator · odometry_node.cpp Odometry bridge · core.launch.py ROS bringup · perception.launch.py RGB-D perception
Components 19
Flight control
- Flight coordinator
src/pickme_offboard/src/offboard_node.cpp - Trajectory tracker
src/pickme_offboard/src/trajectory_tracker.cpp - Safety guard
src/pickme_offboard/src/safety_guard.cpp - PX4 commands
src/pickme_offboard/src/command_sender.cpp - Offboard heartbeat
src/pickme_offboard/src/heartbeat_manager.cpp
Frames and odometry
- Odometry bridge
src/pickme_odometry/src/odometry_node.cpp
Perception and SLAM
- RGB-D perception
src/pickme_bringup/launch/perception.launch.py - Camera pipeline
src/pickme_bringup/launch/camera.launch.py - RTAB-Map SLAM
src/pickme_bringup/launch/perception.launch.py
Simulation
- Gazebo and PX4 SITL
sim/worlds/default.sdf - Vehicle models
sim/models/x500_depth/model.sdf
Interfaces and telemetry
- ROS service API
src/pickme_interfaces/srv/Navigate.srv - ROS bringup
src/pickme_bringup/launch/core.launch.py - Foxglove telemetry
src/pickme_bringup/launch/foxglove.launch.py
Other components
- Mission client
- PX4 flight controller
- Gazebo simulator
- RTAB-Map
- Foxglove Studio
Connections 22
- Mission client → Flight coordinator: requests flight
README.md - Flight coordinator → ROS service API: serves API
- Flight coordinator → Trajectory tracker: updates targets
src/pickme_offboard/src/offboard_node.cpp - Flight coordinator → Safety guard: checks safety
src/pickme_offboard/src/offboard_node.cpp - Flight coordinator → PX4 commands: dispatches commands
- Flight coordinator → Offboard heartbeat: manages heartbeat
- Trajectory tracker → PX4 flight controller: streams setpoints
src/pickme_offboard/src/trajectory_tracker.cpp - Offboard heartbeat → PX4 flight controller: publishes heartbeat
src/pickme_offboard/src/heartbeat_manager.cpp - PX4 commands → PX4 flight controller: sends commands
src/pickme_offboard/src/command_sender.cpp - PX4 flight controller → Odometry bridge: vehicle odometry
src/pickme_odometry/src/odometry_node.cpp - Odometry bridge → PX4 flight controller: visual odometry
src/pickme_odometry/src/odometry_node.cpp - ROS bringup → Flight coordinator: launches core
README.md - ROS bringup → Odometry bridge: launches odometry
README.md - Camera pipeline → RGB-D perception: provides imagery
README.md - RGB-D perception → RTAB-Map SLAM: runs mapping
README.md - RTAB-Map SLAM → Odometry bridge: feeds visual odometry
README.md - Vehicle models → Gazebo simulator: defines vehicles
README.md - Gazebo and PX4 SITL → Gazebo simulator: runs simulation
README.md - Gazebo and PX4 SITL → PX4 flight controller: runs SITL
README.md - ROS bringup → Foxglove telemetry: launches telemetry
README.md - Foxglove telemetry → Foxglove Studio: serves telemetry
README.md - RGB-D perception → RTAB-Map: uses RGB-D SLAM
README.md