DBBC3Validation_OCT_D_110 class

class DBBC3Validation_OCT_D_110(dbbc3, ignoreErrors)

Bases: DBBC3ValidationDefault

class with validation methods specific to the OCT_D 110 mode

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

ValidationReport

validateCalibrationLoop(exitOnError=False)

Validates that the calibration loop is running

Parameters

exitOnError (boolean, optional) – if True raise an exit condition on validation failure

Returns

contains the validation report

Return type

ValidationReport

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

ValidationReport

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

ValidationReport

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

ValidationReport

validateSamplerPhases()

Validates that all sampler phases for all boards are synchronized

Returns

the validation report

Return type

ValidationReport

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

ValidationReport

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

ValidationReport

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

ValidationReport

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

ValidationReport