[nrf fromlist] samples: Added a minimal MCUBoot integration test

From upstream zephyrproject-rtos#13672

Added a minimal integration test for MCUBoot. It has just enough
coverage to catch build issues. Which is better than before (no
coverage in the Zephyr CI).

Signed-off-by: Sebastian Bøe <[email protected]>
(cherry picked from commit 1937b41)

CODEOWNERS

@@ -289,6 +289,7 @@
 /samples/drivers/CAN/                     @alexanderwachter
 /samples/drivers/ht16k33/                 @henrikbrixandersen
 /samples/gui/                             @vanwinkeljan
+/samples/mcuboot/                         @SebastianBoe
 /samples/net/                             @jukkar @tbursztyka @pfalcon
 /samples/net/dns_resolve/                 @jukkar @tbursztyka @pfalcon
 /samples/net/lwm2m_client/                @mike-scott

doc/application/index.rst

@@ -1607,7 +1607,7 @@ changes to the build scripts are necessary.
 As mentioned earlier, each target needs a prefix to disambiguate. This
 includes the library target 'app', so any references to 'app' would
 need to be changed to '${IMAGE}app'. Or, even better, one would use
-the zephyr_library_ API instead of the target_* API to indirectly
+the zephyr_library_* API instead of the target_* API to indirectly
 modify '${IMAGE}app'.
 
 After the application build scripts have been ported we can write some

samples/index.rst

@@ -16,6 +16,7 @@ Samples and Demos
    bluetooth/bluetooth.rst
    sensor/*
    boards/*
+   mcuboot/*
    mpu/*
    drivers/drivers.rst
    application_development/*

samples/mcuboot/CMakeLists.txt

@@ -0,0 +1,6 @@
+cmake_minimum_required(VERSION 3.13.1)
+
+include($ENV{ZEPHYR_BASE}/cmake/app/boilerplate.cmake NO_POLICY_SCOPE)
+project(mcuboot)
+
+target_sources(app PRIVATE src/main.c)

samples/mcuboot/README.rst

@@ -0,0 +1,40 @@
+.. _mcuboot_sample:
+
+MCUBoot Sample
+##############
+
+Overview
+********
+A simple hello world sample that is booted by the bootloader
+MCUBoot. This sample can be used with any platform that supports
+MCUBoot.
+
+Building and Running
+********************
+
+This project outputs output from the bootloader and then 'Hello World'
+from the application.  It can be built and executed on nRF52_pca10040
+as follows:
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/mcuboot
+   :host-os: unix
+   :board: nrf52_pca10040
+   :goals: run
+   :compact:
+
+Sample Output
+=============
+
+.. code-block:: console
+
+    ***** Booting Zephyr OS v1.14.0-rc1-447-gb30b83a6eb *****
+    [00:00:00.004,638] <inf> mcuboot: Starting bootloader
+    [00:00:00.011,505] <inf> mcuboot: Image 0: magic=unset, copy_done=0x3, image_ok=0x3
+    [00:00:00.020,690] <inf> mcuboot: Scratch: magic=unset, copy_done=0xe0, image_ok=0x3
+    [00:00:00.029,998] <inf> mcuboot: Boot source: slot 0
+    [00:00:00.039,062] <inf> mcuboot: Swap type: none
+    [00:00:00.132,904] <inf> mcuboot: Bootloader chainload address offset: 0xc000
+    [00:00:00.141,479] <inf> mcuboot: Jumping to the first image slot
+    ***** Booting Zephyr OS v1.14.0-rc1-447-gb30b83a6eb *****
+    Hello World! nrf52_pca10040

samples/mcuboot/prj.conf

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

samples/mcuboot/sample.yaml

@@ -0,0 +1,13 @@
+sample:
+  name: mcuboot
+tests:
+  boards.mcuboot:
+    tags: mcuboot
+    # All platforms supported by MCUBoot out-of-the-box are
+    # supported. nRF52 is known to be supported.
+    platform_whitelist: nrf52840_pca10056 nrf52_pca10040
+    harness: console
+    harness_config:
+      type: one_line
+      regex:
+        - "Hello World! (.*)"

samples/mcuboot/src/main.c

@@ -0,0 +1,14 @@
+/*
+ * Copyright (c) 2012-2014 Wind River Systems, Inc.
+ * Copyright (c) 2019 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <zephyr.h>
+#include <misc/printk.h>
+
+void main(void)
+{
+	printk("Hello World! %s\n", CONFIG_BOARD);
+}