Setting up of microRTS main thread and task stack size

Category |  Purpose |  Intended Audience |  Applicable to |  Description |  Limitations |  See also


Category:

Top

Micro-RTS


Applicable to:

Top

All Versions

Applicable to the following Platforms: VxWorks, pSOS, VRTX


Purpose:

Top

Provide information on setting of the microRTS main thread/task stack size in some of the supported RTOS platforms.


Intended Audience:

Top

Developers targeting for VxWorks, pSOS, VRTX


Description:

Top

The ObjecTime Toolset provides a way, via the Threads Setup, to specify the priority and stack size of the various ObjecTime tasks/threads. In most cases, for RTOSes such as VxWorks, pSOS, and VRTX, the Main Thread's stack size is unalterable and is assigned default values (specified during configuration of the RTOS kernel). On the other hand, the Main Thread's priority is set/changed after the MicroRTS model has been started on VxWorks, pSOS, and VRTX.

On VxWorks 5.2, the user's MicroRTS model can be started in two ways: running directly in the VxWorks shell or by spawning a task to run it. When running in the VxWorks shell (entering rtsMain at the shell prompt), the MicroRTS' Main Thread is run within the context of the shell's task; therefore, the MicroRTS model uses the shell's stack and priority. Using the spawn command, sp, the model is started within its own task with a default stack size and priority (default values are specified when configuring the VxWorks kernel). Using the spawn command, taskSpawn, the model is also run in its own task, but the task's stack size and priority are specified with the taskSpawn command.

For pSOS, the Main Thread's pSOS task name is by default, "ROOT". It's stack size is specified in the pSOS configuration file, sys_conf.h. When a task is used to spawn a new task (for example: "NEW1") to start/run the MicroRTS Model, then that new task's name should be specified in the MicroRTS rtsconfig.h file and the MicroRTS pSOS Libraries should be rebuilt.

Similarly for VRTX, the MicroRTS's Main Thread can be spawned via a debugger (xRAY) or a remote shell (xsh), in which case the task stack size is that which is defined as the default for the kernel configuration. If the Main Thread is spawned via an existing application task, then the task stack size can be specifed upon task creation.


Limitations:

Top

None


See also:

Top

MicroRTS System Description document


 

Copyright © 1999, ObjecTime Limited.