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.





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