Ackermann Steering Vehicle Simulation in ROS2 with Gazebo Sim Harmonic

This project features the simulation of a custom vehicle with Ackermann steering capabilities, developed using ROS2 and the Gazebo Sim Harmonic environment. The model integrates a variety of sensors and navigation tools for autonomous operation, making it one of the first implementations of an Ackermann steering vehicle in this simulation framework.

Table of Contents

• Ackermann Steering Vehicle Simulation in ROS2 with Gazebo Sim Harmonic
• Features
  • 1 Ackermann Steering
  • 2 ROS2 Communication
  • 3 Sensors
  • 4 Navigation
  • 5 Manual Control with external joystick
  • 6 Visualization
• Requirements
• Local Installation
• Docker Installation
• Usage
  • 1 Basic Simulation and Manual Control
  • 2 SLAM Simultaneous Localization and Mapping
  • 3 Navigation with Nav2
• Future Work
• Gallery
• TF Tree
• Star History

If you like this project, consider giving it a ⭐ to show your support!

Features

1. Ackermann Steering

• A custom vehicle model built with realistic Ackermann steering dynamics for accurate maneuverability.

2. ROS2 Communication

• All sensor data and control signals are fully integrated into the ROS2 ecosystem for seamless interoperability.

3. Sensors

• IMU: Provides orientation and angular velocity.
• Odometry: Ensures accurate vehicle state feedback.
• LiDAR: Mounted for obstacle detection and environmental scanning.
• Cameras:
  • Front-facing
  • Rear-facing
  • Left-side
  • Right-side

    Note: By default, only the front camera is bridged to ROS 2.If you want to use all cameras (left, right, rear) in ROS 2,remove the # at the beginning of the relevant camera sections in saye_bringup/config/ros_gz_bridge.yaml to activate them (e.g., /camera/left_raw, /camera/right_raw, /camera/rear_raw).

4. Navigation

• Integrated with the Nav2 stack for autonomous navigation.
• AMCL (Adaptive Monte Carlo Localization) for improved positional accuracy.
• SLAM techniques implemented for real-time mapping and understanding of the environment.
• Fine-tuned parameters for optimized navigation performance.

5. Manual Control (with external joystick)

• Added support for joystick-based manual control in the simulation environment, enabling users to test vehicle movement interactively.

6. Visualization

• Full model and sensor data visualization in RViz2, providing insights into robot states and environmental feedback.

Requirements

• ROS2 (Humble)
• Gazebo Sim Harmonic
• RViz2
• Nav2

Local Installation

1. Your need to sure that installation of Gazebo Harmonic and ROS (ros_gz):
   sudo apt-get install ros-${ROS_DISTRO}-ros-gz
sudo apt-get install ros-humble-ros-gzharmonic (Only Humble version)
   More details about installation Gazebo and ROS: Link
2. Clone the repository:
   mkdir -p ackermann_sim/src && cd ackermann_sim/src
git clone https://github.com/alitekes1/ackermann-vehicle-gzsim-ros2
cd ..
3. Build the project: colcon build && source install/setup.bash
4. Set environment variables:

   # Set environment variables for current session
   export GZ_SIM_RESOURCE_PATH=$GZ_SIM_RESOURCE_PATH:/your/path/ackermann_sim/src/ackermann-vehicle-gzsim-ros2/
   export ROS_PACKAGE_PATH=$ROS_PACKAGE_PATH:/your/path/ackermann_sim/src/ackermann-vehicle-gzsim-ros2/
   

For Permanent Setup:

To make these environment variables permanent, add them to your .bashrc file:

   # Add environment variables to .bashrc
   echo 'export GZ_SIM_RESOURCE_PATH=$GZ_SIM_RESOURCE_PATH:/your/path/ackermann_sim/src/ackermann-vehicle-gzsim-ros2/' >> ~/.bashrc
   echo 'export ROS_PACKAGE_PATH=$ROS_PACKAGE_PATH:/your/path/ackermann_sim/src/ackermann-vehicle-gzsim-ros2/' >> ~/.bashrc
   
   # Apply changes
   source ~/.bashrc
   

File truncated at 100 lines see the full file