samples: Enable end-to-end commissioning

Make ETS6 and the OpenThread Joiner the default sample flow and provide optional hardcoded and shell-based profiles.

Signed-off-by: Adam Maciuga <adam.maciuga@nordicsemi.no>

Author: Adam-Maciuga

samples/common/overlay-knx-hardcoded.conf

@@ -0,0 +1,6 @@
+# Copyright (c) 2026 Nordic Semiconductor ASA
+# SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+
+# Use fixed KNX group bindings and a group OSCORE key instead of ETS6.
+
+CONFIG_KNX_HARDCODED_COMMISSIONING=y

samples/common/overlay-thread-hardcoded.conf

@@ -0,0 +1,15 @@
+# Copyright (c) 2026 Nordic Semiconductor ASA
+# SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+
+# Optional Thread profile for a fixed dataset.
+
+CONFIG_OPENTHREAD_JOINER=n
+CONFIG_OPENTHREAD_JOINER_AUTOSTART=n
+CONFIG_OPENTHREAD_MANUAL_START=n
+
+# Fixed dataset.
+CONFIG_OPENTHREAD_PANID=4813
+CONFIG_OPENTHREAD_CHANNEL=20
+CONFIG_OPENTHREAD_NETWORK_NAME="knx-lab"
+CONFIG_OPENTHREAD_XPANID="de:ad:00:be:ef:00:ca:fe"
+CONFIG_OPENTHREAD_NETWORKKEY="ae:f0:08:f1:9a:cb:ad:8b:9e:a3:7e:74:90:dd:8c:04"

samples/common/overlay-thread-otshell.conf

@@ -0,0 +1,8 @@
+# Copyright (c) 2026 Nordic Semiconductor ASA
+# SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+
+# Disables automatic network bring up, allowing for manual setup from shell
+
+CONFIG_OPENTHREAD_JOINER=y
+CONFIG_OPENTHREAD_JOINER_AUTOSTART=n
+CONFIG_OPENTHREAD_MANUAL_START=y

samples/common/thread_hardcoded.conf

@@ -0,0 +1,13 @@
+/*
+ * Copyright (c) 2026 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+ */
+
+/*
+ * KNX Stack sends a lot of logs speed needs to be increased to avoid dropping them.
+ */
+
+&uart20 {
+	current-speed = <1000000>;
+};

samples/light_switch_actuator/boards/nrf54l15dk_nrf54l15_cpuapp.overlay

@@ -27,9 +27,9 @@
 
 LOG_MODULE_REGISTER(knx_actuator, LOG_LEVEL_INF);
 
-static void actuator_set_light(bool on)
+static void actuator_set_light(uint8_t channel, bool on)
 {
-	knx_board_set_app_led(on);
+	knx_board_set_app_led((enum knx_board_app_led)channel, on);
 }
 
 /* Datapoint indices within a switching channel. */
@@ -139,20 +139,22 @@ static void actuator_on_write(const knx_datapoint_t *dp)
 			return;
 		}
 
-		actuator_set_light(value);
+		actuator_set_light(KNX_DP_CHANNEL(dp->id), value);
 		LOG_INF("Light turned %s", value ? "on" : "off");
 	}
 }
 
 static void actuator_on_init(void)
 {
-	bool value = false;
+	for (uint8_t channel = 0; channel < NUM_CHANNELS; channel++) {
+		bool value = false;
 
-	if (knx_datapoint_get_bool(KNX_DP_ID(0, SOO), &value) < 0) {
-		LOG_ERR("failed to read initial actuator SOO");
-	}
+		if (knx_datapoint_get_bool(KNX_DP_ID(channel, SOO), &value) < 0) {
+			LOG_ERR("failed to read initial actuator SOO");
+		}
 
-	actuator_set_light(value);
+		actuator_set_light(channel, value);
+	}
 }
 
 static const knx_device_t actuator_device = {

samples/light_switch_actuator/knx_actuator.c

@@ -8,20 +8,24 @@
 
 #include <knx/knx_app.h>
 #include <stdlib.h>
-#include <zephyr/kernel.h>
 #include <zephyr/logging/log.h>
 
 LOG_MODULE_REGISTER(light_switch_actuator, LOG_LEVEL_INF);
 
 int main(void)
 {
+	int err;
+
 	LOG_INF("KNX IoT light switch actuator");
 
 	app_register_device();
 
-	if (knx_app_start()) {
-		LOG_ERR("Error Initiating KNX App");
+	err = knx_app_start();
+
+	if (err) {
+		LOG_ERR("Failed to start KNX application: %d", err);
 		return EXIT_FAILURE;
 	}
+
 	return EXIT_SUCCESS;
 }

samples/light_switch_actuator/main.c

@@ -1,25 +1,50 @@
 # Copyright (c) 2026 Nordic Semiconductor ASA
 # SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
 
+# Debug configuration with shell and logs enabled
+
+# KNX ETS commissioning.
 CONFIG_KNX_IOT_ADD_ON=y
 
-# MVP: hardcode identity + group tables + a shared group OSCORE key so the
-# sensor and actuator talk with no ETS / commissioner (subsys/knx/knx_presets.c).
-CONFIG_KNX_HARDCODED_COMMISSIONING=y
+CONFIG_KNX_PROGRAMMING_MODE_AUTOSTART=n
+
+# Sleepy End Device operation.
+CONFIG_OPENTHREAD=y
+CONFIG_OPENTHREAD_MTD=y
+CONFIG_OPENTHREAD_MTD_SED=y
+CONFIG_OPENTHREAD_POLL_PERIOD=500
+CONFIG_OPENTHREAD_SRP_CLIENT=y
+CONFIG_OPENTHREAD_SLAAC=y
+CONFIG_OPENTHREAD_SHELL=y
+
+# Automatically join a Commissioner-authorized Thread network.
+CONFIG_OPENTHREAD_JOINER=y
+CONFIG_OPENTHREAD_JOINER_AUTOSTART=y
+CONFIG_OPENTHREAD_JOINER_PSKD="N0RD1C"
+CONFIG_OPENTHREAD_MANUAL_START=n
+
+# Keep retained multicast echo messages within the available heap.
+CONFIG_KNXIOT_ECHO_RING_SIZE=16
 
 CONFIG_MAIN_STACK_SIZE=4096
 
 # Persistent storage backend.
 CONFIG_ZMS=y
 CONFIG_SETTINGS_ZMS=y
 
+# User interface.
 CONFIG_GPIO=y
 CONFIG_DK_LIBRARY=y
 
+# Development shell and diagnostics.
 CONFIG_SHELL=y
+CONFIG_SHELL_STACK_SIZE=8192
+CONFIG_SHELL_CMD_BUFF_SIZE=512
 
 CONFIG_MBEDTLS_HEAP_SIZE=30000
 
 CONFIG_LOG=y
+CONFIG_LOG_BACKEND_UART=n
+CONFIG_SHELL_LOG_BACKEND=y
 
 CONFIG_LOG_PROCESS_THREAD_STACK_SIZE=4096

samples/light_switch_actuator/prj.conf

@@ -1,20 +1,34 @@
 sample:
   name: KNX IoT Light Switch Actuator
   description: KNX IoT light switch actuator sample
+common:
+  sysbuild: true
+  build_only: true
+  integration_platforms:
+    - nrf54l15dk/nrf54l15/cpuapp
+    - nrf54lm20dk/nrf54lm20a/cpuapp
+    - nrf54lm20dk/nrf54lm20b/cpuapp
+  platform_allow:
+    - nrf54l15dk/nrf54l15/cpuapp
+    - nrf54lm20dk/nrf54lm20a/cpuapp
+    - nrf54lm20dk/nrf54lm20b/cpuapp
+  tags:
+    - ci_build
 tests:
-  samples.knx_iot.light_switch_actuator:
-    sysbuild: true
-    build_only: true
-    integration_platforms:
-      - nrf54l15dk/nrf54l15/cpuapp
-      - nrf54lm20dk/nrf54lm20a/cpuapp
-      - nrf54lm20dk/nrf54lm20b/cpuapp
-    platform_allow:
-      - nrf54l15dk/nrf54l15/cpuapp
-      - nrf54lm20dk/nrf54lm20a/cpuapp
-      - nrf54lm20dk/nrf54lm20b/cpuapp
+  # Default: ETS6 commissioning + automatic Thread Joiner.
+  samples.knx_iot.light_switch_actuator: {}
+  samples.knx_iot.light_switch_actuator.release:
     extra_args:
-      - EXTRA_CONF_FILE=../common/thread_hardcoded.conf
-    tags:
-      - ci_build
-
+      - FILE_SUFFIX=release
+  samples.knx_iot.light_switch_actuator.knx_hardcoded:
+    extra_args:
+      - EXTRA_CONF_FILE=../common/overlay-knx-hardcoded.conf
+  samples.knx_iot.light_switch_actuator.thread_hardcoded:
+    extra_args:
+      - EXTRA_CONF_FILE=../common/overlay-thread-hardcoded.conf
+  samples.knx_iot.light_switch_actuator.thread_otshell:
+    extra_args:
+      - EXTRA_CONF_FILE=../common/overlay-thread-otshell.conf
+  samples.knx_iot.light_switch_actuator.hardcoded:
+    extra_args:
+      - EXTRA_CONF_FILE=../common/overlay-knx-hardcoded.conf;../common/overlay-thread-hardcoded.conf

samples/light_switch_actuator/sample.yaml

@@ -0,0 +1,13 @@
+/*
+ * Copyright (c) 2026 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+ */
+
+/*
+ * KNX Stack sends a lot of logs speed needs to be increased to avoid dropping them.
+ */
+
+&uart20 {
+	current-speed = <1000000>;
+};