How theshaboury/autonomous-warehouse-robot works
This repository is the ROS 2 runtime for a real-hardware warehouse AMR, with a separate simulation mode. The principal workflow is to launch the robot, accept joystick or Nav2 goals, estimate motion from wheel odometry and IMU, and execute motion through ros2_control and the Arduino serial link. Mapping and saved-map localization are separate operating modes; LiDAR feeds those modes directly. The README documents the overall integrations, while sampled code confirms the Arduino interface, serial messaging, and MPU6050 driver. Other launch/config subsystems are represented from the tree and README, not inspected in source.
Main entry points: arduino_system.cpp Arduino System Interface · twist_mux.yaml Velocity Arbitration · navigation_launch.py Nav2 Planning · launch_robot.launch.py Robot Launch
Components 18
Robot Bringup
- Robot Launch
src/warehouse_real_bringup/launch/launch_robot.launch.py - Velocity Arbitration
src/warehouse_real_description/config/twist_mux.yaml - Robot Model
src/warehouse_real_description/description/robot.urdf.xacro - ros2_control Config
src/warehouse_real_description/config/my_controllers.yaml
Robot Hardware
- Arduino System Interface
src/arduino_hardware_interface/src/arduino_system.cpp - Arduino Messaging
src/arduino_hardware_interface/include/arduino_hardware_interface/arduino_comms.hpp - Serial Library
src/serial
Sensing And State
- MPU6050 ROS Driver
src/mpu6050driver/src/mpu6050driver.cpp - MPU6050 I2C Sensor
src/mpu6050driver/src/mpu6050sensor.cpp - EKF Fusion
src/warehouse_real_nav/config/ekf.yaml
Mapping And Navigation
- SLAM Toolbox
src/warehouse_real_slam/launch/online_async_launch.py - Saved Maps
src/warehouse_real_slam/maps - AMCL Localization
src/warehouse_real_nav/launch/localization_launch.py - Nav2 Planning
src/warehouse_real_nav/launch/navigation_launch.py
Other components
- Joystick / Goal
- Arduino Controller
- Motors / Encoders
- RPLIDAR A1
Connections 23
- Joystick / Goal → Velocity Arbitration: sends teleop
README.md - Joystick / Goal → Nav2 Planning: sets goal
README.md - Robot Launch → Robot Model: loads model
README.md - Robot Launch → ros2_control Config: configures
README.md - Robot Launch → Velocity Arbitration: starts
README.md - Robot Model → Arduino System Interface: declares hardware
README.md - ros2_control Config → Arduino System Interface: uses interface
README.md - Arduino System Interface → Arduino Messaging: calls messaging
src/arduino_hardware_interface/src/arduino_system.cpp - Arduino Messaging → Serial Library: uses serial API
src/arduino_hardware_interface/include/arduino_hardware_interface/arduino_comms.hpp - Serial Library → Arduino Controller: transfers commands
README.md - Arduino Controller → Motors / Encoders: controls hardware
README.md - Motors / Encoders → Arduino System Interface: returns encoders
README.md - MPU6050 ROS Driver → MPU6050 I2C Sensor: reads sensor
src/mpu6050driver/src/mpu6050driver.cpp - MPU6050 I2C Sensor → EKF Fusion: publishes IMU data
README.md - Motors / Encoders → EKF Fusion: provides odometry
README.md - EKF Fusion → Nav2 Planning: provides estimate
README.md - RPLIDAR A1 → SLAM Toolbox: supplies scans
README.md - SLAM Toolbox → Saved Maps: creates maps
README.md - Saved Maps → AMCL Localization: provides saved map
README.md - RPLIDAR A1 → AMCL Localization: supplies scans
README.md - AMCL Localization → Nav2 Planning: provides localization
README.md - Nav2 Planning → Velocity Arbitration: commands motion
- Velocity Arbitration → Arduino System Interface: routes velocity