Renesas M3T-MR100 Network Card User Manual


 
- 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.