How rajagopal95/bumpy_ws works
bumpy_ws is a ROS 2 mobile-robot platform. Its main workflow brings up robot description, odometry/control, and sensors; LiDAR and fused odometry support SLAM and mapping, while Nav2 provides autonomous motion. Separate branches cover operator teleoperation, sensor/dashboard capabilities, and multi-robot formation control. Several capabilities are documented but their launch wiring or implementation was not sampled, so those connections are omitted or marked unverified.
Main entry points: motor_control.py Motor control · bringup.launch.py Bringup launch · minimal.launch.py Minimal launch · ydlidar_ros2_driver_node.cpp YDLidar driver
Components 23
Robot bringup
- Bringup launch
src/bumpy_bringup/launch/bringup.launch.py - Minimal launch
src/bumpy_bringup/launch/minimal.launch.py - Robot description
src/bumpy_description/launch/robot.launch.py - YDLidar driver
src/ydlidar_ros2_driver/src/ydlidar_ros2_driver_node.cpp
Control and sensing
- Encoder odometry
src/bumpy_firmware/bumpy_firmware/diff_tf.py - Motor control
src/bumpy_firmware/bumpy_firmware/motor_control.py - Tick publisher
src/bumpy_firmware/bumpy_firmware/tick_pub.py - Controller teleop
src/bumpy_firmware/bumpy_firmware/teleop.py - IMU node
src/bumpy_sensors/bumpy_sensors/imu.py - Camera node
src/bumpy_sensors/bumpy_sensors/camera.py - Camera transform
src/bumpy_sensors/bumpy_sensors/camera_tf_pub.py - Gas sensing
src/bumpy_sensors/bumpy_sensors/gas_sensor_node.py
Mapping and navigation
- slam_toolbox launch
src/bumpy_slam/launch/slam.launch.py - Cartographer launch
src/bumpy_slam/launch/cartographer.launch.py - Map saving
src/bumpy_slam/launch/save_map.launch.py - Nav2 launch
src/bumpy_navigation/launch/navigation.launch.py
Status and dashboard
- Web dashboard
src/bumpy_sensors/bumpy_sensors/web_server_node.py - OLED display
src/bumpy_sensors/bumpy_sensors/oled.py - Robot status
src/bumpy_sensors/bumpy_sensors/robot_status.py - Leader election
src/bumpy_sensors/bumpy_sensors/leader_ele.py
Multi-robot coordination
- Formation control
src/formation_control/formation_control/3robot.py - Formation obstacles
src/formation_control/formation_control/obstacle.py
Other components
- Robot operator
Connections 19
- Bringup launch → Robot description: starts description
README.md - Bringup launch → Motor control: starts control
README.md - Bringup launch → IMU node: starts sensors
README.md - Minimal launch → Robot description: includes launch
src/bumpy_bringup/launch/minimal.launch.py - Minimal launch → Motor control: includes launch
src/bumpy_bringup/launch/minimal.launch.py - Minimal launch → IMU node: starts node
src/bumpy_bringup/launch/minimal.launch.py - Tick publisher → Encoder odometry: encoder ticks
- Encoder odometry → Motor control: odometry feedback
- Controller teleop → Motor control: velocity commands
- YDLidar driver → slam_toolbox launch: scan input
- YDLidar driver → Cartographer launch: scan input
src/bumpy_slam/launch/cartographer.launch.py - slam_toolbox launch → Map saving: map output
- Cartographer launch → Map saving: map output
- Nav2 launch → Motor control: velocity commands
- Robot operator → Controller teleop: steers robot
README.md - Robot operator → Nav2 launch: sets navigation
- Web dashboard → Motor control: publishes commands
- Leader election → Formation control: coordinates robots
- Formation control → Formation obstacles: obstacle handling