Source code for qblox_instruments.ieee488_2.transport
# ----------------------------------------------------------------------------
# Description : Transport layer (abstract, IP, file, dummy)
# Git repository : https://gitlab.com/qblox/packages/software/qblox_instruments.git
# Copyright (C) Qblox BV (2020)
# ----------------------------------------------------------------------------
# -- include -----------------------------------------------------------------
from abc import ABCMeta, abstractmethod
from typing import Optional
# -- class --------------------------------------------------------------------
[docs]
class Transport(metaclass=ABCMeta):
"""
Abstract base class for data transport to instruments.
"""
# ------------------------------------------------------------------------
[docs]
@abstractmethod
def close(self) -> None:
"""
Abstract method to close instrument.
"""
pass
# ------------------------------------------------------------------------
[docs]
@abstractmethod
def write(self, cmd_str: str) -> None:
"""
Abstract method to write command to instrument.
Parameters
----------
cmd_str : str
Command
"""
pass
# ------------------------------------------------------------------------
[docs]
@abstractmethod
def write_binary(self, *data: bytes) -> None:
"""
Abstract method to write binary data to instrument.
Parameters
----------
*data : bytes
Binary data
"""
pass
# ------------------------------------------------------------------------
[docs]
@abstractmethod
def read_binary(self, size: int) -> bytes:
"""
Abstract method to read binary data from instrument.
Parameters
----------
size : int
Number of bytes
Returns
----------
bytes
Binary data array of length "size".
"""
pass
# ------------------------------------------------------------------------
[docs]
@abstractmethod
def readline(self) -> str:
"""
Abstract method to read data from instrument.
Returns
----------
str
String with data.
"""
pass
# ------------------------------------------------------------------------
def __enter__(self) -> "Transport":
"""
Context manager entry.
Returns
-------
Any
Returns self
"""
return self
# ------------------------------------------------------------------------
def __exit__(self, exc_type, exc_value, traceback) -> Optional[bool]:
"""
Context manager exit. Closes the transport.
"""
self.close()
