This project focuses on the development of a submersible UAV, using advanced technologies in robotics, automatic control and computer vision. Developed with ROS2 Humble, Gazebo Garden 7 and Rviz2, this project represents a pioneering effort in the simulation and operation of underwater autonomous vehicles.

The project is divided into several packages, each focused on a specific functionality:

• ROS2 Humble
• Rviz2 (Installed directly with ROS2 Humble)
• Gazebo Garden 7
• OpenCV

Follow these steps to install and configure the project:

1. Install ROS 2 Humble (Documentation: https://docs.ros.org/en/humble/Installation/Alternatives/Ubuntu-Development-Setup.html)

2. Install Gazebo Garden 7 (Documentation: https://gazebosim.org/docs/garden/install_ubuntu)

3. Install OpenCV (Documentation: https://docs.opencv.org/4.x/d7/d9f/tutorial_linux_install.html)

4. Install additional dependencies

   sudo apt-get install ros-humble-xacro
   sudo apt-get install libncurses5-dev libncursesw5-dev
   sudo apt-get install ros-humble-ros-gzgarden*
   

1. Create a workspace:

   mkdir ~/ros2_ws && cd ~/ros2_ws && mkdir src  
   

2. Clone the repository:

   cd src
   git clone https://github.com/iesusdavila/auv_max
   

3. Navigate to the project directory and run:

   colcon build
   

4. Set up the ROS environment:

   source /opt/ros/humble/setup.bash
   source install/setup.bash
   

• Execute commands so that Gazebo recognizes plugin and model: https://github.com/RAMEL-ESPOL/auv_max/blob/main/initial_run.bash
• To launch the simulation in Gazebo: ros2 launch auv_max_bringup max_sim.launch.py
• To activate GUI teleoperated control: ros2 run auv_max_teleoperation gui_teleop.py
• To activate teleoperated control: ros2 run auv_max_teleoperation auv_teleop_keyboard

If you are interested in contributing to this project, consider the following:

• Code Style: Follow the ROS2 and PEP8 conventions for Python.
• Tests: Ensure that all new code is accompanied by unit tests.
• Documentation: All new developments must be properly documented.

© 2023 AUV Max Project