HORIZONTAL_POSITION_MSO2X
Python Code
from typing import Optional
from flojoy import VisaConnection, flojoy, DataContainer, String
@flojoy(deps={"tm_devices": "1"}, inject_connection=True)
def HORIZONTAL_POSITION_MSO2X(
connection: VisaConnection,
input: Optional[DataContainer] = None,
delay: float = 0,
position: float = 50,
) -> String:
"""Set the MSO2X oscilloscope horizontal position or delay.
If delay is non-zero, position is unused.
Requires a CONNECT_MSO2X block to create the connection.
Tested on MSO22 and MSO24.
Parameters
----------
connection : VisaConnection
The VISA address (requires the CONNECTION_MSO2X block).
delay : float, default=0
Delay after trigger, in seconds. Delay mode is turned on if not 0.
position : float, default=50
Horizontal position, in percent. Only used if delay is zero.
Returns
-------
String
Horizontal position
"""
# Retrieve oscilloscope instrument connection
scope = connection.get_handle()
scope.commands.horizontal.delay.mode.write(delay)
scope.commands.horizontal.position.write(position)
return String(s="Horizontal position")
Example App
This app uses the Tektronix tm_measure library to create a steup file for a Tektronix MSO24 oscilloscope.
A setup file in MSO24 can store most of the instruments settings including axis scales, trigger settings, etc. To store the settings Flojoy blocks must first be used to create the inital settings.
First the necessary blocks were added:
- 1
CONNECT_MSO2X - 1
AFG_MSO2X - 1
CHANNEL_DISPLAY_MSO2X - 1
EDGE_TRIGGER_MSO2X - 1
HORIZONTAL_SCALE_MSO2X - 3
VERTICAL_SCALE_MSO2X - 3
PROBE_ATTENUATION_MSO2X - 1
SETUP_FILE_MSO2X
Each of these blocks must change the connection parameter to the correct instrument. The channel parameter for the 3 VERTICAL_SCALE_MSO2X blocks must be changed to channel 1, 2, and 3 (i.e. one each). The same is true for PROBE_ATTENUATION_MSO2X. Additionally the three channels can be turned on with the CHANNEL_DISPLAY_MSO2X block.
The SETUP_FILE_MSO2X can be set to save flojoy as a filename (this saves the file located at c:/flojoy.set).
Note that the AFG settings are not loaded from the setup file. Note two inputs (CH2 and CH3) came from an external source.