(!) Please ask about problems and questions regarding this tutorial on answers.ros.org. Don't forget to include in your question the link to this page, the versions of your OS & ROS, and also add appropriate tags.

Adding a Source Workspace

Description: Step-by-step instruction on how to download and run Volta and Volta_simulation smoothly

Keywords: Volta

Tutorial Level: BEGINNER

Configuring a non-standard peripheral requires a source workspace on the robot/ remote PC. The instructions below is the step-by-step instructions on how to download and run Volta and Volta_simulation smoothly.


  • Creating a workspace
    $ mkdir  -p  ~/volta_ws/src  
  • Open the ~/volta_ws/src file by running:
    $ cd  ~/volta_ws/src 
  • Git-clone the volta repositories:
    • For Physical Robot
      $ git clone https://github.com/botsync/volta.git
    • To use the melodic-devel repository:
      $ cd volta
      $ git checkout melodic-devel
      $ cd ..
    • For Simulation (the volta repository above is required for simulation):
      $ git clone https://github.com/botsync/volta_simulation.git  
    • To use the melodic-devel repository:
      $ cd volta_simulation
      $ git checkout melodic-devel
      $ cd ..
  • Ensure that necessary dependencies are properly installed:
    $ cd ~/volta_ws 
    $ rosdep install --from-paths src --ignore-src -r -y
  • Once done, catkin_make the packages
    $ catkin_make -j1
  • Reinitialize the environment so the operating system will be able to pick up the newly installed workspace:
    $ cd
    $ source /opt/ros/melodic/setup.bash
  • To overlay this workspace on top of your ROS environment:
    $ source ~/volta_ws/devel/setup.bash
  • You can also include the previous command into your .bashrc to be executed in every new terminal:
    $ echo "source ~/volta_ws/devel/setup.bash" >> ~/.bashrc

Wiki: Robots/Volta/Tutorials/Adding a Source Workspace (last edited 2021-07-16 09:40:11 by Botsync)