Diffbot ROS Packages
The following describes the easiest way to make use of diffbot's ROS packages inside the ros-mobile-robots/diffbot repository.
The following steps will be performed on both, the workstation/development PC and the single board computer (SBC).
Git: clone diffbot repository
Obtain (system) Dependencies
diffbot repository relies on two sorts of dependencies:
- Source (non binary) dependencies from other (git) repositories.
- System dependencies available in the (ROS) Ubuntu package repositories. Also refered to as pre built binaries.
Let's first obtain source dependencies from other repositories.
To do this the recommended tool to use is
(see also https://github.com/dirk-thomas/vcstool for additional documentation and examples.).
Inside the cloned
make use of the
import command and the
diffbot.repos file containing the required source repositories:
This will clone all repositories which are stored in the
diffbot.repos that get passed in via stdin in YAML format.
diffbot.repos contains relative paths and will clone the listed repositories in the parent folder from where
vcs import command is called. When it is called from inside the
diffbot repository, which should be located
src folder of a catkin workspace, then the other repositories are also cloned in the
For the SBC not all dependencies in
diffbot.repos are needed.
diffbot_robot.repos is here to clone the
Now that additional packages are inside the catkin workspace it is time to install the system dependencies.
All the needed ROS system dependencies which are required by diffbot's packages can be installed using
rosdep command, which was installed during the ROS setup.
To install all system dependencies use the following command:
On the following packages pages it is explained that the dependencies of a ROS package are defined inside its
After the installation of all dependencies finished (which can take a while), it is time to build the catkin workspace.
Inside the workspace use
catkin-tools to build the packages inside the
The first time you run the following command, make sure to execute it inside your catkin workspace and not the
Now source the catkin workspace either using the created alias or the full command for the bash shell:
Now you are ready to follow the examples listed in the readme.
TODO extend documentation with examples