feat: add support for os_exit

Add feature to allow system to exit on failures as
well as exit of a predefined delay.

Author: elupus

CMakeLists.txt

@@ -54,7 +54,9 @@ configure_file (
 
 # Add platform-dependent targets early, so they can be configured by
 # platform
-add_library(osal "")
+add_library(osal
+  "src/osal_utils.c"
+)
 
 # Use position independent code if platform supports shared libraries
 get_property(SUPPORTS_SHARED GLOBAL PROPERTY TARGET_SUPPORTS_SHARED_LIBS)
@@ -112,6 +114,7 @@ install(FILES
 install(FILES
   include/osal.h
   include/osal_log.h
+  include/osal_utils.h
   DESTINATION include
   )
 

cmake/Windows.cmake

@@ -25,6 +25,7 @@ target_compile_options(osal
     /WX
     /wd4100
     /wd4152
+    /wd4127 # conditional expression is constant
   >
 
   $<$<C_COMPILER_ID:GCC>:

include/osal.h

@@ -80,6 +80,10 @@ typedef void os_timer_t;
 typedef void os_tick_t;
 #endif
 
+#ifndef OS_EXIT
+typedef int os_exit_t;
+#endif
+
 void * os_malloc (size_t size);
 void os_free (void * ptr);
 
@@ -132,6 +136,8 @@ void os_timer_start (os_timer_t * timer);
 void os_timer_stop (os_timer_t * timer);
 void os_timer_destroy (os_timer_t * timer);
 
+void os_exit (os_exit_t code);
+
 #ifdef __cplusplus
 }
 #endif

include/osal_utils.h

@@ -0,0 +1,31 @@
+/*********************************************************************
+ *        _       _         _
+ *  _ __ | |_  _ | |  __ _ | |__   ___
+ * | '__|| __|(_)| | / _` || '_ \ / __|
+ * | |   | |_  _ | || (_| || |_) |\__ \
+ * |_|    \__|(_)|_| \__,_||_.__/ |___/
+ *
+ * www.rt-labs.com
+ * Copyright 2025 rt-labs AB, Sweden.
+ *
+ * This software is licensed under the terms of the BSD 3-clause
+ * license. See the file LICENSE distributed with this software for
+ * full license information.
+ ********************************************************************/
+
+#ifndef OSAL_UTILS_H
+#define OSAL_UTILS_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include "osal.h"
+
+void os_exit_later (os_exit_t code, const char * reason, uint32_t us);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* OSAL_UTILS_H */

src/freertos/osal.c

@@ -255,3 +255,8 @@ void os_timer_destroy (os_timer_t * timer)
    CC_ASSERT (status == pdPASS);
    free (timer);
 }
+
+void os_exit (os_exit_t code)
+{
+   exit (code);
+}

src/linux/osal.c

@@ -573,3 +573,8 @@ void os_timer_destroy (os_timer_t * timer)
    timer_delete (timer->timerid);
    free (timer);
 }
+
+void os_exit (os_exit_t code)
+{
+   exit (code);
+}

src/osal_utils.c

@@ -0,0 +1,55 @@
+/*********************************************************************
+ *        _       _         _
+ *  _ __ | |_  _ | |  __ _ | |__   ___
+ * | '__|| __|(_)| | / _` || '_ \ / __|
+ * | |   | |_  _ | || (_| || |_) |\__ \
+ * |_|    \__|(_)|_| \__,_||_.__/ |___/
+ *
+ * www.rt-labs.com
+ * Copyright 2025 rt-labs AB, Sweden.
+ *
+ * This software is licensed under the terms of the BSD 3-clause
+ * license. See the file LICENSE distributed with this software for
+ * full license information.
+ ********************************************************************/
+
+#include <string.h>
+#include <inttypes.h>
+#include "osal_utils.h"
+#include "osal_log.h"
+
+#ifndef LOG_LEVEL
+#define LOG_LEVEL LOG_LEVEL_INFO
+#endif
+
+typedef struct os_exit_later_ctx
+{
+    const char * reason;
+    os_exit_t    code;
+} os_exit_later_ctx_t;
+
+static void os_exit_later_callback (os_timer_t *timer, void * arg)
+{
+    os_exit_later_ctx_t * ctx = arg;
+    LOG_INFO (LOG_STATE_ON, "Exiting system due to: %s\n", ctx->reason);
+    os_exit (ctx->code);
+}
+
+void os_exit_later (os_exit_t code, const char * reason, uint32_t us)
+{
+    os_exit_later_ctx_t * ctx;
+    os_timer_t * tmr;
+    LOG_INFO (LOG_STATE_ON, "System will exit in %"PRIu32" microseconds due to: %s\n", us, reason);
+
+    ctx = os_malloc (sizeof (os_exit_later_ctx_t));
+    CC_ASSERT (ctx != NULL);
+
+    memset (ctx, 0, sizeof (os_exit_later_ctx_t));
+    ctx->code = code;
+    ctx->reason = reason;
+
+    tmr = os_timer_create (us, os_exit_later_callback, ctx, true);
+    CC_ASSERT (tmr != NULL);
+
+    os_timer_start (tmr);
+}

src/rt-kernel/osal.c

@@ -222,3 +222,8 @@ void os_timer_destroy (os_timer_t * timer)
 {
    tmr_destroy (timer);
 }
+
+void os_exit (os_exit_t code)
+{
+   exit (code);
+}

src/windows/osal.c

@@ -367,3 +367,8 @@ void os_timer_destroy (os_timer_t * timer)
 {
    free (timer);
 }
+
+void os_exit (os_exit_t code)
+{
+   exit (code);
+}

test/CMakeLists.txt

@@ -38,6 +38,7 @@ target_sources(osal_test PRIVATE
 
   # Unit tests
   test_osal.cpp
+  test_osal_utils.cpp
 
   # Testrunner
   osal_test.cpp