CMSIS-RTOS2  Version 2.1.0
Real-Time Operating System: API and RTX Reference Implementation
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Create an RTX5 Project

The steps to create a microcontroller application using RTX5 are:

  • Create a new project and select a microcontroller device.
  • In the Manage Run-Time Environment window, select CMSIS::CORE and CMSIS::RTOS2 (API)::Keil RTX5. You can choose to either add RTX as a library (Variant: Library) or to add the full source code (Variant: Source - required if using the Event Recorder):

    manage_rte_output.png
  • If the Validation Output requires other components to be present, try to use the Resolve button.
  • Click OK. In the Project window, you will see the files that have been automatically added to you project, such as RTX_Config.h, RTX_Config.c, the library or the source code files, as well as the system and startup files:

    project_window.png
  • You can add template files to the project by right-clicking on Source Group 1 and selecting Add New Item to 'Source Group 1'. In the new window, click on User Code Template. On the right-hand side you will see all available template files for CMSIS-RTOS RTX:

    add_item.png
  • Configure RTX5 to the application's needs using the RTX_Config.h file.

Add support for RTX specific functions

If you require some of the RTX specific functions in your application code, #include the header file rtx_os.h. This enables low-power and tick-less operation modes.

Add Event Recorder Visibility

  • To use the Event Recorder together with RTX5, select the software component Compiler:Event Recorder.
  • Select the Source variant of the software component CMSIS:RTOS2 (API):Keil RTX5.
    event_recorder_rte.png
    Component selection for Event Recorder
  • Call the function EventRecorderInitialize() in your application code (ideally in main()).
  • Build the application code and download it to the debug hardware.

Once the target application generates event information, it can be viewed in the µVision debugger using the Event Recorder.