/core/src/aos_system.c - Annotate - AMiRo-OS - Research for Cognitive Interaction

amiro-os / core / src / aos_system.c @ f3ac1c96

History | View | Annotate | Download (41.451 KB)

-            e545e620
+/*
 AMiRo-OS is an operating system designed for the Autonomous Mini Robot (AMiRo) platform.
-f0ce9e
+Copyright (C) 2016..2019  Thomas Schöpping et al.
-            e545e620
+            Thomas Schöpping
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation, either version 3 of the License, or
 (at your option) any later version.
 This program is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU General Public License for more details.
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
-ca3
+/**
  * @file    aos_system.c
  * @brief   System code.
  * @details Contains system initialization and shutdown routines
  *          and system shell commands.
+ *
  * @addtogroup aos_system
  * @{
  */
-            e545e620
+#include <aos_system.h>
 #include <amiroblt.h>
-aeae
+#include <module.h>
-            e545e620
+#include <string.h>
-aeae
+#include <stdlib.h>
-            e545e620
+#if (AMIROOS_CFG_TESTS_ENABLE == true)
 #include <ch_test.h>
-be0f
+#include <rt_test_root.h>
-            e545e620
+#endif
-            f3ac1c96
+/******************************************************************************/
 /* LOCAL DEFINITIONS                                                          */
 /******************************************************************************/
-            e545e620
+/**
  * @brief   Period of the system timer.
  */
-e5f7648
+#define SYSTIMER_PERIOD               (TIME_MAX_SYSTIME - CH_CFG_ST_TIMEDELTA)
-            e545e620
+            Thomas Schöpping
 /**
  * @brief   Width of the printable system info text.
  */
 #define SYSTEM_INFO_WIDTH             70
-            ba516b61
+/**
  * @brief   Width of the name column of the system info table.
  */
 #define SYSTEM_INFO_NAMEWIDTH         14
-            f3ac1c96
+#if ((AMIROOS_CFG_SSSP_ENABLE == true) && (AMIROOS_CFG_SSSP_MASTER != true) && (AMIROOS_CFG_PROFILE == true)) || defined(__DOXYGEN__)
 /**
  * @brief   Weighting factor for the low-pass filter used for calculating the @p _syssyncskew value.
  */
 #define SYSTEM_SYSSYNCSKEW_LPFACTOR   (0.1f / AOS_SYSTEM_TIME_RESOLUTION)
 #endif /* (AMIROOS_CFG_SSSP_ENABLE == true) && (AMIROOS_CFG_SSSP_MASTER != true) && (AMIROOS_CFG_PROFILE == true) */
 /******************************************************************************/
 /* EXPORTED VARIABLES                                                         */
 /******************************************************************************/
 /**
  * @brief   Global system object.
  */
 aos_system_t aos;
 /******************************************************************************/
 /* LOCAL TYPES                                                                */
 /******************************************************************************/
 /******************************************************************************/
 /* LOCAL VARIABLES                                                            */
 /******************************************************************************/
 /*
  * forward declarations
  */
 #if (AMIROOS_CFG_SHELL_ENABLE == true) || (AMIROOS_CFG_TESTS_ENABLE == true) || defined(__DOXYGEN__)
-            e545e620
+static int _shellcmd_configcb(BaseSequentialStream* stream, int argc, char* argv[]);
 static int _shellcmd_infocb(BaseSequentialStream* stream, int argc, char* argv[]);
 static int _shellcmd_shutdowncb(BaseSequentialStream* stream, int argc, char* argv[]);
-            f3ac1c96
+#if (AMIROOS_CFG_TESTS_ENABLE == true) || defined(__DOXYGEN__)
-            e545e620
+static int _shellcmd_kerneltestcb(BaseSequentialStream* stream, int argc, char* argv[]);
 #endif /* AMIROOS_CFG_TESTS_ENABLE == true */
-dd2e257
+#endif /* (AMIROOS_CFG_SHELL_ENABLE == true) || (AMIROOS_CFG_TESTS_ENABLE == true) */
-            e545e620
+            Thomas Schöpping
 /**
  * @brief   Timer to accumulate system uptime.
  */
 static virtual_timer_t _systimer;
 /**
  * @brief   Accumulated system uptime.
  */
 static aos_timestamp_t _uptime;
 /**
  * @brief   Timer register value of last accumulation.
  */
 static systime_t _synctime;
-ebb11a9
+#if ((AMIROOS_CFG_SSSP_ENABLE == true) && (AMIROOS_CFG_SSSP_MASTER == true)) || defined(__DOXYGEN__)
-            e545e620
+/**
  * @brief   Timer to drive the SYS_SYNC signal for system wide time synchronization according to SSSP.
  */
 static virtual_timer_t _syssynctimer;
 /**
  * @brief   Last uptime of system wide time synchronization.
  */
 static aos_timestamp_t _syssynctime;
-            f3ac1c96
+#endif /* (AMIROOS_CFG_SSSP_ENABLE == true) && (AMIROOS_CFG_SSSP_MASTER == true) */
-            e545e620
+            Thomas Schöpping
-ebb11a9
+#if ((AMIROOS_CFG_SSSP_ENABLE == true) && (AMIROOS_CFG_SSSP_MASTER != true) && (AMIROOS_CFG_PROFILE == true)) || defined(__DOXYGEN__)
-            2674917e
+/**
  * @brief   Offset between local clock and system wide synchronization signal.
  */
-e1a9c79
+static float _syssyncskew;
-            2674917e
+            Thomas Schöpping
-ebb11a9
+#endif /* (AMIROOS_CFG_SSSP_ENABLE == true) && (AMIROOS_CFG_SSSP_MASTER != true) && (AMIROOS_CFG_PROFILE == true) */
-e1a9c79
+            Thomas Schöpping
-dd2e257
+#if (AMIROOS_CFG_SHELL_ENABLE == true) || (AMIROOS_CFG_TESTS_ENABLE == true) || defined(__DOXYGEN__)
-            e545e620
+/**
  * @brief   Shell thread working area.
  */
 THD_WORKING_AREA(_shell_wa, AMIROOS_CFG_SHELL_STACKSIZE);
 /**
  * @brief   Shell input buffer.
  */
 static char _shell_line[AMIROOS_CFG_SHELL_LINEWIDTH];
 /**
  * @brief   Shell argument buffer.
  */
 static char* _shell_arglist[AMIROOS_CFG_SHELL_MAXARGS];
 /**
  * @brief   Shell command to retrieve system information.
  */
 static aos_shellcommand_t _shellcmd_info = {
   /* name     */ "module:info",
   /* callback */ _shellcmd_infocb,
   /* next     */ NULL,
 };
 /**
  * @brief   Shell command to set or retrieve system configuration.
  */
 static aos_shellcommand_t _shellcmd_config = {
   /* name     */ "module:config",
   /* callback */ _shellcmd_configcb,
   /* next     */ NULL,
 };
 /**
  * @brief   Shell command to shutdown the system.
  */
 static aos_shellcommand_t _shellcmd_shutdown = {
-d3e002f
+#if (AMIROOS_CFG_SSSP_ENABLE == true)
-            e545e620
+  /* name     */ "system:shutdown",
-d3e002f
+#else
   /* name     */ "module:shutdown",
 #endif
-            e545e620
+  /* callback */ _shellcmd_shutdowncb,
   /* next     */ NULL,
 };
 #if (AMIROOS_CFG_TESTS_ENABLE == true) || defined(__DOXYGEN__)
 /**
  * @brief   Shell kommand to run a test of the ChibiOS/RT kernel.
  */
 static aos_shellcommand_t _shellcmd_kerneltest = {
   /* name     */ "kernel:test",
   /* callback */ _shellcmd_kerneltestcb,
   /* next     */ NULL,
 };
 #endif /* AMIROOS_CFG_TESTS_ENABLE == true */
-dd2e257
+#endif /* (AMIROOS_CFG_SHELL_ENABLE == true) || (AMIROOS_CFG_TESTS_ENABLE == true) */
-            e545e620
+            Thomas Schöpping
-            f3ac1c96
+/******************************************************************************/
 /* LOCAL FUNCTIONS                                                            */
 /******************************************************************************/
-            e545e620
+            Thomas Schöpping
 /**
  * @brief   Print a separator line.
+ *
-            ba516b61
+ * @param[in] stream    Stream to print to or NULL to print to all system streams.
-            e545e620
+ * @param[in] c         Character to use.
  * @param[in] n         Length of the separator line.
+ *
  * @return  Number of characters printed.
  */
 static unsigned int _printSystemInfoSeparator(BaseSequentialStream* stream, const char c, const unsigned int n)
+{
   aosDbgCheck(stream != NULL);
   // print the specified character n times
   for (unsigned int i = 0; i < n; ++i) {
     streamPut(stream, c);
+  }
   streamPut(stream, '\n');
   return n+1;
+}
 /**
  * @brief   Print a system information line.