Aim MIL-STD-1553 - Apicmdbmcapmode

MIL-STD-1553 Reference Manual
325
Chapter 9 – Bus Monitor Functions
9.1.2 ApiCmdBMCapMode
Prototype:
AiInt16 ApiCmdBMCapMode ( AiUInt32 ul_ModuleHandle, AiUInt8 biu,
TY_API_BM_CAP_SETUP *pcap );
Driver Command:
API_BM_INI_CAP (0xB2)
Purpose:
This function is used to configure the Bus Monitor Capture/Recording mode on the
AIM board according to the specified input parameters.
I
I
n
n
p
p
u
u
t
t
T
T
Y
Y
_
_
A
A
P
P
I
I
_
_
B
B
M
M
_
_
C
C
A
A
P
P
_
_
S
S
E
E
T
T
U
U
P
P
*
*
p
p
c
c
a
a
p
p
BM Capture Mode description
typedef struct ty_api_bm_cap_setup
{
AiUInt8 cap_mode;
AiUInt32 cap_tat;
AiUInt16 cap_mcc;
AiUInt16 cap_fsize;
} TY_API_BM_CAP_SETUP;
A
A
i
i
U
U
I
I
n
n
t
t
8
8
c
c
a
a
p
p
_
_
m
m
o
o
d
d
e
e
Capture Mode selection
Value
Constant
Description
0
API_BM_CAPMODE_ALL
Capture ‘ALL’ (Standard Capture Mode)
The ‘Trace After Trigger Count’ cap_tat defines the
number of entries to be stored in the Monitor Buffer
after the occurrence of the Trigger Start event.
1
API_BM_CAPMODE_ONLY
Capture ‘ONLY’ (Capture Only Mode)
The ‘Message Capture Count’ cap_mcc defines
the number of messages, which shall be captured
after the Trigger Start event. When the defined
number of messages is stored in the Monitor
buffer, capturing of data is stopped and restarted
with the next occurrence of the Trigger Start event.
This process is stopped when Bus Monitor
operation is disabled or when the the number of
entries defined by the ‘Trace After Trigger Count’
cap_tat has been stored in the Monitor Buffer.
2
API_BM_CAPMODE_RECORDING
Recording Mode
The Bus Monitor is setup in Continuous Capture
mode. The ‘Trace After Trigger Count’ cap_tat is
implicitely set to zero in order to enable Continuous
Capturing (Recording). In Recording Mode the
Buffer Full Interrupt is enabled, so that every time
the AIM board Bus Monitor has captured a certain
amount of data an interrupt is asserted (Half Buffer
Full Interrupt).
3
API_BM_CAPMODE_FILTER
Message Filter Recording Mode
The Bus Monitor is setup in Continuous Capture
mode. The ‘Trace After Trigger Count’ cap_tat is
implicitely set to zero in order to enable Continuous
Capturing (Recording). No interrupts are enabled.