17.5 Static API Information
The following describes the format that must be observed when describing the static API information in the system configuration file.
The GOTHIC-FONT characters in following descriptions are the reserved words, and italic face characters are the portion that the user must write the relevant numeric value, symbol name, or keyword.
The task information defines ID number: tskid, Attribute: tskatr, Extended information: exinf, Start address: task, Initial priority: itskpri, Task stack size: stksz, memory area name: sec_nam, Reserved for future use: stk for a task.
Note When a name is specified, the CF850V4 automatically assigns an ID number.
The CF850V4 outputs the relationship between a name and an ID number to the system information header file in the following format:
The CF850V4 outputs the relationship between a name and an ID number to the system information header file in the following format:
#define tskid value
Specifies the attribute for a task.
The keyword that can be specified for tskatr is TA_HLNG, TA_ASM, TA_ACT, TA_DISPREEMPT, TA_ENAINT and TA_DISINT.
The keyword that can be specified for tskatr is TA_HLNG, TA_ASM, TA_ACT, TA_DISPREEMPT, TA_ENAINT and TA_DISINT.
TA_ENAINT: Acceptance of EI level maskable interrupts (from the Maximum interrupt priority: maxintpri to the minimum interrupt priority) is enabled.
TA_DISINT: Acceptance of EI level maskable interrupts (from the Maximum interrupt priority: maxintpri to the minimum interrupt priority) is disabled.
Note 1 If specification of TA_ACT is omitted, the DORMANT state is specified as the initial activation state.
Note 3 If specifications of TA_ENAINT and TA_DISINT are omitted, EI level maskable interrupts (from the Maximum interrupt priority: maxintpri to the minimum interrupt priority) are enabled in the initial state.
Specifies the extended information for a task.
A value from 0x0 to 0xffffffff, or a symbol name, can be specified for exinf.
A value from 0x0 to 0xffffffff, or a symbol name, can be specified for exinf.
Note The target task can be manipulated by handling the extended information as if it were a function parameter.
Specifies the start address for a task.
A value from 0x0 to 0xfffffffe (aligned to a 2-byte boundary), or a symbol name, can be specified for task.
A value from 0x0 to 0xfffffffe (aligned to a 2-byte boundary), or a symbol name, can be specified for task.
#include <kernel.h> #include <kernel_id.h> void func_task ( VP_INT exinf ) { ............ ............ ext_tsk ( ); } |
Specifies the initial priority for a task.
A value from "0x1 to Maximum priority: maxtpri defined in the Basic information" can be specified for itskpri.
A value from "0x1 to Maximum priority: maxtpri defined in the Basic information" can be specified for itskpri.
Specifies the task stack size (unit: bytes) and the name of the memory area secured for the task stack.
Only 4-byte boundary values from 0x0 to 0x7ffffffc can be specified for stksz, and only memory area name sec_nam defined in Memory area information" can be specified for sec_nam.
Only 4-byte boundary values from 0x0 to 0x7ffffffc can be specified for stksz, and only memory area name sec_nam defined in Memory area information" can be specified for sec_nam.
Note 1 If specification of sec_nam is omitted, the task stack is allocated to ".kernel_work" section.
Note 2 The stack size that is actually secured is calculated as the specified stack size plus "ctxsz (size of context area of interrupt handler)". See 2 Task stack for details about ctxsz.