RTEMS Ada User's Guide
procedure Task_Create ( Name : in RTEMS.Name; Initial_Priority : in RTEMS.Task_Priority; Stack_Size : in RTEMS.Unsigned32; Initial_Modes : in RTEMS.Mode; Attribute_Set : in RTEMS.Attribute; ID : out RTEMS.ID; Result : out RTEMS.Status_Codes );
RTEMS.SUCCESSFUL - task created successfully
RTEMS.INVALID_NAME - invalid task name
RTEMS.INVALID_SIZE - stack too small
RTEMS.INVALID_PRIORITY - invalid task priority
RTEMS.MP_NOT_CONFIGURED - multiprocessing not configured
RTEMS.TOO_MANY - too many tasks created
RTEMS.UNSATISFIED - not enough memory for stack/FP context
RTEMS.TOO_MANY - too many global objects
This directive creates a task which resides on the local node.
It allocates and initializes a TCB, a stack, and an optional
floating point context area. The mode parameter contains values
which sets the task's initial execution mode. The
RTEMS.FLOATING_POINT attribute should be
specified if the created task
is to use a numeric coprocessor. For performance reasons, it is
recommended that tasks not using the numeric coprocessor should
attribute is specified, the task can be accessed from remote
nodes. The task id, returned in id, is used in other task
related directives to access the task. When created, a task is
placed in the dormant state and can only be made ready to
execute using the directive
This directive will not cause the calling task to be preempted.
Valid task priorities range from a high of 1 to a low of 255.
The requested stack size should be at least
bytes. The value of
is processor dependent.
Application developers should consider the stack usage of the
device drivers when calculating the stack size required for
tasks which utilize the driver.
The following task attribute constants are defined by RTEMS:
RTEMS.NO_FLOATING_POINT- does not use coprocessor (default)
RTEMS.FLOATING_POINT- uses numeric coprocessor
RTEMS.LOCAL- local task (default)
RTEMS.GLOBAL- global task
The following task mode constants are defined by RTEMS:
RTEMS.PREEMPT- enable preemption (default)
RTEMS.NO_PREEMPT- disable preemption
RTEMS.NO_TIMESLICE- disable timeslicing (default)
RTEMS.TIMESLICE- enable timeslicing
RTEMS.ASR- enable ASR processing (default)
RTEMS.NO_ASR- disable ASR processing
RTEMS.INTERRUPT_LEVEL(0)- enable all interrupts (default)
RTEMS.INTERRUPT_LEVEL(n)- execute at interrupt level n
The interrupt level portion of the task execution mode supports a maximum of 256 interrupt levels. These levels are mapped onto the interrupt levels actually supported by the target processor in a processor dependent fashion.
Tasks should not be made global unless remote tasks must interact with them. This avoids the system overhead incurred by the creation of a global task. When a global task is created, the task's name and id must be transmitted to every node in the system for insertion in the local copy of the global object table.
The total number of global objects, including tasks, is limited by the maximum_global_objects field in the Configuration Table.
RTEMS Ada User's Guide
Copyright © 1988-2004 OAR Corporation