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.

Instructions:

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
```

ROS 2 Documentation

Wiki

Page

User

Adding a Source Workspace