20.12 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 cfg600px assigns the ID number automatically.

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 current priority order
Among tasks with the same current priority, they are queued in FIFO order.

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