beautypg.com

Renesas Emulator System M3T-MR100 User Manual

Page 179

background image

- 163 -

sta_alm

Start alarm handler operation

ista_alm

Start alarm handler operation (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 = sta_alm( ID almid, RELTIM almtim );
ER ercd = ista_alm( ID almid, RELTIM almtim );

z

z

P

P

a

a

r

r

a

a

m

m

e

e

t

t

e

e

r

r

s

s

ID

almid

ID number of the alarm handler to be operated

RELTIM almtim

Alarm

handler

startup time (relative time)

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
sta_alm ALMID,ALMTIM
ista_alm ALMID,ALMTIM

z

z

P

P

a

a

r

r

a

a

m

m

e

e

t

t

e

e

r

r

s

s

ALMID

ID number of the alarm handler to be operated

ALMTIM

Alarm handler startup time (relative time)

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 alarm handler to be operated

R6R4

Alarm handler startup time (relative time)

[

[

[

[

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

]

]

]

]

This service call sets the activation time of the alarm handler indicated by almid as a relative time of day after the lapse of
the time specified by almtim from the time at which it is invoked, and places the alarm handler into an operational state.

If an already operating alarm handler is specified, the previously set activation time is cleared and updated to a new activa-
tion time. If almtim = 0 is specified, the alarm handler starts at the next time tick. The values specified for almtim must be
within (0x7FFFFFFF – time tick value). If any value exceeding this limit is specified, the service call may not operate cor-
rectly. If 0 is specified for almtim , the alarm handler is started at the next time tick.

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