{"id":29829071,"url":"https://github.com/nedap/meta-rauc","last_synced_at":"2026-02-10T01:02:05.297Z","repository":{"id":277817101,"uuid":"930937870","full_name":"nedap/meta-rauc","owner":"nedap","description":null,"archived":false,"fork":false,"pushed_at":"2025-11-03T14:38:22.000Z","size":278,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"scarthgap","last_synced_at":"2025-11-03T16:20:21.031Z","etag":null,"topics":["yocto"],"latest_commit_sha":null,"homepage":"https://github.com/rauc/meta-rauc.git","language":"BitBake","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nedap.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"COPYING.MIT","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-11T13:10:51.000Z","updated_at":"2025-11-03T14:38:26.000Z","dependencies_parsed_at":"2025-02-16T11:18:21.605Z","dependency_job_id":"03676add-9b1f-4c88-8ba1-322ddfaa870f","html_url":"https://github.com/nedap/meta-rauc","commit_stats":null,"previous_names":["nedap/meta-rauc"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/nedap/meta-rauc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nedap%2Fmeta-rauc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nedap%2Fmeta-rauc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nedap%2Fmeta-rauc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nedap%2Fmeta-rauc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nedap","download_url":"https://codeload.github.com/nedap/meta-rauc/tar.gz/refs/heads/scarthgap","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nedap%2Fmeta-rauc/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29287712,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-09T21:57:15.303Z","status":"ssl_error","status_checked_at":"2026-02-09T21:57:11.537Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["yocto"],"created_at":"2025-07-29T08:15:10.444Z","updated_at":"2026-02-10T01:02:05.266Z","avatar_url":"https://github.com/nedap.png","language":"BitBake","funding_links":[],"categories":[],"sub_categories":[],"readme":"|MIT| |gh_action| |Matrix|\n\nThe meta-rauc layer provides support for integrating the RAUC update tool\ninto your device.\n\nPlease see the corresponding sections below for more information.\nFor a detailed description on steps necessary to integrate RAUC into your\nproject, refer https://rauc.readthedocs.io/en/latest/integration.html.\n\n\nDependencies\n============\n\nThis layer depends on::\n\n  URI: https://github.com/openembedded/bitbake.git\n  branch: master\n\n  URI: https://github.com/openembedded/openembedded-core.git\n  layers: meta\n  branch: master\n\nFor rauc-hawkbit client::\n\n  URI: https://github.com/openembedded/meta-openembedded.git\n  layers: meta-python\n  branch: master\n\nFor fuse-support in casync (the default)::\n\n  URI: https://github.com/openembedded/meta-openembedded.git\n  layers: meta-filesystems\n  branch: master\n\nPatches\n=======\n\nPlease submit patches via GitHub pull request on https://github.com/rauc/meta-rauc\n\nMaintainer: Enrico Joerns \u003cejo@pengutronix.de\u003e\n\nMigration Notes\n===============\n\nSince **scarthgap**, the platform configuration (system.conf, keyring, etc.) was\nmoved to a separate ``rauc-conf.bb`` recipe to allow building the rauc package\nwith ``TUNE_PKGARCH`` and have a clearer separation between the binary and the\nconfiguration.\n\nThus when updating to scarthgap or newer, make sure to move all\nconfiguration-specific adaptions from your ``rauc_%.bbappend`` to a\n``rauc-conf.bbappend`` file.\n\n\nI. Adding the rauc Layer to Your Build\n======================================\n\nIn order to use this layer, you need to make the build system aware of\nit.\n\nAssuming the rauc layer exists at the top-level of your\nyocto build tree, you can add it to the build system by adding the\nlocation of the rauc layer to bblayers.conf, along with any\nother layers needed. e.g.::\n\n  BBLAYERS ?= \" \\\n    /path/to/yocto/meta \\\n    /path/to/yocto/meta-poky \\\n    /path/to/yocto/meta-yocto-bsp \\\n    /path/to/yocto/meta-rauc \\\n    \"\n\n\nII. Building and Using RAUC Host Tool\n=====================================\n\nIf you intend to build and use RAUC as a host tool from your BSP, e.g. for\ncalling ``rauc info`` on your built bundle, simply run::\n\n  bitbake rauc-native -caddto_recipe_sysroot\n  oe-run-native rauc-native rauc info --keyring=/path/to/keyring.pem tmp/deploy/images/\u003cmachine\u003e/\u003cbundle-name\u003e.raucb\n\nIf you need to execute the ``casync`` host tool manually, you can do this by running::\n\n  bitbake casync-native -caddto_recipe_sysroot\n  oe-run-native casync-native casync --help\n\nIII. Adding the RAUC Update Service to Your Device\n==================================================\n\nTo prepare your device for using RAUC as its update handler,\nyou have to follow at least the following steps:\n\n1. Add `rauc` to `DISTRO_FEATURES` in your distro (or local) config::\n\n     DISTRO_FEATURES += \"rauc\"\n\n2. Add a ``rauc-conf.bbappend`` in your device-specific (BSP) layer\n   that installs your RAUC system configuration file under\n   ``/etc/rauc/system.conf``. For information on how to write the RAUC\n   update file, please refer to the RAUC user documentation [1]_::\n\n     FILESEXTRAPATHS:prepend := \"${THISDIR}/files:\"\n\n3. Create a bundle recipe for your device by adding a recipe\n   that inherits the `bundle` class and adds all desired\n   configuration::\n\n     inherit bundle\n\n     RAUC_BUNDLE_SLOTS = \"rootfs\"\n     RAUC_SLOT_rootfs = \"my-rootfs-recipe\"\n\n     RAUC_KEY_FILE = \"path/to/development-1.key.pem\"\n     RAUC_CERT_FILE = \"path/to/development-1.cert.pem\"\n\n   For information on how to generate and use the key and certificate files,\n   please refer to the RAUC user documentation [1]_.\n\n   For a more detailed explanation on the required and available variables,\n   read the notes in the bundle.bbclass file.\n\n4. Build a bundle and the rootfs for your device::\n\n     bitbake my-bundle-recipe\n\nNote: If you do not use packagegroup-base, you als need to manually add\nthe `rauc` package to your systems image recipe::\n\n     IMAGE_INSTALL:append = \" rauc\"\n\n\nIV. Building The RAUC hawkBit Clients\n=====================================\n\nThis layer offers support for two clients that interface between RAUC and the\nhawkBit deployment server:\n\n* rauc-hawkbit (python implementation)\n* rauc-hawkbit-updater (C implementation)\n\nTo use ``rauc-hawkbit`` as a standalone service add to your systems image\nrecipe::\n\n    IMAGE_INSTALL:append = \" rauc-hawkbit-service\"\n\nTo use it as a python library in your demo application instead, simply add to\nyour recipe::\n\n    DEPENDS += \"rauc-hawkbit\"\n\nTo use ``rauc-hawkbit-updater`` in your system add to your image recipe::\n\n    IMAGE_INSTALL:append = \" rauc-hawkbit-updater\"\n\nV. Configure Custom Kernel\n==========================\n\nIn order to use RAUC on your system, the kernel must support SquashFS and loop\nmounts. For the standard yocto kernel, the meta-rauc layer provides a kernel\nconfiguration fragment that enables the config options required for this.\n\nIf you build your own kernel with a full custom ``defconfig`` file, you have to\nmake sure that the options in ``recipes-kernel/linux/linux-yocto/rauc.cfg`` are\nenabled in your configuration, too.\n\nVI. Build RAUC Development Version\n==================================\n\nBeside the standard release version recipes, the _git variants of RAUC recipes\nallow to build RAUC from a master branch revision that is newer than the latest\nrelease.\n\nThis is especially useful for early testing and adaption to upcoming features\nin RAUC.\n\nBy default, the _git recipes are disabled. To enable them, you can set::\n\n  RAUC_USE_DEVEL_VERSION = \"1\"\n\nin your local.conf. Note that this has the same effect as setting\n``DEFAULT_PREFERENCE = \"1\"`` for each recipe (target/native/nativesdk)\nindividually.\n\nVII. Contributing\n=================\n\nTo report bugs, file a new `issue \u003chttps://github.com/rauc/meta-rauc/issues\u003e`_\non GitHub.\n\nFor fixing bugs, bumping recipes or adding new features, open a `pull request\n\u003chttps://github.com/rauc/meta-rauc/pulls\u003e`_ on GitHub.\n\nAdd a ``Signed-off-by`` line to your commits according to the\n`Developer’s Certificate of Origin\n\u003chttps://github.com/rauc/meta-rauc/blob/master/DCO\u003e`_.\n\nBackporting\n-----------\n\nFor backporting changes to a stable or LTS branch, two options exist:\n\na) drop a backport request in the original pull request\nb) backport on your own and create a new pull request\n\nWhen doing backports on your own, make sure to include a cherry-pick note and\nthe original commit-ish in a line below the original Signed-off-by and add your\nown Signed-off-by below.\nWhen using git, this can be done automatically with::\n\n  git cherry-pick -xs \u003ccommit-ish\u003e\n\nNote that backports will be acccepted for actively maintained `poky releases\n\u003chttps://wiki.yoctoproject.org/wiki/Releases\u003e`_ only!\n\nVIII. References\n================\n\n.. [1] http://rauc.readthedocs.io/en/latest/\n\n\n.. |MIT| image:: https://img.shields.io/badge/license-MIT-blue.svg\n   :target: https://raw.githubusercontent.com/rauc/meta-rauc/master/COPYING.MIT\n.. |gh_action| image:: https://github.com/rauc/meta-rauc/workflows/meta-rauc%20CI/badge.svg\n   :target: https://github.com/rauc/meta-rauc/actions?query=workflow%3A%22meta-rauc+CI%22\n.. |Matrix| image:: https://img.shields.io/matrix/rauc:matrix.org?label=matrix%20chat\n   :target: https://app.element.io/#/room/#rauc:matrix.org\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnedap%2Fmeta-rauc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnedap%2Fmeta-rauc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnedap%2Fmeta-rauc/lists"}