Skip to main content
Version: Next

Yocto Integration

We provide open-source Yocto layers for integrating Rugix Ctrl into a custom, Yocto-based Linux distribution tailored to your embedded device. The yocto layers are available here.

Installing Rugix Ctrl​

The meta-rugix-core layer provides the rugix-ctrl recipes for installing Rugix Ctrl.

Bootstrapping Configuration​

The meta-rugix-core layer provides the rugix-bootstrapping-conf recipe for installing a custom bootstrapping.toml configuration file. You can extend this recipe to replace the default bootstrapping configuration.

Building Update Bundles​

The meta-rugix-core layer provides the rugix-bundle class for building Rugix update bundles. The class assumes that you build partitioned images using WIC and allows you to include individual partitions as update payloads.

Here's an example for a typical A/B setup with redundant boot and system partitions:

update-bundle-minimal.bb
inherit rugix-bundle

RUGIX_BUNDLE_PAYLOADS = "boot system"

RUGIX_PAYLOAD_boot[image] = "core-image-minimal"
RUGIX_PAYLOAD_boot[partition] = "2"

RUGIX_PAYLOAD_system[image] = "core-image-minimal"
RUGIX_PAYLOAD_system[partition] = "4"

The RUGIX_BUNDLE_PAYLOADS variable contains a space-separated list of update payloads. Each payload is then configured through a corresponding RUGIX_PAYLOAD_ variable with the following flags:

  • image (required): Image to take the partition from.
  • partition (required): Image partition to include as the payload.
  • slot (optional): Update slot for the payload (defaults to payload name).
note

In the future, we will extend the class to support additional payload types.

Note that this recipe doesn't produce signed bundles. You can sign bundles after the build process directly using Rugix Bundler.

Raspberry Pi​

The meta-rugix-rpi-tryboot layer provides support for building Raspberry Pi images with tryboot support. For an example, take a look at the raspberrypi.yaml example kas configuration.