RAUC Bootmeth

This bootmeth provides a way to locate and run an A/B system with RAUC as its update client. The booted distro must supply a script on an MMC device containing the final boot instructions necessary.

This bootmeth assumes a symmetric A/B partition layout, with a separate boot partition containing the kernel image and another partition for the root filesystem each. The partition numbers must be specified with CONFIG_BOOTMETH_RAUC_PARTITIONS. The content must be a list of pairs, with the following syntax: 1,2 3,4, where 1 and 3 are the slots’ boot partition and 2 and 4 the slots’ root partition.

Each pair of boot and rootfs partition form a “slot”. The default order in which available slots are tried is set through CONFIG_BOOTMETH_RAUC_BOOT_ORDER, with the left one tried first.

The default number of boot tries of each slot is set by CONFIG_BOOTMETH_RAUC_DEFAULT_TRIES.

In case no valid slot can be found and/or all slots have zero tries left, the boot order and slot tries are reset to their default values, if CONFIG_BOOTMETH_RAUC_RESET_ALL_ZERO_TRIES is enabled. This prevents a system from locking up in the bootloader and tries booting again after a specified number of tries.

The boot script must be located in each boot partition. The bootmeth searches for “boot.scr.uimg” first, then “boot.scr” if not found.

When the bootflow is booted, the bootmeth sets these environment variables:

devtype

device type (e.g. “mmc”)

devnum

device number, corresponding to the device ‘sequence’ number dev_seq(dev)

distro_bootpart

partition number of the boot partition on the device (numbered from 1)

distro_rootpart

partition number of the rootfs partition on the device (numbered from 1)

raucargs

kernel command line arguments needed for RAUC to detect the currently booted slot

The script file must be a FIT or a legacy uImage. It is loaded into memory and executed.

The compatible string “u-boot,distro-rauc” is used for the driver. It is present if CONFIG_BOOTMETH_RAUC is enabled.