Renesas Emulator System M3T-MR100, User Manual

Page: 125 / 306

- 109 -
set_flg Set eventflag
iset_flg Set eventflag (handler only)
[
[
[
[
C
C
L
L
a
a
n
n
g
g
u
u
a
a
g
g
e
e
A
A
P
P
I
I
]
]
]
]
ER ercd = set_flg( ID flgid, FLGPTN setptn );
ER ercd = iset_flg( ID flgid, FLGPTN setptn );
z
z
P
P
a
a
r
r
a
a
m
m
e
e
t
t
e
e
r
r
s
s
ID flgid ID number of the eventflag to be set
FLGPTN setptn Bit pattern to be set
z z
R
R
e
e
t
t
u
u
r
r
n
n
P
P
a
a
r
r
a
a
m
m
e
e
t
t
e
e
r
r
s
s
ER ercd Terminated normally (E_OK)
[
[
[
[
A
A
s
s
s
s
e
e
m
m
b
b
l
l
y
y
l
l
a
a
n
n
g
g
u
u
a
a
g
g
e
e
A
A
P
P
I
I
]
]
]
]
.include mr100.inc
set_flg FLGID,SETPTN
iset_flg FLGID,SETPTN
z z
P
P
a
a
r
r
a
a
m
m
e
e
t
t
e
e
r
r
s
s
FLGID ID number of the eventflag to be set
SETPTN Bit pattern to be set
z
z
R R e e g g i i s s t t e e r r c c o o n n t t e e n n t t s s a a f f t t e e r r s s e e r r v v i i c c e e c c a a l l l l i i s s i i s s s s u u e e d d
Register name Content after service call is issued
R0 Error code
R2 Eventflag ID number
A1 Bit pattern to be set
[ [ [ [ E E r r r r o o r r c c o o d d e e ] ] ] ]
None
[
[
[
[
F
F
u
u
n
n
c
c
t
t
i
i
o
o
n
n
a
a
l
l
d
d
e
e
s
s
c
c
r
r
i
i
p
p
t
t
i
i
o
o
n
n
]
]
]
]
Of the 32-bit eventflag indicated by flgid, this service call sets the bits indicated by setptn. In other words, the value of the
eventflag indicated by flgid is OR’d with setptn. If the alteration of the eventflag value results in task-awaking conditions
for a task that has been kept waiting for the eventflag by the wai_flg or twai_flg service call becoming satisfied, the task is
released from WAITING state and placed into READY or RUNNING state.
Task-awaking conditions are evaluated sequentially beginning with the top of the waiting queue. If TA_WMUL is specified
as an eventflag attribute, multiple tasks kept waiting for the eventflag can be released from WAITING state at the same
time by one set_flg or iset_flg service call issued. Furthermore, if TA_CLR is specified for the attribute of the target event-
flag, all bit patterns of the eventflag are cleared, with which processing of the service call is terminated.
If all bits specified in setptn are 0, no operation will be performed for the target eventflag, in which case no errors are as-
sumed, however.
If this service call is to be issued from task context, use set_flg; if issued from non-task context, use iset_flg.