An organization maintained by RoboLab (Universidad de Extremadura), Aston University, ISIS (Universidad de Málaga) and many other collaborators from the Google Summer of Code program.
RoboComp is an open-source Robotics framework providing the tools to create and modify software components that communicate through public interfaces. Components may require, subscribe, implement or publish interfaces in a seamless way. Building new components is done using two domain-specific languages, IDSL and CDSL. With IDSL you define an interface and with CDSL you specify how the component will communicate with the world. With this information, a code generator creates C++ and/or Python sources, based on CMake, that compile and execute flawlessly. When some of these features have to be changed, the component can be easily regenerated and all the user-specific code is preserved thanks to a simple inheritance mechanism.
If you already have RoboComp installed, jump to tutorials to start coding!
❓ If you have a question please look for it in the FAQ.
- RoboComp
- About
- Installation from source
- Testing the installation using the Coppelia Simulator
- Next steps
- Known issues
Table of contents generated with markdown-toc
Tested in Ubuntu 20.04 and 22.04 Note: RoboComp is not compatible with Ubuntu 16.04. RoboComp needs to be compiled using C++11. Ice libraries with C++11 support are only available for zeroc-ice 3.7 and the packages for this version are only available since Ubuntu 18.04. Note: RoboComp is not compatible with Ubuntu 18.04. RoboComp needs to be compiled using cmake >= 3.16. It's not available in Ubuntu 18.04.
Note: If you have installed Anaconda in your system. Then you need to change the python from anaconda to default.
Before you begin the installation, make sure you have the following prerequisites installed on your system:
- sudo apt update
- sudo apt install python3 python3-pip cmake vim git wget -y
- pip3 install vcstool colcon-common-extensions
- sudo apt install qtbase5-dev libqt5xmlpatterns5-dev libopenscenegraph-dev libgsl-dev
- sudo apt install qt6-base-dev
- pip install PySide2
- sudo apt install libbz2-dev libssl-dev
- pip install zeroc-ice
- sudo apt install zeroc-icebox zeroc-ice-all-dev libzeroc-icestorm3.7
- sudo apt install libeigen3-dev meld
- Create a directory for your RoboComp workspace and navigate to it:
- mkdir -p ~/robocomp_ws/src
- cd ~/robocomp_ws
- Download the robocomp.repos file:
- Configure environment variables:
- echo export ROBOCOMP=/home/robocomp/robocomp >> ~/.bashrc
- echo export PATH="$PATH:/home/usuario/.local/bin" >> ~/.bashrc
- source ~/.bashrc
- Import RoboComp packages:
- vcs import src < robocomp.repos
- Install RoboComp command-line tools:
- pushd . && cd src/robocomp/robocomp_tools/cli/ && pip install . && popd
- Create symbolic links:
- cd
- ln -s robocomp_sw/src/robocomp robocomp
- cd /home
- sudo ln -s usuario robocomp
- cd robocomp/robocomp
- ln -s robocomp_core/cmake cmake
- ln -s robocomp_core/classes classes
- ln -s robocomp_interfaces/interfaces interfaces
- ln -s robocomp_tools tools
- ln -r robocomp_cortex cortex
- mkdir components
- sudo ln -s /usr/include/eigen3/Eigen/ /usr/include/Eigen
-
Configure rcnode:
Edit the ~/robocomp/tools/rcnode/rcnode.sh file and change the line:
- /opt/robocomp/etc/rcnode.conf
to
- /home/robocomp/robocomp/tools/rcnode/rcnode.conf -
Add an alias for rcnode to your .bashrc:
- echo alias rcnode='bash /home/robocomp/robocomp/tools/rcnode/rcnode.sh&' >> ~/.bashrc
- source ~/.bashrc
If you are going to develop with Robocomp it's recommendable to install the following packages too:
sudo apt-get install yakuake qttools5-dev-tools qt5-assistant meld
and create this link for Eigen includes:
sudo ln -s /usr/include/eigen3/Eigen/ /usr/include/EigenDone! Now let's have some fun.
To test RoboComp with Coppelia you need to:
- Install Coppelia Robotics and Pyrep.
- Run the bridge, i.e. omniPyrep.py and see that Coppelia starts Ok.
- Connect your new component to the ports offered in omniPyrep.py or
- Connect a joystick or XBox pad to omniRep.py using this component
The software of the robots using RoboComp is composed of different components working together, communicating among them. What we just installed is just the core of RoboComp (the simulator, a component generator, and some libraries). To have other features like joystick control we have to run additional software components available from other repositories, for example, robocomp-robolab:
cd ~/robocomp/components
git clone https://github.com/robocomp/robocomp-robolab.git
The RoboLab's set of basic robotics components are now downloaded. You can see them in ~/robocomp/components/robocomp-robolab/components
If you have a joystick around, connect it to the USB port and:
cd ~/robocomp/components/robocomp-robolab/components/hardware/external_control/joystickComp
cmake .
make
cd bin
sudo addgroup your-user dialout // If you find permissions issues in Ubuntu
check the config file in the component's etc folder and make sure that the port matches the DifferentialRobot endpoint in RCIS.
bin/joystick etc/config
Your joystick should be now running. It will make the robot advance and turn at your will. If it does not work,
check where the joystick device file has been created (e.g., /dev/input/js0). If it is not /dev/input/js0, edit ~/robocomp/components/robocomp-robolab/components/hardware/external_control/joystickComp/etc/config change it accordingly and restart. Note that you might want to save the config file to the component's home directory so it does not interfere with future GitHub updates.
If you don't have a JoyStick install this component,
cd ~/robocomp/components/robocomp-robolab/components/hardware/external_control/keyboardrobotcontroller
cmake .
make
src/keyboardrobotcontroller.py etc/config
and use the arrow keys to navigate the robot, the space bar to stop it and 'q' to exit.
Note 1: You must have your simulator running in a terminal and only then you can run a component in another terminal. You will get an error message if you run the above component without having RCIS already running.
Note 2: If you have anaconda installed (for python 3), It is recommended to uninstall anaconda first and then install robocomp. (It is only applicable if you have faced errors while running above commands.)
We are now moving to more advanced robotics simulators that can reduce the gap between simulation and deployment. Our first choice now is CoppeliaSim because it offers a scene editor that can be used during a running simulation, you can "hang" and modify Lua code from the scene nodes in no time, you can choose among 4 physics engines and, thanks to the PyRep library, we have a fast access to almost everything running in the simulator.
Follow the instructions in https://github.com/robocomp/robocomp/blob/development/doc/robocomp-pyrep.md to install CoppeliaSim and PyRep
You can find more tutorials on RoboComp in tutorials
Please, report any bugs with the github issue system: Robocomp Issues
If you have any suggestions to improve the repository, like features or tutorials, please create a feature request here.
- Compatibility problem between pyparsing version and Robocomp tools:
- One of the main tools of Robocomp, robocompdsl is using pyparsing and the current code doesn't work with 2.4 version of this library. With the previous commands, we are installing the 2.2 version (python-pyparsing=2.2.0+dfsg1-2). If you have a more recent version of pyparsing installed with apt or pip we recommend you to uninstall it and install the 2.2 version. You can check your current version of pyparsing with this command:
python3 -c "import pyparsing; print(pyparsing.__version__)"- Ubuntu 18.04 and CMake > 3.16
- Robocomp is currently using the syntax for cmake 3.16. It's the default version in Ubuntu 20.04, but it's not available in Ubuntu 18.04.