- 166 -
ref_alm Reference
alarm
handler
status
iref_alm
Reference alarm handler status (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 = ref_alm( ID almid, T_RALM *pk_ralm );
ER ercd = iref_alm( ID almid, T_RALM *pk_ralm );
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 target alarm handler
T_RALM
*pk_ralm
Pointer to the packet to which alarm handler status is returned
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)
T_RALM
*pk_ralm
Pointer to the packet to which alarm handler status is returned
Contents of pk_ralm
typedef struct
t_ralm{
STAT
almstat
+0
2
Operating status of alarm handler
RELTIM lefttim
+2
4
This
service call returns various statuses of the alarm handler
indicat
} T_RALM;
[
[
[
[
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
ref_alm ALMID,PK_RALM
iref_alm ALMID,PK_RALM
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 target alarm handler
PK_RALM
Pointer to the packet to which alarm handler status is returned
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 alarm handler
A1
Pointer to the packet to which alarm handler status is returned
[
[
[
[
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 returns various statuses of the alarm handler indicated by almid.
almstat
The status of the target alarm handler is returned.
*TALM_STA
Alarm handler is an operational state.
*TALM_STP
Alarm handler is a non-operational state.
lefttim
The remaining time before the target alarm handler will start next is returned. This time is expressed in ms units.
If the target alarm handler is a non-operational state, the returned value is indeterminate.
If this service call is to be issued from task context, use ref_alm; if issued from non-task context, use iref_alm.
