README.md

This repository contains the building blocks for ROS related applications based on qbrobotics® devices. It is composed by all the device-independent structures to interface our devices with the ROS ecosystem, therefore is barely usable as is.

Please, refer to the following wikis respectively if you are dealing with a qbhand, a qbmove, or several qbrobotics® devices connected together:

• qbhand
• qbmove

Table of Contents

1. Usage
2. ROS Packages Overview
3. Support, Bugs and Contribution
4. Purchase

Usage

1. Clone the qb_device packages to your colcon Workspace, e.g. ~/catkin_ws:

   cd `~/catkin_ws/src`
   git clone --recurse-submodules https://bitbucket.org/qbrobotics/qbdevice-ros.git
   cd qbdevice-ros
   git checkout production-noetic
   git submodule update --init --recursive
   

2. Compile the packages using catkin:

   cd `~/catkin_ws`
   catkin build
   

   Note: depending on your ROS installation, you may need some extra packages to properly compile the code. You can install ROS dependencies using rosdep:

   cd `~/catkin_ws`
   rosdep install --from-paths src --ignore-src -r -y
   
   

Do not be worried if you have already followed the above installation instructions: simply proceed with your specific device installation and everything will be fine.

ROS Packages Overview

	Packages
qb_device:	qb_device_bringup, qb_device_control, qb_device_description, qb_device_driver, qb_device_hardware_interface, qb_device_msgs, qb_device_srvs, qb_device_utils

Support, Bugs and Contribution

Since we are not only focused on this project it might happen that you encounter some trouble once in a while. Maybe we have just forget to think about your specific use case or we have not seen a terrible bug inside our code. In such a case, we are really sorry for the inconvenience and we will provide any support you need.

To help you in the best way we can, we are asking you to do the most suitable of the following steps:

1. It is the first time you are holding a qbrobotics® device, or the first time you are using ROS, or even both: it is always a pleasure for us to solve your problems, but please consider first to read again the instructions above and the ROS tutorials. If you have ROS related questions the right place to ask is ROS Answers.
2. You are a beginner user stuck on something you completely don't know how to solve or you are experiencing unexpected behaviour: feel free to contact us at support+ros at qbrobotics.com, you will receive the specific support you need as fast as we can handle it.
3. You are quite an expert user, everything has always worked fine, but now you have founded something strange and you don't know how to fix it: we will be glad if you open an Issue in the package of interest on our Bitbucket.
4. You are definitely an expert user, you have found a bug in our code and you have also correct it: it will be amazing if you open a Pull Request in the package of interest on our Bitbucket; we will merge it as soon as possible.
5. You are comfortable with qbrobotics® products but you are wondering whether is possible to add some additional software features: feel free to open respectively an Issue or a Pull Request in the package of interest on our Bitbucket, according to whether it is just an idea or you have already provided your solution.

In any case, thank you for using qbrobotics® solutions.

Purchase

If you have just found out our company and you are interested in our products, come to visit us and feel free to ask for a quote.