latp.h File Reference

LAT interaction functions. More...

#include <imm.h>

Classes
struct	LATC_di
	Collection of data required to record errors. More...
Defines
#define	DECODE_SIZE(n_)   (n_ * (sizeof(LATC_di)) )
	Size of the structure to hold the decode information (function and destination for each command item).
Functions
unsigned	LATC_load (LATC_imm *imm, LEM_micr *cr)
	Load the LAT with the configuration held in imm.
unsigned	LATC_read (LATC_imm *imm, LEM_micr *cr, LATC_di *di, const LATC_map *ign)
	Read the current configuration of the LAT.

---

Detailed Description

LAT interaction functions.

Author:

James Swain -- jswain@slac.stanford.edu

---

Function Documentation

unsigned LATC_load	(	LATC_imm *	imm,
		LEM_micr *	cr
	)

Load the LAT with the configuration held in imm.

Parameters:

	imm	The IMM structure to use as the basis for the load commands sent to the LAT
	cr	Pointer to structure holding multi-item command and response lists (plus some state information)

Return values:

	LATC_SUCCESS	If the LAT is loaded successfully
	LEM_*	If there is an error arising from one of the load commands

References LEM_load::cr, LEM_load::ldfn, loadSimple(), loadSplit(), and loadTracker().

Referenced by LATC_configure().

unsigned LATC_read	(	LATC_imm *	imm,
		LEM_micr *	cr,
		LATC_di *	di,
		const LATC_map *	ign
	)

Read the current configuration of the LAT.

Parameters:

	imm	Pointer to the IMM structure to populate from the LAT
	cr	Pointer to structure holding multi-item command and response lists (plus some state information)
	di	Array of lem_max_ci latc_di objects that capture read errors from the corresponding command items
	ign	Map of the sections of the lat known to be bad or not present so can be ignored.

Return values:

	LATC_SUCCESS	If all goes well - note that individual register reads may fail but the operation as a whole still succeeds.
	LEM_*	An error concerning the queuing of the c/r list individual read command failures are noted in the map associated with the IMM.

References LEM_read::cr, LEM_read::ddfn, LEM_read::di, handleReadErrors(), LEM_read::rdfn, readSimple(), readSplit(), and readTracker().

Referenced by LATC_capture().