Adding a sysbuild example

README.md

@@ -54,6 +54,25 @@ Before getting started, make sure you have a proper Zephyr development
 environment. Follow the official
 [Zephyr Getting Started Guide](https://docs.zephyrproject.org/latest/getting_started/index.html).
 
+
+### Python VENV
+
+To get started its recommended to initialize a virtual-environment for python.
+
+```
+mkdir -p my-workspace
+cd my-workspace
+python -m venv .venv
+source .venv/bin/activate   # note. activate.{fish,csh} etc for other shells!
+```
+
+From there you can install west and all the required python dependencies for zephyr's build system
+without touching your system's python installation.
+
+```
+pip install west
+```
+
 ### Initialization
 
 The first step is to initialize the workspace folder (``my-workspace``) where
@@ -68,6 +87,12 @@ cd my-workspace
 west update
 ```
 
+Before building, ensure all required python packages are installed
+
+```
+west packages pip --install
+```
+
 ### Building and running
 
 To build the application, run the following command:

app/boards/nucleo_f413zh.overlay

@@ -0,0 +1,33 @@
+/*
+ * Copyright (c) 2021 Nordic Semiconductor ASA
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/* This devicetree overlay file will be automatically picked by the Zephyr
+ * build system when building the sample for the nucleo_f413zh board. It shows
+ * how the example-application can be built on sample boards already provided
+ * by Zephyr.
+ */
+
+/ {
+	example_sensor: example-sensor {
+		compatible = "zephyr,example-sensor";
+		input-gpios = <&gpioc 13 (GPIO_ACTIVE_HIGH)>;
+	};
+
+	blink_led: blink-led {
+		compatible = "blink-gpio-led";
+		led-gpios = <&gpiob 0 GPIO_ACTIVE_HIGH>;
+		blink-period-ms = <1000>;
+	};
+};
+
+&gpioc {
+	status = "okay";
+};
+
+&gpiob {
+  status = "okay";
+};
+
+

sysbuild-example/CMakeLists.txt

@@ -0,0 +1,12 @@
+# SPDX-License-Identifier: Apache-2.0
+# Author: James Walmsley <james@fullfat-fs.co.uk>
+
+cmake_minimum_required(VERSION 3.20.0)
+
+find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})
+test_sysbuild()
+
+project(hello_world)
+
+target_sources(app PRIVATE mfg_image/src/main.c)
+

sysbuild-example/README.md

@@ -0,0 +1,11 @@
+# Example Sysbuild Project
+
+The aim of this folder is to demonstrate a typical sysbuild project from the ground-up.
+
+## Build
+
+```
+cd my-workspace/example-application
+west build --sysbuild sysbuild
+```
+

sysbuild-example/dfu_app/CMakeLists.txt

@@ -0,0 +1,9 @@
+# Copyright (c) 2025 James Walmsley <james@fullfat-fs.co.uk>
+# SPDX-License-Identifier: Apache-2.0
+
+cmake_minimum_required(VERSION 3.20.0)
+find_package(Zephyr REQUIRED HINTS $ENV{ZPEHYR_BASE})
+
+project(dfu_app)
+target_sources(app PRIVATE src/main.c)
+

sysbuild-example/dfu_app/prj.conf

@@ -0,0 +1,9 @@
+CONFIG_BOOTLOADER_MCUBOOT=y
+CONFIG_MCUBOOT_SIGNATURE_KEY_FILE="bootloader/mcuboot/root-rsa-2048.pem"
+CONFIG_FLASH=y
+CONFIG_IMG_MANAGER=y
+CONFIG_STREAM_FLASH=y
+CONFIG_USB_DFU_CLASS=y
+CONFIG_USB_DEVICE_STACK=y
+CONFIG_FLASH_MAP=y
+

sysbuild-example/dfu_app/src/main.c

@@ -0,0 +1,15 @@
+/*
+ * Copyright (c) 2025 James Walmsley
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <zephyr/sys/printk.h>
+
+int main(void)
+{
+	printk("Hello world from %s\n", CONFIG_BOARD_TARGET);
+
+	return 0;
+}
+
+

sysbuild-example/mfg_image/CMakeLists.txt

@@ -0,0 +1,9 @@
+# Copyright (c) 2025 James Walmsley <james@fullfat-fs.co.uk>
+# SPDX-License-Identifier: Apache-2.0
+
+cmake_minimum_required(VERSION 3.20.0)
+find_package(Zephyr REQUIRED HINTS $ENV{ZPEHYR_BASE})
+
+project(mfg_image)
+target_sources(app PRIVATE src/main.c)
+

sysbuild-example/mfg_image/prj.conf

@@ -0,0 +1 @@
+CONFIG_BOOTLOADER_MCUBOOT=y

sysbuild-example/mfg_image/src/main.c

@@ -0,0 +1,14 @@
+/*
+ * Copyright (c) 2025 James Walmsley
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <zephyr/sys/printk.h>
+
+int main(void)
+{
+	printk("Manufacturing image on: %s\n", CONFIG_BOARD_TARGET);
+
+	return 0;
+}
+

sysbuild-example/sysbuild.cmake

@@ -0,0 +1,15 @@
+# Copyright (c) 2025 James Walmsley <james@fullfat-fs.co.uk>
+# SPDX-License-Identifier: Apache-2.0
+
+ExternalZephyrProject_Add(
+    APPLICATION mfg_image
+    SOURCE_DIR ${APP_DIR}/mfg_image
+)
+
+ExternalZephyrProject_Add(
+    APPLICATION dfu_app
+    SOURCE_DIR ${APP_DIR}/dfu_app
+)
+
+add_dependencies(${DEFAULT_IMAGE} mfg_image)
+add_dependencies(${DEFAULT_IMAGE} dfu_app)

sysbuild-example/sysbuild.conf

@@ -0,0 +1 @@
+SB_CONFIG_BOOTLOADER_MCUBOOT=y

sysbuild-example/sysbuild/mcuboot.conf

@@ -0,0 +1,2 @@
+CONFIG_BOOT_SWAP_USING_SCRATCH=y
+

west.yml

@@ -20,3 +20,5 @@ manifest:
           - cmsis      # required by the ARM port
           - hal_nordic # required by the custom_plank board (Nordic based)
           - hal_stm32  # required by the nucleo_f302r8 board (STM32 based)
+          - mcuboot
+          - mbedtls