Intallation

Installation instructions

The following section will explain the required steps to bring the project to work.

Initially this repository support ROS Kinetic and newer distributions.

Prerequisites

• ROS Kinetic: For obtaining and configuring ROS follow the installation instructions for full-desktop kinetic installation.
• Catkin workspace: If you don't have a workspace already configured follow this instructions to create one (it is recommended to create it in a directory where you have full access permissions).

Required Repositories

Clone this and the following repositories in your catkin workspace (some of the packages have installation instructions to follow):

Robot related dependencies

• Motoman packages - Kinetic Devel
• Motoman experimental - motoman_csda10f_support - Kinetic Devel (Only the motoman_csda10f_support package is required, after cloning delete all other packages of this repo).

Robotiq gripper related dependencies

• Danfoa/robotiq_2finger_grippers: Package containing all configuration and functionalities of the Robotiq 2 Finger grippers (both 85mm and 140mm ones).

Force/Torque sensing dependencies

• robotiq/robotiq_ft_sensor: Package allowing the connection to the FT300 Robotiq sensor (Download only this package from the robotiq meta-package)
• invite-robotics/force_sensor_utils: ROS package containing utility functions to process geometry_msgs/WrenchStamped messages.

IDS N35 cameras dependencies

• ensenso/ros_driver: Required only for the invite-vision package. (Delete it in case it wont be used)

Mysc

• ros-drivers/audio_common: ROS package containing functionalities for speech synthesize (sometimes our Robot likes to talk)

For most of this repositories installation through apt-get or synaptic is not possible

Dependencies

To automatically install any missing dependencies of your ROS installation run the following commands on your terminal:

#------------------------ Install third party dependencies
sudo apt-get update
# Move to root of workspace
cd [path_to_your_catkin_package]
# Install all dependencies of packages in workspace
rosdep install --from-paths src --ignore-src -r -y
# Build your workspace
catkin_make
source devel/setup.bash

Once the workspace build process is completed you are ready to start playing...have fun.

Install missing dependencies

If the catkin build fail, it occurs usually to missing package dependencies or missing third party (non-ros) packages. When this occurs the build log in the terminal indicates the name of the package dependency that it is missing, then try:

sudo apt-get update ros-kinetic-[package-name]
# separate the package name words with a '-'

If package is not found it is probably a third party dependency, google the name of the package and search for installation instructions :s.

Recommendations

IDE - Integrated Developing Environment

It is strongly recommended to use an IDE to edit and manage the Catkin workspace and all ROS related files, there are several IDS's available that work properly with ROS, you can select the one you want, but we recommend to use RoboWare Studio since it is an free and specifically design for ROS application development.

Nevertheless Visual Studio Code is perfect for developing in C++, Python, XML and other languages at the same time.

Note: You can use multiple IDS's