Aim MIL-STD-1553 - Apicmdtrackdefex

MIL-STD-1553 Reference Manual
122
Chapter 3 – System Functions
3.1.28 ApiCmdTrackDefEx
Prototype:
AiInt16 ApiCmdTrackDefEx ( AiUInt32 ul_ModuleHandle, AiUInt8 biu,
TY_API_TRACK_DEF_IN x_TrackDefIn,
TY_API_TRACK_DEF_OUT *px_TrackDefOut );
Driver Command:
API_TRACK_DEF (0x2C)
Purpose:
This function provides a method for the user to continually store up to 32 words (Track)
from pre-defined 1553 Data message transfers received at either the BC or RT.
Storage will occur in a Track Multiplex Buffer at the Track Multiplex Buffer Index
contained within the 1553 Data message. This function is used to define up to 32 Track
Multiplex Buffers and the Track and Track Multiplex Buffer Index length and locations
within the 1553 Data message. The Target software will continually monitor the user-
defined Xfer ID or RT SA/Mode code for Data messages and when received will use
the Track Multiplex Buffer Index contained within the Data message to index into the
Track Multiplex Buffer to store the 1553 data. Thus, providing a means to analyze
specific filtered 1553 data transferred over the MILbus.
I
I
n
n
p
p
u
u
t
t
T
T
Y
Y
_
_
A
A
P
P
I
I
_
_
T
T
R
R
A
A
C
C
K
K
_
_
D
D
E
E
F
F
_
_
I
I
N
N
x
x
_
_
T
T
r
r
a
a
c
c
k
k
D
D
e
e
f
f
I
I
n
n
Track definition structure
typedef struct ty_api_track_def_in
{
AiUInt32 ul_TrackId;
AiUInt32 ul_BT;
AiUInt32 ul_XidRtSa;
AiUInt32 ul_Mode;
AiUInt32 ul_TrackStartPos;
AiUInt32 ul_TrackBPos;
AiUInt32 ul_TrackBLen;
AiUInt32 ul_TrackLen;
AiUInt32 ul_MultiplexedTrackNb;
AiUInt32 ul_ContinousTrackNb;
AiInt32 l_Offset;
} TY_API_TRACK_DEF_IN;
A
A
i
i
U
U
I
I
n
n
t
t
3
3
2
2
u
u
l
l
_
_
T
T
r
r
a
a
c
c
k
k
I
I
d
d
Value
Description
0..255
Track Multiplex Buffer Identifier
A
A
i
i
U
U
I
I
n
n
t
t
3
3
2
2
u
u
l
l
_
_
B
B
T
T
Buffer type
Value
Constant
Description
1
API_TRACK_TYPE_BC
BC Message Buffer
2
API_TRACK_TYPE_RT
RT Message Buffer
3
API_TRACK_TYPE_MUX_TRACK
Multiplexed Track (used for 2
nd
level
multiplexing)
A
A
i
i
U
U
I
I
n
n
t
t
3
3
2
2
u
u
l
l
_
_
X
X
i
i
d
d
R
R
t
t
S
S
a
a
'uc_BT'
Bit 31
Bit 30
Bit 29
Bit 28
Bit 27
Bit 26
Bit 25
Bit 24