Difference between revisions of "Using embOS with STM32CubeMX"

From SEGGER Wiki
Jump to: navigation, search
(Created page with "This article describes how '''embOS''' may be used with '''STM32CubeMX'''. == MadeForSTM32 == ''MadeForSTM32'' is a new quality label delivered by ST and is granted after an...")
 
m (Modifications to the linker file)
 
(16 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
This article describes how '''embOS''' may be used with '''STM32CubeMX'''.
 
This article describes how '''embOS''' may be used with '''STM32CubeMX'''.
  +
  +
For using the ''I-CUBE-embOS expansion for STM32CubeMX'', please refer to [[Using I-CUBE-embOS with STM32CubeMX]].
   
 
== MadeForSTM32 ==
 
== MadeForSTM32 ==
''MadeForSTM32'' is a new quality label delivered by ST and is granted after an extended evaluation process. It helps engineers identify software solutions with the highest level of integration and quality for the STM32 microcontrollers’ ecosystem.
+
''MadeForSTM32'' is a quality label delivered by ST and granted after an extended evaluation process. It helps engineers identify software solutions with the highest level of integration and quality for the STM32 microcontrollers' ecosystem.
   
''embOS'' was one of the first solutions to receive the ''MadeForSTM32 (v1)'' label in an advanced collaboration of ''SEGGER'' and ''ST Microelectronics''. As a result, ''SEGGER'' has published the official ''I-CUBE-EMBOS expansion for STM32CubeMX'', which may be used to generate ready-to-go embOS projects for use with ST's STM32F746-Discovery board and various IDEs. Furthermore, it may also be used as a starting point for creating further ''embOS'' projects for different evaluation boards and devices.
+
''embOS'' was one of the first solutions to receive the ''MadeForSTM32'' (v1) label in an advanced collaboration of ''SEGGER'' and ''ST Microelectronics'' and has since been certified to ''MadeForSTM32'' (v2) as well. <br />
  +
As a result, ''SEGGER'' has published the official ''I-CUBE-embOS expansion for STM32CubeMX'', which may be used to generate ready-to-go embOS projects for virtually all Cortex-M devices and various IDEs.
   
For more information on ''MadeForSTM32'' and the ''I-CUBE-EMBOS'' expansion, please visit [https://www.segger.com/products/rtos/embos/tools/third-party-support/made-for-stm32/ SEGGER.com].
+
For more information on ''MadeForSTM32'', please visit [https://www.segger.com/products/rtos/embos/tools/third-party-support/made-for-stm32/ SEGGER.com].
   
 
== Creating projects from scratch ==
 
== Creating projects from scratch ==
 
To use ''embOS'' with ''STM32CubeMX'', customers may either
 
To use ''embOS'' with ''STM32CubeMX'', customers may either
* use the ''I-CUBE-EMBOS expansion for STM32CubeMX'' and adopt it to their desired target hardware,
+
* use the ''I-CUBE-EMBOS expansion for STM32CubeMX'' and adapt it to their desired target hardware,
 
* generate a project in ''STM32CubeMX'' and subsequently add all generated HAL files and further sources to the shipped ''embOS'' start project for their desired target hardware, or
 
* generate a project in ''STM32CubeMX'' and subsequently add all generated HAL files and further sources to the shipped ''embOS'' start project for their desired target hardware, or
 
* generate a project in ''STM32CubeMX'' and subsequently add ''embOS'' to that generated project.
 
* generate a project in ''STM32CubeMX'' and subsequently add ''embOS'' to that generated project.
   
This article will walk readers through the latter approach. The described configuration of the target application in STM32CubeMX, however, applies and must therefore be followed in either approach.
+
This article will walk readers through the latter approach.
   
=== Creating the basic project ===
+
=== Steps to perform in STM32CubeMX ===
  +
==== Creating the basic project ====
Start ''STM32CubeMX'' and create a project for any specific target hardware. For this walk-through, we create a project for the ''32F429IDISCOVERY'' board, but chosing any different evaluation board or device will work as well. After the project was initialized, feel free to add clock configurations, GPIO settings, middleware compontents and further settings as needed. The result should look similar to the screenshot below:
 
  +
Start ''STM32CubeMX'' and create a project for any specific target hardware. For this walk-through, we create a project for the ''32F429IDISCOVERY'' board, but chosing any different evaluation board or device will work as well.<br />
  +
After the project was initialized, feel free to add clock configurations, GPIO settings, third-party middleware components and further settings as needed. The result should look similar to the screenshot below:
   
 
[[File:CubeMX_InitialProject.png|800px]]
 
[[File:CubeMX_InitialProject.png|800px]]
   
  +
In case the generated project is pre-configured for using any other RTOS than embOS, that RTOS must be disabled via ''Middleware and Software packs -> <RTOS Name> -> Interface''.<br />
When done configuring the project, begin to adopt it for ''embOS'' along the guidelines given in the following sections.
 
  +
When done configuring the project, begin to adapt it for ''embOS'' along the guidelines given in the following sections.
   
=== Setting up interrupt priorities for embOS ===
+
==== Interrupt priorities for embOS ====
To prepare the project for use with ''embOS'', care needs to be taken of the required interrupt handlers for using ''embOS'' with [[Cortex-M]] devices. To do so, navigate to ''System Core'' in the menu outline and select ''NVIC''. In the editor window, select the ''NVIC'' tab and check the ''Enabled'' checkbox for both the ''Penadable request for system service'' and ''System tick timer'' as shown below:
+
To prepare the project for use with ''embOS'', care needs to be taken of the required interrupt handlers for using ''embOS'' with [[Cortex-M]] devices. To do so, navigate to ''System Core'' in the menu outline and select ''NVIC''. In the editor window, select the ''NVIC'' tab and check the ''Enabled'' checkbox for both the ''Pendable request for system service'' and ''System tick timer'' as shown below:
   
 
[[File:CubeMX_InterruptPriorities.png|800px]]
 
[[File:CubeMX_InterruptPriorities.png|800px]]
   
 
Please also note the column ''Preemption Priority''. With ''embOS'' for Cortex-M, specific rules for [[Interrupt prioritization]] apply:
 
Please also note the column ''Preemption Priority''. With ''embOS'' for Cortex-M, specific rules for [[Interrupt prioritization]] apply:
* embOS utilizes the ''Penadable request for system service'' to perform context switches; it must use the lowest priority in the entire system in all cases. Hence, it gets configured for a priority of ''15'' in this example.
+
* embOS utilizes the ''Pendable request for system service'' to perform context switches; it must use the lowest priority in the entire system in all cases. Hence, it gets configured for a priority of ''15'' in this example.
 
* embOS utilizes the ''System tick timer'' to generate a time base; it may use any valid priority for an embOS interrupt. Typically, however, using the second-to-lowest priority in the entire system is advised. In this example, it therefore gets configured for a priority of ''14''.
 
* embOS utilizes the ''System tick timer'' to generate a time base; it may use any valid priority for an embOS interrupt. Typically, however, using the second-to-lowest priority in the entire system is advised. In this example, it therefore gets configured for a priority of ''14''.
 
* In case your application utilizes further interrupts (that shall use embOS API), please ensure these are configured for [[Interrupt prioritization|valid embOS interrupt priorities]] as well.
 
* In case your application utilizes further interrupts (that shall use embOS API), please ensure these are configured for [[Interrupt prioritization|valid embOS interrupt priorities]] as well.
   
=== Configuring interrupt handler generation ===
+
==== Interrupt handler generation for embOS ====
''STM32CubeMX'' may generate handlers for specific interrupt sources.
+
''STM32CubeMX'' may generate handlers for specific interrupt sources.
* Since ''embOS'' includes its own handler implementation for the ''Penadable request for system service'', that handler may not be generated by ''STM32CubeMX''. To disable its creation, switch to the ''Code generation'' tab and uncheck the ''Generate IRQ handler'' checbox for this specific handler.
+
* Since ''embOS'' includes its own handler implementation for the ''Pendable request for system service'', that handler may not be generated by ''STM32CubeMX''. To disable its creation, switch to the ''Code generation'' tab and uncheck the ''Generate IRQ handler'' checbox for this specific handler.
* While ''embOS'' includes a handler implementation for the ''System tick timer'' as well, a seperate handler should be geenrated by ''STM32CubeMX''. It should call HAL API functions (enable via according checkbox), which we will later use to call embOS' own handler implementation as a callback.
+
* While ''embOS'' includes a handler implementation for the ''System tick timer'' as well, a seperate handler should be generated by ''STM32CubeMX''. It should call HAL API functions (enable via according checkbox), which we will later use to call embOS' own handler implementation as a callback.
 
* In case your application utilizes further interrupts, appropiate handlers for these may be generated as required.
 
* In case your application utilizes further interrupts, appropiate handlers for these may be generated as required.
   
 
[[File:CubeMX_ISRGeneration.png|800px]]
 
[[File:CubeMX_ISRGeneration.png|800px]]
   
=== Generate the project ===
+
=== Steps to perform in the IDE and project files ===
  +
==== Integrating embOS ====
After generating of the project, open its location in the file system.
 
  +
After generating the project, open its location in the file system:
   
 
[[File:CubeMX_FileSystem.png|800px]]
 
[[File:CubeMX_FileSystem.png|800px]]
  +
  +
This folder structure may be extended as needed. For the integration of embOS, for example, you may want to add a folder ''embOS'' with subfolders ''Inc'', ''Lib'', ''SEGGER'', and ''Setup''.
  +
  +
Subsequently, copy all relevant files from your shipment of embOS (or, alternatively, from an embOS evaluation version) to the created subfolders:
  +
# To the ''Inc'' folder, copy all files from {SHIPMENT_ROOT}\Start\Inc\:
  +
## BSP.h (optional)
  +
## BSP_UART.h (optional)
  +
## Global.h
  +
## JLINKMEM.h
  +
## OS_Config.h
  +
## RTOS.h
  +
# To the ''Lib'' folder, copy one appropriate library from {SHIPMENT_ROOT}\Start\Lib\:
  +
#*e.g. for GCC-based projects:
  +
#** libosT7VHLDP.a (debug & profiling build of embOS for ARMv7-M little-endian devices with FPU using the [[GCC floating-point options|hard floating-point ABI]])
  +
#** libosT7VLDP.a (debug & profiling build of embOS for ARMv7-M little-endian devices with FPU using the [[GCC floating-point options|soft floating-point ABI]])
  +
#** libosT7BR.a (release build of embOS for ARMv7-M big-endian devices without FPU)
  +
#** libosT6BDP.a (debug & profiling build of embOS for ARMv6-M big-endian devices)
  +
#*e.g. for IAR-based projects:
  +
#** os7m_tlv_dp.a (debug & profiling build of embOS for ARMv7-M little-endian devices with FPU)
  +
#** os7m_tb__r.a (release build of embOS for ARMv7-M big-endian devices without FPU)
  +
#** os6m_tb__dp.a (debug & profiling build of embOS for ARMv6-M big-endian devices)
  +
#*e.g. for Keil-based projects:
  +
#** osT7VLDP.lib (debug & profiling build of embOS for ARMv7-M little-endian devices with FPU)
  +
#** osT7BR.lib (release build of embOS for ARMv7-M big-endian devices without FPU)
  +
#** osT6BDP.lib (debug & profiling build of embOS for ARMv6-M big-endian devices)
  +
# To the ''SEGGER'' folder, copy all files from an appropriate board support package, e.g. from {SHIPMENT_ROOT}\Start\BoardSupport\ST\STM32F429_STM32F429I_Discovery\SEGGER\:
  +
## SEGGER.h
  +
## SEGGER_RTT.c
  +
## SEGGER_RTT.h
  +
## SEGGER_RTT_ASM_ARMv7M.S (with ARMv7-M devices only)
  +
## SEGGER_RTT_Conf.h
  +
## SEGGER_RTT_printf.c (optional)
  +
## SEGGER_RTT_Syscalls_GCC.c (optional; GCC-specific source file: different name with embOS for IAR and embOS for Keil MDK)
  +
## SEGGER_SYSVIEW.c
  +
## SEGGER_SYSVIEW.h
  +
## SEGGER_SYSVIEW_Conf.h
  +
## SEGGER_SYSVIEW_ConfDefaults.h
  +
## SEGGER_SYSVIEW_Config_embOS.c
  +
## SEGGER_SYSVIEW_embOS.c
  +
## SEGGER_SYSVIEW_embOS.h
  +
## SEGGER_SYSVIEW_Int.h
  +
# To the ''Setup'' folder, copy the following *.c-files from an appropriate board support package, e.g. from {SHIPMENT_ROOT}\Start\BoardSupport\ST\STM32F429_STM32F429I_Discovery\Setup\:
  +
## BSP.c (optional)
  +
## BSP_SDRAM.c (optional)
  +
## JLINKMEM_Process.c
  +
## OS_Error.c
  +
## OS_ThreadSafe.c (GCC-specific source file: different name with embOS for IAR and embOS for Keil MDK)
  +
## OS_Syscalls.c (GCC-specific source file: different name with embOS for IAR and embOS for Keil MDK)
  +
## RTOSInit_STM32F4xx.c
  +
  +
Open the project and add the folders and files to it. The result should resemble the given example below (which uses the Eclipse-based STM32CubeIDE):
  +
  +
[[File:CubeMX_ProjectTree.png|800px]]
  +
  +
In the next step, configure the include paths for embOS header files:
  +
  +
[[File:CubeMX_Includes.png|800px]]
  +
  +
Configure the linker settings for the embOS library (required with Eclipse-based IDEs, but not with e.g. IAR):
  +
  +
[[File:CubeMX_Lib.png|800px]]
  +
[[File:CubeMX_LibPath.png|800px]]
  +
  +
Configure the preprocessor options for your application (must match the chosen embOS library configuration):
  +
  +
[[File:CubeMX_PreProc.png|800px]]
  +
  +
After these configurations, embOS was fully integrated with the project.
  +
  +
==== Modifications to the linker file ====
  +
embOS expects specific symbols in order to retrieve information about stack and heap in your project:
  +
* __heap_end__
  +
* __heap_start__
  +
* __stack_end__
  +
* __stack_start__
  +
  +
These symbols need to be added to the linker file, which is the generated *.ld-file in the project's root path, as shown below:
  +
  +
[[File:CubeMX_Linker.png|1070px]]
  +
  +
Also, the reset value of the system stack pointer (contained in the respective project's vector table at offset 0x0) must match the value of __stack_end__.
  +
  +
==== Merging the embOS tick with the generated SysTick_Handler() ====
  +
Since ''STM32CubeMX'' already initializes the hardware timer and the ''SysTick'' interrupt, some configurations inside RTOSInit_*.c must be removed.
  +
  +
Open RTOSInit_*.c and perform the following changes to ''OS_InitHW()'':
  +
  +
[[File:CubeMX_RTOSInit_InitHW.png|1200px]]
  +
  +
Furthermore, the ''SysTick_Handler()'' for embOS should now be used as a callback for the generated handler. To do so, apply the following modification to RTOSInit_*.c as well:
  +
  +
[[File:CubeMX_RTOSInit_SysTick.png|1200px]]
  +
  +
For the generated handler to actually call the callback function, add the following line to the generated SysTick_Handler() implementation, which can be found in stm32f*_it.c inside the ''Src'' folder of the generated project:
  +
  +
[[File:CubeMX_SysTick_Handler.png|1070px]]
  +
  +
==== Handle duplicate syscalls implementation ====
  +
The files syscalls.c and sysmem.c should be excluded from build in the project, since their contents are already implemented in OS_Syscalls.c with ''embOS''.
  +
The files may be found in the ''Src'' folder:
  +
  +
[[File:CubeMX_Excluded_Files.png|200px]]
  +
  +
==== Add an embOS application ====
  +
To use embOS in the project, main.c needs to be modified to include the following:
  +
# Inclusion of RTOS.h
  +
# Declaration of task control block and task stack
  +
# A function which will be run as the task
  +
# embOS kernel and task initialization:
  +
## ''OS_Init()''
  +
## ''OS_InitHW()''
  +
## ''OS_TASK_CREATE()'', with task control block, task name, priority, function name and task stack
  +
## ''OS_Start()''
  +
  +
The resulting modifications to main.c should therefore resemble the following example:
  +
  +
[[File:CubeMX Main embOS.PNG|1000px]]
  +
  +
Subsequently, the application may be compiled and executed in hardware.
  +
From here, feel free to modify the initial task, to add further tasks, OS objects and interrupt service routines to create your own embOS application.

Latest revision as of 11:42, 23 February 2024

This article describes how embOS may be used with STM32CubeMX.

For using the I-CUBE-embOS expansion for STM32CubeMX, please refer to Using I-CUBE-embOS with STM32CubeMX.

MadeForSTM32

MadeForSTM32 is a quality label delivered by ST and granted after an extended evaluation process. It helps engineers identify software solutions with the highest level of integration and quality for the STM32 microcontrollers' ecosystem.

embOS was one of the first solutions to receive the MadeForSTM32 (v1) label in an advanced collaboration of SEGGER and ST Microelectronics and has since been certified to MadeForSTM32 (v2) as well.
As a result, SEGGER has published the official I-CUBE-embOS expansion for STM32CubeMX, which may be used to generate ready-to-go embOS projects for virtually all Cortex-M devices and various IDEs.

For more information on MadeForSTM32, please visit SEGGER.com.

Creating projects from scratch

To use embOS with STM32CubeMX, customers may either

  • use the I-CUBE-EMBOS expansion for STM32CubeMX and adapt it to their desired target hardware,
  • generate a project in STM32CubeMX and subsequently add all generated HAL files and further sources to the shipped embOS start project for their desired target hardware, or
  • generate a project in STM32CubeMX and subsequently add embOS to that generated project.

This article will walk readers through the latter approach.

Steps to perform in STM32CubeMX

Creating the basic project

Start STM32CubeMX and create a project for any specific target hardware. For this walk-through, we create a project for the 32F429IDISCOVERY board, but chosing any different evaluation board or device will work as well.
After the project was initialized, feel free to add clock configurations, GPIO settings, third-party middleware components and further settings as needed. The result should look similar to the screenshot below:

CubeMX InitialProject.png

In case the generated project is pre-configured for using any other RTOS than embOS, that RTOS must be disabled via Middleware and Software packs -> <RTOS Name> -> Interface.
When done configuring the project, begin to adapt it for embOS along the guidelines given in the following sections.

Interrupt priorities for embOS

To prepare the project for use with embOS, care needs to be taken of the required interrupt handlers for using embOS with Cortex-M devices. To do so, navigate to System Core in the menu outline and select NVIC. In the editor window, select the NVIC tab and check the Enabled checkbox for both the Pendable request for system service and System tick timer as shown below:

CubeMX InterruptPriorities.png

Please also note the column Preemption Priority. With embOS for Cortex-M, specific rules for Interrupt prioritization apply:

  • embOS utilizes the Pendable request for system service to perform context switches; it must use the lowest priority in the entire system in all cases. Hence, it gets configured for a priority of 15 in this example.
  • embOS utilizes the System tick timer to generate a time base; it may use any valid priority for an embOS interrupt. Typically, however, using the second-to-lowest priority in the entire system is advised. In this example, it therefore gets configured for a priority of 14.
  • In case your application utilizes further interrupts (that shall use embOS API), please ensure these are configured for valid embOS interrupt priorities as well.

Interrupt handler generation for embOS

STM32CubeMX may generate handlers for specific interrupt sources.

  • Since embOS includes its own handler implementation for the Pendable request for system service, that handler may not be generated by STM32CubeMX. To disable its creation, switch to the Code generation tab and uncheck the Generate IRQ handler checbox for this specific handler.
  • While embOS includes a handler implementation for the System tick timer as well, a seperate handler should be generated by STM32CubeMX. It should call HAL API functions (enable via according checkbox), which we will later use to call embOS' own handler implementation as a callback.
  • In case your application utilizes further interrupts, appropiate handlers for these may be generated as required.

CubeMX ISRGeneration.png

Steps to perform in the IDE and project files

Integrating embOS

After generating the project, open its location in the file system:

CubeMX FileSystem.png

This folder structure may be extended as needed. For the integration of embOS, for example, you may want to add a folder embOS with subfolders Inc, Lib, SEGGER, and Setup.

Subsequently, copy all relevant files from your shipment of embOS (or, alternatively, from an embOS evaluation version) to the created subfolders:

  1. To the Inc folder, copy all files from {SHIPMENT_ROOT}\Start\Inc\:
    1. BSP.h (optional)
    2. BSP_UART.h (optional)
    3. Global.h
    4. JLINKMEM.h
    5. OS_Config.h
    6. RTOS.h
  2. To the Lib folder, copy one appropriate library from {SHIPMENT_ROOT}\Start\Lib\:
    • e.g. for GCC-based projects:
      • libosT7VHLDP.a (debug & profiling build of embOS for ARMv7-M little-endian devices with FPU using the hard floating-point ABI)
      • libosT7VLDP.a (debug & profiling build of embOS for ARMv7-M little-endian devices with FPU using the soft floating-point ABI)
      • libosT7BR.a (release build of embOS for ARMv7-M big-endian devices without FPU)
      • libosT6BDP.a (debug & profiling build of embOS for ARMv6-M big-endian devices)
    • e.g. for IAR-based projects:
      • os7m_tlv_dp.a (debug & profiling build of embOS for ARMv7-M little-endian devices with FPU)
      • os7m_tb__r.a (release build of embOS for ARMv7-M big-endian devices without FPU)
      • os6m_tb__dp.a (debug & profiling build of embOS for ARMv6-M big-endian devices)
    • e.g. for Keil-based projects:
      • osT7VLDP.lib (debug & profiling build of embOS for ARMv7-M little-endian devices with FPU)
      • osT7BR.lib (release build of embOS for ARMv7-M big-endian devices without FPU)
      • osT6BDP.lib (debug & profiling build of embOS for ARMv6-M big-endian devices)
  3. To the SEGGER folder, copy all files from an appropriate board support package, e.g. from {SHIPMENT_ROOT}\Start\BoardSupport\ST\STM32F429_STM32F429I_Discovery\SEGGER\:
    1. SEGGER.h
    2. SEGGER_RTT.c
    3. SEGGER_RTT.h
    4. SEGGER_RTT_ASM_ARMv7M.S (with ARMv7-M devices only)
    5. SEGGER_RTT_Conf.h
    6. SEGGER_RTT_printf.c (optional)
    7. SEGGER_RTT_Syscalls_GCC.c (optional; GCC-specific source file: different name with embOS for IAR and embOS for Keil MDK)
    8. SEGGER_SYSVIEW.c
    9. SEGGER_SYSVIEW.h
    10. SEGGER_SYSVIEW_Conf.h
    11. SEGGER_SYSVIEW_ConfDefaults.h
    12. SEGGER_SYSVIEW_Config_embOS.c
    13. SEGGER_SYSVIEW_embOS.c
    14. SEGGER_SYSVIEW_embOS.h
    15. SEGGER_SYSVIEW_Int.h
  4. To the Setup folder, copy the following *.c-files from an appropriate board support package, e.g. from {SHIPMENT_ROOT}\Start\BoardSupport\ST\STM32F429_STM32F429I_Discovery\Setup\:
    1. BSP.c (optional)
    2. BSP_SDRAM.c (optional)
    3. JLINKMEM_Process.c
    4. OS_Error.c
    5. OS_ThreadSafe.c (GCC-specific source file: different name with embOS for IAR and embOS for Keil MDK)
    6. OS_Syscalls.c (GCC-specific source file: different name with embOS for IAR and embOS for Keil MDK)
    7. RTOSInit_STM32F4xx.c

Open the project and add the folders and files to it. The result should resemble the given example below (which uses the Eclipse-based STM32CubeIDE):

CubeMX ProjectTree.png

In the next step, configure the include paths for embOS header files:

CubeMX Includes.png

Configure the linker settings for the embOS library (required with Eclipse-based IDEs, but not with e.g. IAR):

CubeMX Lib.png CubeMX LibPath.png

Configure the preprocessor options for your application (must match the chosen embOS library configuration):

CubeMX PreProc.png

After these configurations, embOS was fully integrated with the project.

Modifications to the linker file

embOS expects specific symbols in order to retrieve information about stack and heap in your project:

  • __heap_end__
  • __heap_start__
  • __stack_end__
  • __stack_start__

These symbols need to be added to the linker file, which is the generated *.ld-file in the project's root path, as shown below:

CubeMX Linker.png

Also, the reset value of the system stack pointer (contained in the respective project's vector table at offset 0x0) must match the value of __stack_end__.

Merging the embOS tick with the generated SysTick_Handler()

Since STM32CubeMX already initializes the hardware timer and the SysTick interrupt, some configurations inside RTOSInit_*.c must be removed.

Open RTOSInit_*.c and perform the following changes to OS_InitHW():

CubeMX RTOSInit InitHW.png

Furthermore, the SysTick_Handler() for embOS should now be used as a callback for the generated handler. To do so, apply the following modification to RTOSInit_*.c as well:

CubeMX RTOSInit SysTick.png

For the generated handler to actually call the callback function, add the following line to the generated SysTick_Handler() implementation, which can be found in stm32f*_it.c inside the Src folder of the generated project:

CubeMX SysTick Handler.png

Handle duplicate syscalls implementation

The files syscalls.c and sysmem.c should be excluded from build in the project, since their contents are already implemented in OS_Syscalls.c with embOS. The files may be found in the Src folder:

CubeMX Excluded Files.png

Add an embOS application

To use embOS in the project, main.c needs to be modified to include the following:

  1. Inclusion of RTOS.h
  2. Declaration of task control block and task stack
  3. A function which will be run as the task
  4. embOS kernel and task initialization:
    1. OS_Init()
    2. OS_InitHW()
    3. OS_TASK_CREATE(), with task control block, task name, priority, function name and task stack
    4. OS_Start()

The resulting modifications to main.c should therefore resemble the following example:

CubeMX Main embOS.PNG

Subsequently, the application may be compiled and executed in hardware. From here, feel free to modify the initial task, to add further tasks, OS objects and interrupt service routines to create your own embOS application.