beautypg.com

Renesas Emulator System M3T-MR100 User Manual

Page 108

background image

- 92 -

rel_wai

Release task from waiting

irel_wai

Release task from waiting (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 = rel_wai( ID tskid );
ER ercd = irel_wai( 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
rel_wai TSKID
irel_wai 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 not an wait state)

[

[

[

[

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

]

]

]

]

This service call forcibly release the task indicated by tskid from waiting (except SUSPENDED state) to place it into
READY or RUNNING state. The forcibly released task returns the error code E_RLWAI. If the target task has been en-
queued in some waiting queue, the task is dequeued from it by execution of this service call.

If this service call is issued to a task in WAITING-SUSPENDED state, the target task is released from WAITING state and
goes to SUSPENDED state.

34

If the target task is not in WAITING state, the error code E_OBJ is returned. This service call forbids specifying the issuing
task itself for tskid.

If this service call is to be issued from task context, use rel_wai; if issued from non-task context, use irel_wai.

34

This means that tasks cannot be resumed from SUSPENDED state by this service call. Only the rsm_tsk, irsm_tsk, frsm_tsk, and

ifrsm_tsk service calls can release them from SUSPENDED state.