Run Usage

Run can be used to run an eRTOS application.

Note: Run cannot be used to start the Network Link Layer (NL2), TCP/IP Stack, or USB Stack.

Usage

Run [/a affinity_mask] [/e expand_size] [/i initial_size] [/r start | firstalloc] [/p ideal_processor] filename.ertos [args]

Parameters

/a (1,2,...,63)

Affinity mask - specifies the processor affinity mask, as a list of comma-separated processor numbers, for the real-time application about to run.

Use integers or hexadecimal values to identify the processors.

/e expand_size

The amount of memory, in kilobytes, by which to expand the process MSpace.

Note: If this parameter is omitted, the process will use the globally configured value.

/i initial_size

The initial amount of local memory (allocated at process startup), in kilobytes, within the process external MSpace.

Note: If this parameter is omitted, the process will use the globally configured value.

/p n

Ideal processor - sets the ideal processor for the real-time application about to run. Use an integer or hexadecimal value to identify the processor.

Note: If the processor affinity mask is specified by /a, then the ideal processor set by /p must be one of the processors specified in the affinity mask.

/r start | firstalloc

The time of allocation of the process external MSpace. This switch requires one of these valid arguments:

start - allocates the MSpace at process start
firstalloc - allocates the MSpace at the first memory request

Note: If this parameter is omitted, the process external MSpace will be allocated when the first allocation request which uses that MSpace occurs.

filename

A simple file name, relative pathname, or absolute pathname to the RTSS application.

[args]

Parameters to the real-time application being run.

Examples

Syntax	Description
Run /p 2 srtm.ertos /n 2 /f /h 60 Run /p 3 srtm.ertos /n 2 /f /h 60	If multiple cores are available, you can run instances of srtm.ertos on each processor to measure their latencies. Note: /n 2 /f /h 60 are arguments for srtm.ertos. See Using SRTM for more information.
Run /a (2,3) sample.ertos	Runs sample.ertos and specifies that the process thread will only run on processors 2 and 3.
Run /a (1,2) /p 2 srtm.ertos	Runs sample.ertos and specifies that the process thread will only run on processors 1 and 2 while setting the ideal processor to 2.

Syntax

Description

Run /p 2 srtm.ertos /n 2 /f /h 60

Run /p 3 srtm.ertos /n 2 /f /h 60

If multiple cores are available, you can run instances of srtm.ertos on each processor to measure their latencies.

Note: /n 2 /f /h 60 are arguments for srtm.ertos. See Using SRTM for more information.

Run /a (2,3) sample.ertos

Runs sample.ertos and specifies that the process thread will only run on processors 2 and 3.

Run /a (1,2) /p 2 srtm.ertos

Runs sample.ertos and specifies that the process thread will only run on processors 1 and 2 while setting the ideal processor to 2.