meta-ros/README

106 lines
3.8 KiB
Plaintext

This is a layer to provide ROS Groovy Galapagos in an OpenEmbedded Linux system.
Currently, this layer is still under development and only provides
cross-compilation of the basic ros-comm packages.
MAINTAINER
Lukas Bulwahn, BMW Car IT GmbH <lukas.bulwahn@oss.bmw-carit.de>
Stefan Herbrechtsmeier, Bielefeld University <stefan@herbrechtsmeier.net>
CONTRIBUTORS
Lukas Bulwahn, BMW Car IT GmbH <lukas.bulwahn@oss.bmw-carit.de>
Stefan Herbrechtsmeier, Bielefeld University <stefan@herbrechtsmeier.net>
Tobias Weigl, BMW Car IT GmbH <tobias.weigl@bmw-carit.de>
Kartik Mohta <kartikmohta@gmail.com>
Koen Kooi <koen@dominion.thruhere.net>
Victor Mayoral Vilches <v.mayoralv@gmail.com>
HOW TO CONTRIBUTE
We are still working on this development and are interested in other use cases.
If you are interested in this project, please contact us via email.
The more people are interested, the more we will be pushing this project.
If you want to contribute, please contact us and we can discuss open issues
and how to join forces.
DEPENDENCIES
This layer depends on:
URI: git://git.openembedded.org/openembedded-core
branch: master
revision: HEAD
URI: git://git.openembedded.org/meta-openembedded
layers: meta-oe
branch: master
revision: HEAD
INSTALLATION
The repository contains a layer for ROS that builds on top of the
OpenEmbedded Core layer and the meta-oe layer.
We believe it should work with the current HEAD of the layers mentioned above.
As a further reference, here are the version I currently work with:
* commit 395b90054eccddc1c9062a9a8657ed4482b7710a of https://github.com/openembedded/oe-core
* commit 2a5dea2399e2be5e5d964eda7465dcaf4c2e152b of https://github.com/openembedded/meta-oe
* commit 324ed96e28ec31cff8cef1824d20d40f9a5d46ad of git://git.openembedded.org/bitbake in the bitbake directory
USAGE
Currently, you can cross-compile the ROS packages with the commands:
source oe-init-build-env
bitbake <package-name>
Look at the meta-ros test reports for the description of the current state.
The recipe core-image-ros-groovy-qemux86-running-roscore provides a minimal
Linux system that runs roscore on the qemu x86 virtual machine.
You can compile the minimal Linux system with
bitbake core-image-ros-groovy-qemux86-running-roscore
Then, you start this system with
runqemu qemux86 core-image-ros-groovy-qemux86-running-roscore
In the qemu shell, set up the environment with
export ROS_ROOT=/usr
export ROS_MASTER_URI=http://localhost:11311
export CMAKE_PREFIX_PATH=/usr
touch /usr/.catkin
Finally, you can start roscore with
roscore
LICENSE
All metadata is MIT licensed unless otherwise stated. Source code included
in tree for individual recipes is under the LICENSE stated in each recipe
(.bb file) unless otherwise stated.
The descriptions in the recipes of ROS packages have been extracted from
the ROS wiki (http://www.ros.org/wiki/) and are licensed under
Creative Commons Attribution 3.0 (http://creativecommons.org/licenses/by/3.0/)
unless otherwise noted.
This README document is Copyright (C) 2012 BMW Car IT GmbH.
REDISTRIBUTIONS
The log4cxx recipe originated from the recipe in the OpenEmbedded (Classic) Development
(cf. http://cgit.openembedded.org/openembedded/tree/recipes/log4cxx)
licensed with the MIT License.
The eigen recipe originated from the recipe in Kartik Mohta's OpenEmbedded layer
(cf. https://github.com/kartikmohta/meta-km/tree/master/recipes-extended/eigen)
licensed with the MIT License.
The core-image-ros-* recipes originated from the core-image-minimal recipe in OpenEmbedded Core
(cf. http://cgit.openembedded.org/openembedded-core/tree/meta/recipes-core/images/core-image-minimal.bb)
licensed with the MIT License.
The original or modified files are redistributed here under the same MIT License.