#include <sltauger.h>

Inheritance diagram for hw4::SltAuger:

Public Types

enum RunMode {
RUN, CAL, WAIT, STOP,
CERR, UNKNOWN
}

Public Member Functions

SltAuger (int ID, const char *inifile="FE.ini")
virtual ~SltAuger ()
void getActualTime (SltTime *time)
unsigned long setActualTime ()
int checkActualTime (long int *tDiff, long int *tDiffEye, int *tMeas, int *tPhase, long int *tDiffGps=0, int id=0, int n=1, const char *gpsserver="localhost", int gpsport=0)
int checkTime (double *tDiff=0, int *tSecErr=0, int *tPhase=0, procDuration *tPC=0)
RunMode getRunMode ()
std::string getRunModeText ()
std::string getRunModeText (RunMode mode)
void getActivePages (int time, int *pages, int *continous)
void convertToUTC (time_t *t_utc, unsigned long time)
void convertToUTC (time_t *t_utc, SltTime time)
void convertToGPS (SltTime *time, time_t t_utc)
void checkDeadTime (unsigned long long *tDead, unsigned long long *tVeto, double *tRecord, double *tPageFull, procDuration *tMeas=0)
int readDeadTime (unsigned long long *tDead, unsigned long long *tVeto, unsigned long long *tInhibit)
std::string convertTimeToText (unsigned long long time, int showSubSecs=0)

Public Attributes

Detailed Description

The class Slt provides the definition for the registers of the second level trigger board (SLT) of the version 4 electronics.

The names of the registers are choosen as found in the hardware description. For a systematic access to all registers without knowledge of the specific register structure the array regList is introduced. The array contains a list of all available registers.

Definition at line 77 of file sltauger.h.

Member Enumeration Documentation

enum hw4::SltAuger::RunMode

Status of the electronic:

RUN No inhibit active, No Resets active, second strobe source = ext trigger source = int dead time enabled
CAL as RUN but dead time disabled
WAIT as RUN but all pages full active
STOP as RUN but ext or sw inhibit active
CERR DAQ configuration error
UNKOWN Other state

Enumerator:

RUN
CAL
WAIT
STOP
CERR
UNKNOWN

Reimplemented from hw4::Slt.

Definition at line 174 of file sltauger.h.

                {
        RUN,
        CAL,
        WAIT,
        STOP,
        CERR,
        UNKNOWN};

Constructor & Destructor Documentation

hw4::SltAuger::SltAuger	(	int	ID,
		const char *	inifile = `"FE.ini"`
	)

virtual hw4::SltAuger::~SltAuger ( ) [virtual]

Member Function Documentation

int hw4::SltAuger::checkActualTime	(	long int *	tDiff,
		long int *	tDiffEye,
		int *	tMeas,
		int *	tPhase,
		long int *	tDiffGps = `0`,
		int	id = `0`,
		int	n = `1`,
		const char *	gpsserver = `"localhost"`,
		int	gpsport = `0`
	)

Compare the PC clock and the hardware clock of all connected telescopes.This function is an extension for more than one telescope connected in PBUS_IP mode.

Parameters:

tDiff	The difference t(Hardware) - t(MirrorPC) in seconds.
tDiffEye	The difference t(MirrorPC) - t(EyePC) in seconds.
tMeas	The measurement point in ms relative to the last second strobe
tPhase	The phase in ms between the GPS time of the hardware and the NTP time of the EyePC: t(Hardware) - t(EyePC) t is the time of the second strobe in each case.
tDiffGps	Difference of the gps clock Two values: oncode time and auger counter
id	Number of the telescope to test. 0 (default) is the actual telescope
n	Number of telescopes to analyse If n > 1 you need to provide a array for the first argument (tDiff).
gpsserver	Hostname of the gpsserver (default: localhost)
gpsport	Port of the gpsserver (0 to use the default port)

Returns:: Status of the function. + 0 failed, > 0 success == number of miliseconds of the last test.

Reimplemented from hw4::Slt.

void hw4::SltAuger::checkDeadTime	(	unsigned long long *	tDead,
		unsigned long long *	tVeto,
		double *	tRecord,
		double *	tPageFull,
		procDuration *	tMeas = `0`
	)

Check the operation time of the crate.

Reimplemented from hw4::Slt.

int hw4::SltAuger::checkTime	(	double *	tDiff = `0`,
		int *	tSecErr = `0`,
		int *	tPhase = `0`,
		procDuration *	tPC = `0`
	)

Check hardware and PC clock synchrony.

The approach used is faster than that implemented in checkActualTime(). It uses the subsecond counters to determine second error and phase between hardware and PC clock.

The function checks only the selected telescope.

return 0 Ok, -1 hardware not responding, bit 1 warning internal second strobe, bit 2 time error param tDiff Difference tHw - t PC [s] param tSecErr Second error tHw - t PC [s] param tPhase Offset between the second strobes in Hw and PC [us] param tPC Measurement intervall.

Reimplemented from hw4::Slt.

std::string hw4::SltAuger::convertTimeToText	(	unsigned long long	time,
		int	showSubSecs = `0`
	)

Convert ded or veto times to a character string.

Reimplemented from hw4::Slt.

void hw4::SltAuger::convertToGPS	(	SltTime *	time,
		time_t	t_utc
	)

Convert to GPS time.

Reimplemented from hw4::Slt.

void hw4::SltAuger::convertToUTC	(	time_t *	t_utc,
		unsigned long	time
	)

Convert the Hardware second counter the the format used by the PC (UTC time started at 1.1.1970)

Parameters:

t_utc	Second counter in UTC format
time	Time in Hardware format

Reimplemented from hw4::Slt.

void hw4::SltAuger::convertToUTC	(	time_t *	t_utc,
		SltTime	time
	)

Reimplemented from hw4::Slt.

void hw4::SltAuger::getActivePages	(	int	time,
		int *	pages,
		int *	continous
	)

Get the number of active and the fraction of continously trigger pages in a given interval.

Parameters:

time	Age of the considered pages in seconds (0 all time)
pages	Pointer to the number of active pages
continous	Pointer to the number of continuous triggered pages

Reimplemented from hw4::Slt.

void hw4::SltAuger::getActualTime ( SltTime * time )

Get the actual time of the system.

Note: The system runs with GPS time. The GPS second count differs from the UNIX System time by about 10 years.

Reimplemented from hw4::Slt.

RunMode hw4::SltAuger::getRunMode ( )

Get System state.

The system state is defined by the configuration of the signal sources and the level of the signals.

Reimplemented from hw4::Slt.

std::string hw4::SltAuger::getRunModeText ( )

Give text output for the run modes.

Reimplemented from hw4::Slt.

std::string hw4::SltAuger::getRunModeText ( RunMode mode )

int hw4::SltAuger::readDeadTime	(	unsigned long long *	tDead,
		unsigned long long *	tVeto,
		unsigned long long *	tInhibit
	)

Read dead and veto times Calculate the inhibit time by substracting both.

The inhibit time is only valid if the function returns zero.

Reimplemented from hw4::Slt.

unsigned long hw4::SltAuger::setActualTime ( )

Synchronize the actual time of the system with the local PC clock.

To set the correct value of the second, the function waits 300ms after the next second change. Then the UTC second counter ist converted to GPS seconds second counter is written. The hardware will set this value with the next second strobe. Finally the function checks, whether it was possible to finish the operation within one second.

Returns:: The second since beginning of GPS time when the crate was synchronized. A value of zero indicates that the setting failed. Repeat the function.

Reimplemented from hw4::Slt.

Member Data Documentation

BaseRegister* hw4::SltAuger::adcData

Reimplemented from hw4::Slt.

Definition at line 364 of file sltauger.h.

BaseRegister* hw4::SltAuger::auxBusTest

Reimplemented from hw4::Slt.

Definition at line 284 of file sltauger.h.

SltPageSelectReg* hw4::SltAuger::bufferSelect

Reimplemented from hw4::Slt.

Definition at line 332 of file sltauger.h.

SltCommandReg* hw4::SltAuger::command

Command register.

Reimplemented from hw4::Slt.

Definition at line 242 of file sltauger.h.

SltControlReg* hw4::SltAuger::control

Control register.

Reimplemented from hw4::Slt.

Definition at line 236 of file sltauger.h.

SltDataBlockReg* hw4::SltAuger::dataBlock

Reimplemented from hw4::Slt.

Definition at line 368 of file sltauger.h.

BaseRegister* hw4::SltAuger::dataBlockRW

Definition at line 366 of file sltauger.h.

procDuration hw4::SltAuger::deadCheckTime[24]

Interval of the dead time checks.

Reimplemented from hw4::Slt.

Definition at line 372 of file sltauger.h.

unsigned long long hw4::SltAuger::deadStart[24]

Dead time counter at start in interval.

Reimplemented from hw4::Slt.

Definition at line 375 of file sltauger.h.

SltLongRegister* hw4::SltAuger::deadTime

Counter for the dead-time.

Use the command reset dead-time to reset the counter before starting the data aquisition run.

Reimplemented from hw4::Slt.

Definition at line 276 of file sltauger.h.

BaseRegister* hw4::SltAuger::debugStatus

Reimplemented from hw4::Slt.

Definition at line 286 of file sltauger.h.

BaseRegister* hw4::SltAuger::eepromBuffer

Reimplemented from hw4::Slt.

Definition at line 347 of file sltauger.h.

BaseRegister* hw4::SltAuger::eepromControl

Reimplemented from hw4::Slt.

Definition at line 345 of file sltauger.h.

SltEPCSCommandReg* hw4::SltAuger::epcsCommand

Reimplemented from hw4::Slt.

Definition at line 342 of file sltauger.h.

SltEventStatusMem* hw4::SltAuger::eventStatus

Reimplemented from hw4::Slt.

Definition at line 326 of file sltauger.h.

SltI2CCommandReg* hw4::SltAuger::i2cCommand

Reimplemented from hw4::Slt.

Definition at line 340 of file sltauger.h.

SltInterruptReg* hw4::SltAuger::interruptMask

The register contains the interrupt mask.

High bits will disable the interrupt and low bits will enable it.

Reimplemented from hw4::Slt.

Definition at line 247 of file sltauger.h.

SltInterruptReg* hw4::SltAuger::interruptRequest

The register gives the actual interrupt status of the SLT board.

After the interrupt acknowledge cycle the register is cleared.

Name in Slt fpga documentation: Interrupt Request

Reimplemented from hw4::Slt.

Definition at line 256 of file sltauger.h.

BaseRegister* hw4::SltAuger::multiplicity

Reimplemented from hw4::Slt.

Definition at line 354 of file sltauger.h.

BaseRegister* hw4::SltAuger::numberOfPages

Timing and trigger information of the recorded events.

Defines the number of active registers in the page numbers list This register will contain always 64 unless some registers should be taken out of operation.

Reimplemented from hw4::Slt.

Definition at line 322 of file sltauger.h.

SltPageManagementReg* hw4::SltAuger::pageManager

Status register of the page controller.

Reimplemented from hw4::Slt.

Definition at line 305 of file sltauger.h.

BaseRegister* hw4::SltAuger::pageNumbers

Reimplemented from hw4::Slt.

Definition at line 324 of file sltauger.h.

SltPageSelectReg* hw4::SltAuger::pageSelect

Page select register.

Reimplemented from hw4::Slt.