Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
stylesquare

Install supported ROS-2 distribution

By clicking the image,  you can go to the installation procedure of the respective ROS distro.


Note
titleNote

Rolling distro, is specific for the developers and there are chances to find code that breaks your process. Using Rolling distro is encouraged, only if you are developing a package based on this simulation, else use other distros. 

Create workspace

ROS-2 does not use catkin for building the package unlike ROS-1, rather it uses ament_cmake as the default!

Follow this link to create a colcon workspace https://docs.ros.org/en/foxy/Tutorials/Colcon-Tutorial.html

Before continuing with this tutorial, make sure you have sourced your corresponding ROS-Distro

Automated workspace setup

  1. Download this file to your directory where you want to setup your workspace (usually the /home/$USER)

    Tip
    iconfalse
    titleSetup script for neo_simulation

    Download the setup script here: setup-2.sh


  2. Make the downloaded file as an executable using:

    Code Block
    languagebash
    themeRDark
    linenumberstrue
    chmod +x /setup-2.sh


  3. Just run the downloaded script from that particular directory to install all our packages:

    Code Block
    languagebash
    themeRDark
    linenumberstrue
    ./setup-2.sh


Manual workspace setup

Installing the package

There are two ways to do it

1. Clone neo_simulation2 into your workspace


Tip
titleTip

Please checkout to your $ROS_DISTRO branch – We provide support to all the currently active ROS2 distribution.


Code Block
languagebash
themeRDark
linenumberstrue
cd your_colcon_workspace/src
git clone https://github.com/neobotix/neo_simulation2.git
cd ..
colcon build --symlink-install


2. Install it as binaries


Code Block
languagebash
themeRDark
linenumberstrue
sudo apt-get install ros-$ROS_DISTRO-gazeboneo-rossimulation2


Sourcing the workspace


Code Block
languagebash
themeRDark
linenumberstrue
echo "source your_colcon_workspace/install/setup.bash" >> ~/.bashrc


Install the relevant ROS-2 Gazebo Packages


Code Block
languagebash
themeRDark
linenumberstrue
sudo apt-get install ros-$ROS_DISTRO-gazebo-ros ros-$ROS_DISTRO-gazebo-plugins ros-$ROS_DISTRO-gazebo-ros-pkgs


Install the ROS-2 Navigation Packages


Code Block
languagebash
themeRDark
linenumberstrue
sudo apt install ros-$ROS_DISTRO-navigation2 ros-$ROS_DISTRO-nav2-bringup


Clone the neo_local_planner and build it


Tip
titleTip

Please checkout to your $ROS_DISTRO branch – We provide support to all the currently active ROS2 distribution.


Code Block
languagebash
themeRDark
linenumberstrue
cd to_your_workspace/src
git clone https://github.com/neobotix/neo_local_planner2.git
cd ..
colcon build --symlink-install


Install the ROS-2 SLAM Toolbox


Code Block
languagebash
themeRDark
linenumberstrue
sudo apt install ros-foxy-slam-toolbox