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 Embedded Linux

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	1
RiCOSDefaultThreadPriority	(long) RTOS_PRIORITY_NORMAL
RiCOSDefaultStackSize	(long) RTOS_DEFAULT_STACK
RiCOSDefaultMessageQueueSize	(long) RTOS_MQ_DEFAULT_SIZE
RTOS_PRIORITY_NORMAL	46
RTOS_PRIORITY_HIGH	98
RTOS_PRIORITY_LOW	1
RTOS_DEFAULT_STACK	256
RTOS_MQ_DEFAULT_SIZE	8
RTOS_MAIN_STK_SIZE	512
RTOS_SCHEDULING_POLICY	SCHED_FIFO
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 is defined.

WSTRTOS.c

This file is used in the GettingStarted example. It implements the following functions:

WSTRTOS_Init	Is implemented as initializing thread attributes for the main thread MainTask and creating it. Any further threads will be joining the main thread. MainTask() will set its priority to RTOS_PRIOITY_NORMAL and call the Rhapsody generated function WST_RXF_Main() to start your application.
WSTRTOS_Cleanup	This function is left empty.