How 0range02/heliobox works
Heliobox is a ROS 2 robot software stack: operators or other ROS nodes start capabilities, which consume sensor or joystick input and publish motion, perception, or robot-state outputs. Its source tree covers application-level behaviors, hardware drivers, peripherals, navigation/SLAM, and multi-robot coordination. The README provides no further workflow description, and many launch and runtime files were not sampled; the graph therefore shows documented module calls where visible and avoids asserting wiring for unsampled subsystems.
Main entry points: lidar_controller.py Lidar behavior · yolo_detect.py YOLO detection · navigation.launch.py Navigation stack · ros_robot_controller_node.py Robot controller node
Components 27
Robot behaviors
- Lidar behavior
src/app/app/lidar_controller.py - App helpers
src/app/app/common.py - Hand landmarks
src/app/app/model/hand_landmark.py - Vision geometry
src/app/app/model/utils.py - Line following
src/app/app/line_following.py - Hand gestures
src/app/app/hand_gesture.py - Heliobox control
src/heliobox/heliobox/heliobox_ctrl.py - Behavior state
src/heliobox/heliobox/state_machine.py
Control and drivers
- Robot controller node
src/driver/ros_robot_controller/ros_robot_controller/ros_robot_controller_node.py - Board SDK
src/driver/ros_robot_controller/ros_robot_controller/ros_robot_controller_sdk.py - Joystick control
src/peripherals/peripherals/joystick_control.py - Control utilities
src/driver/sdk/sdk/common.py - PID controller
src/driver/sdk/sdk/pid.py - Odometry publisher
src/driver/controller/controller/odom_publisher_node.py
Perception and sensors
- YOLO detection
src/yolov5_ros2/yolov5_ros2/yolo_detect.py - Image tools
src/yolov5_ros2/yolov5_ros2/cv_tool.py - FPS meter
src/yolov5_ros2/yolov5_ros2/fps.py - Lidar driver
src/heliobox/heliobox/heliobox_lidar.py - Camera driver
src/heliobox/heliobox/heliobox_cam.py
Navigation and mapping
- Navigation stack
src/navigation/launch/navigation.launch.py - SLAM stack
src/slam/launch/slam.launch.py - Map saving
src/slam/slam/map_save.py - Motion calibration
src/calibration/calibration/calibrate_linear.py
Operations and fleets
- Startup checks
src/bringup/bringup/startup_check.py - Fleet coordination
src/multi/multi/formation_update.py - Keyboard teleop
src/peripherals/peripherals/teleop_key_control.py
Other components
- ROS operator
Connections 19
- ROS operator → Lidar behavior: starts behavior
- ROS operator → YOLO detection: starts detection
- ROS operator → Navigation stack: starts navigation
- ROS operator → SLAM stack: starts mapping
- Lidar behavior → App helpers: uses helpers
src/app/app/lidar_controller.py - Lidar behavior → PID controller: uses control
src/app/app/lidar_controller.py - Lidar behavior → Control utilities: uses utilities
src/app/app/lidar_controller.py - Hand landmarks → Vision geometry: uses geometry
src/app/app/model/hand_landmark.py - Heliobox control → Behavior state: uses state
src/heliobox/heliobox/heliobox_ctrl.py - Robot controller node → Board SDK: uses board SDK
src/driver/ros_robot_controller/ros_robot_controller/ros_robot_controller_node.py - Joystick control → Control utilities: uses utilities
src/peripherals/peripherals/joystick_control.py - YOLO detection → Image tools: uses image tools
src/yolov5_ros2/yolov5_ros2/yolo_detect.py - YOLO detection → FPS meter: updates meter
src/yolov5_ros2/yolov5_ros2/yolo_detect.py - Lidar driver → Lidar behavior: supplies scans
- Camera driver → YOLO detection: supplies images
- Navigation stack → Odometry publisher: uses odometry
- SLAM stack → Map saving: saves maps
- Keyboard teleop → Robot controller node: commands motion
- Fleet coordination → Navigation stack: coordinates robots