Renesas Emulator System M3T-MR100, Руководство пользователя

Страница: 104 / 306

- 88 -
wup_tsk Wakeup task
iwup_tsk Wakeup task (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 = wup_tsk( ID tskid );
ER ercd = iwup_tsk( ID tskid );
z
z
P
P
a
a
r
r
a
a
m
m
e
e
t
t
e
e
r
r
s
s
ID tskid ID number of the target task
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) or error code
[ [ [ [ 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
wup_tsk TSKID
iwup_tsk TSKID
z z
P
P
a
a
r
r
a
a
m
m
e
e
t
t
e
e
r
r
s
s
TSKID ID number of the target task
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 ID number of the target task
[ [ [ [ E E r r r r o o r r c c o o d d e e ] ] ] ]
E_OBJ Object status invalid(task indicated by tskid is an inactive state)
E_QOVR Queuing overflow
[ [ [ [ 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 ] ] ] ]
If the task specified by tskid has been placed into WAITING state by slp_tsk or tslp_tsk, this service call wakes up the task
from WAITING state to place it into READY or RUNNING state. Or if the task specified by tskid is in WAIT-
ING-SUSPENDED state, this service call awakes the task from only the sleeping state so that the task goes to SUS-
PENDED state.
If a wakeup request is issued while the target task remains in DORMANT state, the error code E_OBJ is returned to the
service call issuing task. If TSK_SELF is specified for tskid, it means specifying the issuing task itself. If TSK_SELF is
specified for tskid in non-task context, operation of the service call cannot be guaranteed.
If this service call is issued to a task that has not been placed in WAITING state or in WAITING-SUSPENDED state by
execution of slp_tsk or tslp_tsk, the wakeup request is accumulated. More specifically, the wakeup request count for the
target task to be awakened is incremented by 1, in which way wakeup requests are accumulated.
The maximum value of the wakeup request count is 255. If while the wakeup request count = 255 a new wakeup request is
generated exceeding this limit, the error code E_QOVR is returned to the task that issued the service call, with the wakeup
request count left intact.
If this service call is to be issued from task context, use wup_tsk; if issued from non-task context, use iwup_tsk.