samples: dect_phy: dect_shell: new startup_cmd added

New command to store shell commands
to be run sequentially after a bootup.
Default max of 6 mem slots available for commands.

Signed-off-by: Jani Hirsimäki <[email protected]>

doc/nrf/releases_and_maturity/releases/release-notes-changelog.rst

@@ -268,6 +268,8 @@ DECT NR+ samples
     * The ``dect mac`` command.
       A brief MAC-level sample on top of DECT PHY interface with new commands to create a periodic cluster beacon, scan for it, associate or disassociate a PT/client, and send data to a FT/beacon random access window.
       This is not a full MAC implementation and not fully compliant with DECT NR+ MAC specification (`ETSI TS 103 636-4`_).
+    * The ``startup_cmd`` command.
+      This command is used to store shell commands to be run sequentially after bootup.
 
   * Updated:
 

samples/dect/dect_phy/dect_shell/CMakeLists.txt

@@ -16,3 +16,4 @@ target_sources(app PRIVATE src/shell.c)
 add_subdirectory(src/print)
 add_subdirectory(src/utils)
 add_subdirectory_ifdef(CONFIG_DESH_DECT_PHY src/dect)
+add_subdirectory_ifdef(CONFIG_DESH_STARTUP_CMDS src/startup_cmd)

samples/dect/dect_phy/dect_shell/Kconfig

@@ -21,4 +21,8 @@ config DESH_DECT_PHY
 	help
 	  DECT NR+ PHY api shell tools
 
+config DESH_STARTUP_CMDS
+	bool "Possibility to run stored shell commands from settings after bootup"
+	default y
+
 endmenu

samples/dect/dect_phy/dect_shell/README.rst

@@ -876,6 +876,32 @@ Example: starting of cluster beacon and sending RA data to it
       Stopping beacon.
       Beacon TX stopped, cause: User Initiated.
 
+Running commands at bootup
+==========================
+
+DeSh command: ``startup_cmd``.
+
+You can use the ``startup_cmd`` command to store shell commands to be run sequentially after bootup.
+
+Example: starting of cluster beacon and sending RA data to it
+-------------------------------------------------------------
+
+* FT/Beacon device - Set a command to start a cluster beacon five seconds after bootup:
+
+  .. code-block:: console
+
+      desh:~$ startup_cmd -t 5 --mem_slot 1 --cmd_str "dect sett -t 1234"
+      desh:~$ startup_cmd --mem_slot 2 --cmd_str "dect mac beacon_start"
+
+* PT/Client device - Set a command to start scanning for the beacon 60 seconds after bootup, associate to it, and send RA data to it:
+
+  .. code-block:: console
+
+      desh:~$ startup_cmd -t 60 --mem_slot 1 --cmd_str "dect sett -t 1235"
+      desh:~$ startup_cmd --mem_slot 2 --cmd_str "dect mac beacon_scan -c 0"
+      desh:~$ startup_cmd --mem_slot 3 -d 60 --cmd_str "dect mac associate -t 1234"
+      desh:~$ startup_cmd --mem_slot 4 -d 10 --cmd_str "dect mac rach_tx -t 1234 -d data"
+
 Building
 ********
 

samples/dect/dect_phy/dect_shell/prj.conf

@@ -9,7 +9,7 @@ CONFIG_SHELL_WILDCARD=n
 CONFIG_SHELL_PROMPT_UART="desh:~$ "
 CONFIG_SHELL_ARGC_MAX=40
 
-#Note that NR+ modem FW has limited set of AT commands supported
+# Note that NR+ modem FW supports a limited set of AT commands
 CONFIG_AT_SHELL=y
 
 # -h and --help options are handled in Dect Shell

samples/dect/dect_phy/dect_shell/src/main.c

@@ -25,12 +25,24 @@
 
 #include <dk_buttons_and_leds.h>
 
+#if defined(CONFIG_DESH_STARTUP_CMDS)
+#include "startup_cmd_ctrl.h"
+#endif
 #include "desh_defines.h"
 #include "desh_print.h"
 
 BUILD_ASSERT(IS_ENABLED(CONFIG_SHELL_BACKEND_SERIAL),
 	     "CONFIG_SHELL_BACKEND_SERIAL shell backend must be enabled");
 
+/***** Work queue and work item definitions *****/
+
+#if defined(CONFIG_DESH_STARTUP_CMDS)
+#define DESH_COMMON_WORKQUEUE_STACK_SIZE 4096
+#define DESH_COMMON_WORKQ_PRIORITY 5
+K_THREAD_STACK_DEFINE(desh_common_workq_stack, DESH_COMMON_WORKQUEUE_STACK_SIZE);
+struct k_work_q desh_common_work_q;
+#endif
+
 /* Global variables */
 const struct shell *desh_shell;
 
@@ -163,14 +175,28 @@ int main(void)
 	 */
 	desh_print_reset_reason();
 
+#if defined(CONFIG_DESH_STARTUP_CMDS)
+	struct k_work_queue_config cfg = {
+		.name = "desh_common_workq",
+	};
+
+	k_work_queue_start(
+		&desh_common_work_q,
+		desh_common_workq_stack,
+		K_THREAD_STACK_SIZEOF(desh_common_workq_stack),
+		DESH_COMMON_WORKQ_PRIORITY,
+		&cfg);
+#endif
 	err = nrf_modem_lib_init();
 	if (err) {
 		/* Modem library initialization failed. */
 		printk("Could not initialize nrf_modem_lib, err %d\n", err);
 		printk("Fatal error\n");
 		return 0;
 	}
-
+#if defined(CONFIG_DESH_STARTUP_CMDS)
+	startup_cmd_ctrl_init();
+#endif
 #if defined(CONFIG_DK_LIBRARY)
 	err = dk_leds_init();
 	if (err) {

samples/dect/dect_phy/dect_shell/src/startup_cmd/CMakeLists.txt

@@ -0,0 +1,11 @@
+#
+# Copyright (c) 2024 Nordic Semiconductor
+#
+# SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+#
+
+target_include_directories(app PRIVATE .)
+
+target_sources(app PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/startup_cmd_ctrl.c)
+target_sources(app PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/startup_cmd_shell.c)
+target_sources(app PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/startup_cmd_settings.c)

samples/dect/dect_phy/dect_shell/src/startup_cmd/startup_cmd_ctrl.c

@@ -0,0 +1,86 @@
+/*
+ * Copyright (c) 2024 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+ */
+
+#include <zephyr/kernel.h>
+#include <stdio.h>
+
+#include <zephyr/shell/shell.h>
+
+#include "desh_print.h"
+#include "startup_cmd_settings.h"
+
+extern struct k_work_q desh_common_work_q;
+extern const struct shell *desh_shell;
+
+/* Work for running commands: */
+struct startup_cmd_worker_data {
+	struct k_work_delayable work;
+	uint8_t running_mem_slot;
+};
+static struct startup_cmd_worker_data startup_cmd_worker_data;
+
+static bool running;
+
+static void startup_cmd_worker(struct k_work *work_item)
+{
+	int len = 0;
+	int err;
+	struct k_work_delayable *delayable_work = k_work_delayable_from_work(work_item);
+	struct startup_cmd_worker_data *data_ptr =
+		CONTAINER_OF(delayable_work, struct startup_cmd_worker_data, work);
+	struct startup_cmd current_cmd_data;
+
+	err = startup_cmd_settings_cmd_data_read_by_memslot(
+		&current_cmd_data, data_ptr->running_mem_slot);
+	if (err) {
+		desh_error("(%s): Cannot read startup_cmd data for mem_slot %d",
+			(__func__), data_ptr->running_mem_slot);
+		return;
+	}
+
+	len = strlen(current_cmd_data.cmd_str);
+	if (len) {
+		desh_print("Starting to execute sett_cmd %d \"%s\"...",
+			data_ptr->running_mem_slot, current_cmd_data.cmd_str);
+		shell_execute_cmd(desh_shell, current_cmd_data.cmd_str);
+	}
+
+	/* We are done for this one. Schedule next stored command. */
+	if (data_ptr->running_mem_slot < STARTUP_CMD_MAX_COUNT) {
+		startup_cmd_worker_data.running_mem_slot++;
+		k_work_schedule_for_queue(
+			&desh_common_work_q,
+			&startup_cmd_worker_data.work,
+			K_SECONDS(startup_cmd_settings_cmd_delay_get(
+				startup_cmd_worker_data.running_mem_slot)));
+	} else {
+		/* No more commands to run */
+		startup_cmd_worker_data.running_mem_slot = 0;
+	}
+}
+
+static bool startup_cmd_can_be_started(void)
+{
+	return (!running && startup_cmd_settings_enabled());
+}
+
+void startup_cmd_ctrl_settings_loaded(void)
+{
+	int starttime = startup_cmd_settings_starttime_get();
+
+	if (startup_cmd_can_be_started()) {
+		startup_cmd_worker_data.running_mem_slot = 1;
+		k_work_schedule_for_queue(
+			&desh_common_work_q, &startup_cmd_worker_data.work, K_SECONDS(starttime));
+		running = true;
+	}
+}
+
+void startup_cmd_ctrl_init(void)
+{
+	k_work_init_delayable(&startup_cmd_worker_data.work, startup_cmd_worker);
+	startup_cmd_settings_init();
+}

samples/dect/dect_phy/dect_shell/src/startup_cmd/startup_cmd_ctrl.h

@@ -0,0 +1,13 @@
+/*
+ * Copyright (c) 2024 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+ */
+
+#ifndef DESH_STARTUP_CMD_CTRL_H
+#define DESH_STARTUP_CMD_CTRL_H
+
+void startup_cmd_ctrl_settings_loaded(void);
+void startup_cmd_ctrl_init(void);
+
+#endif /* DESH_STARTUP_CMD_CTRL_H */