/modules/STM32L476RG-NUCLEO64/aosconf.h - Annotate - AMiRo-OS - Research for Cognitive Interaction

amiro-os / modules / STM32L476RG-NUCLEO64 / aosconf.h @ 6ff06bbf

History | View | Annotate | Download (6.967 KB)

-d0378b
+/*
 AMiRo-OS is an operating system designed for the Autonomous Mini Robot (AMiRo) platform.
-d0d9
+Copyright (C) 2016..2019  Thomas Schöpping et al.
-d0378b
+            Simon Welzel
 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/>.
 */
 /**
-d0d9
+ * @file
-            a0301104
+ * @brief   AMiRo-OS Configuration file for the STM32L476RG-NUCLEO64 module.
-d0378b
+ * @details Contains the application specific AMiRo-OS settings.
+ *
-            a0301104
+ * @addtogroup STM32L476RG-NUCLEO64_aos_config
-d0378b
+ * @{
  */
-ff06bbf
+#ifndef AOSCONF_H
 #define AOSCONF_H
-d0378b
+            Simon Welzel
 /*
  * compatibility guards
  */
 #define _AMIRO_OS_CFG_
 #define _AMIRO_OS_CFG_VERSION_MAJOR_            2
 #define _AMIRO_OS_CFG_VERSION_MINOR_            0
 #include <stdbool.h>
 /*
  * Include an external configuration file to override the following default settings only if required.
  */
 #if defined(AMIRO_APPS) && (AMIRO_APPS == true)
   #include <osconf.h>
 #endif
 /*===========================================================================*/
 /**
  * @name Kernel parameters and options
  * @{
  */
 /*===========================================================================*/
 /**
  * @brief   Flag to enable/disable debug API and logic.
  */
 #if !defined(OS_CFG_DBG)
   #define AMIROOS_CFG_DBG                       true
 #else
   #define AMIROOS_CFG_DBG                       OS_CFG_DBG
 #endif
 /**
  * @brief   Flag to enable/disable unit tests.
-d0d9
+ * @note    Setting this flag will implicitely enable the shell.
-d0378b
+ */
 #if !defined(OS_CFG_TESTS_ENABLE)
-            a0301104
+  #define AMIROOS_CFG_TESTS_ENABLE              true
-d0378b
+#else
   #define AMIROOS_CFG_TESTS_ENABLE              OS_CFG_TESTS_ENABLE
 #endif
 /**
  * @brief   Flag to enable/disable profiling API and logic.
  */
 #if !defined(OS_CFG_PROFILE)
   #define AMIROOS_CFG_PROFILE                   true
 #else
   #define AMIROOS_CFG_PROFILE                   OS_CFG_PROFILE
 #endif
 /**
-d0d9
+ * @brief   Mask for the control thread to listen to certain IO events.
  * @note    Any mandatory events (e.g. for SSSP) are enabled implicitely despite this configuration.
  */
 #if !defined(OS_CFG_MAIN_LOOP_IOEVENT_MASK)
   #define AMIROOS_CFG_MAIN_LOOP_IOEVENT_MASK    MODULE_OS_IOEVENTFLAGS_USERBUTTON
 #else
   #define AMIROOS_CFG_MAIN_LOOP_IOEVENT_MASK    OS_CFG_MAIN_LOOP_IOEVENT_MASK
 #endif
 /**
-d0378b
+ * @brief   Timeout value when waiting for events in the main loop in microseconds.
  * @details A value of 0 deactivates the timeout.
  */
 #if !defined(OS_CFG_MAIN_LOOP_TIMEOUT)
   #define AMIROOS_CFG_MAIN_LOOP_TIMEOUT         0
 #else
   #define AMIROOS_CFG_MAIN_LOOP_TIMEOUT         OS_CFG_MAIN_LOOP_TIMEOUT
 #endif
 /** @} */
 /*===========================================================================*/
 /**
  * @name SSSP (Startup Shutdown Synchronization Protocol) configuration.
  * @{
  */
 /*===========================================================================*/
 /**
  * @brief   Flag to enable SSSP.
  */
 #if !defined(OS_CFG_SSSP_ENABLE)
-cc
+  #define AMIROOS_CFG_SSSP_ENABLE               false
-d0378b
+#else
   #define AMIROOS_CFG_SSSP_ENABLE               OS_CFG_SSSP_ENABLE
 #endif
 /**
  * @brief   Flag to set the module as SSSP master.
  * @details There must be only one module with this flag set to true in a system.
  */
 #if !defined(OS_CFG_SSSP_MASTER)
-d0d9
+  #define AMIROOS_CFG_SSSP_MASTER               false
-d0378b
+#else
   #define AMIROOS_CFG_SSSP_MASTER               OS_CFG_SSSP_MASTER
 #endif
 /**
  * @brief   Flag to set the module to be the first in the stack.
  * @details There must be only one module with this flag set to true in a system.
  */
 #if !defined(OS_CFG_SSSP_STACK_START)
-d0d9
+  #define AMIROOS_CFG_SSSP_STACK_START          false
-d0378b
+#else
   #define AMIROOS_CFG_SSSP_STACK_START          OS_CFG_SSSP_STACK_START
 #endif
 /**
  * @brief   Flag to set the module to be the last in the stack.
  * @details There must be only one module with this flag set to true in a system.
  */
 #if !defined(OS_CFG_SSSP_STACK_END)
-d0d9
+  #define AMIROOS_CFG_SSSP_STACK_END            false
-d0378b
+#else
   #define AMIROOS_CFG_SSSP_STACK_END            OS_CFG_SSSP_STACK_END
 #endif
 /**
  * @brief   Delay time (in microseconds) how long a SSSP signal must be active.
  */
 #if !defined(OS_CFG_SSSP_SIGNALDELAY)
   #define AMIROOS_CFG_SSSP_SIGNALDELAY          1000
 #else
   #define AMIROOS_CFG_SSSP_SIGNALDELAY          OS_CFG_SSSP_SIGNALDELAY
 #endif
 /**
  * @brief   Time boundary for robot wide clock synchronization in microseconds.
  * @details Whenever the SSSP S (snychronization) signal gets logically deactivated,
  *          All modules need to align their local uptime to the nearest multiple of this value.
  */
 #if !defined(OS_CFG_SSSP_SYSSYNCPERIOD)
   #define AMIROOS_CFG_SSSP_SYSSYNCPERIOD        1000000
 #else
   #define AMIROOS_CFG_SSSP_SYSSYNCPERIOD        OS_CFG_SSSP_SYSSYNCPERIOD
 #endif
 /** @} */
 /*===========================================================================*/
 /**
  * @name System shell options
  * @{
  */
 /*===========================================================================*/
 /**
  * @brief   Shell enable flag.
  */
-d0d9
+#if !defined(OS_CFG_SHELL_ENABLE)
-d0378b
+  #define AMIROOS_CFG_SHELL_ENABLE              true
 #else
   #define AMIROOS_CFG_SHELL_ENABLE              OS_CFG_SHELL_ENABLE
 #endif
 /**
  * @brief   Shell thread stack size.
  */
 #if !defined(OS_CFG_SHELL_STACKSIZE)
   #define AMIROOS_CFG_SHELL_STACKSIZE           1024
 #else
   #define AMIROOS_CFG_SHELL_STACKSIZE           OS_CFG_SHELL_STACKSIZE
 #endif
 /**
  * @brief   Shell thread priority.
  * @details Thread priorities are specified as an integer value.
  *          Predefined ranges are:
  *            lowest  ┌ THD_LOWPRIO_MIN
  *                    │ ...
  *                    └ THD_LOWPRIO_MAX
  *                    ┌ THD_NORMALPRIO_MIN
  *                    │ ...
  *                    └ THD_NORMALPRIO_MAX
  *                    ┌ THD_HIGHPRIO_MIN
  *                    │ ...
  *                    └ THD_HIGHPRIO_MAX
  *                    ┌ THD_RTPRIO_MIN
  *                    │ ...
  *            highest └ THD_RTPRIO_MAX
  */
 #if !defined(OS_CFG_SHELL_THREADPRIO)
   #define AMIROOS_CFG_SHELL_THREADPRIO          AOS_THD_NORMALPRIO_MIN
 #else
   #define AMIROOS_CFG_SHELL_THREADPRIO          OS_CFG_SHELL_THREADPRIO
 #endif
 /**
  * @brief   Shell maximum input line length.
  */
 #if !defined(OS_CFG_SHELL_LINEWIDTH)
   #define AMIROOS_CFG_SHELL_LINEWIDTH           64
 #else
   #define AMIROOS_CFG_SHELL_LINEWIDTH           OS_CFG_SHELL_LINEWIDTH
 #endif
 /**
  * @brief   Shell maximum number of arguments.
  */
 #if !defined(OS_CFG_SHELL_MAXARGS)
   #define AMIROOS_CFG_SHELL_MAXARGS             4
 #else
   #define AMIROOS_CFG_SHELL_MAXARGS             OS_CFG_SHELL_MAXARGS
 #endif
 /** @} */
-ff06bbf
+#endif /* AOSCONF_H */
-d0378b
+            Simon Welzel
 /** @} */