19.4 System Information (system)
Here, information on the system whole is defined.

Only one "system" can be defined. And the "system" can not be omitted.

Format

Parentheses < >show the user input part.

 system {
     stack_size  = <1. System stack size (stack_size)>;
     priority    = <2. Maximum task priority (priority)>;
     system_IPL  = <3. Kernel interrupt mask level (system_IPL)>;
     message_pri = <4. Maximum message priority (message_pri)>;
     tic_deno    = <5. Denominator of base clock interval time (tic_deno)>;
     tic_nume    = <6. Numerator of base clock interval time (tic_nume)>;
     context     = <7. Task context register (context)>;
 };


1 ) System stack size (stack_size)

- Description
Define the total stack size used in service call processing and interrupt processing.


- Definition format
Numeric value


- Definition range
More than 8, and multiple of 4.


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


2 ) Maximum task priority (priority)

- Description
Define the maximum task priority.


- Definition format
Numeric value


- Definition range
1 - 255


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


- TMAX_TPRI
The cfg600 outputs the macro TMAX_TPRI which defines this setting to the system information header file "kernel_id.h".

3 ) Kernel interrupt mask level (system_IPL)

- Description
Define the interrupt mask level when the kernel's critical section is executed (PSW register's IPL value). Interrupts with higher priority levels than that are handled as "non-kernel interrupts".
For details of "non-kernel interrupts" and "kernel interrupts", refer to "10.1 Interrupt Type".



- Definition format
Numeric value


- Definition range
1 - 15


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


- VTKNL_LVL
The cfg600 outputs the macro VTKNL_LVL which defines this setting to the system information header file "kernel_id.h".

4 ) Maximum message priority (message_pri)

- Description
Define the maximum message priority used in the mailbox function. Note that if the mailbox function is not used, this definition item has no effect.


- Definition format
Numeric value


- Definition range
1 - 255


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


- TMAX_MPRI
The cfg600 outputs the macro TMAX_MPRI which defines this setting to the system information header file "kernel_id.h".

5 ) Denominator of base clock interval time (tic_deno)

- Description
The base clock interval time is calculated by the following expression. Either tic_deno or tic_nume should be 1.


The base clock interval time (in millisecond) = tic_nume / tic_deno

- Definition format
Numeric value


- Definition range
1 - 100


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


- TIC_DENO
The cfg600 outputs the macro TIC_DENO which defines this setting to the system information header file "kernel_id.h".

6 ) Numerator of base clock interval time (tic_nume)

- Description
See above.


- Definition format
Numeric value


- Definition range
1 - 65535


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


- TIC_NUME
The cfg600 outputs the macro TIC_NUME which defines this setting to the system information header file "kernel_id.h".

7 ) Task context register (context)

- Description
Define the register set used by tasks. The settings made here apply to all tasks.


- Definition format
Symbol


- Definition range
Select one from item of "Setting" in Table 19-2.


Table 19-2 system.context

Setting

CPU

FPU

DSP

PSW, PC, R0 - R7, R14, R15

R8 - R13

FPSW

Accumulator 1

NO

Guaranteed

Guaranteed

Not guaranteed

Not guaranteed

FPSW

Guaranteed

Guaranteed

Guaranteed

Not guaranteed

ACC

Guaranteed

Guaranteed

Not guaranteed

Guaranteed

FPSW,ACC

Guaranteed

Guaranteed

Guaranteed

Guaranteed

MIN

Guaranteed

Not guaranteed

Not guaranteed

Not guaranteed

MIN,FPSW

Guaranteed

Not guaranteed

Guaranteed

Not guaranteed

MIN,ACC

Guaranteed

Not guaranteed

Not guaranteed

Guaranteed

MON,FPSW,ACC

Guaranteed

Not guaranteed

Guaranteed

Guaranteed

1
When compiler option "-isa=rxv2" is specified, the "Accumulator" means ACC0 register and ACC1 register. In the case of others, the "Accumulator" means ACC0 register (in RXv2 architecture) or ACC register (in RXV1 architecture).





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: NO) applied.


- Note
Be sure to refer to "19.5 Note Concerning system.context".