Page tree
Skip to end of metadata
Go to start of metadata

Install supported ROS distribution


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

Create workspace

Follow this link to create a workspace http://wiki.ros.org/catkin/Tutorials/create_a_workspace

Clone neo_simulation into your workspace


Attention

Make sure to select the correct branch!

cd your_catkin_workspace/src
git clone https://github.com/neobotix/neo_simulation.git

Build workspace


cd ..
catkin_make

Sourcing the workspace


echo "source your_catkin_workspace/devel/setup.bash" >> ~/.bashrc

Add path to custom gazebo models into .bashrc


echo "export GAZEBO_MODEL_PATH=/(Path to your workspace)/src/neo_simulation/models:$GAZEBO_MODEL_PATH" >> ~/.bashrc

Tip

You can download additional Gazebo Models from http://data.nvision2.eecs.yorku.ca/3DGEMS/

Add locale path into .bashrc


echo "export LC_NUMERIC="en_US.UTF-8" " >> ~/.bashrc

Additional step to melodic

Warning

To avoid  "Error [REST.cc:205] during startup gazebo" while starting ros-gazebo, do the following steps!

  1.  Open a terminal, go to the following directory

        cd ~/.ignition/fuel
  2.  Using gedit (or any text editor of your prefernce) open the config.yaml file
  3.  Change

          url: https://api.ignitionfuel.org

    To

          url: https://api.ignitionrobotics.org


Packages that need to be built from the source for all the distros

  1.  Dependencies for the kinematics node for MPO-700 and MPO-500

    cd to_your_workspace/src/ 
    git clone https://github.com/neobotix/neo_msgs.git
    git clone https://github.com/neobotix/neo_srvs.git
    git clone https://github.com/neobotix/neo_common.git
    cd ..
    catkin_make
  2. Kinematics node for MPO-700 and MMO-700

    cd to_your_workspace/src/ 
    git clone https://github.com/neobotix/neo_kinematics_omnidrive.git
    cd ..
    catkin_make
  3. Kinematics node for MPO-500 and MMO-500

    cd to_your_workspace/src/ 
    git clone https://github.com/neobotix/neo_kinematics_mecanum.git
    cd ..
    catkin_make
  4. Neo-localization

    cd to_your_workspace/src/ 
    git clone https://github.com/neobotix/neo_localization.git
    cd ..
    catkin_make


Install ROS-Packages for kinetic, melodic and noetic-distro

Warning

Some of the package might not be available yet for all the distributions. In that case, please go to the source repo and build it from the source, if the package is a must!

Tip

$ROS_DISTRO - allows to detect the ROS Distro automatically

  1. Control package (For MMO-700, MMO-500 and MM-400)

     sudo apt-get install ros-$ROS_DISTRO-ros-controllers
     sudo apt-get install ros-$ROS_DISTRO-gazebo-ros-control
  2. Navigation

     sudo apt-get install ros-$ROS_DISTRO-navigation
  3. Local Planner

    1. Neo_local_planner

      Warning

      Not yet available has binary for kinetic and noetic. Please build it from the source.

       sudo apt-get install ros-$ROS_DISTRO-neo-local-planner
    1. Eband local planner (optional)

       sudo apt-get install ros-$ROS_DISTRO-eband-local-planner
    2. TEB local planner (optional)

       sudo apt-get install ros-$ROS_DISTRO-teb-local-planner
    3. DWA local planner (optional)

       sudo apt-get install ros-$ROS_DISTRO-dwa-local-planner
  1. Localization
    1. Gmapping

       sudo apt-get install ros-$ROS_DISTRO-openslam-gmapping
    2. AMCL

       sudo apt-get install ros-$ROS_DISTRO-amcl
  2.  Teleoperation

    sudo apt-get install ros-$ROS_DISTRO-joy
    sudo apt-get install ros-$ROS_DISTRO-teleop-twist-keyboard
  3.  Other dependencies
    1.  tf2-sensor-msgs for neo_local_planner

      sudo apt-get install ros-$ROS_DISTRO-tf2-sensor-msgs
  • No labels