# ----------------------------------------------------------------------------
# Description : SCPI interface
# Git repository : https://gitlab.com/qblox/packages/software/qblox_instruments.git
# Copyright (C) Qblox BV (2020)
# ----------------------------------------------------------------------------
# ----------------------------------------------------------------------------
# THIS FILE IS AUTOMATICALLY GENERATED. DO NOT MODIFY THIS FILE MANUALLY!
# ----------------------------------------------------------------------------
# -- include ------------------------------------------------------------------
import sys
import struct
import re
import json
from typing import Any, Dict, List, Optional, Tuple
# Add IEEE488.2 support
from qblox_instruments.ieee488_2 import Ieee488_2, Transport
from qblox_instruments.scpi.error_check import scpi_error_check
from qblox_instruments.types import DebugLevel
# -- class --------------------------------------------------------------------
[docs]
class Cluster(Ieee488_2):
"""
This interface provides an API for the mandatory and required SCPI calls and adds
Cluster related functionality
(see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
"""
# -------------------------------------------------------------------------
[docs]
def __init__(
self, transport: Transport, debug: DebugLevel = DebugLevel.MINIMAL_CHECK
):
"""
Creates SCPI interface object.
Parameters
----------
transport : Transport
Transport class responsible for the lowest level of communication
(e.g. Ethernet).
debug : DebugLevel
Debug level, which determines if and when version match checks and
SCPI error checks are done.
Returns
----------
Raises
----------
ConnectionError
version_check is True and there is a device or version mismatch.
"""
self._debug = debug
# Initialize parent class.
super(Cluster, self).__init__(transport)
if self._debug in (
DebugLevel.MINIMAL_CHECK,
DebugLevel.VERSION_AND_ERROR_CHECK,
):
# Check if device and build are compatible.
_, _, *_, build = self._read("*IDN?").split(",")
build_ref = "fwVersion=0.12.0 fwBuild=26/09/2025-09:02:05 fwHash=0x0C12F6CC fwDirty=0 kmodVersion=0.13.0 kmodBuild=22/10/2025-12:58:39 kmodHash=0x28A9548B kmodDirty=0 swVersion=0.13.0 swBuild=22/10/2025-12:58:39 swHash=0x28A9548B swDirty=0 cfgManVersion=0.12.0 cfgManBuild=22/10/2025-12:58:39 cfgManHash=0x28A9548B cfgManDirty=0"
if build != build_ref:
build = re.split(" |=", build)
build_ref = re.split(" |=", build_ref)
import qblox_instruments # importing here to prevent circular import error.
raise ConnectionError(
f"Qblox Instruments package version (`qblox-instruments=={qblox_instruments.__version__}`) is not compatible with "
"the firmware that is installed on the hardware. Here are the device versions of what is expected by "
f"`qblox-instruments=={qblox_instruments.__version__}` and what is installed on the hardware (actual):\n"
"\n"
f" {' ':<15}{'Expected:':<25} {'Actual:'}\n"
f"{'Firmware'}\n"
f"{'Version:':>15} {build_ref[1]:<25} {build[1]}\n"
f"{'Date:':>15} {build_ref[3]:<25} {build[3]}\n"
f"{'Hash:':>15} {build_ref[5]:<25} {build[5]}\n"
f"{'Dirty:':>15} {build_ref[7]:<25} {build[7]}\n"
f"{'Kernel module'}\n"
f"{'Version:':>15} {build_ref[9]:<25} {build[9]}\n"
f"{'Date:':>15} {build_ref[11]:<25} {build[11]}\n"
f"{'Hash:':>15} {build_ref[13]:<25} {build[13]}\n"
f"{'Dirty:':>15} {build_ref[15]:<25} {build[15]}\n"
f"{'Application'}\n"
f"{'Version:':>15} {build_ref[17]:<25} {build[17]}\n"
f"{'Date:':>15} {build_ref[19]:<25} {build[19]}\n"
f"{'Hash:':>15} {build_ref[21]:<25} {build[21]}\n"
f"{'Dirty:':>15} {build_ref[23]:<25} {build[23]}\n"
"\n"
"To Resolve this issue:\n"
f"- Update your device's firmware ({build_ref[1]}) to a compatible version. \n"
"- Alternatively, install a compatible version of the python `qblox-instruments` "
"package that matches your current "
f"device firmware (version {build_ref[1]}).\n"
"For information on version compatibility refer to https://gitlab.com/qblox/packages/software/qblox_instruments#compatibility-matrix"
"For detailed instructions on updating firmware or installing a compatible version "
"of the Qblox Instruments package, please refer to our troubleshooting guide, "
"https://qblox-qblox-instruments.readthedocs-hosted.com/en/master/cluster/troubleshooting.html.\n"
"\n"
"Support: \n"
"If you require assistance or encounter any issues during the update process, please contact our support team at "
"[email protected] or visit our support page."
)
if self._debug != DebugLevel.NO_CHECK:
# Clear SCPI error queue.
while int(self._read("SYSTem:ERRor:COUNt?")) != 0:
self._read("SYSTem:ERRor:NEXT?")
# -------------------------------------------------------------------------
[docs]
def get_system_error(self) -> str:
"""
Get system error from queue (see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
None
Returns
-------
str
System error description string.
"""
# SCPI call
var0 = self._read("SYSTem:ERRor:NEXT?")
return var0
# -------------------------------------------------------------------------
[docs]
def get_num_system_error(self) -> int:
"""
Get number of system errors (see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
None
Returns
-------
int
Current number of system errors.
"""
# SCPI call
var0 = self._read("SYSTem:ERRor:COUNt?")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_idn(self) -> str:
"""
Get device identity and build information.
Parameters
----------
None
Returns
-------
str
Concatenated list of strings separated by the semicolon character. The IDN consists of four strings respectively ordered as:
- Manufacturer
- Model
- Serial number
- Build information
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("*IDN?")
return var0
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_json_description(self) -> Any:
"""
Returns a JSON description of the instrument and all its managed modules.
Parameters
----------
None
Returns
-------
Any
Instrument description structure.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read_bin("*DESCribe?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_system_version(self) -> str:
"""
Get SCPI system version (see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
None
Returns
-------
str
SCPI system version.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("SYSTem:VERSion?")
return var0
# -------------------------------------------------------------------------
@scpi_error_check
def _get_scpi_commands(self) -> str:
"""
Get SCPI commands.
Parameters
----------
None
Returns
-------
str
Concatenated list of strings separated by the semicolon character. Each command consists of nine sections respectively ordered as:
- SCPI command pattern
- SCPI input type
- SCPI output type
- Python function
- Python input types (comma separated)
- Python input variable names (comma separated)
- Python output types (comma separated)
- User access level (0 = public, >=1 = private)
- Comment
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("*CMDS?")
return var0
# -------------------------------------------------------------------------
@scpi_error_check
def _temp_file_new(self) -> int:
"""
Creates a temporary file for the purpose of sending a large batch of data to the instrument, such as an update file.
Parameters
----------
None
Returns
-------
int
Handle by which the file can be identified.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("TMPFILe:NEW?")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _temp_file_delete(self, handle: int) -> None:
"""
Deletes a temporary file.
Parameters
----------
handle : int
Temporary file handle.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
self._write(f"TMPFILe:DELete {handle}")
# -------------------------------------------------------------------------
@scpi_error_check
def _temp_file_size(self, handle: int) -> int:
"""
Returns the size of a temporary file in bytes.
Parameters
----------
handle : int
Temporary file handle.
Returns
-------
int
Size of the file in bytes.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"TMPFILe:SIZe? {handle}")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _temp_file_block_count(self, handle: int) -> int:
"""
Returns the number of blocks that can be read from a temporary file.
Parameters
----------
handle : int
Temporary file handle.
Returns
-------
int
Number of blocks that can be read.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"TMPFILe:BLOCK:COUNT? {handle}")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _temp_file_block_read(self, handle: int, block: int) -> bytes:
"""
Reads the nth block of a temporary file.
Parameters
----------
handle : int
Temporary file handle.
block : int
Block index.
Returns
-------
bytes
Contents of the block.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"TMPFILe:BLOCK:READ? {handle},{block}")
return var0
# -------------------------------------------------------------------------
@scpi_error_check
def _temp_file_append(self, handle: int, data: bytes) -> None:
"""
Appends a block of data to a temporary file.
Parameters
----------
handle : int
Temporary file handle.
data : bytes
Data to append.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "bytes"])
# SCPI call
self._write_bin(f"TMPFILe:APPend {handle},", data)
# -------------------------------------------------------------------------
@scpi_error_check
def _task_poll(self, handle: int) -> float:
"""
Polls for completion of the given task.
Parameters
----------
handle : int
Task handle.
Returns
-------
float
Task progress from 0.0 to 1.0. 1.0 indicates completion.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"TASK:POLL? {handle}")
return float(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _task_get_result(self, handle: int) -> Any:
"""
Retrieves the value returned by a task. The task must be complete. If the task yielded an error, the error will be returned by this call. The task handle is deleted once the value is returned.
Parameters
----------
handle : int
Task handle.
Returns
-------
Any
The result of the task.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read_bin(f"TASK:RESult? {handle}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def set_name(self, name: str) -> None:
"""
Sets the customer-specified name of the instrument. The name must not contain any newlines, backslashes, or double quotes.
Parameters
----------
name : str
The new name for the device.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["str"])
# SCPI call
self._write(f'SYSTem:NAME "{name}"')
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_name(self) -> str:
"""
Returns the customer-specified name of the instrument.
Parameters
----------
None
Returns
-------
str
The name of the device.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("SYSTem:NAME?")
return var0
# -------------------------------------------------------------------------
@scpi_error_check
def _download_log(self, source: str, format: int) -> int:
"""
Prepares a batch of log data for retrieval via temp_file_*(). This may take some time, so instead of returning immediately, this spawns a task. task_poll() may be used to poll the state of the task, once this returns True (task complete), use task_get_result() to get the temp_file handle.
Parameters
----------
source : str
The log source. Must be "system" for the Linux system log,"cfg_man" for the configuration manager log, or "app" for the main application log.
format : int
The format. Specify a positive integer to get up to that number of lines from the log. Specify zero to get the complete current log file (older log entries may exist via logrotate, only the file currently being written is returned). Specify a negative number to get all available log data in .tgz format.
Returns
-------
int
Task handle.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["str", "int"])
# SCPI call
var0 = self._read(f'SYSTem:LOG? "{source}",{format}')
return int(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def set_ip_config(self, config: str) -> None:
"""
Reconfigures the IP address of this device. The configuration will not go into effect until reboot() is called or the device is power-cycled.
Parameters
----------
config : str
IP configuration. May be one of the following things:
- an IPv4 address including prefix length, for example 192.168.0.2/24, - the string `dhcp` to enable IPv4 DHCP, - an IPv6 address including prefix length, for example 1:2::3:4/64, or - a semicolon-separated combination of an IPv4 configuration (IP address or `dhcp`) and an IPv6 address.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["str"])
# SCPI call
self._write(f'SYSTem:IPCONFig "{config}"')
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_ip_config(self) -> str:
"""
Returns the IP address configuration that will go into effect when the device reboots.
Parameters
----------
None
Returns
-------
str
IP configuration. Can be one of the following things:
- an IPv4 address including prefix length, for example 192.168.0.2/24, - the string `dhcp` to enable IPv4 DHCP, - an IPv6 address including prefix length, for example 1:2::3:4/64, or - a semicolon-separated combination of an IPv4 configuration (IP address or `dhcp`) and an IPv6 address.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("SYSTem:IPCONFig?")
return var0
# -------------------------------------------------------------------------
@scpi_error_check
def _get_update_module_types(self) -> str:
"""
Returns a comma-separated list of device types that may be updated in addition to our own device type in the form of cluster modules. Returns ``not_applicable`` if this is not applicable to this device type.
Parameters
----------
None
Returns
-------
str
Comma-separated list of device types.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("SYSTem:UPDATE:MODules?")
return var0
# -------------------------------------------------------------------------
@scpi_error_check
def _exclude_from_update(self, excluded_slots: Any) -> None:
"""
Exclude the specified slots from the update
Parameters
----------
excluded_slots : Any
List of slots to exclude from update
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["Any"])
# SCPI call
self._write_bin(
f"SYSTem:UPDATE:EXCLude", json.dumps(excluded_slots).encode("utf-8")
)
# -------------------------------------------------------------------------
@scpi_error_check
def _include_in_update(self, excluded_slots: Any) -> None:
"""
Include only the specified slots in the update
Parameters
----------
excluded_slots : Any
List of slots to update
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["Any"])
# SCPI call
self._write_bin(
f"SYSTem:UPDATE:INCLude", json.dumps(excluded_slots).encode("utf-8")
)
# -------------------------------------------------------------------------
@scpi_error_check
def _update(self, handle: int) -> int:
"""
Updates the device with an update tarball that was previously uploaded using temp_file_*() commands. This command merely starts the update process, and returns a task handle that can polled for completion via task_poll(), at which point any errors that may have occurred must be retrieved using task_get_result(). The task will return the string "OK" if successful. If this happens, the device must be rebooted via the reboot() command or via a power cycle to fully apply the update. Do not power down the device while the update task is running.
Parameters
----------
handle : int
Temporary file handle for the update tarball.
Returns
-------
int
Task handle.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SYSTem:UPDATE:PREPare? {handle}")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _rollback(self) -> int:
"""
Rolls back the device to the previous version, if rollback information is available. This command merely starts the rollback process, and returns a task handle that can polled for completion via task_poll(), at which point any errors that may have occurred must be retrieved using task_get_result(). The task will return the string "OK" if successful. If this happens, the device must be rebooted via the reboot() command or via a power cycle to fully apply the rollback. Do not power down the device while the rollback task is running.
Parameters
----------
None
Returns
-------
int
Task handle.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("SYSTem:ROLLBACK:PREPare?")
return int(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def reboot(self) -> None:
"""
Reboots the instrument.
Parameters
----------
None
Returns
-------
None
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
self._write("SYSTem:REBOOT")
# -------------------------------------------------------------------------
@scpi_error_check
def _arm_timekeeping_capture(
self, source: int, polarity: int, sync_ref: int
) -> None:
"""
Configure and ARM TIMEkeeping capture.
Parameters
----------
source : int
source (0 = party line, 1-7 = channel)
polarity : int
polarity (0 = falling edge, 1 = rising edge)
sync_ref : int
sync ref (0 = not sync, 1 = sync to internal 10 MHz clock)
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
self._write(f"TIMEkeeping:CAPTure:ARM {source},{polarity},{sync_ref}")
# -------------------------------------------------------------------------
@scpi_error_check
def _get_timekeeping_capture_status(self) -> Any:
"""
Timekeeping capture status
Parameters
----------
None
Returns
-------
Any
Configuration struct.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read_bin("TIMEkeeping:CAPTure:STATus?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _adjust_timekeeping(self, adjust: Any) -> None:
"""
Adjust TIMEkeeping
Parameters
----------
adjust : Any
Delta to adjust
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["Any"])
# SCPI call
self._write_bin(f"TIMEkeeping:ADJust", json.dumps(adjust).encode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_current_timestamp(self) -> Any:
"""
Get current CTC timestamp.
Parameters
----------
None
Returns
-------
Any
Struct with current timestamp ns and sub ns.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read_bin("TIMEkeeping:CURRent:TIMEstamp?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_timekeeping_sync_status(self) -> str:
"""
Get timekeeping sync status.
Parameters
----------
None
Returns
-------
str
Concatenated list of strings separated by the semicolon character. Status is indicated by one status string and an optional number of flags respectively ordered as:
:Status:
- ``OKAY``: System is okay.
- ``RESOLVED``: An error indicated by the flags occurred, but has been resolved.
- ``ERROR``: An error indicated by the flags is occurring.
:StatE:
- ``SYNCED``: Internally synchronized.
- ``NOT SYNCED``: Internally synchronized.
:Flags:
- ``SYNC DONE``
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("TIMEkeeping:SYNC:STATUS?")
return var0
# -------------------------------------------------------------------------
@scpi_error_check
def _timekeeping_capt_ext_trigger(self, trigger_channel: int) -> None:
"""
Start an externally triggered capture on this module, on the channel provided as an argument by the user.
Parameters
----------
trigger_channel : int
Channel that will be used to capture the trigger.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
self._write(f"TIMEkeeping:CAPTure:EXT:TRIGger {trigger_channel}")
# -------------------------------------------------------------------------
@scpi_error_check
def _get_timekeeping_status(self) -> Any:
"""
Get current timekeeping status
Parameters
----------
None
Returns
-------
Any
Struct with current timekeeping status information
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read_bin("TIMEkeeping:STATus?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _reset(self) -> None:
"""
Reset device and clear all status and event registers (see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
None
Returns
-------
None
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
self._write("*RST")
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def clear(self) -> None:
"""
Clear all status and event registers (see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
None
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
self._write("*CLS")
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_status_byte(self) -> int:
"""
Get status byte register. Register is only cleared when feeding registers are cleared (see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
None
Returns
-------
int
Status byte register.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("*STB?")
return int(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def set_service_request_enable(self, reg: int) -> None:
"""
Set service request enable register (see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
reg : int
Service request enable register.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
self._write(f"*SRE {reg}")
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_service_request_enable(self) -> int:
"""
Get service request enable register. The register is cleared after reading it (see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
None
Returns
-------
int
Service request enable register.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("*SRE?")
return int(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def set_standard_event_status_enable(self, reg: int) -> None:
"""
Set standard event status enable register (see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
reg : int
Standard event status enable register.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
self._write(f"*ESE {reg}")
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_standard_event_status_enable(self) -> int:
"""
Get standard event status enable register. The register is cleared after reading it (see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
None
Returns
-------
int
Standard event status enable register.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("*ESE?")
return int(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_standard_event_status(self) -> int:
"""
Get standard event status register. The register is cleared after reading it (see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
None
Returns
-------
int
Standard event status register.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("*ESR?")
return int(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def set_operation_complete(self) -> None:
"""
Set device in operation complete query active state (see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
None
Returns
-------
None
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
self._write("*OPC")
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_operation_complete(self) -> bool:
"""
Get operation complete state (see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
None
Returns
-------
bool
Operation complete state (False = running, True = completed).
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("*OPC?")
return bool(int(var0))
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def test(self) -> bool:
"""
Run self-test. Currently not implemented (see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
None
Returns
-------
bool
Test result (False = failed, True = success).
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("*TST?")
return bool(int(var0))
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def wait(self) -> None:
"""
Wait until operations completed before continuing (see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
None
Returns
-------
None
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
self._write("*WAI")
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def preset_system_status(self) -> None:
"""
Preset system status registers. Connects general system status flags for PLL unlock and temperature out-of-range indications
to event status enable, status questionable temperature and status questionable frequency registers respectively
(see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
None
Returns
-------
None
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
self._write("STATus:PRESet")
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_questionable_condition(self) -> int:
"""
Get status questionable condition register (see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
None
Returns
-------
int
Status questionable condition register.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("STATus:QUEStionable:CONDition?")
return int(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_questionable_event(self) -> int:
"""
Get status questionable event register (see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
None
Returns
-------
int
Status questionable event register.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("STATus:QUEStionable:EVENt?")
return int(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def set_questionable_enable(self, reg: int) -> None:
"""
Set status questionable enable register (see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
reg : int
Status questionable enable register.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
self._write(f"STATus:QUEStionable:ENABle {reg}")
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_questionable_enable(self) -> int:
"""
Get status questionable enable register (see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
None
Returns
-------
int
Status questionable enable register.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("STATus:QUEStionable:ENABle?")
return int(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_operation_condition(self) -> int:
"""
Get status operation condition register (see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
None
Returns
-------
int
Status operation condition register.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("STATus:OPERation:CONDition?")
return int(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_operation_events(self) -> int:
"""
Get status operation event register (see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
None
Returns
-------
int
Status operation event register.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("STATus:OPERation:EVENt?")
return int(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def set_operation_enable(self, reg: int) -> None:
"""
Set status operation enable register (see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
reg : int
Status operation enable register.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
self._write(f"STATus:OPERation:ENABle {reg}")
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_operation_enable(self) -> int:
"""
Get status operation enable register (see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
None
Returns
-------
int
Status operation enable register.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("STATus:OPERation:ENABle?")
return int(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def identify(self) -> None:
"""
Toggle frontpanel LEDs to visually identify the instrument.
Parameters
----------
None
Returns
-------
None
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
self._write("*IDENtify")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_led_brightness(self, brightness: str) -> None:
"""
Set frontpanel LED brightness. Valid inputs to set LED brightness are 'HIGH', 'MEDIUM', 'LOW' and 'OFF'
Parameters
----------
brightness : str
LED brightness.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["str"])
# SCPI call
self._write(f'STATus:QUEStionable:LED:BRIGHTness "{brightness}"')
# -------------------------------------------------------------------------
@scpi_error_check
def _get_led_brightness(self) -> str:
"""
Get frontpanel LED brightness.
Parameters
----------
None
Returns
-------
str
LED brightness.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("STATus:QUEStionable:LED:BRIGHTness?")
return var0
# -------------------------------------------------------------------------
@scpi_error_check
def _get_system_state(self) -> str:
"""
Get general system state.
Parameters
----------
None
Returns
-------
str
Concatenated list of strings separated by the semicolon character. Status is indicated by one status string and an optional number of flags respectively ordered as:
:Status:
- ``OKAY``: System is okay.
- ``RESOLVED``: An error indicated by the flags occurred, but has been resolved.
- ``ERROR``: An error indicated by the flags is occurring.
:Flags:
- ``PLL UNLOCKED``
- ``TEMPERATURE OUT-OF-RANGE``
- ``MODULE NOT CONNECTED`` (only for Cluster)
- ``FEEDBACK NETWORK CALIBRATION FAILED`` (only for Cluster)
- ``HARDWARE FAULT``
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("STATus:GENeral:STATE?")
return var0
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_hardware_revisions(self) -> Any:
"""
Get a table with the different hardware revisions of the current module
Parameters
----------
None
Returns
-------
Any
The module's hardware revision table
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read_bin("STATus:HARDware:REVisions?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_reference_source(self, internal: bool) -> None:
"""
Set reference (10MHz) clock source.
Parameters
----------
internal : bool
Reference clock source (False = External, True = Internal).
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["bool"])
# SCPI call
self._write(
f"STATus:QUEStionable:FREQuency:REFerence:SRC {0 if internal == False else 1}"
)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_reference_source(self) -> bool:
"""
Get reference (10MHz) clock source.
Parameters
----------
None
Returns
-------
bool
Reference clock source (False = External, True = Internal).
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("STATus:QUEStionable:FREQuency:REFerence:SRC?")
return bool(int(var0))
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_current_fpga_temperature(self, slot: int) -> float:
"""
Get current FPGA junction temperature (inside device).
Parameters
----------
slot : int
slot index.
Returns
-------
float
Current FPGA junction temperature.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:STATus:QUEStionable:TEMPerature:FPGA:CURRent?")
return float(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_maximum_fpga_temperature(self, slot: int) -> float:
"""
Get maximum FPGA junction temperature since boot or clear (inside device).
Parameters
----------
slot : int
slot index.
Returns
-------
float
Maximum FPGA junction temperature.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:STATus:QUEStionable:TEMPerature:FPGA:MAXimum?")
return float(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_current_carrier_temperature(self, slot: int) -> float:
"""
Get current carrier board temperature (inside device).
Parameters
----------
slot : int
slot index.
Returns
-------
float
Current carrier board temperature.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(
f"SLOT{slot}:STATus:QUEStionable:TEMPerature:CARRier:CURRent?"
)
return float(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_maximum_carrier_temperature(self, slot: int) -> float:
"""
Get maximum carrier board temperature since boot or clear (inside device).
Parameters
----------
slot : int
slot index.
Returns
-------
float
Maximum carrier board temperature.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(
f"SLOT{slot}:STATus:QUEStionable:TEMPerature:CARRier:MAXimum?"
)
return float(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_current_afe_low_temperature(self, slot: int) -> float:
"""
Get current QRC AFE low board temperature (inside device).
Parameters
----------
slot : int
slot index.
Returns
-------
float
Current QRC AFE low board temperature.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(
f"SLOT{slot}:STATus:QUEStionable:TEMPerature:AFE:LOW:CURRent?"
)
return float(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_maximum_afe_low_temperature(self, slot: int) -> float:
"""
Get maximum QRC AFE low board temperature since boot or clear (inside device).
Parameters
----------
slot : int
slot index.
Returns
-------
float
Maximum QRC AFE low board temperature.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(
f"SLOT{slot}:STATus:QUEStionable:TEMPerature:AFE:LOW:MAXimum?"
)
return float(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_current_afe_high_temperature(self, slot: int) -> float:
"""
Get current QRC AFE board board temperature (inside device).
Parameters
----------
slot : int
slot index.
Returns
-------
float
Current QRC AFE board board temperature.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(
f"SLOT{slot}:STATus:QUEStionable:TEMPerature:AFE:HIGH:CURRent?"
)
return float(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_maximum_afe_high_temperature(self, slot: int) -> float:
"""
Get maximum QRC AFE board board temperature since boot or clear (inside device).
Parameters
----------
slot : int
slot index.
Returns
-------
float
Maximum QRC AFE board board temperature.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(
f"SLOT{slot}:STATus:QUEStionable:TEMPerature:AFE:HIGH:MAXimum?"
)
return float(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_current_bp_temperature_0(self) -> float:
"""
Get current backplane board temperature from sensor 0 (inside device).
Parameters
----------
None
Returns
-------
float
Current backplane board temperature from sensor 0.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("STATus:QUEStionable:TEMPerature:BP0:CURRent?")
return float(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_maximum_bp_temperature_0(self) -> float:
"""
Get maximum backplane board temperature from sensor 0 since boot or clear (inside device).
Parameters
----------
None
Returns
-------
float
Maximum backplane board temperature from sensor 0.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("STATus:QUEStionable:TEMPerature:BP0:MAXimum?")
return float(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_current_bp_temperature_1(self) -> float:
"""
Get current backplane board temperature from sensor 1 (inside device).
Parameters
----------
None
Returns
-------
float
Current backplane board temperature from sensor 1.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("STATus:QUEStionable:TEMPerature:BP1:CURRent?")
return float(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_maximum_bp_temperature_1(self) -> float:
"""
Get maximum backplane board temperature from sensor 1 since boot or clear (inside device).
Parameters
----------
None
Returns
-------
float
Maximum backplane board temperature from sensor 1.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("STATus:QUEStionable:TEMPerature:BP1:MAXimum?")
return float(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_current_bp_temperature_2(self) -> float:
"""
Get current backplane board temperature from sensor 2 (inside device).
Parameters
----------
None
Returns
-------
float
Current backplane board temperature from sensor 2.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("STATus:QUEStionable:TEMPerature:BP2:CURRent?")
return float(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_maximum_bp_temperature_2(self) -> float:
"""
Get maximum backplane board temperature from sensor 2 since boot or clear (inside device).
Parameters
----------
None
Returns
-------
float
Maximum backplane board temperature from sensor 2.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("STATus:QUEStionable:TEMPerature:BP2:MAXimum?")
return float(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_modules_present(self) -> int:
"""
Get an indication of module presence for each slot of the Cluster.
Parameters
----------
None
Returns
-------
int
Module present indication where each bit represents a single slot and the LSB is slot 1 (False = not present, True = present).
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("BP:MODules?")
return int(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def shutdown_modules(self, slots: Any) -> None:
"""
Shutdown modules in the given slots
Parameters
----------
slots : Any
Slot numbers of modules to shutdown.
Returns
-------
None
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
Exception
Invalid input parameter type.
"""
# Check input types.
self._check_in_type(locals(), ["Any"])
# SCPI call
self._write_bin(f"BP:MODules:SHUTdown", json.dumps(slots).encode("utf-8"))
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def shutdown_module(self, slot: int) -> None:
"""
Shutdown specific connected module
Parameters
----------
slot : int
slot index.
Returns
-------
None
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
Exception
Invalid input parameter type.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
self._write(f"BP:MODule{slot}:SHUTdown")
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def reboot_modules(self, slots: Any) -> None:
"""
Reboots the instruments in the given slots. If slot 0 (CMM) is included, the whole cluster reboots
Parameters
----------
slots : Any
Slot numbers of modules to reboot.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["Any"])
# SCPI call
self._write_bin(f"BP:MODules:REBOOT", json.dumps(slots).encode("utf-8"))
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def reboot_module(self, slot: int) -> None:
"""
Reboots the instrument in the given slot. If slot 0 (CMM) is given, the whole cluster reboots
Parameters
----------
slot : int
slot index.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
self._write(f"BP:MODule{slot}:REBOOT")
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def powerup_modules(self, slots: Any) -> None:
"""
Powers up the instrument in the given slots.
Parameters
----------
slots : Any
Slot numbers of modules to reboot.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["Any"])
# SCPI call
self._write_bin(f"BP:MODules:POWerup", json.dumps(slots).encode("utf-8"))
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def powerup_module(self, slot: int) -> None:
"""
Powers up the instrument in the given slot.
Parameters
----------
slot : int
slot index.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
self._write(f"BP:MODule{slot}:POWerup")
# -------------------------------------------------------------------------
@scpi_error_check
def _get_mods_info(self) -> Any:
"""
Get information about the available modules
Parameters
----------
None
Returns
-------
Any
Module types available per slot
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read_bin("*MODS?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _slot_reset(self, slot: int) -> None:
"""
Reset the module in the slot specified by slot_index,and clear all its status and event registers (see `SCPI <https://www.ivifoundation.org/downloads/SCPI/scpi-99.pdf>`_).
Parameters
----------
slot : int
slot index.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
self._write(f"SLOT{slot}:RST")
# -------------------------------------------------------------------------
@scpi_error_check
def _get_slot_idn(self, slot: int) -> str:
"""
Get IDN from given slot number
Parameters
----------
slot : int
slot index.
Returns
-------
str
Concatenated list of strings separated by the semicolon character, related to the slot provided in the argument. The IDN consists of four strings respectively ordered as:
- Manufacturer
- Model
- Serial number
- Build information
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:IDN?")
return var0
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def set_trg_in_delay(self, trg_in_delay: int) -> None:
"""
Set external trigger input delay
Parameters
----------
trg_in_delay : int
External trigger input delay (ps), in steps of 39 ps.
Returns
-------
None
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
self._write(f"TRG:IN:DLY {trg_in_delay}")
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_trg_in_delay(self) -> int:
"""
Get external trigger input delay
Parameters
----------
None
Returns
-------
int
Current status of the external trigger input delay (ps), in steps of 39 ps.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("TRG:IN:DLY?")
return int(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def set_trg_in_map_en(self, trg_in_map_en: bool) -> None:
"""
Set external trigger input map enable
Parameters
----------
trg_in_map_en : bool
External trigger input map enable
Returns
-------
None
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["bool"])
# SCPI call
self._write(f"TRG:IN:MAP:ENAble {0 if trg_in_map_en == False else 1}")
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_trg_in_map_en(self) -> bool:
"""
Get external trigger input map enable
Parameters
----------
None
Returns
-------
bool
Current status of the external trigger input map enable
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("TRG:IN:MAP:ENAble?")
return bool(int(var0))
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def set_trg_in_map_addr(self, trg_in_map_addr: int) -> None:
"""
Set external trigger input map enable
Parameters
----------
trg_in_map_addr : int
External trigger input map address
Returns
-------
None
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
self._write(f"TRG:IN:MAP:ADDRess {trg_in_map_addr}")
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_trg_in_map_addr(self) -> int:
"""
Get external trigger input map address
Parameters
----------
None
Returns
-------
int
Current status of the external trigger input map address
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("TRG:IN:MAP:ADDRess?")
return int(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def reset_trigger_monitor_count(self, address: int) -> None:
"""
Reset external trigger monitor counter
Parameters
----------
address : int
Address of the trigger which count has to be reset
Returns
-------
None
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
self._write(f"TNN:TRG:MON:COUNT:RST {address}")
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_trigger_monitor_count(self, address: int) -> int:
"""
Get trigger monitor count
Parameters
----------
address : int
Address of the trigger
Returns
-------
int
Current status of trigger monitor counter
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"TNN:TRG:MON:COUNT? {address}")
return int(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_trigger_monitor_latest(self) -> int:
"""
Get trigger monitor latest value
Parameters
----------
None
Returns
-------
int
Latest value from the trigger monitor counter
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
var0 = self._read("TNN:TRG:MON:LAST?")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _tnn_exec_calib(self) -> None:
"""
Execute TNN calibration
Parameters
----------
None
Returns
-------
None
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
self._write("TNN:CALIB:EXEC")
# -------------------------------------------------------------------------
@scpi_error_check
def _timekeeping_intra_sync(self) -> None:
"""
Start the intra-cluster synchronization.
Parameters
----------
None
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# SCPI call
self._write("TIMEkeeping:INTra:SYNC")
# -------------------------------------------------------------------------
@scpi_error_check
def _arm_timekeeping_capture_slot(
self, slot: int, source: int, polarity: int, sync_ref: int
) -> None:
"""
Configure and ARM TIMEkeeping capture.
Parameters
----------
slot : int
slot index.
source : int
source (0 = party line, 1-7 = channel)
polarity : int
polarity (0 = falling edge, 1 = rising edge)
sync_ref : int
sync ref (0 = not sync, 1 = sync to internal 10 MHz clock)
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int", "int"])
# SCPI call
self._write(
f"SLOT{slot}:TIMEkeeping:CAPTure:ARM {source},{polarity},{sync_ref}"
)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_timekeeping_capture_slot(self, slot: int) -> Any:
"""
Get capture value after capture had been armed.
Parameters
----------
slot : int
slot index.
Returns
-------
Any
Capture values (if there has been any)
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:TIMEkeeping:CAPTure?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _sync_to_ntp(self, authority: str) -> None:
"""
Synchronize to NTP server.
Parameters
----------
authority : str
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["str"])
# SCPI call
self._write(f'TIMEkeeping:SYNC:NTP "{authority}"')
# -------------------------------------------------------------------------
@scpi_error_check
def _get_ip_status(self, slot: int) -> Any:
"""
Get ADC and DAC IP status
Parameters
----------
slot : int
slot index.
Returns
-------
Any
Reads the DAC/ADC tile and block configuration from the RFDC IP.
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:RFDC:STATus?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _sync_all(self, slot: int) -> Any:
"""
MTS sync for DAC and ADC, and also resets DUC phase
Parameters
----------
slot : int
slot index.
Returns
-------
Any
RFDC execution status.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:RFDC:SYNC:ALL?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _sync_dac(self, slot: int, tile_bitmask: int, tile_target_latency: int) -> Any:
"""
MTS sync for DACs
Parameters
----------
slot : int
slot index.
tile_bitmask : int
Bit mask of tiles to use in the MTS process
tile_target_latency : int
Default -1
Returns
-------
Any
RFDC execution status.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:RFDC:SYNC:DAC? {tile_bitmask},{tile_target_latency}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _sync_adc(self, slot: int, tile_bitmask: int, tile_target_latency: int) -> Any:
"""
MTS sync for ADCs
Parameters
----------
slot : int
slot index.
tile_bitmask : int
Bit mask of tiles to use in the MTS process
tile_target_latency : int
Default -1
Returns
-------
Any
RFDC execution status.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:RFDC:SYNC:ADC? {tile_bitmask},{tile_target_latency}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_dac_current(
self, slot: int, tile_id: int, block_id: int, current: int
) -> Any:
"""
Set current on DAC output
Parameters
----------
slot : int
slot index.
tile_id : int
Tile ID of the target DAC
block_id : int
Block ID of the target DAC
current : int
Current in uA, between 2250 and 40000
Returns
-------
Any
RFDC execution status.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:RFDC:DAC:CURRENT? {tile_id},{block_id},{current}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_sysref_state(self, slot: int, state: bool) -> Any:
"""
Set the analog sysref state of the receiver
Parameters
----------
slot : int
slot index.
state : bool
True to enable, False to disable
Returns
-------
Any
RFDC execution status.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "bool"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:RFDC:SET:SYSREF:STATE? {0 if state == False else 1}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _reset_duc_phase_dac(self, slot: int, tile_id: int, block_id: int) -> Any:
"""
Reset the NCO of the DAC block
Parameters
----------
slot : int
slot index.
tile_id : int
Tile ID of the target DAC
block_id : int
Block ID of the target DAC
Returns
-------
Any
RFDC execution status.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:RFDC:DAC:RESET:DUC? {tile_id},{block_id}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _reset_duc_phase_adc(self, slot: int, tile_id: int, block_id: int) -> Any:
"""
Reset the NCO of the ADC block
Parameters
----------
slot : int
slot index.
tile_id : int
Tile ID of the target ADC
block_id : int
Block ID of the target ADC
Returns
-------
Any
RFDC execution status.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:RFDC:ADC:RESET:DUC? {tile_id},{block_id}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _reset_duc_phase_all(self, slot: int) -> Any:
"""
Reset the NCO of the ADC and DAC blocks
Parameters
----------
slot : int
slot index.
Returns
-------
Any
RFDC execution status.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:RFDC:RESET:DUC?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_inv_sync_filter(
self, slot: int, tile_id: int, block_id: int, Mode: int
) -> Any:
"""
Set inverse sync filter mode
Parameters
----------
slot : int
slot index.
tile_id : int
Tile ID of the target DAC
block_id : int
Block ID of the target DAC
Mode : int
Valid values are 0 (disable), 1 (First Nyquist Zone), and for Gen 3 devices only, 2(Second Nyquist Zone)
Returns
-------
Any
RFDC execution status.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:RFDC:DAC:SET:INV:SYNC:FILT? {tile_id},{block_id},{Mode}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_mixer_settings_freq_dac(
self, slot: int, tile_id: int, block_id: int, NCO_frequency: int
) -> Any:
"""
Set DAC NCO frequency in MHz
Parameters
----------
slot : int
slot index.
tile_id : int
Tile ID of the target DAC
block_id : int
Block ID of the target DAC
NCO_frequency : int
DAC NCO frequency in MHz
Returns
-------
Any
RFDC execution status.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:RFDC:DAC:SET:MIXER:FREQ? {tile_id},{block_id},{NCO_frequency}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_mixer_settings_freq_adc(
self, slot: int, tile_id: int, block_id: int, NCO_frequency: int
) -> Any:
"""
Set ADC NCO frequency in MHz
Parameters
----------
slot : int
slot index.
tile_id : int
Tile ID of the target ADC
block_id : int
Block ID of the target ADC
NCO_frequency : int
ADC NCO frequency in MHz
Returns
-------
Any
RFDC execution status.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:RFDC:ADC:SET:MIXER:FREQ? {tile_id},{block_id},{NCO_frequency}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_mixer_settings_freq_adc(
self, slot: int, tile_id: int, block_id: int
) -> Any:
"""
Get ADC NCO frequency in MHz
Parameters
----------
slot : int
slot index.
tile_id : int
Tile ID of the target ADC
block_id : int
Block ID of the target ADC
Returns
-------
Any
RFDC execution status.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:RFDC:ADC:GET:MIXER:FREQ? {tile_id},{block_id}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_mixer_settings_mode(
self, slot: int, tile_id: int, block_id: int, Mixer_mode: int
) -> Any:
"""
Set DAC NCO frequency in MHz
Parameters
----------
slot : int
slot index.
tile_id : int
Tile ID of the target DAC
block_id : int
Block ID of the target DAC
Mixer_mode : int
Typical values OFF, C2C, C2R, R2C, R2R
Returns
-------
Any
RFDC execution status.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:RFDC:DAC:SET:MIXER:MODE? {tile_id},{block_id},{Mixer_mode}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_mixer_settings_coarse_delay_dac(
self, slot: int, tile_id: int, block_id: int, delay: int
) -> Any:
"""
Set NCO coarse delay for DAC block
Parameters
----------
slot : int
slot index.
tile_id : int
Tile ID of the target DAC
block_id : int
Block ID of the target DAC
delay : int
Coarse delay in the number of samples. Range: 0 to 40 for Gen 3 devices
Returns
-------
Any
RFDC execution status.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:RFDC:DAC:SET:MIXER:COARSE:DELAY? {tile_id},{block_id},{delay}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_mixer_settings_coarse_delay_adc(
self, slot: int, tile_id: int, block_id: int, delay: int
) -> Any:
"""
Set NCO coarse delay for ADC block
Parameters
----------
slot : int
slot index.
tile_id : int
Tile ID of the target ADC
block_id : int
Block ID of the target ADC
delay : int
Coarse delay in the number of samples. Range: 0 to 40 for Gen 3 devices
Returns
-------
Any
RFDC execution status.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:RFDC:ADC:SET:MIXER:COARSE:DELAY? {tile_id},{block_id},{delay}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_mixer_settings_nco_phase_offset(
self, slot: int, tile_id: int, block_id: int, nco_phase_offset: float
) -> Any:
"""
Set DAC NCO phase offset
Parameters
----------
slot : int
slot index.
tile_id : int
Tile ID of the target DAC
block_id : int
Block ID of the target DAC
nco_phase_offset : float
Phase offset ranging from -180 to 180
Returns
-------
Any
RFDC execution status.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int", "float"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:RFDC:DAC:SET:MIXER:NCO:PHASE:OFFSET? {tile_id},{block_id},{nco_phase_offset}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_rfdc_nyquist_zone_dac(
self, slot: int, tile_id: int, block_id: int, DAC_Nyquist_zone: int
) -> Any:
"""
Set DAC RFDC nyquist zone
Parameters
----------
slot : int
slot index.
tile_id : int
Tile ID of the target DAC
block_id : int
Block ID of the target DAC
DAC_Nyquist_zone : int
odd(1) or even(2)
Returns
-------
Any
RFDC execution status.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:RFDC:DAC:SET:RFDC:NYQUIST:ZONE? {tile_id},{block_id},{DAC_Nyquist_zone}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_rfdc_nyquist_zone_adc(
self, slot: int, tile_id: int, block_id: int, ADC_Nyquist_zone: int
) -> Any:
"""
Set ADC RFDC nyquist zone
Parameters
----------
slot : int
slot index.
tile_id : int
Tile ID of the target ADC
block_id : int
Block ID of the target ADC
ADC_Nyquist_zone : int
odd(1) or even(2)
Returns
-------
Any
RFDC execution status.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:RFDC:ADC:SET:RFDC:NYQUIST:ZONE? {tile_id},{block_id},{ADC_Nyquist_zone}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_pll_fsample(
self,
slot: int,
clock_source: int,
ref_clock_frequency: float,
sampling_rate: float,
tile_id: int,
) -> Any:
"""
Set sampling clock and reference clock source and frequency
Parameters
----------
slot : int
slot index.
clock_source : int
External (0) or internal (1)
ref_clock_frequency : float
Reference clock frequency in MHz
sampling_rate : float
Sample rate in MHz
tile_id : int
DAC tile ID
Returns
-------
Any
RFDC execution status.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "float", "float", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:RFDC:DAC:SET:FSAMPLE? {clock_source},{ref_clock_frequency},{sampling_rate},{tile_id}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_fsample(self, slot: int, bypass: bool) -> None:
"""
Switch between ADF4002 or LMX clock
Parameters
----------
slot : int
slot index.
bypass : bool
true to bypass, false to use LMX clock
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "bool"])
# SCPI call
self._write(f"SLOT{slot}:SET:FSAMPLE {0 if bypass == False else 1}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_gpio_value(self, slot: int, i2c_dev: str, addr: int, value: int) -> Any:
"""
Set GPIO expander output value mask
Parameters
----------
slot : int
slot index.
i2c_dev : str
i2c device
addr : int
I2C address
value : int
Value to write
Returns
-------
Any
Execution result.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "str", "int", "int"])
# SCPI call
var0 = self._read_bin(f'SLOT{slot}:SET:GPIO:VAL? "{i2c_dev}",{addr},{value}')
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _read_gpio_value(self, slot: int, i2c_dev: str, addr: int) -> Any:
"""
Read GPIO expander input value mask
Parameters
----------
slot : int
slot index.
i2c_dev : str
i2c device
addr : int
I2C address
Returns
-------
Any
Execution result.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "str", "int"])
# SCPI call
var0 = self._read_bin(f'SLOT{slot}:READ:GPIO:VAL? "{i2c_dev}",{addr}')
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_gpio_dir(self, slot: int, i2c_dev: str, addr: int, value: int) -> Any:
"""
Set GPIO expander output dir mask
Parameters
----------
slot : int
slot index.
i2c_dev : str
i2c device
addr : int
I2C address
value : int
Dir mask to write
Returns
-------
Any
Execution result.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "str", "int", "int"])
# SCPI call
var0 = self._read_bin(f'SLOT{slot}:SET:GPIO:DIR? "{i2c_dev}",{addr},{value}')
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_decoder_mode(
self, slot: int, tile_id: int, block_id: int, mode: int
) -> Any:
"""
Set DAC decoder mode
Parameters
----------
slot : int
slot index.
tile_id : int
Tile ID of the target DAC
block_id : int
Block ID of the target DAC
mode : int
Max SNR(1) or Max Linearity(2)
Returns
-------
Any
RFDC execution status.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:RFDC:SET:DECODER:MODE? {tile_id},{block_id},{mode}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_dac_comp_mode(
self, slot: int, tile_id: int, block_id: int, mode: int
) -> Any:
"""
Set DAC output mode
Parameters
----------
slot : int
slot index.
tile_id : int
Tile ID of the target DAC
block_id : int
Block ID of the target DAC
mode : int
Valid values are 0 (Gen 3 behavior) 1 (Gen 2 behavior)
Returns
-------
Any
RFDC execution status.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:RFDC:SET:DAC:COMP:MODE? {tile_id},{block_id},{mode}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_adc_dsa(
self, slot: int, tile_id: int, block_id: int, attenuation: float
) -> Any:
"""
Set ADC attenuation
Parameters
----------
slot : int
slot index.
tile_id : int
Tile ID of the target DAC
block_id : int
Block ID of the target DAC
attenuation : float
The attenuation 0 - 27 dB for production silicon
Returns
-------
Any
RFDC execution status.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int", "float"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:RFDC:SET:ADC:DSA? {tile_id},{block_id},{attenuation}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_adc_dsa(self, slot: int, tile_id: int, block_id: int) -> Any:
"""
Get ADC attenuation
Parameters
----------
slot : int
slot index.
tile_id : int
Tile ID of the target DAC
block_id : int
Block ID of the target DAC
Returns
-------
Any
RFDC ADC attenuation value for block/tile pair.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:RFDC:ADC:GET:DSA? {tile_id},{block_id}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_interrupts_adc(self, slot: int) -> Any:
"""
Get ADC interupt status
Parameters
----------
slot : int
slot index.
Returns
-------
Any
Interrupt status of all enabled ADC tiles
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:RFDC:ADC:GET:INTERRUPTS?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _clear_interrupts(self, slot: int) -> Any:
"""
Clear all enabled interrupt status
Parameters
----------
slot : int
slot index.
Returns
-------
Any
Clears Interrupt status of all enabled interrupts
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:RFDC:ADC:CLEAR:INTERRUPTS?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_hpf_lpf_ctrl(self, slot: int, channel_id: int, value: int) -> Any:
"""
Set the value of hpf_lpf_ctrl GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
value : int
Value
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:OUT:BPF:HPFLPF:CTRL:SET:DEBUG? {channel_id},{value}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_bpf_switch_b_ctrl(self, slot: int, channel_id: int, value: int) -> Any:
"""
Set the value of bpf_switch_b_ctrl GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
value : int
Value
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:OUT:BPF:SWITCH:B:CTRL:SET:DEBUG? {channel_id},{value}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_hpf_ctrl(self, slot: int, channel_id: int, value: int) -> Any:
"""
Set the value of hpf_ctrl GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
value : int
Value
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:OUT:HPF:CTRL:SET:DEBUG? {channel_id},{value}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_bpf_switch_a_ctrl(self, slot: int, channel_id: int, value: int) -> Any:
"""
Set the value of bpf_switch_a_ctrl GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
value : int
Value
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:OUT:BPF:SWITCH:A:CTRL:SET:DEBUG? {channel_id},{value}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_bpf_band_mode_ctrl(
self, slot: int, channel_id: int, value: int
) -> Any:
"""
Set the value of bpf_band_mode_ctrl GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
value : int
Value
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:OUT:BPF:MODE:BAND:SET:DEBUG? {channel_id},{value}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_lpf_ctrl(self, slot: int, channel_id: int, value: int) -> Any:
"""
Set the value of lpf_ctrl GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
value : int
Value
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:OUT:LPF:CTRL:SET:DEBUG? {channel_id},{value}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_amp_ctrl(self, slot: int, channel_id: int, value: int) -> Any:
"""
Set the value of amp_ctrl GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
value : int
Value
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:OUT:AMP:CTRL:SET:DEBUG? {channel_id},{value}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_bpf_all_ctrl(self, slot: int, channel_id: int, value: int) -> Any:
"""
Set the value of bpf_all_ctrl GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
value : int
Value
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:OUT:BPF:ALL:CTRL:SET:DEBUG? {channel_id},{value}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_mix_dds(self, slot: int, channel_id: int, value: int) -> Any:
"""
Set the value of mix_dds GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
value : int
Value
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:OUT:MIX:SEL:SET:DEBUG? {channel_id},{value}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_out_sel(self, slot: int, channel_id: int, value: int) -> Any:
"""
Set the value of out_sel GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
value : int
Value
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:OUT:OUT:SEL:SET:DEBUG? {channel_id},{value}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_pwr_ctrl(self, slot: int, channel_id: int, value: int) -> Any:
"""
Set the value of pwr_ctrl GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
value : int
Value
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:OUT:PWR:CTRL:SET:DEBUG? {channel_id},{value}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_hpf_lpf_ctrl(self, slot: int, channel_id: int) -> Any:
"""
Get the value of hpf_lpf_ctrl GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:OUT:BPF:HPFLPF:CTRL:GET:DEBUG? {channel_id}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_bpf_switch_b_ctrl(self, slot: int, channel_id: int) -> Any:
"""
Get the value of bpf_switch_b_ctrl GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:OUT:BPF:SWITCH:B:CTRL:GET:DEBUG? {channel_id}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_hpf_ctrl(self, slot: int, channel_id: int) -> Any:
"""
Get the value of hpf_ctrl GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:OUT:HPF:CTRL:GET:DEBUG? {channel_id}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_bpf_switch_a_ctrl(self, slot: int, channel_id: int) -> Any:
"""
Get the value of bpf_switch_a_ctrl GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:OUT:BPF:SWITCH:A:CTRL:GET:DEBUG? {channel_id}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_bpf_band_mode_ctrl(self, slot: int, channel_id: int) -> Any:
"""
Get the value of bpf_band_mode_ctrl GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:OUT:BPF:MODE:BAND:GET:DEBUG? {channel_id}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_lpf_ctrl(self, slot: int, channel_id: int) -> Any:
"""
Get the value of lpf_ctrl GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:OUT:LPF:CTRL:GET:DEBUG? {channel_id}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_amp_ctrl(self, slot: int, channel_id: int) -> Any:
"""
Get the value of amp_ctrl GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:OUT:AMP:CTRL:GET:DEBUG? {channel_id}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_bpf_all_ctrl(self, slot: int, channel_id: int) -> Any:
"""
Get the value of bpf_all_ctrl GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:OUT:BPF:ALL:CTRL:GET:DEBUG? {channel_id}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_mix_dds(self, slot: int, channel_id: int) -> Any:
"""
Get the value of mix_dds GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:OUT:MIX:SEL:GET:DEBUG? {channel_id}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_out_sel(self, slot: int, channel_id: int) -> Any:
"""
Get the value of out_sel GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:OUT:OUT:SEL:GET:DEBUG? {channel_id}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_pwr_ctrl(self, slot: int, channel_id: int) -> Any:
"""
Get the value of pwr_ctrl GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:OUT:PWR:CTRL:GET:DEBUG? {channel_id}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_nyquist_filter(
self, slot: int, channel_id: int, nyquist_filter: str
) -> Any:
"""
Set Nyquist zone filter of a given output channel
Parameters
----------
slot : int
slot index
channel_id : int
Target Chanel ID
nyquist_filter : str
Nyquist filter value
Returns
-------
Any
result
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str"])
# SCPI call
var0 = self._read_bin(
f'SLOT{slot}:AFE:OUT:NYQ:FILTer:SET:DEBUG? {channel_id},"{nyquist_filter}"'
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_nyquist_filter(self, slot: int, channel_id: int) -> Any:
"""
Get Nyquist zone filter of a given output channel
Parameters
----------
slot : int
slot index
channel_id : int
Target Chanel ID
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:OUT:NYQ:FILTer:GET:DEBUG? {channel_id}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_mixer_filter_bank(self, slot: int, channel: int, value: str) -> Any:
"""
Get selected mixer filter bank for a given output channel
Parameters
----------
slot : int
slot index
channel : int
Channel ID
value : str
Mixer filter value
Returns
-------
Any
result
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str"])
# SCPI call
var0 = self._read_bin(
f'SLOT{slot}:AFE:OUT:FILTer:BANK:SET:DEBUG? {channel},"{value}"'
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_mixer_filter_bank(self, slot: int, channel: int) -> Any:
"""
Get selected mixer filter bank for a given output channel
Parameters
----------
slot : int
slot index
channel : int
Channel ID
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:OUT:FILTer:BANK:GET:DEBUG? {channel}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _print_out_gpio_configuration(self, slot: int, channel: int) -> Any:
"""
Print output channel GPIO configuration
Parameters
----------
slot : int
slot index
channel : int
Channel ID
Returns
-------
Any
Execution result and GPIO Config
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:OUT:GPIO:CONFIG:PRINT:DEBUG? {channel}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_mixer_mode(self, slot: int, channel_id: int, enable: bool) -> Any:
"""
Enable/disable mixer path of an output channel
Parameters
----------
slot : int
slot index
channel_id : int
Target Chanel ID
enable : bool
Mixer mode enable/disable
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "bool"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:OUT:MIX:ENable:DEBUG? {channel_id},{0 if enable == False else 1}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_in_amp_iso_fw(self, slot: int, channel_id: int, value: int) -> Any:
"""
Set the value of amp_iso_fw GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
value : int
Value
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:IN:AMP:SEL:SET:DEBUG? {channel_id},{value}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_in_dsa_2(self, slot: int, channel_id: int, value: int) -> Any:
"""
Set the value of dsa_2 GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
value : int
Value
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:IN:DSA2:SET:DEBUG? {channel_id},{value}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_in_dsa_1(self, slot: int, channel_id: int, value: int) -> Any:
"""
Set the value of dsa_1 GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
value : int
Value
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:IN:DSA1:SET:DEBUG? {channel_id},{value}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_in_mix_x2(self, slot: int, channel_id: int, value: int) -> Any:
"""
Set the value of mix_x2 GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
value : int
Value
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:IN:MIX:X2:SET:DEBUG? {channel_id},{value}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_in_ch_splt_en(self, slot: int, channel_id: int, value: int) -> Any:
"""
Set the value of ch_splt_en GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
value : int
Value
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:IN:CH:SPLIT:SET:DEBUG? {channel_id},{value}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_in_mix_dds(self, slot: int, channel_id: int, value: int) -> Any:
"""
Set the value of mix_dds GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
value : int
Value
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:IN:MIX:SEL:SET:DEBUG? {channel_id},{value}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_in_nyq_sel(self, slot: int, channel_id: int, value: int) -> Any:
"""
Set the value of nyq_sel GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
value : int
Value
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:IN:NYQ:SEL:SET:DEBUG? {channel_id},{value}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_in_amp_iso_fw(self, slot: int, channel_id: int) -> Any:
"""
Get the value of amp_iso_fw GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}AFE:IN:AMP:SEL:GET:DEBUG? {channel_id}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_in_dsa_2(self, slot: int, channel_id: int) -> Any:
"""
Get the value of dsa_2 GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}AFE:IN:DSA2:GET:DEBUG? {channel_id}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_in_dsa_1(self, slot: int, channel_id: int) -> Any:
"""
Get the value of dsa_1 GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}AFE:IN:DSA1:GET:DEBUG? {channel_id}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_in_mix_x2(self, slot: int, channel_id: int) -> Any:
"""
Get the value of mix_x2 GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}AFE:IN:MIX:X2:GET:DEBUG? {channel_id}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_in_ch_splt_en(self, slot: int, channel_id: int) -> Any:
"""
Get the value of ch_splt_en GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}AFE:IN:CH:SPLIT:GET:DEBUG? {channel_id}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_in_mix_dds(self, slot: int, channel_id: int) -> Any:
"""
Get the value of mix_dds GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}AFE:IN:MIX:SEL:GET:DEBUG? {channel_id}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_in_nyq_sel(self, slot: int, channel_id: int) -> Any:
"""
Get the value of nyq_sel GPIO line(s)
Parameters
----------
slot : int
slot index
channel_id : int
Chanel ID
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}AFE:IN:NYQ:SEL:GET:DEBUG? {channel_id}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_in_nyquist_filter(
self, slot: int, channel_id: int, nyquist_filter: str
) -> Any:
"""
Set Nyquist zone filter of a given input channel
Parameters
----------
slot : int
slot index
channel_id : int
Target Chanel ID
nyquist_filter : str
Nyquist filter value
Returns
-------
Any
result
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str"])
# SCPI call
var0 = self._read_bin(
f'SLOT{slot}:AFE:IN:NYQ:FILTer:SET:DEBUG? {channel_id},"{nyquist_filter}"'
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_in_nyquist_filter(self, slot: int, channel_id: int) -> Any:
"""
Get Nyquist zone filter of a given input channel
Parameters
----------
slot : int
slot index
channel_id : int
Target Chanel ID
Returns
-------
Any
result
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:IN:NYQ:FILTer:GET:DEBUG? {channel_id}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _print_in_gpio_configuration(self, slot: int, channel: int) -> Any:
"""
Print output channel GPIO configuration
Parameters
----------
slot : int
slot index
channel : int
Channel ID
Returns
-------
Any
Execution result and GPIO Config
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:IN:GPIO:CONFIG:PRINT:DEBUG? {channel}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_lo_frequency(
self, slot: int, channel: int, frequency_hz: float
) -> Any:
"""
Set the LO frequency for a given channel
Parameters
----------
slot : int
slot index
channel : int
Channel ID
frequency_hz : float
LO Frequency value (Hz)
Returns
-------
Any
Execution status
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "float"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:OUT:LO:FREQ:SET:DEBUG? {channel},{frequency_hz}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_lo_power(self, slot: int, channel: int, power_db: int) -> Any:
"""
Set the LO power for a given channel
Parameters
----------
slot : int
slot index
channel : int
Channel ID
power_db : int
LO power (dB)
Returns
-------
Any
Execution status
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:OUT:LO:POW:SET:DEBUG? {channel},{power_db}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_lo_power(self, slot: int, channel: int) -> Any:
"""
Get the LO power for a given channel
Parameters
----------
slot : int
slot index
channel : int
Channel ID
Returns
-------
Any
Result
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:OUT:LO:POW:GET:DEBUG? {channel}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _init_out_lo(self, slot: int, channel: int) -> Any:
"""
Configure the LMX2594 with initial settings
Parameters
----------
slot : int
slot index
channel : int
Channel ID
Returns
-------
Any
Execution status
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:OUT:LO:INIT:DEBUG? {channel}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _soft_sync_all_out_lo(self, slot: int, incl_div: int) -> Any:
"""
Execute a software synchronization on all PLLs
Parameters
----------
slot : int
slot index
incl_div : int
INCL_DIV
Returns
-------
Any
Execution status
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:OUT:LO:SOFT:SYNC:DEBUG? {incl_div}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _power_down_out_lo_output(self, slot: int, channel: int, mode: int) -> Any:
"""
Set the LMX output powerdown mode
Parameters
----------
slot : int
slot index
channel : int
Channel ID
mode : int
bit mask for channel index, 0 - both enabled, 1 - OUTA pdown, 2 - OUTB pdown, 3 - OUTA and OUTB pdown
Returns
-------
Any
Execution status
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:OUT:LO:OUT:POWERDOWN? {channel},{mode}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _power_down_out_lo(self, slot: int, channel: int, enable: bool) -> Any:
"""
Set the LMX output powerdown
Parameters
----------
slot : int
slot index
channel : int
Channel ID
enable : bool
power down
Returns
-------
Any
Execution status
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "bool"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:AFE:OUT:LO:POWERDOWN? {channel},{0 if enable == False else 1}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_att(self, slot: int, channel: int, attenuation: float) -> Any:
"""
Set the attenuation value for a given channel in steps of 0.5 dB
Parameters
----------
slot : int
slot index
channel : int
Channel ID
attenuation : float
Attenuation value in steps of 0.5 dB
Returns
-------
Any
Execution status
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "float"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:OUT:ATT:SET? {channel},{attenuation}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_att(self, slot: int, channel: int) -> float:
"""
Get the attenuation value for a given channel
Parameters
----------
slot : int
slot index
channel : int
Channel ID
Returns
-------
float
Attenuation value in dB
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:OUT:ATT:GET? {channel}")
return float(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_max_out_att(self, slot: int, channel: int) -> float:
"""
Get the maximum possible attenuation value for a given channel
Parameters
----------
slot : int
slot index
channel : int
Channel ID
Returns
-------
float
Attenuation value in dB
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:OUT:MAX:ATT:GET? {channel}")
return float(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _set_output_mode(self, slot: int, channel: int, mode: str) -> Any:
"""
Set output mode of a given channel
Parameters
----------
slot : int
slot index
channel : int
Channel ID
mode : str
Output mode [isolated | single | combine]
Returns
-------
Any
Execution status
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str"])
# SCPI call
var0 = self._read_bin(f'SLOT{slot}:AFE:OUT:MODE:SET? {channel},"{mode}"')
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_freq(self, slot: int, channel: int, frequency: int) -> Any:
"""
Set the output frequency (MHz)
Parameters
----------
slot : int
slot index
channel : int
Channel ID
frequency : int
Output frequency in MHz
Returns
-------
Any
Execution status
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:OUT:FREQ:SET? {channel},{frequency}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_freq(self, slot: int, channel: int) -> Any:
"""
Get the output frequency (MHz)
Parameters
----------
slot : int
slot index
channel : int
Channel ID
Returns
-------
Any
Result
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:OUT:FREQ:GET? {channel}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_in_att(self, slot: int, channel: int, attenuation: float) -> Any:
"""
Set the attenuation value for a given channel in steps of 0.5 dB
Parameters
----------
slot : int
slot index
channel : int
Channel ID
attenuation : float
Attenuation value in steps of 0.5 dB
Returns
-------
Any
Execution status
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "float"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:IN:ATT:SET? {channel},{attenuation}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_in_att(self, slot: int, channel: int) -> float:
"""
Get the attenuation value for a given channel
Parameters
----------
slot : int
slot index
channel : int
Channel ID
Returns
-------
float
Attenuation value in dB
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:IN:ATT:GET? {channel}")
return float(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _set_in_att1(self, slot: int, channel: int, attenuation: float) -> Any:
"""
Set the attenuation value for a given channel in steps of 0.5 dB
Parameters
----------
slot : int
slot index
channel : int
Channel ID
attenuation : float
Attenuation value in steps of 0.5 dB
Returns
-------
Any
Execution status
Raises
------
Exception
Invalid input parameter type.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "float"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:IN:ATT1:SET? {channel},{attenuation}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_in_att2(self, slot: int, channel: int, attenuation: float) -> Any:
"""
Set the attenuation value for a given channel in steps of 0.5 dB
Parameters
----------
slot : int
slot index
channel : int
Channel ID
attenuation : float
Attenuation value in steps of 0.5 dB
Returns
-------
Any
Execution status
Raises
------
Exception
Invalid input parameter type.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "float"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:IN:ATT2:SET? {channel},{attenuation}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_in_att1(self, slot: int, channel: int) -> float:
"""
Get the attenuation value for a given channel
Parameters
----------
slot : int
slot index
channel : int
Channel ID
Returns
-------
float
Attenuation value in dB
Raises
------
Exception
Invalid input parameter type.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:IN:ATT1:GET? {channel}")
return float(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_in_att2(self, slot: int, channel: int) -> float:
"""
Get the attenuation value for a given channel
Parameters
----------
slot : int
slot index
channel : int
Channel ID
Returns
-------
float
Attenuation value in dB
Raises
------
Exception
Invalid input parameter type.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:IN:ATT2:GET? {channel}")
return float(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_max_in_att(self, slot: int, channel: int) -> float:
"""
Get the maximum possible attenuation value for a given channel
Parameters
----------
slot : int
slot index
channel : int
Channel ID
Returns
-------
float
Attenuation value in dB
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:IN:MAX:ATT:GET? {channel}")
return float(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _set_input_mode(self, slot: int, channel: int, mode: str) -> Any:
"""
Set input mode of a given channel
Parameters
----------
slot : int
slot index
channel : int
Channel ID
mode : str
Input mode [single | split]
Returns
-------
Any
Execution status
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str"])
# SCPI call
var0 = self._read_bin(f'SLOT{slot}:AFE:IN:MODE:SET? {channel},"{mode}"')
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_in_freq(self, slot: int, channel: int, frequency: int) -> Any:
"""
Set the input frequency (MHz)
Parameters
----------
slot : int
slot index
channel : int
Channel ID
frequency : int
Input frequency in MHz
Returns
-------
Any
Execution status
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:IN:FREQ:SET? {channel},{frequency}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_in_freq(self, slot: int, channel: int) -> Any:
"""
Get the input frequency (MHz)
Parameters
----------
slot : int
slot index
channel : int
Channel ID
Returns
-------
Any
Result
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:AFE:IN:FREQ:GET? {channel}")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _upload_freq_plan(self, slot: int, plan_json: Any) -> None:
"""
Upload frequency plan settings
Parameters
----------
slot : int
slot index
plan_json : Any
Exported frequency plan in JSON format
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "Any"])
# SCPI call
self._write_bin(
f"SLOT{slot}:AFE:FREQ:SETTINGS?", json.dumps(plan_json).encode("utf-8")
)
# -------------------------------------------------------------------------
@scpi_error_check
def _set_carrier_fan_duty_cycle(self, slot: int, duty_cycle: int) -> Any:
"""
Set PWM duty cycle (0-255) to the fan on the carrier board
Parameters
----------
slot : int
slot index
duty_cycle : int
0-255 duty cycle
Returns
-------
Any
Execution status
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(
f"SLOT{slot}:CARRIER:FAN:DUTYCYCLE:SET:DEBUG? {duty_cycle}"
)
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_carrier_fan_rpm(self, slot: int) -> Any:
"""
Get RPM of the fan on the carrier board
Parameters
----------
slot : int
slot index
Returns
-------
Any
Execution status
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:CARRIER:FAN:RPM:GET:DEBUG?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_carrier_fan_fault_code(self, slot: int) -> Any:
"""
Get the fault code of the fan on the carrier board
Parameters
----------
slot : int
slot index
Returns
-------
Any
Execution status
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:CARRIER:FAN:FAULTCODE:GET:DEBUG?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_som2_present(self, slot: int) -> bool:
"""
Verifies if SOM 2 is present.
Parameters
----------
slot : int
slot index
Returns
-------
bool
SOM2 2 present
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:SOM2:PRESENT?")
return bool(int(var0))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_som2_ps_done(self, slot: int) -> bool:
"""
Verifies if SOM 2 has started correctly.
Parameters
----------
slot : int
slot index
Returns
-------
bool
SOM2 2 started correctly
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:SOM2:PS:DONE?")
return bool(int(var0))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_som2_active(self, slot: int) -> bool:
"""
Is SOM2 active.
Parameters
----------
slot : int
slot index
Returns
-------
bool
SOM2 active flag
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:SOM2:ACTIVE?")
return bool(int(var0))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_loopback_enable(self, slot: int, handle: bool) -> None:
"""
Enable or disable loopback.
Parameters
----------
slot : int
slot index
handle : bool
Loopback enable
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "bool"])
# SCPI call
self._write(f"SLOT{slot}:LOOPBACK:ENAble {0 if handle == False else 1}")
# -------------------------------------------------------------------------
@scpi_error_check
def _get_loopback_data(self, slot: int) -> str:
"""
Read data from loopback.
Parameters
----------
slot : int
slot index
Returns
-------
str
String with metadata and data from loopback
Raises
------
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:LOOPBACK:READ?")
return var0
# -------------------------------------------------------------------------
@scpi_error_check
def _loopback_write(self, slot: int, loopback_data: str) -> None:
"""
Write data to loopback
Parameters
----------
slot : int
slot index
loopback_data : str
String with metadata and data to loopback
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "str"])
# SCPI call
self._write(f'SLOT{slot}:LOOPBACK:WRITE "{loopback_data}"')
# -------------------------------------------------------------------------
@scpi_error_check
def _set_qsm_channel_to_zero(self, slot: int, io_channel: int) -> None:
"""
Resets the output for a specified channel to zero.
Parameters
----------
slot : int
slot index.
io_channel : int
I/O channel to manipulate.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
self._write(f"SLOT{slot}:IO:CHANnel{io_channel}:OUT:ZERO")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_qsm_outputs_to_zero(self, slot: int) -> None:
"""
Resets the output for a all channels to zero.
Parameters
----------
slot : int
slot index.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
self._write(f"SLOT{slot}:IO:OUTput:OUT:ZERO")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_voltage_wait(self, slot: int, io_channel: int, voltage: float) -> None:
"""
Sets the voltage for a specified channel and blocks execution
until the voltage stabilizes at the requested value.
Parameters
----------
slot : int
slot index.
io_channel : int
I/O channel to manipulate.
voltage : float
The desired voltage in volts.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "float"])
# SCPI call
self._write(f"SLOT{slot}:IO:CHANnel{io_channel}:VOLTage:WAIT {voltage}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_instant(self, slot: int, io_channel: int, voltage: float) -> None:
"""
Sets the voltage for a specified channel immediately, bypassing ramping constraints.
Parameters
----------
slot : int
slot index.
io_channel : int
I/O channel to manipulate.
voltage : float
The desired voltage in volts.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "float"])
# SCPI call
self._write(f"SLOT{slot}:IO:CHANnel{io_channel}:VOLTage:INSTant {voltage}")
# -------------------------------------------------------------------------
@scpi_error_check
def _get_qsm_output_config(self, slot: int) -> Any:
"""
Retrieves the current configuration of the QSM output channels as a JSON object.
If the channel index is out of range, an error is set in system error.
Parameters
----------
slot : int
slot index.
Returns
-------
Any
A JSON object containing the output channel configuration.
Raises
------
Exception
Invalid input parameter type.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:IO:OUTput:CONFig?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_qsm_output_config(self, slot: int, config: Any) -> None:
"""
Sets the configuration of the QSM output channels. The configuration is provided
as a JSON object. If the input JSON is invalid, a system error will occur.
Parameters
----------
slot : int
slot index.
config : Any
A JSON object defining the configuration of the output channels.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
"""
# Check input types.
self._check_in_type(locals(), ["int", "Any"])
# SCPI call
self._write_bin(
f"SLOT{slot}:IO:OUTput:CONFig", json.dumps(config).encode("utf-8")
)
# -------------------------------------------------------------------------
@scpi_error_check
def _measure_current(self, slot: int, io_channel: int) -> float:
"""
Returns the current measured for a specified channel.
Parameters
----------
slot : int
slot index.
io_channel : int
I/O channel to manipulate.
Returns
-------
float
The measured current for the specified channel in amperes.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:IO:CHANnel{io_channel}:MEASurement:CURRent?")
return float(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _measure_voltage(self, slot: int, io_channel: int) -> float:
"""
Returns the voltage measured for a specified channel.
Parameters
----------
slot : int
slot index.
io_channel : int
I/O channel to manipulate.
Returns
-------
float
The measured voltage for the specified channel in volts.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:IO:CHANnel{io_channel}:MEASurement:VOLTage?")
return float(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_assembler_status(self, slot: int) -> bool:
"""
Get assembler status. Refer to the assembler log to get more information regarding the assembler result.
Parameters
----------
slot : int
slot index.
Returns
-------
bool
Assembler status (False = failed, True = success).
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:STATus:ASSEMbler:SUCCess?")
return bool(int(var0))
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_assembler_log(self, slot: int) -> str:
"""
Get assembler log.
Parameters
----------
slot : int
slot index.
Returns
-------
str
Assembler log.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:STATus:ASSEMbler:LOG?")
return var0.decode("utf-8", "ignore")
# -------------------------------------------------------------------------
@scpi_error_check
def _get_in_offset_0(self, slot: int) -> float:
"""
Get input offset for input 0.
Parameters
----------
slot : int
slot index.
Returns
-------
float
Current input offset for input 0.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:OFFSet:IN0?")
return float(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_in_offset_1(self, slot: int) -> float:
"""
Get input offset for input 1.
Parameters
----------
slot : int
slot index.
Returns
-------
float
Current input offset for input 1.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:OFFSet:IN1?")
return float(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_in_offset_2(self, slot: int) -> float:
"""
Get input offset for input 2.
Parameters
----------
slot : int
slot index.
Returns
-------
float
Current input offset for input 2.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:OFFSet:IN2?")
return float(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_in_offset_3(self, slot: int) -> float:
"""
Get input offset for input 3.
Parameters
----------
slot : int
slot index.
Returns
-------
float
Current input offset for input 3.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:OFFSet:IN3?")
return float(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_in_amp_gain_0(self, slot: int) -> int:
"""
Get input amplifier gain for input 0.
Parameters
----------
slot : int
slot index.
Returns
-------
int
Current input amplifier gain for input 0.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:GAIN:INAMP0?")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_in_amp_gain_1(self, slot: int) -> int:
"""
Get input amplifier gain for input 1.
Parameters
----------
slot : int
slot index.
Returns
-------
int
Current input amplifier gain for input 1.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:GAIN:INAMP1?")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_amp_offset_0(self, slot: int) -> float:
"""
Get output amplifier offset for output 0.
Parameters
----------
slot : int
slot index.
Returns
-------
float
Current output amplifier offset for output 0.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:OFFSet:OUTAMP0?")
return float(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_amp_offset_1(self, slot: int) -> float:
"""
Get output amplifier offset for output 1.
Parameters
----------
slot : int
slot index.
Returns
-------
float
Current output amplifier offset for output 1.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:OFFSet:OUTAMP1?")
return float(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_amp_offset_2(self, slot: int) -> float:
"""
Get output amplifier offset for output 2.
Parameters
----------
slot : int
slot index.
Returns
-------
float
Current output amplifier offset for output 2.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:OFFSet:OUTAMP2?")
return float(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_amp_offset_3(self, slot: int) -> float:
"""
Get output amplifier offset for output 3.
Parameters
----------
slot : int
slot index.
Returns
-------
float
Current output amplifier offset for output 3.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:OFFSet:OUTAMP3?")
return float(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_dac_offset_0(self, slot: int) -> float:
"""
Get dac offset for output 0.
Parameters
----------
slot : int
slot index.
Returns
-------
float
Current dac offset for output 0.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:OFFSet:DAC0?")
return float(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_dac_offset_1(self, slot: int) -> float:
"""
Get dac offset for output 1.
Parameters
----------
slot : int
slot index.
Returns
-------
float
Current dac offset for output 1.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:OFFSet:DAC1?")
return float(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_dac_offset_2(self, slot: int) -> float:
"""
Get dac offset for output 2.
Parameters
----------
slot : int
slot index.
Returns
-------
float
Current dac offset for output 2.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:OFFSet:DAC2?")
return float(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_dac_offset_3(self, slot: int) -> float:
"""
Get dac offset for output 3.
Parameters
----------
slot : int
slot index.
Returns
-------
float
Current dac offset for output 3.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:OFFSet:DAC3?")
return float(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_acq_scope_config(self, slot: int) -> Any:
"""
Get configuration of the scope acquisition. The configuration consists of multiple parameters in a JSON format. If the configuration does not have the correct format, an error is set in system error.
Parameters
----------
slot : int
slot index.
Returns
-------
Any
Current configuration struct.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:ACQ:SCOpe:CONFiguration?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_pre_distortion_config(self, slot: int) -> Any:
"""
Get pre-distortion configuration. The configuration consists of multiple parameters in a JSON format. If the configation does not have the correct format, an error is set in system error..
Parameters
----------
slot : int
slot index.
Returns
-------
Any
Current pre-distortion config.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:PREDISTortion:CONFiguration?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_quad_config(self, slot: int, quad: int) -> Any:
"""
Get configuration parameters for the given I/O quad. The configuration consists of a JSON object with instrument-specific content. If the quad index is out of range or the object does not have the correct format, an error is set in system error.
Parameters
----------
slot : int
slot index.
quad : int
I/O quad index.
Returns
-------
Any
Current configuration struct.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:QUAD{quad}:CONFig?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_io_channel_config(self, slot: int, channel: int) -> Any:
"""
Get configuration parameters for the given I/O channel. The configuration consists of a JSON object with instrument-specific content. If the channel index is out of range or the object does not have the correct format, an error is set in system error.
Parameters
----------
slot : int
slot index.
channel : int
I/O channel index.
Returns
-------
Any
Current configuration struct.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:IO:CHANnel{channel}:CONFig?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_sequencer_channel_map(self, slot: int, sequencer: int) -> Any:
"""
Get channel map of the indexed sequencer. The channel map consists of a list with two elements representing the components of the complex signal to be acquired, each mapping to a list of DAC indices. Index i maps to output i+1. If an invalid sequencer index is given or the channel map is not valid, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
Returns
-------
Any
Current Sequencer index.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:SEQuencer{sequencer}:CHANnelmap?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_sequencer_acq_channel_map(self, slot: int, sequencer: int) -> Any:
"""
Get input channel map of the indexed sequencer. The channel map consists of a list with two elements representing the components of the complex signal to be acquired, each mapping to a list of ADC or loopback indices. The hardware only supports one channel per complex number component, so the inner list must have 0 or 1 elements. 0 and 1 are used to select the ADCs for input 1 and input 2, while 2 and 3 are used to select outputs 1 and 2 in loopback mode. If an invalid sequencer index is given or the channel map is not valid, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
Returns
-------
Any
Current Sequencer index.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:SEQuencer{sequencer}:ACQ:CHANnelmap?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_sequencer_config(self, slot: int, sequencer: int) -> Any:
"""
Get configuration of the indexed sequencer. The configuration consists of multiple parameters in a JSON format. If an invalid sequencer index is given, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
Returns
-------
Any
Current Configuration struct.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:SEQuencer{sequencer}:CONFiguration?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_lo_enable_0(self, slot: int) -> bool:
"""
Get LO 0 status.
Parameters
----------
slot : int
slot index.
Returns
-------
bool
Current LO 0 status.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:LO0:ENAble?")
return bool(int(var0))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_lo_enable_1(self, slot: int) -> bool:
"""
Get LO 1 status.
Parameters
----------
slot : int
slot index.
Returns
-------
bool
Current LO 1 status.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:LO1:ENAble?")
return bool(int(var0))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_in_att_0(self, slot: int) -> int:
"""
Get input attenuator.
Parameters
----------
slot : int
slot index.
Returns
-------
int
Attenuation in dB in a range of 0 to 30 in steps of 2dB.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:ATT:IN0?")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_att_0(self, slot: int) -> int:
"""
Get output attenuator for output 0.
Parameters
----------
slot : int
slot index.
Returns
-------
int
Attenuation in dB in a range of 0 to 60 in steps of 2dB.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:ATT:OUT0?")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_att_1(self, slot: int) -> int:
"""
Get output attenuator for output 1.
Parameters
----------
slot : int
slot index.
Returns
-------
int
Attenuation in dB in a range of 0 to 60 in steps of 2dB.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:ATT:OUT1?")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_filt_width_0(self, slot: int) -> int:
"""
Get band filter width for output 0.
Parameters
----------
slot : int
slot index.
Returns
-------
int
Frequency in MHz.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:FILT:OUT0:WIDTh?")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_filt_width_1(self, slot: int) -> int:
"""
Get band filter width for output 1.
Parameters
----------
slot : int
slot index.
Returns
-------
int
Frequency in MHz.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:FILT:OUT1:WIDTh?")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_filt_center_0(self, slot: int) -> int:
"""
Get band filter center for output 0.
Parameters
----------
slot : int
slot index.
Returns
-------
int
Frequency in MHz.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:FILT:OUT0:CENTer?")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_filt_center_1(self, slot: int) -> int:
"""
Get band filter center for output 1.
Parameters
----------
slot : int
slot index.
Returns
-------
int
Frequency in MHz.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:FILT:OUT1:CENTer?")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_filt_en_0(self, slot: int) -> bool:
"""
Get band filter center for output 0.
Parameters
----------
slot : int
slot index.
Returns
-------
bool
Whether to enable.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:FILT:OUT0:ENAble?")
return bool(int(var0))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_out_filt_en_1(self, slot: int) -> bool:
"""
Get band filter center for output 1.
Parameters
----------
slot : int
slot index.
Returns
-------
bool
Whether to enable.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:FILT:OUT1:ENAble?")
return bool(int(var0))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_mrk_inv_en_0(self, slot: int) -> bool:
"""
Get marker 0 invert enable.
Parameters
----------
slot : int
slot index.
Returns
-------
bool
Current marker 0 invert enable.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:MRK0:INVert:ENAble?")
return bool(int(var0))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_mrk_inv_en_1(self, slot: int) -> bool:
"""
Get marker 1 invert enable.
Parameters
----------
slot : int
slot index.
Returns
-------
bool
Current marker 1 invert enable.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:MRK1:INVert:ENAble?")
return bool(int(var0))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_mrk_inv_en_2(self, slot: int) -> bool:
"""
Get marker 2 invert enable.
Parameters
----------
slot : int
slot index.
Returns
-------
bool
Current marker 2 invert enable.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:MRK2:INVert:ENAble?")
return bool(int(var0))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_mrk_inv_en_3(self, slot: int) -> bool:
"""
Get marker 3 invert enable.
Parameters
----------
slot : int
slot index.
Returns
-------
bool
Current marker 3 invert enable.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:MRK3:INVert:ENAble?")
return bool(int(var0))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_lo_freq_0(self, slot: int) -> int:
"""
Get LO Frequency for output 0.
Parameters
----------
slot : int
slot index.
Returns
-------
int
Frequency in Hertz
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:STATus:QUEStionable:FREQuency:LO0?")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_lo_freq_1(self, slot: int) -> int:
"""
Get LO Frequency for output 1.
Parameters
----------
slot : int
slot index.
Returns
-------
int
Frequency in Hertz
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:STATus:QUEStionable:FREQuency:LO1?")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_lo_pwr_0(self, slot: int) -> int:
"""
Get LO Power for output 0.
Parameters
----------
slot : int
slot index.
Returns
-------
int
Power in dBm
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:STATus:QUEStionable:POWer:LO0?")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_lo_pwr_1(self, slot: int) -> int:
"""
Get LO Power for output 1.
Parameters
----------
slot : int
slot index.
Returns
-------
int
Power in dBm
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:STATus:QUEStionable:POWer:LO1?")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_som2_power(self, slot: int) -> bool:
"""
Get SOM2 power enable.
Parameters
----------
slot : int
slot index.
Returns
-------
bool
Current SOM2 power enable.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:SOM2:POWER:ENABLE?")
return bool(int(var0))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_som2_por_state(self, slot: int) -> bool:
"""
Get power on reset of SOM2.
Parameters
----------
slot : int
slot index.
Returns
-------
bool
Current power on reset of SOM2.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:SOM2:POR:STATE?")
return bool(int(var0))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_som2_srst_state(self, slot: int) -> bool:
"""
Get power on reset of SOM2.
Parameters
----------
slot : int
slot index.
Returns
-------
bool
Current power on reset of SOM2.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:SOM2:SRST:STATE?")
return bool(int(var0))
# -------------------------------------------------------------------------
@scpi_error_check
def _set_in_offset_0(self, slot: int, in_offset_0: float) -> None:
"""
Set input offset for input 0.
Parameters
----------
slot : int
slot index.
in_offset_0 : float
Current input offset for input 0 float.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "float"])
# SCPI call
self._write(f"SLOT{slot}:AFE:OFFSet:IN0 {in_offset_0}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_in_offset_1(self, slot: int, in_offset_1: float) -> None:
"""
Set input offset for input 1.
Parameters
----------
slot : int
slot index.
in_offset_1 : float
Current input offset for input 1 float.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "float"])
# SCPI call
self._write(f"SLOT{slot}:AFE:OFFSet:IN1 {in_offset_1}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_in_offset_2(self, slot: int, in_offset_2: float) -> None:
"""
Set input offset for input 2.
Parameters
----------
slot : int
slot index.
in_offset_2 : float
Current input offset for input 2 float.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "float"])
# SCPI call
self._write(f"SLOT{slot}:AFE:OFFSet:IN2 {in_offset_2}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_in_offset_3(self, slot: int, in_offset_3: float) -> None:
"""
Set input offset for input 3.
Parameters
----------
slot : int
slot index.
in_offset_3 : float
Current input offset for input 3 float.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "float"])
# SCPI call
self._write(f"SLOT{slot}:AFE:OFFSet:IN3 {in_offset_3}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_in_amp_gain_0(self, slot: int, in_amp_gain_0: int) -> None:
"""
Set input amplifier gain for input 0.
Parameters
----------
slot : int
slot index.
in_amp_gain_0 : int
Current input amplifier gain for input 0 int.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
self._write(f"SLOT{slot}:AFE:GAIN:INAMP0 {in_amp_gain_0}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_in_amp_gain_1(self, slot: int, in_amp_gain_1: int) -> None:
"""
Set input amplifier gain for input 1.
Parameters
----------
slot : int
slot index.
in_amp_gain_1 : int
Current input amplifier gain for input 1 int.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
self._write(f"SLOT{slot}:AFE:GAIN:INAMP1 {in_amp_gain_1}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_amp_offset_0(self, slot: int, out_amp_offset_0: float) -> None:
"""
Set output amplifier offset for output 0.
Parameters
----------
slot : int
slot index.
out_amp_offset_0 : float
Current output amplifier offset for output 0 float.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "float"])
# SCPI call
self._write(f"SLOT{slot}:AFE:OFFSet:OUTAMP0 {out_amp_offset_0}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_amp_offset_1(self, slot: int, out_amp_offset_1: float) -> None:
"""
Set output amplifier offset for output 1.
Parameters
----------
slot : int
slot index.
out_amp_offset_1 : float
Current output amplifier offset for output 1 float.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "float"])
# SCPI call
self._write(f"SLOT{slot}:AFE:OFFSet:OUTAMP1 {out_amp_offset_1}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_amp_offset_2(self, slot: int, out_amp_offset_2: float) -> None:
"""
Set output amplifier offset for output 2.
Parameters
----------
slot : int
slot index.
out_amp_offset_2 : float
Current output amplifier offset for output 2 float.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "float"])
# SCPI call
self._write(f"SLOT{slot}:AFE:OFFSet:OUTAMP2 {out_amp_offset_2}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_amp_offset_3(self, slot: int, out_amp_offset_3: float) -> None:
"""
Set output amplifier offset for output 3.
Parameters
----------
slot : int
slot index.
out_amp_offset_3 : float
Current output amplifier offset for output 3 float.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "float"])
# SCPI call
self._write(f"SLOT{slot}:AFE:OFFSet:OUTAMP3 {out_amp_offset_3}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_dac_offset_0(self, slot: int, dac_offset_0: float) -> None:
"""
Set dac offset for output 0.
Parameters
----------
slot : int
slot index.
dac_offset_0 : float
Current dac offset for output 0 float.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "float"])
# SCPI call
self._write(f"SLOT{slot}:AFE:OFFSet:DAC0 {dac_offset_0}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_dac_offset_1(self, slot: int, dac_offset_1: float) -> None:
"""
Set dac offset for output 1.
Parameters
----------
slot : int
slot index.
dac_offset_1 : float
Current dac offset for output 1 float.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "float"])
# SCPI call
self._write(f"SLOT{slot}:AFE:OFFSet:DAC1 {dac_offset_1}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_dac_offset_2(self, slot: int, dac_offset_2: float) -> None:
"""
Set dac offset for output 2.
Parameters
----------
slot : int
slot index.
dac_offset_2 : float
Current dac offset for output 2 float.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "float"])
# SCPI call
self._write(f"SLOT{slot}:AFE:OFFSet:DAC2 {dac_offset_2}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_dac_offset_3(self, slot: int, dac_offset_3: float) -> None:
"""
Set dac offset for output 3.
Parameters
----------
slot : int
slot index.
dac_offset_3 : float
Current dac offset for output 3 float.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "float"])
# SCPI call
self._write(f"SLOT{slot}:AFE:OFFSet:DAC3 {dac_offset_3}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_acq_scope_config(self, slot: int, acq_scope_config: Any) -> None:
"""
Set configuration of the scope acquisition. The configuration consists of multiple parameters in a JSON format. If the configuration does not have the correct format, an error is set in system error.
Parameters
----------
slot : int
slot index.
acq_scope_config : Any
Current configuration struct Any.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "Any"])
# SCPI call
self._write_bin(
f"SLOT{slot}:ACQ:SCOpe:CONFiguration",
json.dumps(acq_scope_config).encode("utf-8"),
)
# -------------------------------------------------------------------------
@scpi_error_check
def _set_pre_distortion_config(self, slot: int, pre_distortion_config: Any) -> None:
"""
Set pre-distortion configuration. The configuration consists of multiple parameters in a JSON format. If the configation does not have the correct format, an error is set in system error..
Parameters
----------
slot : int
slot index.
pre_distortion_config : Any
Current pre-distortion config Any.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "Any"])
# SCPI call
self._write_bin(
f"SLOT{slot}:PREDISTortion:CONFiguration",
json.dumps(pre_distortion_config).encode("utf-8"),
)
# -------------------------------------------------------------------------
@scpi_error_check
def _set_quad_config(self, slot: int, quad: int, quad_config: Any) -> None:
"""
Set configuration parameters for the given I/O quad. The configuration consists of a JSON object with instrument-specific content. If the quad index is out of range or the object does not have the correct format, an error is set in system error.
Parameters
----------
slot : int
slot index.
quad : int
I/O quad index.
quad_config : Any
Current configuration struct Any.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "Any"])
# SCPI call
self._write_bin(
f"SLOT{slot}:QUAD{quad}:CONFig", json.dumps(quad_config).encode("utf-8")
)
# -------------------------------------------------------------------------
@scpi_error_check
def _set_io_channel_config(
self, slot: int, channel: int, io_channel_config: Any
) -> None:
"""
Set configuration parameters for the given I/O channel. The configuration consists of a JSON object with instrument-specific content. If the channel index is out of range or the object does not have the correct format, an error is set in system error.
Parameters
----------
slot : int
slot index.
channel : int
I/O channel index.
io_channel_config : Any
Current configuration struct Any.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "Any"])
# SCPI call
self._write_bin(
f"SLOT{slot}:IO:CHANnel{channel}:CONFig",
json.dumps(io_channel_config).encode("utf-8"),
)
# -------------------------------------------------------------------------
@scpi_error_check
def _set_sequencer_channel_map(
self, slot: int, sequencer: int, sequencer_channel_map: Any
) -> None:
"""
Set channel map of the indexed sequencer. The channel map consists of a list with two elements representing the components of the complex signal to be acquired, each mapping to a list of DAC indices. Index i maps to output i+1. If an invalid sequencer index is given or the channel map is not valid, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
sequencer_channel_map : Any
Current Sequencer index Any.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "Any"])
# SCPI call
self._write_bin(
f"SLOT{slot}:SEQuencer{sequencer}:CHANnelmap",
json.dumps(sequencer_channel_map).encode("utf-8"),
)
# -------------------------------------------------------------------------
@scpi_error_check
def _set_sequencer_acq_channel_map(
self, slot: int, sequencer: int, sequencer_acq_channel_map: Any
) -> None:
"""
Set input channel map of the indexed sequencer. The channel map consists of a list with two elements representing the components of the complex signal to be acquired, each mapping to a list of ADC or loopback indices. The hardware only supports one channel per complex number component, so the inner list must have 0 or 1 elements. 0 and 1 are used to select the ADCs for input 1 and input 2, while 2 and 3 are used to select outputs 1 and 2 in loopback mode. If an invalid sequencer index is given or the channel map is not valid, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
sequencer_acq_channel_map : Any
Current Sequencer index Any.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "Any"])
# SCPI call
self._write_bin(
f"SLOT{slot}:SEQuencer{sequencer}:ACQ:CHANnelmap",
json.dumps(sequencer_acq_channel_map).encode("utf-8"),
)
# -------------------------------------------------------------------------
@scpi_error_check
def _set_sequencer_config(
self, slot: int, sequencer: int, sequencer_config: Any
) -> None:
"""
Set configuration of the indexed sequencer. The configuration consists of multiple parameters in a JSON format. If an invalid sequencer index is given, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
sequencer_config : Any
Current Configuration struct Any.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "Any"])
# SCPI call
self._write_bin(
f"SLOT{slot}:SEQuencer{sequencer}:CONFiguration",
json.dumps(sequencer_config).encode("utf-8"),
)
# -------------------------------------------------------------------------
@scpi_error_check
def _set_lo_enable_0(self, slot: int, lo_enable_0: bool) -> None:
"""
Set LO 0 status.
Parameters
----------
slot : int
slot index.
lo_enable_0 : bool
Current LO 0 status bool.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "bool"])
# SCPI call
self._write(f"SLOT{slot}:LO0:ENAble {0 if lo_enable_0 == False else 1}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_lo_enable_1(self, slot: int, lo_enable_1: bool) -> None:
"""
Set LO 1 status.
Parameters
----------
slot : int
slot index.
lo_enable_1 : bool
Current LO 1 status bool.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "bool"])
# SCPI call
self._write(f"SLOT{slot}:LO1:ENAble {0 if lo_enable_1 == False else 1}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_in_att_0(self, slot: int, in_att_0: int) -> None:
"""
Set input attenuator.
Parameters
----------
slot : int
slot index.
in_att_0 : int
Attenuation in dB in a range of 0 to 30 in steps of 2dB.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
self._write(f"SLOT{slot}:AFE:ATT:IN0 {in_att_0}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_att_0(self, slot: int, out_att_0: int) -> None:
"""
Set output attenuator for output 0.
Parameters
----------
slot : int
slot index.
out_att_0 : int
Attenuation in dB in a range of 0 to 60 in steps of 2dB.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
self._write(f"SLOT{slot}:AFE:ATT:OUT0 {out_att_0}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_att_1(self, slot: int, out_att_1: int) -> None:
"""
Set output attenuator for output 1.
Parameters
----------
slot : int
slot index.
out_att_1 : int
Attenuation in dB in a range of 0 to 60 in steps of 2dB.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
self._write(f"SLOT{slot}:AFE:ATT:OUT1 {out_att_1}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_filt_width_0(self, slot: int, out_filt_width_0: int) -> None:
"""
Set band filter width for output 0.
Parameters
----------
slot : int
slot index.
out_filt_width_0 : int
Frequency in MHz.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
self._write(f"SLOT{slot}:AFE:FILT:OUT0:WIDTh {out_filt_width_0}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_filt_width_1(self, slot: int, out_filt_width_1: int) -> None:
"""
Set band filter width for output 1.
Parameters
----------
slot : int
slot index.
out_filt_width_1 : int
Frequency in MHz.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
self._write(f"SLOT{slot}:AFE:FILT:OUT1:WIDTh {out_filt_width_1}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_filt_center_0(self, slot: int, out_filt_center_0: int) -> None:
"""
Set band filter center for output 0.
Parameters
----------
slot : int
slot index.
out_filt_center_0 : int
Frequency in MHz.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
self._write(f"SLOT{slot}:AFE:FILT:OUT0:CENTer {out_filt_center_0}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_filt_center_1(self, slot: int, out_filt_center_1: int) -> None:
"""
Set band filter center for output 1.
Parameters
----------
slot : int
slot index.
out_filt_center_1 : int
Frequency in MHz.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
self._write(f"SLOT{slot}:AFE:FILT:OUT1:CENTer {out_filt_center_1}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_filt_en_0(self, slot: int, out_filt_en_0: bool) -> None:
"""
Set band filter center for output 0.
Parameters
----------
slot : int
slot index.
out_filt_en_0 : bool
Whether to enable.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "bool"])
# SCPI call
self._write(
f"SLOT{slot}:AFE:FILT:OUT0:ENAble {0 if out_filt_en_0 == False else 1}"
)
# -------------------------------------------------------------------------
@scpi_error_check
def _set_out_filt_en_1(self, slot: int, out_filt_en_1: bool) -> None:
"""
Set band filter center for output 1.
Parameters
----------
slot : int
slot index.
out_filt_en_1 : bool
Whether to enable.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "bool"])
# SCPI call
self._write(
f"SLOT{slot}:AFE:FILT:OUT1:ENAble {0 if out_filt_en_1 == False else 1}"
)
# -------------------------------------------------------------------------
@scpi_error_check
def _set_mrk_inv_en_0(self, slot: int, mrk_inv_en_0: bool) -> None:
"""
Set marker 0 invert enable.
Parameters
----------
slot : int
slot index.
mrk_inv_en_0 : bool
Current marker 0 invert enable bool.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "bool"])
# SCPI call
self._write(
f"SLOT{slot}:MRK0:INVert:ENAble {0 if mrk_inv_en_0 == False else 1}"
)
# -------------------------------------------------------------------------
@scpi_error_check
def _set_mrk_inv_en_1(self, slot: int, mrk_inv_en_1: bool) -> None:
"""
Set marker 1 invert enable.
Parameters
----------
slot : int
slot index.
mrk_inv_en_1 : bool
Current marker 1 invert enable bool.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "bool"])
# SCPI call
self._write(
f"SLOT{slot}:MRK1:INVert:ENAble {0 if mrk_inv_en_1 == False else 1}"
)
# -------------------------------------------------------------------------
@scpi_error_check
def _set_mrk_inv_en_2(self, slot: int, mrk_inv_en_2: bool) -> None:
"""
Set marker 2 invert enable.
Parameters
----------
slot : int
slot index.
mrk_inv_en_2 : bool
Current marker 2 invert enable bool.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "bool"])
# SCPI call
self._write(
f"SLOT{slot}:MRK2:INVert:ENAble {0 if mrk_inv_en_2 == False else 1}"
)
# -------------------------------------------------------------------------
@scpi_error_check
def _set_mrk_inv_en_3(self, slot: int, mrk_inv_en_3: bool) -> None:
"""
Set marker 3 invert enable.
Parameters
----------
slot : int
slot index.
mrk_inv_en_3 : bool
Current marker 3 invert enable bool.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "bool"])
# SCPI call
self._write(
f"SLOT{slot}:MRK3:INVert:ENAble {0 if mrk_inv_en_3 == False else 1}"
)
# -------------------------------------------------------------------------
@scpi_error_check
def _set_lo_freq_0(self, slot: int, lo_freq_0: int) -> None:
"""
Set LO Frequency for output 0.
Parameters
----------
slot : int
slot index.
lo_freq_0 : int
Frequency in Hertz
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
self._write(f"SLOT{slot}:STATus:QUEStionable:FREQuency:LO0 {lo_freq_0}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_lo_freq_1(self, slot: int, lo_freq_1: int) -> None:
"""
Set LO Frequency for output 1.
Parameters
----------
slot : int
slot index.
lo_freq_1 : int
Frequency in Hertz
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
self._write(f"SLOT{slot}:STATus:QUEStionable:FREQuency:LO1 {lo_freq_1}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_lo_pwr_0(self, slot: int, lo_pwr_0: int) -> None:
"""
Set LO Power for output 0.
Parameters
----------
slot : int
slot index.
lo_pwr_0 : int
Power in dBm
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
self._write(f"SLOT{slot}:STATus:QUEStionable:POWer:LO0 {lo_pwr_0}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_lo_pwr_1(self, slot: int, lo_pwr_1: int) -> None:
"""
Set LO Power for output 1.
Parameters
----------
slot : int
slot index.
lo_pwr_1 : int
Power in dBm
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
self._write(f"SLOT{slot}:STATus:QUEStionable:POWer:LO1 {lo_pwr_1}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_som2_power(self, slot: int, som2_power: bool) -> None:
"""
Set SOM2 power enable.
Parameters
----------
slot : int
slot index.
som2_power : bool
Current SOM2 power enable bool.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "bool"])
# SCPI call
self._write(f"SLOT{slot}:SOM2:POWER:ENABLE {0 if som2_power == False else 1}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_som2_por_state(self, slot: int, som2_por_state: bool) -> None:
"""
Set power on reset of SOM2.
Parameters
----------
slot : int
slot index.
som2_por_state : bool
Current power on reset of SOM2 bool.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "bool"])
# SCPI call
self._write(f"SLOT{slot}:SOM2:POR:STATE {0 if som2_por_state == False else 1}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_som2_srst_state(self, slot: int, som2_srst_state: bool) -> None:
"""
Set power on reset of SOM2.
Parameters
----------
slot : int
slot index.
som2_srst_state : bool
Current power on reset of SOM2 bool.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "bool"])
# SCPI call
self._write(
f"SLOT{slot}:SOM2:SRST:STATE {0 if som2_srst_state == False else 1}"
)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_io_channel_status(self, slot: int, channel: int) -> Any:
"""
Get status information for the given I/O channel. The status consists of a JSON object with instrument-specific content. If the channel index is out of range, an error is set in system error.
Parameters
----------
slot : int
slot index.
channel : int
I/O channel index.
Returns
-------
Any
Current status object.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:IO:CHANnel{channel}:STATus?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_io_channel_scope_data(self, slot: int, channel: int) -> Any:
"""
Get scope data, represented as JSON. If the channel index is out of range, an error is set in system error.
Parameters
----------
slot : int
slot index.
channel : int
I/O channel index.
Returns
-------
Any
Current scope data.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:IO:CHANnel{channel}:SCOpe:DATA?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_io_channel_faults(self, slot: int, channel: int) -> Any:
"""
Get list of fault identification strings. If the channel index is out of range, an error is set in system error.
Parameters
----------
slot : int
slot index.
channel : int
I/O channel index.
Returns
-------
Any
Current faults.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:IO:CHANnel{channel}:FAULTs?")
return json.loads(var0.decode("utf-8"))
# -------------------------------------------------------------------------
@scpi_error_check
def _get_output_latency(self, slot: int, channel: int) -> float:
"""
Get delay associated with the current filter configuration.
Parameters
----------
slot : int
slot index.
channel : int
I/O channel index.
Returns
-------
float
Current filter delays.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read(
f"SLOT{slot}:PREDISTortion:CONFiguration:IO:CHANnel{channel}:DELAY?"
)
return float(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_current_afe_temperature(self, slot: int) -> float:
"""
Get current AFE temperature.
Parameters
----------
slot : int
slot index.
Returns
-------
float
current
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:STATus:QUEStionable:TEMPerature:AFE:CURRent?")
return float(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_maximum_afe_temperature(self, slot: int) -> float:
"""
Get maximum AFE temperature.
Parameters
----------
slot : int
slot index.
Returns
-------
float
maximum
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:STATus:QUEStionable:TEMPerature:AFE:MAXimum?")
return float(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_current_lo_temperature(self, slot: int) -> float:
"""
Get current LO temperature.
Parameters
----------
slot : int
slot index.
Returns
-------
float
current
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:STATus:QUEStionable:TEMPerature:LO:CURRent?")
return float(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_maximum_lo_temperature(self, slot: int) -> float:
"""
Get maximum LO temperature.
Parameters
----------
slot : int
slot index.
Returns
-------
float
maximum
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:STATus:QUEStionable:TEMPerature:LO:MAXimum?")
return float(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_current_eom_temperature(self, slot: int) -> float:
"""
Get current EOM temperature.
Parameters
----------
slot : int
slot index.
Returns
-------
float
current
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:STATus:QUEStionable:TEMPerature:EOM:CURRent?")
return float(var0)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def get_maximum_eom_temperature(self, slot: int) -> float:
"""
Get maximum EOM temperature.
Parameters
----------
slot : int
slot index.
Returns
-------
float
maximum
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:STATus:QUEStionable:TEMPerature:EOM:MAXimum?")
return float(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_max_out_att_0(self, slot: int) -> int:
"""
Get Get maximum possible attenuation for output 0..
Parameters
----------
slot : int
slot index.
Returns
-------
int
Maximum possible attenuation in dB.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:ATT:OUT0:MAX?")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_max_out_att_1(self, slot: int) -> int:
"""
Get Get maximum possible attenuation for output 1..
Parameters
----------
slot : int
slot index.
Returns
-------
int
Maximum possible attenuation in dB.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:AFE:ATT:OUT1:MAX?")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_sequencer_state(self, slot: int, sequencer: int) -> str:
"""
Get Get the sequencer state. If an invalid sequencer index is given, an error is set in system error..
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
Returns
-------
str
Concatenated list of strings separated by the semicolon character. Status is indicated by one status string and an optional number of flags respectively ordered as:
:Status:
- IDLE: Sequencer waiting to be armed and started.
- ARMED: Sequencer is armed and ready to start.
- RUNNING: Sequencer is running.
- Q1 STOPPED: Classical part of the sequencer has stopped, waiting for real-time part to stop.
- STOPPED: Sequencer has completely stopped.
:Flags:
- DISARMED: Sequencer was disarmed.
- FORCED STOP: Sequencer was stopped while still running.
- SEQUENCE PROCESSOR Q1 ILLEGAL INSTRUCTION: Classical sequencer part executed an unknown instruction.
- SEQUENCE PROCESSOR RT EXEC ILLEGAL INSTRUCTION: Real-time sequencer part executed an unknown instruction.
- AWG WAVE PLAYBACK INDEX INVALID PATH 0: AWG path 0 tried to play an unknown waveform.
- AWG WAVE PLAYBACK INDEX INVALID PATH 1: AWG path 1 tried to play an unknown waveform.
- ACQ WEIGHT PLAYBACK INDEX INVALID PATH 0: Acquisition path 0 tried to play an unknown weight.
- ACQ WEIGHT PLAYBACK INDEX INVALID PATH 1: Acquisition path 1 tried to play an unknown weight.
- ACQ SCOPE DONE PATH 0: Scope acquisition for path 0 has finished.
- ACQ SCOPE OUT-OF-RANGE PATH 0: Scope acquisition data for path 0 was out-of-range.
- ACQ SCOPE OVERWRITTEN PATH 0: Scope acquisition data for path 0 was overwritten.
- ACQ SCOPE DONE PATH 1: Scope acquisition for path 1 has finished.
- ACQ SCOPE OUT-OF-RANGE PATH 1: Scope acquisition data for path 1 was out-of-range.
- ACQ SCOPE OVERWRITTEN PATH 1: Scope acquisition data for path 1 was overwritten.
- ACQ BINNING DONE: Acquisition binning completed.
- ACQ BINNING FIFO ERROR: Acquisition binning encountered internal FIFO error.
- ACQ BINNING COMM ERROR: Acquisition binning encountered internal communication error.
- ACQ BINNING OUT-OF-RANGE: Acquisition binning data out-of-range.
- ACQ INDEX INVALID: Acquisition tried to process an invalid acquisition.
- ACQ BIN INDEX INVALID: Acquisition tried to process an invalid bin.
- CLOCK INSTABILITY: Clock source instability occurred.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:SEQuencer{sequencer}:STATE?")
return var0
# -------------------------------------------------------------------------
@scpi_error_check
def _get_acq_num_acquisitions(self, slot: int, sequencer: int) -> int:
"""
Get Get number of acquisitions in acquisition list of indexed sequencer's acquisition path. If an invalid sequencer index is given, an error is set in system error..
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
Returns
-------
int
Number of acquisitions.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:SEQuencer{sequencer}:ACQ:ALISt:SIZE?")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_acq_acquisitions(self, slot: int, sequencer: int) -> List[bytes]:
"""
Get Get all acquisitions in acquisition list of indexed sequencer's acquisition path. If an invalid sequencer index is given, an error is set in system error..
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
Returns
-------
list[bytes]
Dictionary with acquisitions
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:SEQuencer{sequencer}:ACQ:ALISt?")
return var0
# -------------------------------------------------------------------------
@scpi_error_check
def _set_sequencer_program(self, slot: int, sequencer: int, program: str) -> None:
"""
Assemble and set the resulting Q1ASM program for the indexed sequencer. If an invalid sequencer index is given or assembling fails, an error is set in system error. The assembler status and log can be retrieved using separate commands. To set the Q1ASM program, the sequencer will be stopped.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
program : str
Q1ASM program.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str"])
# SCPI call
self._write_bin(
f"SLOT{slot}:SEQuencer{sequencer}:PROGram", program.encode("ascii")
)
# -------------------------------------------------------------------------
[docs]
@scpi_error_check
def start_adc_calib(self, slot: int) -> None:
"""
Calibrates ADC delay and offset values. This method sets the correct delay values for every input data index (IO data lane) in order to avoid timing violations which occur while sampling ADC data. It also calibrates offsets internal to the ADC.
Parameters
----------
slot : int
slot index.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
self._write(f"SLOT{slot}:AFE:ADC:CALibration")
# -------------------------------------------------------------------------
@scpi_error_check
def _add_awg_waveform(
self, slot: int, sequencer: int, name: str, size: int, is_integer: bool
) -> None:
"""
Add new waveform to waveform list of indexed sequencer's AWG path. If an invalid sequencer index is given or if the waveform causes the waveform memory limit to be exceeded, an error is set in system error. The waveform names 'all' and 'ALL' are reserved and adding those will also result in an error being set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
name : str
Waveform name.
size : int
Waveform length in number of samples.
is_integer : bool
Waveform is provided as integers (False = floats, True = integers).
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str", "int", "bool"])
# SCPI call
self._write(
f'SLOT{slot}:SEQuencer{sequencer}:AWG:WLISt:WAVeform:NEW "{name}",{size},{0 if is_integer == False else 1}'
)
# -------------------------------------------------------------------------
@scpi_error_check
def _delete_awg_waveform(self, slot: int, sequencer: int, name: str) -> None:
"""
Delete waveform from waveform list of indexed sequencer's AWG path. If an invalid sequencer index is given or if a non-existing waveform name is given, an error is set in system error. The waveform names 'all' and 'ALL' are reserved and deleting those will cause a purge of the entire waveform list.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
name : str
Waveform name.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str"])
# SCPI call
self._write(
f'SLOT{slot}:SEQuencer{sequencer}:AWG:WLISt:WAVeform:DELete "{name}"'
)
# -------------------------------------------------------------------------
@scpi_error_check
def _set_awg_waveform_data(
self, slot: int, sequencer: int, name: str, waveform: List[float]
) -> None:
"""
Set waveform data of waveform in waveform list of indexed sequencer's AWG path. If an invalid sequencer index is given or if a non-existing waveform name is given, an error is set in system error. If the waveform size does not match the size specified while adding the waveform or if the waveform samples are out-of-range, an error is set in the system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
name : str
Waveform name.
waveform : list[float]
List of floats in the range of 1.0 to -1.0 representing the waveform samples.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str", "float"])
# SCPI call
self._write_bin(
f'SLOT{slot}:SEQuencer{sequencer}:AWG:WLISt:WAVeform:DATA "{name}",',
struct.pack("f" * len(waveform), *waveform),
)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_awg_waveform_data(
self, slot: int, sequencer: int, name: str, start: int, size: int
) -> List[float]:
"""
Get waveform data of waveform in waveform list of indexed sequencer's AWG path. If an invalid sequencer index is given or if a non-existing waveform name is given, an error is set in system error. The start and size arguments can be used to return a section of the waveform. If the start argument is not given, zero is used as the default start sample. If the size argument is not given, all samples starting from the start sample are returned.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
name : str
Waveform name.
start : int
First sample within the waveform to be returned.
size : int
Number of samples starting from the start sample to be returned.
Returns
-------
list[float]
List of floats in the range of 1.0 to -1.0 representing the waveform samples.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str", "int", "int"])
# SCPI call
var0 = self._read_bin(
f'SLOT{slot}:SEQuencer{sequencer}:AWG:WLISt:WAVeform:DATA? "{name}",{start},{size}'
)
return struct.unpack("f" * int(len(var0) / 4), var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _set_awg_waveform_index(
self, slot: int, sequencer: int, name: str, index: int
) -> None:
"""
Set waveform index of waveform in waveform list of indexed sequencer's AWG path. The index is used by the sequencer Q1ASM program to refer to the waveform. If an invalid sequencer or waveform index is given or if a non-existing waveform name is given, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
name : str
Waveform name.
index : int
Waveform index of the waveform in the waveform list.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str", "int"])
# SCPI call
self._write(
f'SLOT{slot}:SEQuencer{sequencer}:AWG:WLISt:WAVeform:INDex "{name}",{index}'
)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_awg_waveform_index(self, slot: int, sequencer: int, name: str) -> int:
"""
Get waveform index of waveform in waveform list of indexed sequencer's AWG path. The index is used by the sequencer Q1ASM program to refer to the waveform. If an invalid sequencer index is given or if a non-existing waveform name is given, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
name : str
Waveform name.
Returns
-------
int
Waveform index of the waveform in the waveform list.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str"])
# SCPI call
var0 = self._read(
f'SLOT{slot}:SEQuencer{sequencer}:AWG:WLISt:WAVeform:INDex? "{name}"'
)
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_awg_waveform_length(self, slot: int, sequencer: int, name: str) -> int:
"""
Get length of waveform in waveform list of indexed sequencer's AWG path. If an invalid sequencer index is given or if a non-existing waveform name is given, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
name : str
Waveform name.
Returns
-------
int
Waveform length in number of samples.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str"])
# SCPI call
var0 = self._read(
f'SLOT{slot}:SEQuencer{sequencer}:AWG:WLISt:WAVeform:LENGth? "{name}"'
)
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_awg_waveform_name(self, slot: int, sequencer: int, index: int) -> str:
"""
Get name of waveform in waveform list of indexed sequencer's AWG path based on its waveform index. If an invalid sequencer index is given or if a non-existing waveform index is given, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
index : int
Waveform index.
Returns
-------
str
Waveform name.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read(
f"SLOT{slot}:SEQuencer{sequencer}:AWG:WLISt:WAVeform:NAME? {index}"
)
return var0
# -------------------------------------------------------------------------
@scpi_error_check
def _get_awg_num_waveforms(self, slot: int, sequencer: int) -> int:
"""
Get number of waveforms in waveform list of indexed sequencer's AWG path. If an invalid sequencer index is given, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
Returns
-------
int
Number of waveforms.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:SEQuencer{sequencer}:AWG:WLISt:SIZE?")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_awg_waveforms(self, slot: int, sequencer: int) -> List[bytes]:
"""
Get all waveforms in waveform list of indexed sequencer's AWG path. If an invalid sequencer index is given, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
Returns
-------
list[bytes]
Dictionary with waveforms.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:SEQuencer{sequencer}:AWG:WLISt?")
return var0
# -------------------------------------------------------------------------
@scpi_error_check
def _add_acq_weight(
self, slot: int, sequencer: int, name: str, size: int, is_integer: bool
) -> None:
"""
Add new weight to weight list of indexed sequencer's acquisition path. If an invalid sequencer index is given or if the weight causes the weight memory limit to be exceeded, an error is set in system error. The weight names 'all' and 'ALL' are reserved and adding those will also result in an error being set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
name : str
Weight name.
size : int
Weight length in number of samples.
is_integer : bool
Weight is provided as integers (False = floats, True = integers).
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str", "int", "bool"])
# SCPI call
self._write(
f'SLOT{slot}:SEQuencer{sequencer}:ACQ:WLISt:WEIght:NEW "{name}",{size},{0 if is_integer == False else 1}'
)
# -------------------------------------------------------------------------
@scpi_error_check
def _delete_acq_weight(self, slot: int, sequencer: int, name: str) -> None:
"""
Delete weight from weight list of indexed sequencer's acquisition path. If an invalid sequencer index is given or if a non-existing weight name is given, an error is set in system error. The weight names 'all' and 'ALL' are reserved and deleting those will cause a purge of the entire weight list.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
name : str
Weight name.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str"])
# SCPI call
self._write(f'SLOT{slot}:SEQuencer{sequencer}:ACQ:WLISt:WEIght:DELete "{name}"')
# -------------------------------------------------------------------------
@scpi_error_check
def _set_acq_weight_data(
self, slot: int, sequencer: int, name: str, weight: List[float]
) -> None:
"""
Set weight data of weight in weight list of indexed sequencer's acquisition path. If an invalid sequencer index is given or if a non-existing weight name is given, an error is set in system error. If the weight size does not match the size specified while adding the weight or if the weight samples are out-of-range, an error is set in the system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
name : str
Weight name.
weight : list[float]
List of floats in the range of 1.0 to -1.0 representing the weight samples.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str", "float"])
# SCPI call
self._write_bin(
f'SLOT{slot}:SEQuencer{sequencer}:ACQ:WLISt:WEIght:DATA "{name}",',
struct.pack("f" * len(weight), *weight),
)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_acq_weight_data(
self, slot: int, sequencer: int, name: str, start: int, size: int
) -> List[float]:
"""
Get weight data of weight in weight list of indexed sequencer's acquisition path. If an invalid sequencer index is given or if a non-existing weight name is given, an error is set in system error. The start and size arguments can be used to return a section of the weight. If the start argument is not given, zero is used as the default start sample. If the size argument is not given, all samples starting from the start sample are returned.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
name : str
Weight name.
start : int
First sample within the weight to be returned.
size : int
Number of samples starting from the start sample to be returned.
Returns
-------
list[float]
List of floats in the range of 1.0 to -1.0 representing the weight samples.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str", "int", "int"])
# SCPI call
var0 = self._read_bin(
f'SLOT{slot}:SEQuencer{sequencer}:ACQ:WLISt:WEIght:DATA? "{name}",{start},{size}'
)
return struct.unpack("f" * int(len(var0) / 4), var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _set_acq_weight_index(
self, slot: int, sequencer: int, name: str, index: int
) -> None:
"""
Set weight index of weight in weight list of indexed sequencer's acquisition path. The index is used by the sequencer Q1ASM program to refer to the weight. If an invalid sequencer or weight index is given or if a non-existing weight name is given, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
name : str
Weight name.
index : int
Weight index of the weight in the weight list.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str", "int"])
# SCPI call
self._write(
f'SLOT{slot}:SEQuencer{sequencer}:ACQ:WLISt:WEIght:INDex "{name}",{index}'
)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_acq_weight_index(self, slot: int, sequencer: int, name: str) -> int:
"""
Get weight index of weight in weight list of indexed sequencer's acquisition path. The index is used by the sequencer Q1ASM program to refer to the weight. If an invalid sequencer index is given or if a non-existing weight name is given, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
name : str
Weight name.
Returns
-------
int
Weight index of the weight in the weight list.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str"])
# SCPI call
var0 = self._read(
f'SLOT{slot}:SEQuencer{sequencer}:ACQ:WLISt:WEIght:INDex? "{name}"'
)
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_acq_weight_length(self, slot: int, sequencer: int, name: str) -> int:
"""
Get length of weight in weight list of indexed sequencer's acquisition path. If an invalid sequencer index is given or if a non-existing weight name is given, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
name : str
Weight name.
Returns
-------
int
Weight length in number of samples.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str"])
# SCPI call
var0 = self._read(
f'SLOT{slot}:SEQuencer{sequencer}:ACQ:WLISt:WEIght:LENGth? "{name}"'
)
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_acq_weight_name(self, slot: int, sequencer: int, index: int) -> str:
"""
Get name of weight in weight list of indexed sequencer's acquisition path based on its weight index. If an invalid sequencer index is given or if a non-existing weight index is given, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
index : int
Weight index.
Returns
-------
str
Weight name.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read(
f"SLOT{slot}:SEQuencer{sequencer}:ACQ:WLISt:WEIght:NAME? {index}"
)
return var0
# -------------------------------------------------------------------------
@scpi_error_check
def _get_acq_num_weights(self, slot: int, sequencer: int) -> int:
"""
Get number of weights in weight list of indexed sequencer's acquisition path. If an invalid sequencer index is given, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
Returns
-------
int
Number of weights.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:SEQuencer{sequencer}:ACQ:WLISt:SIZE?")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_acq_weights(self, slot: int, sequencer: int) -> List[bytes]:
"""
Get all weights in weight list of indexed sequencer's acquisition path. If an invalid sequencer index is given, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
Returns
-------
list[bytes]
Dictionary with weights.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:SEQuencer{sequencer}:ACQ:WLISt?")
return var0
# -------------------------------------------------------------------------
@scpi_error_check
def _arm_sequencer(self, slot: int, sequencer: int) -> None:
"""
Prepare the indexed sequencer to start by putting it in the armed state. If no sequencer index is given, all sequencers are armed. Any sequencer that was already running is stopped and rearmed. If an invalid sequencer index is given, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
self._write(f"SLOT{slot}:SEQuencer{sequencer}:ARM")
# -------------------------------------------------------------------------
@scpi_error_check(minimal_check=True)
def _start_sequencer(self, slot: int, sequencer: int) -> None:
"""
Start the indexed sequencer, thereby putting it in the running state. If an invalid sequencer index is given or the indexed sequencer was not yet armed, an error is set in system error. If no sequencer index is given, all armed sequencers are started and any sequencer not in the armed state is ignored. However, if no sequencer index is given and no sequencers are armed, and error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
self._write(f"SLOT{slot}:SEQuencer{sequencer}:START")
# -------------------------------------------------------------------------
@scpi_error_check(minimal_check=True)
def _stop_sequencer(self, slot: int, sequencer: int) -> None:
"""
Stop the indexed sequencer, thereby putting it in the stopped state. If an invalid sequencer index is given, an error is set in system error. If no sequencer index is given, all sequencers are stopped.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
self._write(f"SLOT{slot}:SEQuencer{sequencer}:STOP")
# -------------------------------------------------------------------------
@scpi_error_check
def _add_acq_acquisition(
self, slot: int, sequencer: int, name: str, num_bins: int
) -> None:
"""
Add new acquisition to acquisition list of indexed sequencer's acquisition path. If an invalid sequencer index is given or if the required acquisition memory cannot be allocated, an error is set in system error. The acquisition names 'all' and 'ALL' are reserved and adding those will also result in an error being set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
name : str
Acquisition name.
num_bins : int
Number of bins in acquisition. Maximum is 2^24.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str", "int"])
# SCPI call
self._write(
f'SLOT{slot}:SEQuencer{sequencer}:ACQ:ALISt:ACQuisition:NEW "{name}",{num_bins}'
)
# -------------------------------------------------------------------------
@scpi_error_check
def _delete_acq_acquisition(self, slot: int, sequencer: int, name: str) -> None:
"""
Delete acquisition from acquisition list of indexed sequencer's acquisition path. If an invalid sequencer index is given or if a non-existing acquisition name is given, an error is set in system error. The acquisition names 'all' and 'ALL' are reserved and deleting those will cause a purge of the entire acquisition list.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
name : str
Acquisition name.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str"])
# SCPI call
self._write(
f'SLOT{slot}:SEQuencer{sequencer}:ACQ:ALISt:ACQuisition:DELete "{name}"'
)
# -------------------------------------------------------------------------
@scpi_error_check
def _set_acq_acquisition_data(self, slot: int, sequencer: int, name: str) -> None:
"""
Move scope mode (raw) acquisition data into acquisition in acquisition list of indexed sequencer's acquisition path. If an invalid sequencer index is given or if a non-existing acquisition name is given, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
name : str
Acquisition name.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str"])
# SCPI call
self._write(
f'SLOT{slot}:SEQuencer{sequencer}:ACQ:ALISt:ACQuisition:DATA "{name}"'
)
# -------------------------------------------------------------------------
@scpi_error_check
def _delete_acq_acquisition_data(
self, slot: int, sequencer: int, name: str
) -> None:
"""
Delete acquisition data from acquisition in acquisition list. If an invalid sequencer index is given or if a non-existing acquisition name is given, an error is set in system error. The acquisition names 'all' and 'ALL' are reserved and deleting those will cause a purge of the data within the entire acquisition list.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
name : str
Acquisition name.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str"])
# SCPI call
self._write(
f'SLOT{slot}:SEQuencer{sequencer}:ACQ:ALISt:ACQuisition:DATA:DELete "{name}"'
)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_acq_acquisition_data(
self, slot: int, sequencer: int, name: str
) -> List[bytes]:
"""
Get acquisition data of acquisition in acquisition list of indexed sequencer's acquisition path. If an invalid sequencer index is given or if a non-existing acquisition name is given, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
name : str
Acquisition name.
Returns
-------
list[bytes]
Binary structure containing the acquisition.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str"])
# SCPI call
var0 = self._read(
f'SLOT{slot}:SEQuencer{sequencer}:ACQ:ALISt:ACQuisition:DATA? "{name}"'
)
return var0
# -------------------------------------------------------------------------
@scpi_error_check
def _set_acq_acquisition_index(
self, slot: int, sequencer: int, name: str, index: int
) -> None:
"""
Set acquisition index of acquisition in acquisition list of indexed sequencer's acquisition path. The index is used by the sequencer Q1ASM program to refer to the acquisition. If an invalid sequencer or acquisition index is given or if a non-existing acquisition name is given, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
name : str
Acquisition name.
index : int
Acquisition index of the acquisition in the acquisition list.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str", "int"])
# SCPI call
self._write(
f'SLOT{slot}:SEQuencer{sequencer}:ACQ:ALISt:ACQuisition:INDex "{name}",{index}'
)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_acq_acquisition_index(self, slot: int, sequencer: int, name: str) -> int:
"""
Get acquisition index of acquisition in acquisition list of indexed sequencer's acquisition path. The index is used by the sequencer Q1ASM program to refer to the acquisition. If an invalid sequencer index is given or if a non-existing acquisition name is given, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
name : str
Acquisition name.
Returns
-------
int
Acquisition index of the acquisition in the acquisition list.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str"])
# SCPI call
var0 = self._read(
f'SLOT{slot}:SEQuencer{sequencer}:ACQ:ALISt:ACQuisition:INDex? "{name}"'
)
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_acq_acquisition_num_bins(
self, slot: int, sequencer: int, name: str
) -> int:
"""
Get number of bins in acquisition in acquisition list of indexed sequencer's acquisition path. If an invalid sequencer index is given or if a non-existing acquisition name is given, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
name : str
Acquisition name.
Returns
-------
int
Number of bins in acquisition.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "str"])
# SCPI call
var0 = self._read(
f'SLOT{slot}:SEQuencer{sequencer}:ACQ:ALISt:ACQuisition:BINs? "{name}"'
)
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_acq_acquisition_name(self, slot: int, sequencer: int, index: int) -> str:
"""
Get name of acquisition in acquisition list of indexed sequencer's acquisition path based on its acquisition index. If an invalid sequencer index is given or if a non-existing acquisition index is given, an error is set in system error.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
index : int
acquisition index.
Returns
-------
str
acquisition name.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
var0 = self._read(
f"SLOT{slot}:SEQuencer{sequencer}:ACQ:ALISt:ACQuisition:NAME? {index}"
)
return var0
# -------------------------------------------------------------------------
@scpi_error_check
def _clear_sequencer_flags(self, slot: int, sequencer: int) -> None:
"""
Clear flags of the indexed sequencer. Sequencer state remains unaltered.
Parameters
----------
slot : int
slot index.
sequencer : int
Sequencer index.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
self._write(f"SLOT{slot}:SEQuencer{sequencer}:CLR:FLAGS")
# -------------------------------------------------------------------------
@scpi_error_check
def _scope_trigger_arm(self, slot: int) -> None:
"""
Arms the central external trigger logic for trace acquisition.
Parameters
----------
slot : int
slot index.
Returns
-------
None
"""
# Check input types.
self._check_in_type(locals(), ["int"])
# SCPI call
self._write(f"SLOT{slot}:SCOpe:TRG:ARM")
# -------------------------------------------------------------------------
@scpi_error_check
def _run_mixer_lo_calib(self, slot: int, output: int) -> None:
"""
Run LO Calibration Algorithm
Parameters
----------
slot : int
slot index.
output : int
output that will be affected by the calibration
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
self._write(f"SLOT{slot}:MIXer:LO:CALIB {output}")
# -------------------------------------------------------------------------
@scpi_error_check
def _run_mixer_sidebands_calib(self, slot: int, sequencer: int) -> None:
"""
Run sidebands Calibration Algorithm
Parameters
----------
slot : int
slot index.
sequencer : int
sequencer that will be affected by the calibration
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
self._write(f"SLOT{slot}:MIXer:SIDEbands:CALIB {sequencer}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_programmable_delay_value(
self, slot: int, channel: int, delay: int
) -> None:
"""
Set programmable delay value
Parameters
----------
slot : int
slot index.
channel : int
programmable delay channel
delay : int
delay value.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "int"])
# SCPI call
self._write(f"SLOT{slot}:PROGrammable:DELay{channel}:VALue {delay}")
# -------------------------------------------------------------------------
@scpi_error_check
def _get_programmable_delay_value(self, slot: int, channel: int) -> int:
"""
Get programmable delay value
Parameters
----------
slot : int
slot index.
channel : int
programmable delay channel
Returns
-------
int
delay value.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:PROGrammable:DELay{channel}:VALue?")
return int(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _set_dac_output_value(self, slot: int, channel: int, voltage: float) -> None:
"""
Set DAC output value
Parameters
----------
slot : int
slot index.
channel : int
pulse channel
voltage : float
dac voltage.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "float"])
# SCPI call
self._write(f"SLOT{slot}:DAC:OUT{channel}:VALue {voltage}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_output_normalized_amplitude(
self, slot: int, channel: int, amplitude: float
) -> None:
"""
Set normalized amplitude configuration.
Parameters
----------
slot : int
slot index.
channel : int
pulse channel
amplitude : float
Normalized amplitude configuration. Ranging from 0 to 1.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "float"])
# SCPI call
self._write(f"SLOT{slot}:IO:PULSe{channel}:NORMamp {amplitude}")
# -------------------------------------------------------------------------
@scpi_error_check
def _get_output_normalized_amplitude(self, slot: int, channel: int) -> float:
"""
Get normalized amplitude configuration.
Parameters
----------
slot : int
slot index.
channel : int
pulse channel
Returns
-------
float
Normalized amplitude configuration. Ranging from 0 to 1.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:IO:PULSe{channel}:NORMamp?")
return float(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_io_pulse_output_offset(self, slot: int, channel: int) -> float:
"""
Get Pulse output voltage offset
Parameters
----------
slot : int
slot index.
channel : int
pulse channel
Returns
-------
float
Pulse output voltage offset. Ranging from -3 to 3 volts.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read(f"SLOT{slot}:IO:PULSe{channel}:OUT:OFFset?")
return float(var0)
# -------------------------------------------------------------------------
@scpi_error_check
def _set_io_pulse_output_offset(
self, slot: int, channel: int, voltage: float
) -> None:
"""
Set Pulse output voltage offset.
Parameters
----------
slot : int
slot index.
channel : int
pulse channel
voltage : float
Pulse output voltage offset. Ranging from -3 to 3 volts.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "float"])
# SCPI call
self._write(f"SLOT{slot}:IO:PULSe{channel}:OUT:OFFset {voltage}")
# -------------------------------------------------------------------------
@scpi_error_check
def _set_io_pulse_width(self, slot: int, channel: int, width: Any) -> None:
"""
Set Pulse output coarse and fine width configuration.Coarse parameters is in steps of 1 nano second.Fine parameters is in steps of 5 pico seconds.
Parameters
----------
slot : int
slot index.
channel : int
pulse channel
width : Any
Pulse output width configuration object.
Returns
-------
None
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int", "Any"])
# SCPI call
self._write_bin(
f"SLOT{slot}:IO:PULSe{channel}:WIDth", json.dumps(width).encode("utf-8")
)
# -------------------------------------------------------------------------
@scpi_error_check
def _get_io_pulse_width(self, slot: int, channel: int) -> Any:
"""
Get Pulse output coarse and fine width configuration.Coarse parameters is in steps of 1 nano second.Fine parameters is in steps of 5 pico seconds.
Parameters
----------
slot : int
slot index.
channel : int
pulse channel
Returns
-------
Any
Pulse output width configuration object.
Raises
------
Exception
Invalid input parameter type.
Exception
An error is reported in system error and debug <= 1.
All errors are read from system error and listed in the exception.
"""
# Check input types.
self._check_in_type(locals(), ["int", "int"])
# SCPI call
var0 = self._read_bin(f"SLOT{slot}:IO:PULSe{channel}:WIDth?")
return json.loads(var0.decode("utf-8"))
# ---------------------------------------------------------------------
def _check_in_type(self, in_arg_dict: Dict, in_type_list: List) -> None:
"""
Checks input argument types against reference types.
Parameters
----------
in_arg_dict : dict
Dictionary with input arguments created by locals().
in_type_list : list
List of reference input argument types.
Returns
----------
Raises
----------
TypeError
Input argument type mismatch.
"""
if self._debug != DebugLevel.NO_CHECK:
del in_arg_dict["self"]
in_val_list = [in_arg_dict[name] for name in in_arg_dict]
for i, (in_val, in_type) in enumerate(zip(in_val_list, in_type_list)):
if (
type(in_val).__name__ == "list"
or type(in_val).__name__ == "ndarray"
):
if len(in_val) > 0:
in_val = in_val[0]
else:
raise TypeError(
f"Unexpected type for input argument {i}, expected {in_type} but got empty {str(type(in_val).__name__)}."
)
if in_type == "Any":
continue
if type(in_val).__name__[: len(in_type)] != in_type:
raise TypeError(
f"Unexpected type for input argument {i}, expected {in_type} but got {str(type(in_val).__name__)}."
)
# -------------------------------------------------------------------------
[docs]
def check_error_queue(self, err: Optional[Exception] = None) -> None:
"""
Check system error for errors. Empties and prints the complete error
queue.
Parameters
----------
err : Optional[Exception]
Exception to reraise.
Returns
----------
Raises
----------
Exception
An exception was passed as input argument.
RuntimeError
An error was found in system error.
"""
# ExceptionGroup is Python 3.11+, this snippet can be removed when 3.10 support is dropped
# (And Exception below replaced with `ExceptionGroup`
try:
GroupException = ExceptionGroup
except NameError:
# Somehow 3.11 still detects the class below when it is named ExceptionGroup
class GroupException(Exception):
def __init__(self, message: str, exceptions: list[Exception]):
self.exceptions = exceptions
message = f"{message}: {[f'{type(e).__name__}: {e!s}' for e in exceptions]}"
super().__init__(message)
errors: list[Exception] = [err] if err is not None else []
while int(self._read("SYSTem:ERRor:COUNt?")) != 0:
errors.append(
RuntimeError(",".join(self._read("SYSTem:ERRor:NEXT?").split(",")[1:]))
)
if len(errors) == 1:
raise errors[0].with_traceback(sys.exc_info()[2]) from errors[0]
if len(errors) > 1:
raise GroupException("Multiple errors occurred", errors).with_traceback(
sys.exc_info()[2]
)
