---

GLAST/LAT > DAQ and FSW > FSW > Doxygen Index > RIM / V1-0-0

Constituent: rim     Tag: mv2304

---

         

---

RIM_p.h File Reference

Private definitions for the RIM facility. More...

#include "RIM/RIM.h"
#include "RIM_AG_types_p.h"
#include <stddef.h>

Include dependency graph for RIM_p.h:

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

Data Structures
struct	FldDescription
	Parameters necessary to describe a field within a register. More...
struct	RegDescription
	Description of a register within a component. More...
struct	CptDescription
	Description of a component of the LAT. More...
struct	LEM_load
	Functions and resources used to load LAT registers. More...
struct	LEM_read
	Functions and resources used to read LAT registers. More...
Defines
#define	MAX_MAP   ((N_MAX / 32) + 1)
	Number of 32 bit words guaranteed to be big enough to hold a map large enough for any component type.
Enumerations
enum	{   RIM_NO_LOW = -1,   RIM_NO_HIGH = 24 }
	Special TFE ID values. More...
enum	{ RIM_TFE_MODE = 4 }
	TFE mode register ID - defined here to avoid dependence on LEM. More...
Functions
void	RIM_getFld (const void *cpt, RIM_type type, int regId, int fldId, void *value)
	Puts the contents of the fldId field of register regId into value.
void	RIM_getReg (const void *cpt, RIM_type type, int regId, void *value)
	Puts the contents of the target register regId into value.
void	RIM_layerHigh (const Layer_addr *layer, TEM_addr *tem)
	Convert the conceptual layer addressing of a TFE to the hierarchical form used to communicate with the LAT.
void	RIM_layerLow (const Layer_addr *layer, TEM_addr *tem)
	Convert the conceptual layer addressing of a TFE to the hierarchical form used to communicate with the LAT.
int	RIM_regEnum (RIM_type type, int regId)
	Convert the public register ID in to the RIM internal register ID.
int	RIM_setFld (void *cpt, RIM_type type, int regId, int fldId, const void *value)
	Sets the tgtId field of the regId register of cpt structure to value.
void	RIM_setReg (void *cpt, RIM_type type, int regId, const void *value)
	Set the regId register of cpt structure to value.

---

Detailed Description

Private definitions for the RIM facility.

Author:

James Swain & Owen Saxton

Id

RIM_p.h,v 1.2 2007/03/22 23:46:59 saxton Exp

---

Enumeration Type Documentation

anonymous enum

Special TFE ID values. Enumerator: RIM_NO_LOW  TFE "ID" indicating that there are no TFEs on the low side of the split. RIM_NO_HIGH  TFE "ID" indicating that there are no TFEs on the high side of the split.

anonymous enum

TFE mode register ID - defined here to avoid dependence on LEM. Enumerator: RIM_TFE_MODE  TFE mode register ID for LATp.

---

Function Documentation

void RIM_getFld (  const void *  cpt, RIM_type  type, int  regId, int  fldId, void *  value )

Puts the contents of the fldId field of register regId into value. Parameters: type  Type of data sought cpt  Pointer to start of the component data. regId  Enumerated ID of the register fldId  Target field value  Location to put the contents of the target field

void RIM_getReg (  const void *  cpt, RIM_type  type, int  regId, void *  value )

Puts the contents of the target register regId into value. Parameters: cpt  Pointer to start of the component data. type  Type of data sought regId  Enumerated ID of the register value  Location to put the contents of the target reg

void RIM_layerHigh (  const Layer_addr *  layer, TEM_addr *  tem )

Convert the conceptual layer addressing of a TFE to the hierarchical form used to communicate with the LAT. Note that GTFEs are usually referred to as being part of an X or Y layer. This identification is converted to an absolute layer number and stored in the rc space by addr->rc = (layerNumber << 1) | isYlayer. This conversion is performed by the XLM->RIM converter, but is documented here since it is a storage convention. Parameters: layer  Address of the TFE / SPT in terms of layers tem  Address of the TFE / TRC in terms of CC/RC

void RIM_layerLow (  const Layer_addr *  layer, TEM_addr *  tem )

Convert the conceptual layer addressing of a TFE to the hierarchical form used to communicate with the LAT. Note that GTFEs are usually referred to as being part of an X or Y layer. This identification is converted to an absolute layer number and stored in the rc space by addr->rc = (layerNumber << 1) | isYlayer. This conversion is performed by the XLM->RIM converter, but is documented here since it is a storage convention. Parameters: layer  Address of the TFE / SPT in terms of layers tem  Address of the TFE / TRC in terms of CC/RC

int RIM_regEnum (  RIM_type  type, int  regId )

Convert the public register ID in to the RIM internal register ID. Parameters: type  Component type regId  Register ID in terms of hardware numbering (the Huffer docs and LEM) Returns: The index of the register in the array of register descriptions within the component description

int RIM_setFld (  void *  cpt, RIM_type  type, int  regId, int  fldId, const void *  value )

Sets the tgtId field of the regId register of cpt structure to value. Parameters: cpt  Pointer to start of the component data. type  Type of component regId  Enum specifying register to write to fldId  Enum specifying field to write to value  Value to set the field to. Return values: RIM_SUCCESS  If all goes well RIM_FLDRNG

void RIM_setReg (  void *  cpt, RIM_type  type, int  regId, const void *  value )

Set the regId register of cpt structure to value. Parameters: cpt  Pointer to start of the component data. type  Type of data sought regId  Enum specifing register to write to value  Value to set register to

---