Interfaces RTOS


Each product has a number of interfaces, see the image below:



We focus on the interface to the RTOS - please refer to the description on all interfaces on details for non-RTOS interfaces. All RXF source files always include WSTRTOS.h

Example:

#include "RxfConstants.h"
#include "WSTProduct.h"
#include "WSTProlog.h"
#include "WSTCompiler.h"
#include "WSTTarget.h"
#include "WSTRTOS.h"
#include "WSTPMF.h"
#include "RxfDimensions.h"

..  (include files for ANSI-C like stddef.h, include files for RXF)

#include "WSTEpilog.h"


Interface RTOS implementation CMX-RTX


Files Description
WSTRTOS.h This file defines the following functions:
  • WSTRTOS_Init
This function is called as second call in RiCOXFInit(), which is the first call generated by Rhapsody in WST_RXF_Main(). So this is the place to hook code into when your RTOS is not already initialized by your startup code, prior to calling main().

Its prototype is:

void     WSTRTOS_Init( void );
  • WSTRTOS_Cleanup
This function is not called by the RXF.
You must implement it and call it in your <Rhapsody component>__Cleanup() if you need it.

Its prototype is:

void     WSTRTOS_Cleanup( void );
         
This file defines the following macros:
  • RIC_MS_PER_TICK
10
  • RiCOSDefaultThreadPriority
(long) RTOS_PRIORITY_NORMAL
  • RiCOSDefaultStackSize
(long) RTOS_DEFAULT_STACK
  • RiCOSDefaultMessageQueueSize
(long) RTOS_MQ_DEFAULT_SIZE
  • RTOS_PRIORITY_NORMAL
120
  • RTOS_PRIORITY_ABOVE_NORMAL
130
  • RTOS_PRIORITY_HIGH
255
  • RTOS_PRIORITY_LOW
0
  • RTOS_DEFAULT_STACK
(long) 256
  • RTOS_MQ_DEFAULT_SIZE
(long) 32
  • WST_MAIN_STK_SIZE
512
  • RiC_RAW_MEMORY_ALIGNMENT
16
  • RiCOSMemoryAllocation_malloc
malloc is mapped to this function
  • RiCOSMemoryAllocation_calloc
calloc is mapped to this function
  • RiCOSMemoryAllocation_realloc
realloc is mapped to this function
  • RiCOSMemoryAllocation_free
free is mapped to this function

The constants RIC_OS_MUTEX_LOCK_AS_OPERATION and RIC_OS_MUTEX_FREE_AS_OPERATION are defined.
WSTRTOS.c This file is used in the GettingStarted example. It implements the following functions:
  • WSTRTOS_Init
Is implemented as:
  • a call to RiCOSMemoryAllocation_Init()
  • a call to RiCOSMutex_InitSysVars() to initialize the mutexes used by CMX-RTX
  • a call to K_OS_Init() to initialize CMX-RTX
  • a creation and activation of the MainTask() in which your Rhapsody model is launched
  • initialization of a timer T0; we use t0_handler as ISR to call the CMX-RTX function K_OS_Tick_Update() at a regular interval
  • finally the activation of CMX-RTX using K_OS_Start().
  • t0_handler
This is an ISR which calls K_OS_Tick_Update() peridically.
  • WSTRTOS_Cleanup
This function is left empty.





Copyright (c) Willert Software Tools GmbH. All rights reserved.