Source code for qcodes.instrument_drivers.Keysight.private.error_handling

from typing import Tuple

from typing_extensions import Protocol

from qcodes.instrument.base import InstrumentProtocol


[docs]class KeysightErrorProtocol(InstrumentProtocol, Protocol):
[docs] def error(self) -> Tuple[int, str]: ...
[docs]class KeysightErrorQueueMixin: """ Mixin class for visa instruments that happen to implement an error queue. It is meant to work ONLY with drivers for Keysight instruments (which inherit from VisaInstrument class). """
[docs] def error(self: KeysightErrorProtocol) -> Tuple[int, str]: """ Return the first error message in the queue. It also clears it from the error queue. Up to 20 errors can be stored in the instrument's error queue. Error retrieval is first-in-first-out (FIFO). If more than 20 errors have occurred, the most recent error stored in the queue is replaced with -350,"Queue overflow". No additional errors are stored until you remove errors from the queue. If no errors have occurred when you read the error queue, the instrument responds with +0,"No error". Returns: The error code and the error message. """ rawmssg = self.ask('SYSTem:ERRor?') code = int(rawmssg.split(',')[0]) mssg = rawmssg.split(',')[1].strip().replace('"', '') return code, mssg
[docs] def flush_error_queue(self: KeysightErrorProtocol, verbose: bool = True) -> None: """ Clear the instrument error queue, and prints it. Args: verbose: If true, the error messages are printed. Default: True. """ self.log.debug('Flushing error queue...') err_code, err_message = self.error() self.log.debug(f' {err_code}, {err_message}') if verbose: print(err_code, err_message) while err_code != 0: err_code, err_message = self.error() self.log.debug(f' {err_code}, {err_message}') if verbose: print(err_code, err_message) self.log.debug('...flushing complete')