19.9 Eventflag Information (flag[])

Here, each semaphore is defined.

Format

Parentheses < >show the user input part.

flag[ <1. ID number> ] { name = <2. ID name (name)>; initial_pattern = <3. Initial bit pattern (initial_pattern)>; wait_multi = <4. Multiple wait permission attribute (wait_multi)>; clear_attribute = <5. Clear attribute (clear_attribute)>; wait_queue = <6. Wait queue attribute (wait_queue)>; };

1 ) ID number

- Description
Define the eventflag 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 ) Initial bit pattern (initial_pattern)

- Description
Define the initial bit pattern

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

4 ) Multiple wait permission attribute (wait_multi)

- Description
Define the attribute regarding whether multiple tasks are permitted to wait for the eventflag.

- Definition format
Symbol

- Definition range
Select either of the following:

TA_WSGL: Not permit multiple tasks to wait for the eventflag.

TA_WMUL: Permit multiple tasks to wait for the eventflag.

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

5 ) Clear attribute (clear_attribute)

- Description
Define the clear attribute (TA_CLR).

- Definition format
Symbol

- Definition range
Select either of the following:

NO: Not specify the TA_CLR attribute.

YES: Specify the TA_CLR attribute.

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

6 ) Wait queue attribute (wait_queue)

- Description
Define the wait queue attribute.

- Definition format
Symbol

- Definition range
Select either of the following: However, when the TA_CLR attribute is not specified, the wait queue is managed in the FIFO order even if TA_TPRI is specified for wait_queue. This behavior falls outside mITRON4.0 specification.

TA_TFIFO: FIFO order

TA_TPRI: Task priority order
Among tasks with the same priority, they are queued in FIFO order.

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