---

GLAST/LAT > DAQ and FSW > FSW > Doxygen Index > TPG / V3-1-1

Constituent: tpg     Tag: mv2304

---

         

---

tpg.h File Reference

Trigger Pattern Generator command-line user interface. More...

This graph shows which files directly or indirectly include this file:

Typedefs
typedef _TPG	TPG
	typedef for the TPG structure containing pattern buffers and gnatHandles for the COMM boards
Functions
TPG *	TPGnew (unsigned *commAddr)
	Calls calloc to allocate memory for the struct and associated buffers then sets the buffer pointers to the correct offsets.
void	TPGclear (TPG *this)
	Sets all the buffers to 0.
void	TPGclearBuf (TPG *this, unsigned bufferId)
	Sets the buffer indicated by bufferId to 0.
unsigned	TPGsetTEM (TPG *this, unsigned tem_id, unsigned trg, unsigned start, unsigned pattern, unsigned pat_len, unsigned repetitions)
	Places the pat_len LSBs of pattern into the channel and buffer indicated by tem_id and trg.
unsigned	TPGsetVETO (TPG *this, unsigned free_id, unsigned veto_id, unsigned start, unsigned pattern, unsigned pat_len, unsigned repetitions)
	Places the pat_len LSBs of pattern into the channel and buffer indicated by free_id and veto_id.
unsigned	TPGsetCNO (TPG *this, unsigned free_id, unsigned start, unsigned pattern, unsigned pat_len, unsigned repetitions)
	Places the pat_len LSBs of pattern into the channel and buffer indicated by free_id and veto_id.
unsigned	TPGsetTEMv (TPG *this, unsigned tem_id, unsigned trg, unsigned start, unsigned *pattern, unsigned pat_len, unsigned repetitions)
	Places the pat_len LSBs of pattern into the channel and buffer indicated by tem_id and trg.
unsigned	TPGsetVETOv (TPG *this, unsigned free_id, unsigned veto_id, unsigned start, unsigned *pattern, unsigned pat_len, unsigned repetitions)
	Places the pat_len LSBs of pattern into the channel and buffer indicated by free_id and veto_id.
unsigned	TPGsetCNOv (TPG *this, unsigned free_id, unsigned start, unsigned *pattern, unsigned pat_len, unsigned repetitions)
	Places the pat_len LSBs of pattern into the channel and buffer indicated by free_id and veto_id.
unsigned	TPGsetTEMsticky (TPG *this, unsigned tem_id, unsigned trg)
	Sets the last bit of the buffer, which will "stick" on the COMM I/O outputs.
unsigned	TPGsetVETOsticky (TPG *this, unsigned free_id, unsigned veto_id)
	Sets the last bit of the buffer, which will "stick" on the COMM I/O outputs.
unsigned	TPGsetCNOsticky (TPG *this, unsigned free_id)
	Clears the last bit of the buffer, which will "stick" on the COMM I/O outputs.
unsigned	TPGclrTEMsticky (TPG *this, unsigned tem_id, unsigned trg)
	Clears the last bit of the buffer, which will "stick" on the COMM I/O outputs.
unsigned	TPGclrVETOsticky (TPG *this, unsigned free_id, unsigned veto_id)
	Clears the last bit of the buffer, which will "stick" on the COMM I/O outputs.
unsigned	TPGclrCNOsticky (TPG *this, unsigned free_id)
	Clears the last bit of the buffer, which will "stick" on the COMM I/O outputs.
unsigned	TPGload (TPG *this, unsigned char *clkDelay)
	Use Programmed I/O to fill the COMM board FIFOs.
unsigned	TPGstart (TPG *this)
	Start the playback.
unsigned	TPGdumpFREE (TPG *this, unsigned free_id, unsigned start, unsigned len)
	Print out the bit patterns in the free board.
unsigned	TPGdumpCNO (TPG *this, unsigned start, unsigned len)
	Print out the bit patterns in the CNO buffer.
unsigned	TPGdumpTEM (TPG *this, unsigned start, unsigned len)
	Print out the bit patterns in the TEM buffer.
unsigned	TPGdump (TPG *this, unsigned boardId, unsigned start, unsigned len)
	Print out the bit patterns in the requested board.
int	TPGmsgInit (void)
	Starts a simple printf MSG processor.
Variables
unsigned	TPG_BUSY
	Use unknown.
unsigned	TPG_TIAR
	Use unknown.
unsigned	TPG_CALHI
	Use unknown.
unsigned	TPG_CALLO
	Use unknown.
unsigned	TPG_N_TRG
	Use unknown.
unsigned	TPG_LASTWORD
	Use unknown.

---

Detailed Description

Trigger Pattern Generator command-line user interface.

Author:

James Swain -- jswain@slac.stanford.edu

---

Function Documentation

void TPGclear (  TPG *  this  )

Sets all the buffers to 0. Parameters: this  TPG structure to clear

Here is the call graph for this function:

void TPGclearBuf (  TPG *  this, unsigned  bufferId )

Sets the buffer indicated by bufferId to 0. Parameters: this  TPG structure containing buffer to clear bufferId  ID of the buffer to clear

unsigned TPGclrCNOsticky (  TPG *  this, unsigned  free_id )

Clears the last bit of the buffer, which will "stick" on the COMM I/O outputs. Parameters: this  TPG structure being modified free_id  FREE being targeted (gives tgt board), 0 ... 3 Returns: One of TPG_msgs, TPG_SUCCESS if all goes well.

Here is the call graph for this function:

unsigned TPGclrTEMsticky (  TPG *  this, unsigned  tem_id, unsigned  trg )

Clears the last bit of the buffer, which will "stick" on the COMM I/O outputs. Parameters: this  TPG structure being modified tem_id  TEM being targeted (gives channel range), 0 ... 3 trg  TEM trg being targeted, (gives channel number), 0 ... 3 Returns: One of TPG_msgs, TPG_SUCCESS if all goes well.

Here is the call graph for this function:

unsigned TPGclrVETOsticky (  TPG *  this, unsigned  free_id, unsigned  veto_id )

Clears the last bit of the buffer, which will "stick" on the COMM I/O outputs. Parameters: this  TPG structure being modified free_id  FREE being targeted (gives tgt board), 0 ... 3 veto_id  VETO bit being targeted, (gives channel number), 0 ... 17 Returns: One of TPG_msgs, TPG_SUCCESS if all goes well.

Here is the call graph for this function:

unsigned TPGdump (  TPG *  this, unsigned  boardId, unsigned  start, unsigned  len )

Print out the bit patterns in the requested board. Parameters: this  TPG struct to use to configure COMM I/O boards boardId  0 ... N_TPG_BOARDS start  Line of the buffer to start dump len  Number of lines to dump Returns: One of TPG_msgs, TPG_SUCCESS if all goes well.

unsigned TPGdumpCNO (  TPG *  this, unsigned  start, unsigned  len )

Print out the bit patterns in the CNO buffer. Parameters: this  TPG struct to use to configure COMM I/O boards start  Line of the buffer to start dump len  Number of lines to dump Returns: One of TPG_msgs, TPG_SUCCESS if all goes well.

Here is the call graph for this function:

unsigned TPGdumpFREE (  TPG *  this, unsigned  free_id, unsigned  start, unsigned  len )

Print out the bit patterns in the free board. Parameters: this  TPG struct to use to configure COMM I/O boards free_id  FREE ID start  Line of the buffer to start dump len  Number of lines to dump Returns: One of TPG_msgs, TPG_SUCCESS if all goes well.

Here is the call graph for this function:

unsigned TPGdumpTEM (  TPG *  this, unsigned  start, unsigned  len )

Print out the bit patterns in the TEM buffer. Parameters: this  TPG struct to use to configure COMM I/O boards start  Line of the buffer to start dump len  Number of lines to dump Returns: One of TPG_msgs, TPG_SUCCESS if all goes well.

Here is the call graph for this function:

unsigned TPGload (  TPG *  this, unsigned char *  clkDelay )

Use Programmed I/O to fill the COMM board FIFOs. Parameters: this  TPG struct to use to configure COMM I/O boards clkDelay  Argument no longer used, left for backward compatibility. Use TPGDelay(). Returns: One of TPG_msgs, TPG_SUCCESS if all goes well.

Here is the call graph for this function:

int TPGmsgInit (  void   )

Starts a simple printf MSG processor. Returns: 0 on success, -1 on failure

TPG* TPGnew (  unsigned *  brdAddr  )

Calls calloc to allocate memory for the struct and associated buffers then sets the buffer pointers to the correct offsets. Parameters: brdAddr  Null terminated array of GTB (GEM Test Board) addresses Returns: Ptr to a new TPG structure containing ptrs to buffers and gnatHandles

unsigned TPGsetCNO (  TPG *  this, unsigned  free_id, unsigned  start, unsigned  pattern, unsigned  pat_len, unsigned  repetitions )

Places the pat_len LSBs of pattern into the channel and buffer indicated by free_id and veto_id. Parameters: this  TPG structure being modified free_id  FREE being targeted (gives tgt board), 0 ... 3 start  Start bit for the pattern, 0 ... (32*1024)-1 pattern  Up to 32 bit pattern to use (LSB first) pat_len  Pattern length 1 ... 32 repetitions  Number of times to repeat the same pattern on this channel, use 0 to request as many reps as will fit in remaining FIFO depth Returns: One of TPG_msgs, TPG_SUCCESS if all goes well.

Here is the call graph for this function:

unsigned TPGsetCNOsticky (  TPG *  this, unsigned  free_id )

Clears the last bit of the buffer, which will "stick" on the COMM I/O outputs. Parameters: this  TPG structure being modified free_id  FREE being targeted (gives tgt board), 0 ... 3 Returns: One of TPG_msgs, TPG_SUCCESS if all goes well.

Here is the call graph for this function:

unsigned TPGsetCNOv (  TPG *  this, unsigned  free_id, unsigned  start, unsigned *  pattern, unsigned  pat_len, unsigned  repetitions )

Places the pat_len LSBs of pattern into the channel and buffer indicated by free_id and veto_id. Parameters: this  TPG structure being modified free_id  FREE being targeted (gives tgt board), 0 ... 3 start  Start bit for the pattern, 0 ... (32*1024)-1 pattern  Up to 32 bit pattern to use (LSB first) pat_len  Pattern length 1 ... (32*1024) - 1 repetitions  Number of times to repeat the same pattern on this channel, use 0 to request as many reps as will fit in remaining FIFO depth Returns: One of TPG_msgs, TPG_SUCCESS if all goes well.

Here is the call graph for this function:

unsigned TPGsetTEM (  TPG *  this, unsigned  tem_id, unsigned  trg, unsigned  start, unsigned  pattern, unsigned  pat_len, unsigned  repetitions )

Places the pat_len LSBs of pattern into the channel and buffer indicated by tem_id and trg. Parameters: this  TPG structure being modified tem_id  TEM being targeted (gives channel range), 0 ... 3 trg  TEM trg being targeted, (gives channel number), 0 ... 3 start  Start bit for the pattern, 0 ... (32*1024)-1 pattern  Up to 32 bit pattern to use (LSB first) pat_len  Pattern length 1 ... 32 repetitions  Number of times to repeat the same pattern on this channel, use 0 to request as many reps as will fit in remaining FIFO depth Returns: One of TPG_msgs, TPG_SUCCESS if all goes well.

Here is the call graph for this function:

unsigned TPGsetTEMsticky (  TPG *  this, unsigned  tem_id, unsigned  trg )

Sets the last bit of the buffer, which will "stick" on the COMM I/O outputs. Parameters: this  TPG structure being modified tem_id  TEM being targeted (gives channel range), 0 ... 3 trg  TEM trg being targeted, (gives channel number), 0 ... 3 Returns: One of TPG_msgs, TPG_SUCCESS if all goes well.

Here is the call graph for this function:

unsigned TPGsetTEMv (  TPG *  this, unsigned  tem_id, unsigned  trg, unsigned  start, unsigned *  pattern, unsigned  pat_len, unsigned  repetitions )

Places the pat_len LSBs of pattern into the channel and buffer indicated by tem_id and trg. Parameters: this  TPG structure being modified tem_id  TEM being targeted (gives channel range), 0 ... 3 trg  TEM trg being targeted, (gives channel number), 0 ... 3 start  Start bit for the pattern, 0 ... (32*1024)-1 pattern  Up to 32 bit pattern to use (LSB first) pat_len  Pattern length 1 ... (32*1024) - 1 repetitions  Number of times to repeat the same pattern on this channel, use 0 to request as many reps as will fit in remaining FIFO depth Returns: One of TPG_msgs, TPG_SUCCESS if all goes well.

Here is the call graph for this function:

unsigned TPGsetVETO (  TPG *  this, unsigned  free_id, unsigned  veto_id, unsigned  start, unsigned  pattern, unsigned  pat_len, unsigned  repetitions )

Places the pat_len LSBs of pattern into the channel and buffer indicated by free_id and veto_id. Parameters: this  TPG structure being modified free_id  FREE being targeted (gives tgt board), 0 ... 3 veto_id  VETO bit being targeted, (gives channel number), 0 ... 17 start  Start bit for the pattern, 0 ... (32*1024)-1 pattern  Up to 32 bit pattern to use (LSB first) pat_len  Pattern length 1 ... 32 repetitions  Number of times to repeat the same pattern on this channel, use 0 to request as many reps as will fit in remaining FIFO depth Returns: One of TPG_msgs, TPG_SUCCESS if all goes well.

Here is the call graph for this function:

unsigned TPGsetVETOsticky (  TPG *  this, unsigned  free_id, unsigned  veto_id )

Sets the last bit of the buffer, which will "stick" on the COMM I/O outputs. Parameters: this  TPG structure being modified free_id  FREE being targeted (gives tgt board), 0 ... 3 veto_id  VETO bit being targeted, (gives channel number), 0 ... 17 Returns: One of TPG_msgs, TPG_SUCCESS if all goes well.

Here is the call graph for this function:

unsigned TPGsetVETOv (  TPG *  this, unsigned  free_id, unsigned  veto_id, unsigned  start, unsigned *  pattern, unsigned  pat_len, unsigned  repetitions )

Places the pat_len LSBs of pattern into the channel and buffer indicated by free_id and veto_id. Parameters: this  TPG structure being modified free_id  FREE being targeted (gives tgt board), 0 ... 3 veto_id  VETO bit being targeted, (gives channel number), 0 ... 17 start  Start bit for the pattern, 0 ... (32*1024)-1 pattern  Up to 32 bit pattern to use (LSB first) pat_len  Pattern length 1 ... (32*1024) - 1 repetitions  Number of times to repeat the same pattern on this channel, use 0 to request as many reps as will fit in remaining FIFO depth Returns: One of TPG_msgs, TPG_SUCCESS if all goes well.

Here is the call graph for this function:

unsigned TPGstart (  TPG *  this  )

Start the playback. Parameters: this  TPG struct to use to configure COMM I/O boards Returns: One of TPG_msgs, TPG_SUCCESS if all goes well.

Here is the call graph for this function:

---

Variable Documentation

unsigned TPG_BUSY

Use unknown. Channel number for the TEM BUSY signal

unsigned TPG_CALHI

Use unknown. Channel number for the TEM CAL HE signal

unsigned TPG_CALLO

Use unknown. Channel number for the TEM CAL LE signal

unsigned TPG_LASTWORD

Use unknown. first bit of last word of a pattern

unsigned TPG_N_TRG

Use unknown. Total number of TEM triggers

unsigned TPG_TIAR

Use unknown. Channel number for the TEM Three-in-a-row signal

---