19.7 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)>; };

1 ) ID number

- Description
Define the task ID number.

- Definition format
Numeric value

- Definition range
From 1 to 255

- When omitting
The cfg600 assigns the ID number automatically.

- Note
The ID numbers must be assigned without an omission beginning with 1. Therefore, when specifying an ID number, be sure that the specified value is equal to or less than the number of objects defined.

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.

Table 19-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 cfg600 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.

- 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.