Linux — Buildroot

The buildroot-otapulse package builds the OTA-Pulse agent into your Buildroot image, alongside the systemd unit, the A/B partition layout and your signing public key. If you build with Yocto instead, see Linux — Yocto.

Prerequisites

• Buildroot 2023.02 or newer
• systemd as the init system (BR2_INIT_SYSTEMD)
• A board with dual A/B root partitions plus a persistent data partition
• Your artifact signing public key

Integration

1. Add the external package.

   Point BR2_EXTERNAL at the buildroot-otapulse tree and enable the package in menuconfig under Target packages.

2. Configure the server and tenant token.

   Set your server URL and tenant token in the package configuration. They are written into /etc/otapulse/otapulse.conf in the built image.

3. Install your signing public key.

   The public key is baked into the read-only root filesystem at build time. The private key never touches the device.

4. Lay out A/B partitions.

   Your genimage configuration needs two root filesystem partitions of equal size plus a persistent data partition that survives updates.

5. Build and flash.

   Build the image as usual and flash it. On first boot the agent registers itself with the server and appears in the console.

Note

The agent binary, config path, data directory and service name are identical across Yocto, Buildroot and manual installs — see Install the agent for the file-path reference.