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 DSP/BIOS

Files

Description

WSTRTOS.h

This file defines the following functions:

WSTRTOS_Init	This function is called in main() which is before rhpMainTask() is activated by DSP/BIOS which calls the function WST_RXF_Main(), generated by Rhapsody. The function WST_RXF_Main() is your Rhapsody model running on the Willert Framework. 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 (default value of ?)
RiCOSDefaultThreadPriority	(long) RTOS_PRIORITY_NORMAL
RiCOSDefaultStackSize	(long) RTOS_DEFAULT_STACK
RiCOSDefaultMessageQueueSize	(long) RTOS_MQ_DEFAULT_SIZE
RTOS_PRIORITY_NORMAL	7
RTOS_PRIORITY_ABOVE_NORMAL	8
RTOS_PRIORITY_HIGH	15
RTOS_PRIORITY_LOW	1
RTOS_DEFAULT_STACK	256
RTOS_MQ_DEFAULT_SIZE	32
WST_BRIDGE_STK_SIZE	256
RTOS_MEM_TASK_STACK_SEGMENT	L47SARAM
RTOS_MEM_HEAP_SEGMENT	L47SARAM
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 constant 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 RiCOSMutex_InitSysVars() in RiCOSDSPBIOS.cand RiCOSMemoryAllocation_Init() in RiCOSDimMemoryAllocation.c
WSTRTOS_Cleanup	This function is left empty.