13.4 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 number of task information items that can be specified is defined as being within the range of 1 to 127.
Note The CF78V4 outputs to the system information header file the correspondence between the task names and IDs, in the following format. Consequently, task names can be used in the place of IDs by including the relevant system information header file using the processing program.
Specifies the attributes (coding language, initial activation status, initial interrupt status) of the task.
The keywords that can be specified for tskatr are TA_HLNG, TA_ASM, TA_ACT, TA_ENAINT and TA_DISINT.
The keywords that can be specified for tskatr are TA_HLNG, TA_ASM, TA_ACT, TA_ENAINT and TA_DISINT.
Note 1 If specification of TA_ACT is omitted, the initial task activation status is set to the "DORMANT state".
Note 2 If specification of TA_ENAINT and TA_DISINT is omitted, the initial task interrupt status is set to "interrupts acknowledgment enabled".
Specifies the extended information of the task.
Values that can be specified for exinf are from 0 to 1048575, or symbol names written in C.
Values that can be specified for exinf are from 0 to 1048575, or symbol names written in C.
Note exinf is passed as an extended information to the target task when the task is activated by act_tsk or iact_tsk. The target task can therefore handle exinf in the same manner as handling function parameters.
Specifies the start address of the task.
Values that can be specified for task are symbol names written in C.
Values that can be specified for task are symbol names written in C.
Note 1 When a task is in written in C as shown below, the value specified by this item is "func_task".
#include <kernel.h> #include <kernel_id.h> void func_task ( VP_INT exinf ) { /* ............ */ ext_tsk ( ); } |
Note 2 When a task is in written in assembly language as shown below, the value specified by this item is "func_task".
$INCLUDE (kernel.inc) $INCLUDE (kernel_id.inc) .PUBLIC _func_task .SECTION .text, TEXT _func_task: PUSH BC PUSH AX ; ............ BR !!_ext_tsk |
Specifies the initial priority of the task.
Values that can be specified for itskpri are limited to "1 to Priority range: maxtpri".
Values that can be specified for itskpri are limited to "1 to Priority range: maxtpri".
Specifies the stack size (in bytes) of the task.
A value between 0 and 65534, aligned to a 2-byte boundary, can be specified for stksz.
A value between 0 and 65534, aligned to a 2-byte boundary, can be specified for stksz.
Note 2 For details about the estimation of the stack size of the task, refer to See "13.5.2Stack size of the task".