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.