beautypg.com

Renesas Emulator System M3T-MR100 User Manual

Page 112

background image

- 96 -

rsm_tsk

Resume suspended task

irsm_tsk Resume

suspended task(handler only)

frsm_tsk

Forcibly resume suspended task

ifrsm_tsk Forcibly

resume

suspended 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 = rsm_tsk( ID tskid );
ER ercd = irsm_tsk( ID tskid );
ER ercd = frsm_tsk( ID tskid );
ER ercd = ifrsm_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
rsm_tsk TSKID
irsm_tsk TSKID
frsm_tsk TSKID
ifrsm_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 not a forcible 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

]

]

]

]

If the task indicated by tskid has been aborted by sus_tsk, this service call resumes the target task from SUSPENDED state.
In this case, the target task is linked to behind the tail of the ready queue. In the case of frsm_tsk and ifrsm_tsk, the task is
forcibly resumed from SUSPENDED state.

If a request is issued while the target task is not in SUSPENDED state (including DORMANT state), the error code E_OBJ
is returned to the service call issuing task.

The rsm_tsk, irsm_tsk, frsm_tsk, and ifrsm_tsk service calls each operate the same way, because the maximum number of
forcible wait requests that can be nested is 1.

If this service call is to be issued from task context, use rsm_tsk/frsm_tsk; if issued from non-task context, use
irsm_tsk/ifrsm_tsk.