Aim MIL-STD-1553 - Apicmdbcinstrtblgen

MIL-STD-1553 Reference Manual
227
Chapter 7 – Bus Controller Functions
7.1.14 ApiCmdBCInstrTblGen
Prototype:
AiInt16 ApiCmdBCInstrTblGen ( AiUInt32 ul_ModuleHandle, AiUInt8 biu,
AiUInt8 mode, AiUInt32 cnt,
AiUInt32 dest_cnt, AiUInt32 dest_offset,
TY_API_BC_FW_INSTR *tbl, AiUInt32 *ctbl,
AiUInt32 *err_line, AiUInt8 *status);
Driver Command: -
none
Purpose:
This function is used to convert the BC Instruction Table structure (tbl) into an array of
instruction long-words (ctbl). Labels, Transfer IDs, Jumps, Calls and other firmware
instructions contained within the BC Instruction Table structure (tbl) are calculated to
absolute addresses during the conversion. The converted output represents an image
of Firmware instructions which is then written into the BC Instruction list area of the
Global memory.
Using this approach is an alternate method of defining Minor and Major Frame
sequences besides the standard library functions ApiCmdBCFrameDef and
ApiCmdBCMFrameDef.
A cyclic frame can be setup more efficiently and with more flexibility within the Global
memory. Using this function provides no limitation to the number of Transfers allowed
within a Minor Frame and the number of Minor Frames in a Major Frame (only
limitation is the available size of the BC Instruction list within the Global memory
layout, refer to ApiCmdBCInstrTblIni). Using the BC Instruction Table structure (tbl)
allows the user to prepare additional Transfer sequences (Minor Frames) within the
Global memory for later use (cyclic or acyclic). For each Instruction within the tbl
structure a label can be defined. Using function
ApiCmdBCInstrTblGetAddrFromLabel returns the address for such label which can
then be used as an input parameter for ApiCmdBCStart (parameter saddr).
To start the BC operation / Transfer execution of the specified BC Instruction Table
(tbl) function ApiCmdBCStart shall be called with smod =
API_BC_START_INSTR_TABLE.
Using parameters dest_cnt and dest_offset it is possible to write specific parts or entire
ctbl to the Instruction list area of the Global memory.