Aim MIL-STD-1553 - Apicmdsystagdef

MIL-STD-1553 Reference Manual
115
Chapter 3 – System Functions
3.1.25 ApiCmdSystagDef
Prototype:
AiInt16 ApiCmdSystagDef ( AiUInt32 ul_ModuleHandle, AiUInt8 biu, AiUInt8 id,
AiUInt8 con, AiUInt8 mode, TY_API_SYSTAG *psystag );
Driver Command:
API_SYSTAG_DEF (0x002E)
Purpose:
This function defines a scenario to insert System Dynamic Data words/buffers into the
data transmitted by the simulated BC and/or RT. Up to 255 scenarios can be created.
This function can also enable/disable the defined System Dynamic Data scenario. If
dataset buffers are to be transmitted by the simulated BC/RT, these buffers should first
be filled with data using the ApiCmdRamWriteDataset function.
On BC side, System Dynamic Data insertion is performed in the BC Transmit Buffer
within an interrupt service routine, whenever the selected BC Transfer is executed.
The BC transfer already has to be defined using the library functions
ApiCmdBCXferDef and ApiCmdBCBHDef when System Dynamic Data generation is
enabled.
On RT side the System Dynamic Data insertion is performed in the RT Transmit
Subaddress Buffer within an interrupt service routine, whenever the selected Transmit
Subaddress is accessed by a Bus Controller Transmit command. The RT Transmit
Subaddress already has to be defined using the library functions ApiCmdRTSACon
and ApiCmdRTBHDef when System Dynamic Data generation is enabled.
Input
A
A
i
i
U
U
I
I
n
n
t
t
8
8
i
i
d
d
Identifies the System Dynamic Data generation scenario containing the data
generation scheme defined when this function is issued.
Value
Description
1..255
System Dynamic Data identifier
A
A
i
i
U
U
I
I
n
n
t
t
8
8
c
c
o
o
n
n
System Dynamic Data Control
Value
Constant
Description
0
API_DIS
Disable System Dynamic Data Generation
1
API_ENA
Enable System Dynamic Data Generation
2
Reserved
3
API_ENA_INIT
Enable System Dynamic Data Generation
and initialize System Dynamic Data Word