How muhammadelbialy/gp_2026_autonomous_robot works
This repository is a ROS 2 differential-drive robot stack, with ESP32 firmware and ROS packages for odometry, IMU data, robot description, sensor bringup, and SLAM. The principal workflow is to read serial encoder/IMU data, compute and publish odometry, then compose odometry, lidar, and SLAM processes for mapping; robot-description tooling supports visualization. The README documents encoder odometry and IMU integration, while launch files expose lidar and SLAM. Some topic-level connections and firmware protocol details are not shown, so those links are omitted or marked unverified.
Main entry points: slam.launch.py SLAM launch · full_system.launch.py Full system launch · encoder_odom_node.cpp Encoder odometry · odom_bringup.launch.py Odometry launch
Components 16
Robot hardware
- ESP32 firmware
firmware
Motion estimation
- Encoder odometry
src/encoder_odometry/src/encoder_odom_node.cpp - Odometry and TF
src/encoder_odometry/src/encoder_odom_node.cpp - Standalone IMU node
src/imu_pkg/src/imu_node.cpp - EKF filter
src/encoder_odometry/config/ekf.yaml
Sensors and mapping
- Lidar driver
src/robot_bringup/launch/lidar.launch.py - SLAM toolbox
src/robot_bringup/launch/slam.launch.py - SLAM parameters
src/robot_bringup/config/slam_params.yaml
Robot runtime
- Robot description
src/my_robot_description/urdf/final2.xml - Model visualization
src/my_robot_description/launch/view_robot.launch.py - Odometry launch
src/robot_bringup/launch/odom_bringup.launch.py - Full system launch
src/robot_bringup/launch/full_system.launch.py - SLAM launch
src/robot_bringup/launch/slam.launch.py - IMU launch
src/imu_pkg/launch/imu.launch.py - RViz
src/encoder_odometry/rviz/odom_config.rviz
Other components
- Operator
Connections 21
- Operator → Odometry launch: starts
src/robot_bringup/launch/odom_bringup.launch.py - Operator → Full system launch: starts
src/robot_bringup/launch/full_system.launch.py - Operator → SLAM launch: starts
src/robot_bringup/launch/slam.launch.py - Operator → IMU launch: starts
src/imu_pkg/launch/imu.launch.py - ESP32 firmware → Encoder odometry: serial data
- Encoder odometry → Odometry and TF: publishes
src/encoder_odometry/src/encoder_odom_node.cpp - Encoder odometry → Standalone IMU node: publishes
src/encoder_odometry/src/encoder_odom_node.cpp - Full system launch → Encoder odometry: launches
src/robot_bringup/launch/full_system.launch.py - Full system launch → EKF filter: configures
src/robot_bringup/launch/full_system.launch.py - Full system launch → RViz: launches
src/robot_bringup/launch/full_system.launch.py - Odometry launch → Encoder odometry: launches
src/robot_bringup/launch/odom_bringup.launch.py - Odometry launch → RViz: launches
src/robot_bringup/launch/odom_bringup.launch.py - IMU launch → Standalone IMU node: launches
src/imu_pkg/launch/imu.launch.py - SLAM launch → Full system launch: includes
src/robot_bringup/launch/slam.launch.py - SLAM launch → Lidar driver: includes
src/robot_bringup/launch/slam.launch.py - SLAM launch → SLAM toolbox: launches
src/robot_bringup/launch/slam.launch.py - SLAM launch → SLAM parameters: configures
src/robot_bringup/launch/slam.launch.py - Odometry and TF → EKF filter: feeds
- Lidar driver → SLAM toolbox: scan input
- Operator → Model visualization: starts
src/my_robot_description/launch/view_robot.launch.py - Model visualization → Robot description: loads
src/my_robot_description/launch/view_robot.launch.py