DBBC3ValidationDefault
class¶
- class DBBC3ValidationDefault(dbbc3, ignoreErrors)¶
Base class that contains the validation methods common to all DBBC3 modes
All classes that contain validation methods specific for a particaular mode and software version should be derived from this class.
- Parameters
dbbc3 (DBBC3) – the active DBBC3 instance
ignoreErrors (boolean) – If True do not exit processing in case of validation failures
- restoreState()¶
Restores the state of the DBBC3 according to the state that was previously saved upon initialization
- validateBitStatistics(boardNum)¶
Validate the bit statistics for all samplers of the specified board
- Parameters
boardNum (int or str) – the board number (starting at 0=A) or board ID (e.g “A”)
- Returns
the validation report
- Return type
- validateIFLevel(board, downConversion=True, agc=True)¶
Performs various validations of the IF power settings as obtained from the dbbcif command:
IF power should be within 1000 counts of the target value
The attenuation setting should be within 20-40
AGC should be switched on (unless disabled by the agc parameter)
Downconversion should be switched on (unless check is disabled with the downConversion parameter)
- Parameters
board (int or str) – the board number (starting at 0=A) or board ID (e.g “A”)
downConversion (boolean, optional) – If True validate that downconversion is enabled (default: True)
agc (boolean, optional) – If True validate that agc is turned on (default: True)
- Returns
the validation report
- Return type
- validatePPS(maxDelay=200, exitOnError=True)¶
Validates the delay between the internally generated and external PPS signals. The validation is carried out for all all active boards of the DBBC3. The validation fails in case any of the PPS delays is exceeding +-maxDelay nanoseconds (configurable).
- Parameters
board (int or str) – the board number (starting at 0=A) or board ID (e.g “A”)
maxDelay (int) – the maximum valid delay in nanoseconds
exitOnError (boolean) – if True any error will cause a program exit
- Returns
contains the validation report
- Return type
- validateSamplerOffsets(boardNum)¶
Validate the offsets of all samplers of the specified board
- Parameters
boardNum (int or str) – the board number (starting at 0=A) or board ID (e.g “A”)
- Returns
the validation report
- Return type
- validateSamplerPhases()¶
Validates that all sampler phases for all boards are synchronized
- Returns
the validation report
- Return type
- validateSamplerPower(boardNum)¶
Validate the powers of all samplers of the specified board
- Parameters
boardNum (int or str) – the board number (starting at 0=A) or board ID (e.g “A”)
- Returns
the validation report
- Return type
- validateSynthesizerFreq(board, targetFreq=0.0, exitOnError=True)¶
Validates the actual tuning frequency of the GCoMo synthesizer serving the given board against the target value as specified by the last synthFreq command or the value in the DBBC3 configuration file.
If the parameter targetFreq is set to a value > 0 an additional check is performed against that frequency.
- Parameters
board (int or str) – the board number (starting at 0=A) or board ID (e.g “A”)
targetFreq (float) – the synthesizer frequency in MHz
exitOnError (boolean) – if True any error will cause a program exit
- Returns
contains the validation report
- Return type
- validateSynthesizerLock(board, exitOnError=True)¶
Validates that the synthesizer serving the given board is locked
- Parameters
board (int or str) – the board number (starting at 0=A) or board ID (e.g “A”)
exitOnError (boolean) – if True any error will cause a program exit
- Returns
contains the validation report
- Return type
- validateTimesync(board, exitOnError=True, maxDelay=5)¶
Validates the time synchronisation of the specified core3h board
Validation fails in case:
not valid time stamp could be obtained from the DBBC3
the DBBC3 time deveates by more than maxDealy seconds (configurable) from the local NTP time
Failure could indicate that the GPS antenna is not properly connected to the DBBC3 or no GPS satelites were visible on system initialization. Also make sure that the local computer has its time synchonized by NTP.
- Parameters
board (int or str) – the board number (starting at 0=A) or board ID (e.g “A”)
exitOnError (boolean) – if True any error will cause a program exit
maxDelay (int) – the maximum valid time delay in seconds
- Returns
contains the validation report
- Return type