20.10 Task Information (task[])
Here, each task is defined.

Format

Parentheses < >show the user input part.

 task[ <1. ID number> ] {
     name          = <2. ID name (name)>;
     entry_address = <3. Task entry address (entry_addreess)>;
     stack_size    = <4. User stack size (stack_size)>;
     stack_section = <5. Section name assigned to the stack area (stack_section)>;
     priority      = <6. Task initial priority (priority)>;
     initial_start = <7. TA_ACT attribute (initial_start)>;
     exinf         = <8. Extended information (exinf)>;
     texrtn        = <9. Task exception handling routine entry address (texrtn)>;
     domain_num    = <10. Belonging domain ID (domain_num)>;
 };


1 ) ID number

- Description
Define the task ID number.


- Definition format
Numeric value


- Definition range
From 1 to 255


- When omitting
The cfg600px assigns the ID number automatically.


2 ) ID name (name)

- Description
Define the ID name. The specified ID name is output to the system information header file (kernel_id.h) in the form of the following.


 #define   <ID name>   <ID number>
- Definition format
Symbol


- Definition range
-


- When omitting
Cannot be omitted.


3 ) Task entry address (entry_addreess)

- Description
Define the starting function of the task.


- Definition format
Symbol


- Definition range
-


- When omitting
Cannot be omitted.


4 ) User stack size (stack_size)

- Description
Define the user stack size.


- Definition format
Numeric value


- Definition range
More than the following values, and multiple of 16.


Table 20-8 Lower Bound Value of User Stack Size

Setting of system.context

Compiler option "-isa"

Lower bound value

NO

-

68

FPSW

-

72

ACC

"-isa=rxv2"

92

"-isa=rxv1" or not specify "-isa"

76

FPSW,ACC

"-isa=rxv2"

96

"-isa=rxv1" or not specify "-isa"

80

MIN

-

44

MIN,FPSW

-

48

MIN,ACC

"-isa=rxv2"

68

"-isa=rxv1" or not specify "-isa"

52

MON,FPSW,ACC

"-isa=rxv2"

72

"-isa=rxv1" or not specify "-isa"

56



Note Compiler option "-isa" is supported by the compiler CC-RX V2.01 or later.

- When omitting
The set value in the default system configuration file (factory setting: 256) applied.


5 ) Section name assigned to the stack area (stack_section)

- Description
Define the section name to be assigned to the user stack area.
The cfg600px generates the user stack area with the size specified by stack_size to the section specified by stack_section. The section attribute is "DATA", and the alignment number is 4.
When linking, be sure to locate this section in the RAM area. Note, this section must not be located to address 0.
Since this section should be started from 16-bytes boundary address, specify "aligned_section" linker option at linking.





- Definition format
Symbol


- Definition range
-


- When omitting
The set value in the default system configuration file (factory setting: "SURI_STACK") applied.


6 ) Task initial priority (priority)

- Description
Define the task initial priority.


- Definition format
Numeric value


- Definition range
From 1 to Maximum task priority (priority) in System Information (system)


- When omitting
The set value in the default system configuration file (factory setting: 1) applied.


7 ) TA_ACT attribute (initial_start)

- Description
Define the initial state of the task.


- Definition format
Symbol


- Definition range
Select either of the following:


ON: Specify the TA_ACT attribute. (The initial state is READY state.)

OFF: Not Specify the TA_ACT attribute. (The initial state is DORMANGT state.)

- When omitting
The set value in the default system configuration file (factory setting: "OFF") applied.


8 ) Extended information (exinf)

- Description
Define the extended information of the task.


- Definition format
Numeric value


- Definition range
From 0 to 0xFFFFFFFF


- When omitting
The set value in the default system configuration file (factory setting: 0) applied.


- Note
When the task is activated by the TA_ACT attribute, act_tsk or iact_tsk, the extended information is passed to the task.


9 ) Task exception handling routine entry address (texrtn)

- Description
Define the starting function of the task exception handling routine. To not define task exception handling routine, do not define texrtn.


- Definition format
Symbol


- Definition range
-


- When omitting
The task exception handling routine is not defined.


10 ) Belonging domain ID (domain_num)

- Description
Define the ID number of the domain by which the task belongs.


- Definition format
Numeric value


- Definition range
From 1 to 15


- When omitting
The set value in the default system configuration file (factory setting: 1) applied.