DPO7AX device driver module.
DPO7AX(
config_entry: DeviceConfigEntry,
verbose: bool,
visa_resource: MessageBasedResource,
default_visa_timeout: int,
)
Bases: DPO7AXMixin, DPO7
DPO7AX device driver.
| Parameters: |
|
|---|
property
¶
address: str
Return the device address as defined in the config_entry.
This could be an IP address, hostname, or USB device address.
property
¶
Return a tuple containing all the channel names.
cached
property
¶
channel: MappingProxyType[str, TekScopeChannel]
Mapping of channel names to any detectable properties, attributes, and settings.
cached
property
¶
command_argument_constants: DPO7AXCommandConstants
Return the DPO7AX command argument constants.
This provides access to all the string constants which can be used as arguments for DPO7AX commands.
property
¶
command_syntax_enabled: bool
Return a string containing the syntax of the command being accessed.
This property indicates when the syntax should be returned instead of writing/querying the device and returning the result.
property
¶
command_verification_enabled: bool
Indicate if command verification is enabled.
This property only applies to commands sent using the .commands property of the
device.
Notes
- If
.enable_verificationis set toFalse, then no verification will happen at all. - If
.enable_verificationis set toTrueand this property isTrue, then verification will happen for commands sent using the.commandsproperty of the device. - If
.enable_verificationis set toTrueand this property isFalse, then verification will not happen for commands sent using the.commandsproperty of the device.
cached
property
¶
commands: DPO7AXCommands
Return the DPO7AX commands.
This provides access to all the commands for the DPO7AX device. See the documentation of each sub-property for more usage information.
Sub-properties
.acquire: TheACQuirecommand..actonevent: TheACTONEVentcommand tree..afg: TheAFGcommand tree..alias: TheALIascommand..allev: TheALLEvcommand..application: TheAPPLicationcommand tree..autosavepitimeout: TheAUTOSAVEPITIMEOUTcommand..autosaveuitimeout: TheAUTOSAVEUITIMEOUTcommand..autoset: TheAUTOSetcommand..auxin: TheAUXIncommand tree..auxout: TheAUXoutcommand tree..bus: TheBUScommand tree..bustable: TheBUSTABlecommand tree..busy: TheBUSYcommand..cal: The*CALcommand..calibrate: TheCALibratecommand..callouts: TheCALLOUTScommand tree..ch: TheCH<x>command..clear: TheCLEARcommand..cls: The*CLScommand..configuration: TheCONFIGurationcommand tree..connected: TheCONNectedcommand tree..curvestream: TheCURVEStreamcommand..customtable: TheCUSTOMTABlecommand tree..data: TheDATacommand..date: TheDATEcommand..ddt: The*DDTcommand..dese: TheDESEcommand..diag: TheDIAgcommand tree..diggrp: TheDIGGRP<x>command tree..display: TheDISplaycommand..ese: The*ESEcommand..esr: The*ESRcommand..ethernet: TheETHERnetcommand tree..event: TheEVENTcommand..evmsg: TheEVMsgcommand..evqty: TheEVQtycommand..eyemask: TheEYEMASKcommand tree..factory: TheFACtorycommand..filesystem: TheFILESystemcommand..fpanel: TheFPAnelcommand tree..header: TheHEADercommand..histogram: TheHISTogramcommand tree..horizontal: TheHORizontalcommand..hostprocessor: TheHOSTProcessorcommand..hsinterface: TheHSInterfacecommand tree..id: TheIDcommand..idn: The*IDNcommand..license: TheLICensecommand..lock: TheLOCkcommand..lrn: The*LRNcommand..mainwindow: TheMAINWindowcommand tree..mask: TheMASKcommand tree..math: TheMATHcommand tree..matharbflt: TheMATHArbflt<x>command tree..meastable: TheMEASTABlecommand tree..measurement: TheMEASUrementcommand..newpass: TheNEWpasscommand..opc: The*OPCcommand..opt: The*OPTcommand..password: ThePASSWordcommand..pause: ThePAUSecommand..peakstable: ThePEAKSTABlecommand tree..pilogger: ThePILOGgercommand tree..plot: ThePLOTcommand tree..psc: The*PSCcommand..pud: The*PUDcommand..recall: TheRECAllcommand tree..ref: TheREFcommand tree..refx: TheREF<x>command tree..rem: TheREMcommand..rosc: TheROSccommand tree..rst: The*RSTcommand..save: TheSAVecommand tree..saveon: TheSAVEONcommand tree..saveonevent: TheSAVEONEVentcommand tree..search: TheSEARCHcommand tree..searchtable: TheSEARCHTABlecommand tree..security: TheSECuritycommand tree..select: TheSELectcommand tree..set: TheSETcommand..socketserver: TheSOCKETServercommand tree..sre: The*SREcommand..stb: The*STBcommand..sv: TheSVcommand tree..teksecure: TheTEKSecurecommand..time: TheTIMecommand..totaluptime: TheTOTaluptimecommand..touchscreen: TheTOUCHSCReencommand tree..trg: The*TRGcommand..trigger: TheTRIGgercommand..tst: The*TSTcommand..undo: TheUNDOcommand..unlock: TheUNLockcommand..usbdevice: TheUSBDevicecommand tree..verbose: TheVERBosecommand..vertical: TheVERTicalcommand tree..visual: TheVISualcommand tree..vxi: TheVXIcommand tree..wai: The*WAIcommand..wavfrm: TheWAVFrmcommand..wfmoutpre: TheWFMOutprecommand.
property
¶
default_visa_timeout: int
Return the default VISA timeout value in milliseconds.
property
¶
device_number: int
Return the device number, if it was not created by the DeviceManager it will be -1.
property
writable
¶
enable_verification: bool
Return the boolean which indicates if verification checks should happen.
This can be disabled after developing a script in order to increase the speed of the script.
Notes
- If
.enable_verificationis set toFalse, then no verification of any commands sent using the.set_and_check()method will occur (the “check” portion of “set” and “check” will be skipped). - If
.enable_verificationis set toTrue, then verification will happen for commands sent using the.set_and_check()method (both the “set” and “check” portions will be executed).
cached
property
¶
hostname: str
Return the hostname of the device or an empty string if unable to fetch that.
cached
property
¶
idn_string: str
Return the string returned from the *IDN? query when the device was created.
property
¶
ieee_cmds: IEEE4882Commands
Return an internal class containing methods for the standard IEEE 488.2 command set.
cached
property
¶
ip_address: str
Return the IPv4 address of the device or an empty string if unable to fetch that.
cached
property
¶
Return the list of license AppIDs installed on the scope.
cached
property
¶
name_and_alias: str
Return string for easy ID of device in console output prints.
property
¶
num_dig_bits_in_ch: int
Return the number of digital bits expected in a digital channel.
cached
property
¶
series: str
Return the series of the device.
| Returns: |
|
|---|
property
¶
source_device_constants: TekScopeSourceDeviceConstants
The constants defining what functions and memory sizes are allowed for the device.
cached
property
¶
total_channels: int
Return the total number of channels (all types).
property
¶
property
¶
visa_resource: MessageBasedResource
Return the VISA resource object.
This gives access to all the attributes and methods that PyVISA provides.
property
writable
¶
visa_timeout: float
Return the current VISA timeout of the device in milliseconds.
add_bus(bus_num: int) -> None
Add a new bus.
| Parameters: |
|
|---|
add_histogram(hist_num: int) -> None
Add a new histogram.
| Parameters: |
|
|---|
add_math(math_num: int) -> None
Add a new math.
| Parameters: |
|
|---|
add_measurement(measurement_num: int) -> None
Add a new measurement.
| Parameters: |
|
|---|
add_measurement_table(meas_table_num: int) -> None
Add a new measurement table.
| Parameters: |
|
|---|
classmethod
¶
add_method(method: Callable[Concatenate[Self, _P], _T]) -> None
Add a method to the class.
This class method is best used as a decorator on functions in order to add them to a class.
Examples:
>>> from tm_devices.drivers.device import Device
>>>
>>> @Device.add_method
... def print_hello(self: Device, var: str):
... print("Hello World!")
... print(f"I am a {self.__class__.__name__}!")
... print(f"My var is {var}")
| Parameters: |
|
|---|
Add a new measurement with the given name, type, and source.
| Parameters: |
|---|
add_plot(plot_num: int) -> None
Add a new plot.
| Parameters: |
|
|---|
add_power(power_meas_num: int) -> None
Add a new power measurement.
| Parameters: |
|
|---|
classmethod
¶
add_property(method: Callable[Concatenate[_EM, _P], _T]) -> None
add_property(
method: None = None, /, *, is_cached: bool = False
) -> Callable[[Callable[Concatenate[_EM, _P], _T]], None]
add_property(
method: Callable[[Self], _T] | None = None, /, *, is_cached: bool = False
) -> Callable[[Callable[[Self], _T]], None] | None
Add a property to the class.
This class method is best used as a decorator on functions in order to add them to a class.
Examples:
>>> from tm_devices.drivers.device import Device
>>>
>>> @Device.add_property
... def foo(self: Device):
... return "bar"
>>>
>>> @Device.add_property(is_cached=True)
... def foo(self: Device):
... return self.name + self.address
| Parameters: |
|---|
add_ref(ref_num: int) -> None
Add a new ref.
| Parameters: |
|
|---|
add_search(search_num: int) -> None
Add a new search.
| Parameters: |
|
|---|
Check the network connection to the device using an external ping command.
Wrapper function for
check_network_connection.
| Returns: |
|---|
Check if the given port is open on the device.
Wrapper function for check_port_connection.
| Parameters: |
|---|
| Returns: |
|
|---|
check_visa_connection() -> bool
Check if a VISA connection can be made to the device.
Wrapper function for check_visa_connection.
cleanup(verbose: bool = True) -> None
Perform the cleanup defined for the device.
| Parameters: |
|
|---|
command_syntax() -> Generator[None, None, None]
Enable command syntax for the duration of this context manager.
This method is designed to be used as a context manager (with device.command_syntax():)
around any blocks of code where the literal syntax of commands accessed using the
.commands property is desired.
This is accomplished by setting the .command_syntax_enabled property to True for the
duration of the context manager.
command_verification() -> Generator[None, None, None]
Enable command verification for the duration of this context manager.
This method is designed to be used as a context manager (with
device.command_verification():) around any blocks of code where verification of commands
sent using the .commands property is desired.
This is accomplished by setting the .command_verification_enabled property to True
for the duration of the context manager.
curve_query(
channel_num: int,
wfm_type: str = "TimeDomain",
output_csv_file: str | PathLike[str] | None = None,
) -> list[Any]
Perform a curve query on a specific channel.
| Parameters: |
|---|
| Returns: |
|---|
| Raises: |
|
|---|
delete_bus(bus_num: int) -> None
Delete a bus.
| Parameters: |
|
|---|
delete_histogram(hist_num: int) -> None
Delete a histogram.
| Parameters: |
|
|---|
delete_math(math_num: int) -> None
Delete a math.
| Parameters: |
|
|---|
delete_measurement(measurement_num: int) -> None
Delete a measurement.
| Parameters: |
|
|---|
delete_measurement_table(measurement_table_num: int) -> None
Delete a measurement table.
| Parameters: |
|
|---|
delete_plot(plot_num: int) -> None
Delete a plot.
| Parameters: |
|
|---|
delete_power(power_num: int) -> None
Delete a power.
| Parameters: |
|
|---|
delete_ref(ref_num: int) -> None
Delete a ref.
| Parameters: |
|
|---|
delete_search(search_num: int) -> None
Delete a search.
| Parameters: |
|
|---|
expect_esr(
esr: int, error_messages: tuple[str, ...] = (), *, use_regex_match: bool = False
) -> bool
Checks for the expected esr value and queued error messages.
| Parameters: |
|
|---|
| Returns: |
|
|---|
| Raises: |
|
|---|
factory_reset() -> None
Send the FACTORY command followed by an *OPC? query.
This command is equivalent to pressing the DEFAULT SETUP button located on the instrument front panel or selected Default Setup from the File menu.
It recalls the instrument to factory default settings.
In addition to what *RST does, this command also performs the following operations:
- Clears any pending OPC operations
- Resets the following IEEE488.2 registers:
*ESR0 (Event Status Enable Register)*SRE0 (Service Request Enable Register)- DESE 255 (Device Event Status Enable Register)
*PSC1 (Power-on Status Clear Flag)- Deletes all defined aliases.
- Enables command headers (:HEADer 1).
FACTORY only resets the programmable interface settings, it does not change the
user interface settings.
generate_function(
frequency: float,
function: SignalGeneratorFunctionsIAFG,
amplitude: float,
offset: float,
channel: str = "all",
output_signal_path: SignalGeneratorOutputPathsBase | None = None,
termination: Literal["FIFTY", "HIGHZ"] = "FIFTY",
duty_cycle: float = 50.0,
polarity: Literal["NORMAL", "INVERTED"] = "NORMAL",
symmetry: float = 50.0,
) -> None
Generate a predefined waveform given the following parameters.
| Parameters: |
|
|---|
get_waveform_constraints(
function: SignalGeneratorFunctionsIAFG | None = None,
waveform_length: int | None = None,
frequency: float | None = None,
output_signal_path: SignalGeneratorOutputPathsBase | None = None,
load_impedance: LoadImpedanceAFG = HIGHZ,
) -> ExtendedSourceDeviceConstants
Get the constraints that restrict the waveform to certain parameter ranges.
| Parameters: |
|
|---|
| Returns: |
|
|---|
has_errors() -> bool
Check if the device has any errors.
Note
This method will clear out the error queue after reading the current errors.
| Returns: |
|
|---|
poll_query(
number_of_polls: int,
query: str,
wanted_val: float | str,
sleep_time: float = 0.4,
tolerance: float = 0,
percentage: bool = False,
invert_range: bool = False,
invalid_values: list[float | str] | None = None,
) -> None
Poll the query until the wanted value appears.
| Parameters: |
|
|---|
| Raises: |
|
|---|
query(
query: str, *, verbose: bool = True, remove_quotes: bool = False, allow_empty: bool = False
) -> str
Send a query to the device and return the result.
| Parameters: |
|
|---|
| Returns: |
|
|---|
| Raises: |
|
|---|
query_binary(
query: str,
verbose: bool = True,
datatype: BINARY_DATATYPES = "f",
is_big_endian: bool = False,
container: type[T] | Callable[[Iterable[Any]], T] = list,
delay: float | None = None,
header_fmt: BINARY_HEADERS = "ieee",
expect_termination: bool = True,
data_points: int = 0,
chunk_size: int | None = None,
) -> T
Send a query to the device and return the binary values.
| Parameters: |
|
|---|
| Returns: |
|
|---|
| Raises: |
|
|---|
Send a query expecting it to time out and fail.
| Parameters: |
|---|
| Returns: |
|
|---|
| Raises: |
|
|---|
query_less_than(
query: str,
value: float | str,
tolerance: float = 0,
percentage: bool = False,
allow_equal: bool = False,
) -> bool
Send the given query and verify the result is less than the expected response.
| Parameters: |
|
|---|
| Returns: |
|
|---|
Send a command to the device and then read and return the raw binary values.
| Parameters: |
|---|
| Returns: |
|
|---|
| Raises: |
|
|---|
query_response(
query: str,
value: str | float,
tolerance: float = 0,
percentage: bool = False,
remove_quotes: bool = False,
custom_message_prefix: str = "",
allow_empty: bool = False,
) -> tuple[bool, str]
Query the device and verify the result.
| Parameters: |
|
|---|
| Returns: |
|---|
query_response_not(
query: str, value: str, remove_quotes: bool = False, custom_message_prefix: str = ""
) -> tuple[bool, str]
Query the device and verify the result is not the given value.
| Parameters: |
|
|---|
| Returns: |
|---|
recall_session(session_path: str) -> None
Recall a session file.
| Parameters: |
|
|---|
reset() -> None
Send the *RST command followed by an *OPC? query.
*RST only resets the programmable interface settings, it does not change the user
interface settings.
save_screenshot(
filename: str | PathLike[str] | None = None,
*,
colors: str | None = None,
view_type: str | None = None,
local_folder: str | PathLike[str] = "./",
device_folder: str | PathLike[str] = "./",
keep_device_file: bool = False
) -> None
Capture a screenshot from the device and save it locally.
| Parameters: |
|
|---|
Save the specified waveform to a reference.
This uses a workaround by saving the waveform to a file and then recalling that file
to a reference because the PI command :SAVE:WAVEFORM CH1,REF1 is not available
currently. If it gets added later this function should be updated.
Recalling a file to a ref turns on ref, so :REF:ADDNEW is not needed.
| Parameters: |
|---|
set_and_check(
command: str,
value: str | float,
tolerance: float = 0,
percentage: bool = False,
remove_quotes: bool = False,
custom_message_prefix: str = "",
*,
expected_value: str | float | None = None,
opc: bool = False
) -> str
Send the given command with the given value and then verify the results.
| Parameters: |
|
|---|
| Returns: |
|
|---|
set_if_needed(
command: str,
value: str | float,
tolerance: float = 0,
percentage: bool = False,
remove_quotes: bool = False,
custom_message_prefix: str = "",
*,
expected_value: str | float | None = None,
opc: bool = False,
allow_empty: bool = False,
verify_value: bool = False
) -> tuple[bool, str]
Query the command’s field and update it if the value does not match the input.
| Parameters: |
|
|---|
| Returns: |
|---|
setup_burst(
frequency: float,
function: SignalGeneratorFunctionsIAFG,
amplitude: float,
offset: float,
burst_count: int,
channel: str = "all",
output_signal_path: SignalGeneratorOutputPathsBase | None = None,
termination: Literal["FIFTY", "HIGHZ"] = "FIFTY",
duty_cycle: float = 50.0,
polarity: Literal["NORMAL", "INVERTED"] = "NORMAL",
symmetry: float = 50.0,
) -> None
Set up the Internal AFG for sending a burst of waveforms given the following parameters.
| Parameters: |
|
|---|
Enable (or disable) all verification of communication for the duration of the context.
This will temporarily set the
Device.enable_verification
property to the specified value, and then reset it to the previous value
when the context exits.
| Parameters: |
|
|---|
Set a temporary console output verbosity for the duration of the context.
This will reset the verbosity to the previous value when the context exits.
| Parameters: |
|
|---|
Set a temporary VISA timeout value for the duration of the context.
This will reset the VISA timeout to the previous value when the context exits.
| Parameters: |
|
|---|
turn_channel_off(channel_str: str) -> None
Turn off the specified channel.
| Parameters: |
|
|---|
turn_channel_on(channel_str: str) -> None
Turn on the specified channel.
| Parameters: |
|
|---|
wait_for_network_connection(
wait_time: float, sleep_seconds: int = 2, accept_immediate_connection: bool = False
) -> bool
Wait for a network connection to the device.
| Parameters: |
|
|---|
| Returns: |
|
|---|
| Raises: |
|
|---|
wait_for_port_connection(
port: int, wait_time: float, sleep_seconds: int = 5, accept_immediate_connection: bool = False
) -> bool
Wait for a connection to be made to the given port on the device.
| Parameters: |
|
|---|
| Returns: |
|
|---|
| Raises: |
|
|---|
wait_for_srq_event(timeout: int) -> WaitResponse
Wait for the service request event to happen, up to the given timeout.
| Parameters: |
|
|---|
| Returns: |
|
|---|
wait_for_visa_connection(
wait_time: float, sleep_seconds: int = 5, accept_immediate_connection: bool = False
) -> bool
Wait for a VISA connection to be made to the device.
| Parameters: |
|---|
| Returns: |
|
|---|
| Raises: |
|
|---|
Write a command to the device.
| Parameters: |
|---|
| Raises: |
|
|---|