Repository Summary
Checkout URI | https://github.com/bmwcarit/meta-ros.git |
VCS Type | git |
VCS Version | master |
Last Updated | 2024-06-26 |
Dev Status | MAINTAINED |
CI status | No Continuous Integration |
Released | UNRELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (0)
Good First Issues (0) Pull Requests to Review (0) |
Packages
README
meta-ros
This is a series of OpenEmbedded layers designed to add support for the Robot Operating System (ROS) for embedded Linux releases by the Yocto Project.
It enables developers to create custom, Linux-based robotic systems, taking advantage of capabilities of ROS and the flexibility of the Yocto Project.
Supported Combinations
The following table shows the end-of-life dates for combinations of Yocto Releases and ROS Distros. Releases and distros not shown in the table above can be presumed unsupported.
Yocto Release | ROS1 Distros | ROS 2 Distros | ||
---|---|---|---|---|
(Rolling) | Noetic | Humble (LTS) | Iron | |
May 2025 | May 2027 | Nov 2024 | ||
Styhead (Dev) | (Future) | May 2025 | (Future) | Nov 2024 |
Scarthgap (LTS) | Apr 2028 | May 2025 | May 2027 | Nov 2024 |
Nanbield | ||||
Mickledore | Nov 2023 1 | |||
Langdale | ||||
Kirkstone (LTS) | Apr 2026 | Apr 2024 | Apr 2026 | Nov 2024 |
Support Levels
| Value | Definition |
| — | — |
| full | the configuration is fully supported |
| unsupported | the configuration is never built and only updated to fix breaking changes introduced upstream, eg [master] of a component’s repository being renamed to [main] or git:// needing to be replaced by https:// |
| 1 best-effort | the configuration has an EOL-ed ROS distro or OpenEmbedded release series, which means only a “best effort” will be made to have all its packages build |
| 2 contrib | the configuration has been contributed and is not built |
Getting Started
The easiest way to get started with ROS with OpenEmbedded is to build the combination of Kirkstone (Yocto Project) with Humble (ROS 2).
You may use the kas tool to clone the necessary git repositories and kick off the build.
Instructions can be found here: https://github.com/ros/meta-ros/tree/build/kas/README.md
Repository Layout
Branches
The master
branch follows the Yocto Project release series currently under
development.
The branches named after Yocto releases track updates during their support lifecycle. The commit history on these branches is linear.
The -next
branches contain commits that are pending being merged into their
corresponding unsuffixed branches. The commit history on these branches may
get rewritten as patches are tested and revised.
The build
branch contains the mcf tool which can be used for creating an
environment using the .mcf configuration files. These files may be found in the
files, files-contrib, and files-unsupported directories in the build
branch.
Tags
Information on past meta-ros milestone releases can be found on the meta-ros GitHub wiki: https://github.com/ros/meta-ros/wiki/Superflore-OE-Recipe-Generation-Scheme#milestones
The last official milestone was Milestone 17 on 2022-06-05.
Milestones provide updates for all supported combinations of OpenEmbedded
releases and ROS Distributions. They follow the format <BRANCH>/milestones/<N>
.
ROS Layers
The meta-ros-common
layer provides recipes that are common to all ROS
distributions. This typically includes 3rd party libraries and tools needed by
ROS as well as ROS-specific image and package group recipes.
The ROS distros each have their own sub-directory containing a layer inside each
branch. This contains bitbake configuration files that describe the ROS distro
including which packages from ROS may be built. The recipes generated by the
superflore tool may be found in the recipes-*
directories. When changes are
required against the generated recipes, the bbappend files are created in
recipes-bbappends
.
History
The original implementation of meta-ros
for ROS 1 Indigo Igloo
(https://github.com/bmwcarit/meta-ros) was transferred here on 2019-06-25.
The initial port of ROS 2 port was undertaken by Erle Robotics. Their work was
shared at this repository and
integrated upstream into meta-ros
.
It has been converted to use recipes generated by superflore. Please see this wiki page for details of what was done and the current development milestones.
The original implementation has been retained in the
legacy
branch.
Contributing
There are many ways to contribute back to meta-ros. This includes helping report build errors, writing documentation, adding support for ROS packages that are currently skipped, and adding build-time and run-time tests for ROS packages.
-
To find details of how
meta-ros
is being developed, you may find detailed information at the meta-ros wiki. -
To report a bug with
meta-ros
, we encourage you to file an issue. We also welcome pull requests. -
See CONTRIBUTING.md for additional information about ROS contribution policies.
Join the meta-ros Community
To join the conversation about meta-ros you may find us on the forum or at our bi-weekly working group meeting:
- OpenEmbedded category on the ROS Discourse forum
- ROS OpenEmbedded Working Group (minutes, meeting invites)
CONTRIBUTING
Any contribution that you make to this repository will be under the MIT License, unless explicitly stated otherwise.
Contributors must sign-off each commit by adding a Signed-off-by: ...
line to commit messages to certify that they have the right to submit
the code they are contributing to the project according to the
Developer Certificate of Origin (DCO).
Repository Summary
Checkout URI | https://github.com/bmwcarit/meta-ros.git |
VCS Type | git |
VCS Version | master |
Last Updated | 2024-06-26 |
Dev Status | MAINTAINED |
CI status | No Continuous Integration |
Released | UNRELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (0)
Good First Issues (0) Pull Requests to Review (0) |
Packages
README
meta-ros
This is a series of OpenEmbedded layers designed to add support for the Robot Operating System (ROS) for embedded Linux releases by the Yocto Project.
It enables developers to create custom, Linux-based robotic systems, taking advantage of capabilities of ROS and the flexibility of the Yocto Project.
Supported Combinations
The following table shows the end-of-life dates for combinations of Yocto Releases and ROS Distros. Releases and distros not shown in the table above can be presumed unsupported.
Yocto Release | ROS1 Distros | ROS 2 Distros | ||
---|---|---|---|---|
(Rolling) | Noetic | Humble (LTS) | Iron | |
May 2025 | May 2027 | Nov 2024 | ||
Styhead (Dev) | (Future) | May 2025 | (Future) | Nov 2024 |
Scarthgap (LTS) | Apr 2028 | May 2025 | May 2027 | Nov 2024 |
Nanbield | ||||
Mickledore | Nov 2023 1 | |||
Langdale | ||||
Kirkstone (LTS) | Apr 2026 | Apr 2024 | Apr 2026 | Nov 2024 |
Support Levels
| Value | Definition |
| — | — |
| full | the configuration is fully supported |
| unsupported | the configuration is never built and only updated to fix breaking changes introduced upstream, eg [master] of a component’s repository being renamed to [main] or git:// needing to be replaced by https:// |
| 1 best-effort | the configuration has an EOL-ed ROS distro or OpenEmbedded release series, which means only a “best effort” will be made to have all its packages build |
| 2 contrib | the configuration has been contributed and is not built |
Getting Started
The easiest way to get started with ROS with OpenEmbedded is to build the combination of Kirkstone (Yocto Project) with Humble (ROS 2).
You may use the kas tool to clone the necessary git repositories and kick off the build.
Instructions can be found here: https://github.com/ros/meta-ros/tree/build/kas/README.md
Repository Layout
Branches
The master
branch follows the Yocto Project release series currently under
development.
The branches named after Yocto releases track updates during their support lifecycle. The commit history on these branches is linear.
The -next
branches contain commits that are pending being merged into their
corresponding unsuffixed branches. The commit history on these branches may
get rewritten as patches are tested and revised.
The build
branch contains the mcf tool which can be used for creating an
environment using the .mcf configuration files. These files may be found in the
files, files-contrib, and files-unsupported directories in the build
branch.
Tags
Information on past meta-ros milestone releases can be found on the meta-ros GitHub wiki: https://github.com/ros/meta-ros/wiki/Superflore-OE-Recipe-Generation-Scheme#milestones
The last official milestone was Milestone 17 on 2022-06-05.
Milestones provide updates for all supported combinations of OpenEmbedded
releases and ROS Distributions. They follow the format <BRANCH>/milestones/<N>
.
ROS Layers
The meta-ros-common
layer provides recipes that are common to all ROS
distributions. This typically includes 3rd party libraries and tools needed by
ROS as well as ROS-specific image and package group recipes.
The ROS distros each have their own sub-directory containing a layer inside each
branch. This contains bitbake configuration files that describe the ROS distro
including which packages from ROS may be built. The recipes generated by the
superflore tool may be found in the recipes-*
directories. When changes are
required against the generated recipes, the bbappend files are created in
recipes-bbappends
.
History
The original implementation of meta-ros
for ROS 1 Indigo Igloo
(https://github.com/bmwcarit/meta-ros) was transferred here on 2019-06-25.
The initial port of ROS 2 port was undertaken by Erle Robotics. Their work was
shared at this repository and
integrated upstream into meta-ros
.
It has been converted to use recipes generated by superflore. Please see this wiki page for details of what was done and the current development milestones.
The original implementation has been retained in the
legacy
branch.
Contributing
There are many ways to contribute back to meta-ros. This includes helping report build errors, writing documentation, adding support for ROS packages that are currently skipped, and adding build-time and run-time tests for ROS packages.
-
To find details of how
meta-ros
is being developed, you may find detailed information at the meta-ros wiki. -
To report a bug with
meta-ros
, we encourage you to file an issue. We also welcome pull requests. -
See CONTRIBUTING.md for additional information about ROS contribution policies.
Join the meta-ros Community
To join the conversation about meta-ros you may find us on the forum or at our bi-weekly working group meeting:
- OpenEmbedded category on the ROS Discourse forum
- ROS OpenEmbedded Working Group (minutes, meeting invites)
CONTRIBUTING
Any contribution that you make to this repository will be under the MIT License, unless explicitly stated otherwise.
Contributors must sign-off each commit by adding a Signed-off-by: ...
line to commit messages to certify that they have the right to submit
the code they are contributing to the project according to the
Developer Certificate of Origin (DCO).