Sysbuild and Flash

Note

This section describes sysbuild for simple single image applications. For most users, the recommended approach is to use a single image unless your application requires advanced security through secure/nonsecure processing isolation. See SPE/NSPE Architecture and Advanced Build Options for details on secure and non-secure processing environments.

Overview

Zephyr’s Sysbuild (System build) is a higher-level build system that can be used to combine multiple other build systems together. (Refer to Zephyr Sysbuild for details)

This guide describes how to use sysbuild to build Atmosic multi-images with simplified commands for single image applications.

Atmosic test items in the sample.yaml file are named using the pattern <item_name_base>.atm, where <item_name_base> is the sample folder path relative to the repository root. For example, samples.sysbuild.hello_world.atm, as shown in the sysbuild sample.

Naming conventions:

  • Item names with .mcuboot indicate MCUboot support and require @mcuboot in the board specification.

  • Item names without .mcuboot are non-MCUboot builds that can be used with single image or SPE/NSPE system.

Attention

In previous Openair releases, the application build variants in the application .yaml file defaults to a SPE/NSPE application using the sysbuild option SB_CONFIG_SPE=y in the extra_args property. To build the application as a single image this extra argument can be removed. Most applications have been updated to default to a single image variant and have removed the use of SB_CONFIG_SPE.

Refer to the sysbuild sample for usage details.

Building with Sysbuild

Use the west build command with different board specifications depending on whether MCUboot is used:

For non-MCUboot builds:

west build -p always -b <BOARD> <APP> --sysbuild -T <test_item>

For MCUboot builds:

west build -p always -b <BOARD>@mcuboot <APP> --sysbuild -T <test_item>

Where:

  • BOARD: Atmosic device. See board.

  • APP: Sample folder path relative to the Zephyr project root.

  • test_item: Test item defined in sample.yaml, e.g., samples.sysbuild.hello_world.atm, samples.sysbuild.hello_world.atm.mcuboot.

Board Specification Patterns:

  • Non-MCUboot: Use <BOARD> format (e.g., ATMEVK-3430e-WQN-2)

  • MCUboot: Use <BOARD>@mcuboot format (e.g., ATMEVK-3430e-WQN-2@mcuboot)

The @mcuboot qualifier tells the build system to use MCUboot-specific board configurations and partitioning schemes.

Examples:

Non-MCUboot build:

west build -p always -b ATMEVK-3430e-WQN-2 openair/samples/sysbuild/hello_world --sysbuild -T samples.sysbuild.hello_world.atm

MCUboot build:

west build -p always -b ATMEVK-3430e-WQN-2@mcuboot openair/samples/sysbuild/hello_world --sysbuild -T samples.sysbuild.hello_world.atm.mcuboot

Flashing with Sysbuild

To Flash the built images:

west flash --skip-rebuild --verify --device <DEVICE_ID> [--jlink] [--dl] --fast_load [--erase_flash]

Where:

  • DEVICE_ID: Serial number of the interface device. See serial.

  • --jlink: Add this option if using a J-Link interface. If omitted, FTDI interface is assumed.

  • --dl: Add this option if using a Download Board (DL) interface.

  • --erase_flash: used to erase the entire RRAM and flash of the EVK before programming. If omitted, to do programming only

To flash a single image only:

west flash --domain <image_name> --skip-rebuild --verify --device <DEVICE_ID> [--jlink] [--dl] --fast_load [--erase_flash]

Where:

  • image_name: Image domain name, e.g., hci_uart, spe, or mcuboot.

  • DEVICE_ID: Serial number of the interface device. See serial.

  • --jlink: Add this option if using a J-Link interface. If omitted, FTDI interface is assumed.

  • --dl: Add this option if using a Download Board (DL) interface.

  • --erase_flash: used to erase the entire RRAM and flash of the EVK before programming. If omitted, to do programming only

Note

  • The default build directory is the build folder under the current directory.

  • If you specify a custom -d build_dir with west build, you must also specify the same build_dir with west flash.

Subpages