Aim MIL-STD-1553 - Apicmdrtmsgread

MIL-STD-1553 Reference Manual
300
Chapter 8 – Remote Terminal Functions
8.1.15 ApiCmdRTMsgRead
Prototype:
AiInt16 ApiCmdRTMsgRead ( AiUInt32 ul_ModuleHandle, AiUInt8 biu, AiUInt8 rt_addr,
TY_API_RT_MSG_DSP *pmsg_dsp );
Driver Command:
API_RT_MSG_READ (0x9B)
Purpose:
This function is used to read the current execution status of the specified Remote
Terminal number including the RT’s Next/Last Status word, Last Command word and
message and error counter.
I
I
n
n
p
p
u
u
t
t
A
A
i
i
U
U
I
I
n
n
t
t
8
8
r
r
t
t
_
_
a
a
d
d
d
d
r
r
Value
Description
0..31
Remote Terminal Address
O
O
u
u
t
t
p
p
u
u
t
t
T
T
Y
Y
_
_
A
A
P
P
I
I
_
_
R
R
T
T
_
_
M
M
S
S
G
G
_
_
D
D
S
S
P
P
*
*
p
p
m
m
s
s
g
g
_
_
d
d
s
s
p
p
RT Message Status information
typedef struct ty_api_rt_msg_dsp
{
AiUInt16 nxw;
AiUInt16 lsw;
AiUInt16 lcw;
AiUInt32 msg_cnt;
AiUInt32 err_cnt;
} TY_API_RT_MSG_DSP;
A
A
i
i
U
U
I
I
n
n
t
t
1
1
6
6
n
n
x
x
w
w
Next Status Word – See Figure 9-1.
A
A
i
i
U
U
I
I
n
n
t
t
1
1
6
6
l
l
s
s
w
w
Last Status Word transmitted – See Figure 9-1.
A
A
i
i
U
U
I
I
n
n
t
t
1
1
6
6
l
l
c
c
w
w
Last Command Word received – See Figure 9-2.
A
A
i
i
U
U
I
I
n
n
t
t
3
3
2
2
m
m
s
s
g
g
_
_
c
c
n
n
t
t
Number of messages transferred –
A
A
i
i
U
U
I
I
n
n
t
t
3
3
2
2
e
e
r
r
r
r
_
_
c
c
n
n
t
t
Number of message errors detected .
Note: msg_cnt and err_cnt are
cleared on restart of the
AIM board Remote
Terminals when the
ApiCmdRTStart'
function is called.