# Tektronix2SeriesMSO

## class Tektronix2SeriesMSO( visa_resource: str | VisaConfig, )[source]

Bases: [`ScopeDriverBase`](https://dev.nominal.io/instro/ref/instruments/instro.scope.ScopeDriverBase.md#instro.scope.ScopeDriverBase "instro.scope.scope.ScopeDriverBase")

SCPI driver for Tektronix 2 Series MSO oscilloscopes (MSO22, MSO24).

Methods

| [`check_errors`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.check_errors "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.check_errors") | Drain `ALLEv?` and raise on any event with code > 1. |
| --- | --- |
| [`clear_measurements`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.clear_measurements "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.clear_measurements") | Delete every measurement slot on the scope and reset the local cache. |
| [`close`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.close "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.close") | Close the underlying transport. |
| [`digitize`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.digitize "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.digitize") | ``` SEQuence``+``RUN ```, then `*OPC?` under a scoped VISA timeout. |
| [`fetch_waveform`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.fetch_waveform "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.fetch_waveform") | Fetch the waveform from `channel` over `RIBinary` (signed 16-bit). |
| [`force_trigger`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.force_trigger "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.force_trigger") | Force a trigger event immediately, regardless of the configured conditions. |
| [`get_acquisition_mode`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.get_acquisition_mode "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.get_acquisition_mode") | Read back the current acquisition mode. |
| [`get_acquisition_state`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.get_acquisition_state "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.get_acquisition_state") | Read back the acquisition run state (RUNNING / STOPPED). |
| [`get_average_count`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.get_average_count "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.get_average_count") | Read back the waveforms-to-average count. |
| [`get_coupling`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.get_coupling "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.get_coupling") | Read back input coupling on `channel`. |
| [`get_horizontal_scale`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.get_horizontal_scale "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.get_horizontal_scale") | Read back the timebase (seconds/div). |
| [`get_probe_attenuation`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.get_probe_attenuation "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.get_probe_attenuation") | Read back `channel`'s probe attenuation ratio. |
| [`get_sample_rate`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.get_sample_rate "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.get_sample_rate") | Read back the current sample rate (samples per second). |
| [`get_trigger_status`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.get_trigger_status "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.get_trigger_status") | Read back the trigger status (ARMED / READY / TRIGGERED / …). |
| [`get_vertical_offset`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.get_vertical_offset "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.get_vertical_offset") | Read back `channel`'s vertical offset (volts). |
| [`get_vertical_scale`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.get_vertical_scale "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.get_vertical_scale") | Read back `channel`'s vertical scale (V/div). |
| [`load_settings`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.load_settings "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.load_settings") | Recall a scope setup from `name`. |
| [`measure`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.measure "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.measure") | Read a built-in measurement from a persistent slot; the vendor's invalid sentinel maps to `NaN`. |
| [`open`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.open "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.open") | Open the underlying transport. |
| [`run`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.run "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.run") | Start continuous (free-running) acquisition. |
| [`save_screenshot`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.save_screenshot "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.save_screenshot") | Capture a screenshot. |
| [`save_settings`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.save_settings "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.save_settings") | Save the current scope setup. |
| [`set_acquisition_mode`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.set_acquisition_mode "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.set_acquisition_mode") | Set the acquisition mode. |
| [`set_average_count`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.set_average_count "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.set_average_count") | Set the number of waveforms to average. |
| [`set_coupling`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.set_coupling "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.set_coupling") | Set AC/DC input coupling on `channel`. |
| [`set_horizontal_scale`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.set_horizontal_scale "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.set_horizontal_scale") | Set the timebase to `seconds_per_div`. |
| [`set_probe_attenuation`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.set_probe_attenuation "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.set_probe_attenuation") | Set `channel`'s probe attenuation ratio (e.g. 1, 10, 100, 1000). |
| [`set_trigger_level`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.set_trigger_level "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.set_trigger_level") | Set the trigger threshold to `level` (volts). |
| [`set_trigger_mode`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.set_trigger_mode "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.set_trigger_mode") | Set the trigger sweep mode (AUTO / NORMAL). |
| [`set_trigger_slope`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.set_trigger_slope "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.set_trigger_slope") | Set the trigger edge slope (RISING / FALLING / EITHER). |
| [`set_trigger_source`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.set_trigger_source "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.set_trigger_source") | Set the trigger source to analog `channel`. |
| [`set_trigger_type`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.set_trigger_type "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.set_trigger_type") | Set the trigger type (EDGE, PULSE, …). |
| [`set_vertical_offset`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.set_vertical_offset "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.set_vertical_offset") | Set `channel`'s vertical offset to `offset` (volts). |
| [`set_vertical_scale`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.set_vertical_scale "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.set_vertical_scale") | Set `channel`'s vertical scale to `volts_per_div` (V/div). |
| [`setup_measurement`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.setup_measurement "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.setup_measurement") | Ensure a persistent measurement slot exists for this type and channel. |
| [`single`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.single "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.single") | Arm a single-shot acquisition. |
| [`stop`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.stop "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.stop") | Stop acquisition. |

### open() → None[source]

Open the underlying transport. Idempotent.

Concrete drivers also perform any one-shot instrument setup here
(e.g. `*CLS`, remote-mode handshake).

### close() → None[source]

Close the underlying transport. Idempotent.

### check_errors() → None[source]

Drain `ALLEv?` and raise on any event with code > 1.

### set_vertical_scale( volts_per_div: float, channel: int, ) → None[source]

Set `channel`’s vertical scale to `volts_per_div` (V/div).

Drivers may snap to the nearest hardware-supported step. Callers that
need the actual applied value should `get_vertical_scale()` afterward.

### get_vertical_scale(channel: int) → float[source]

Read back `channel`’s vertical scale (V/div).

### set_vertical_offset( offset: float, channel: int, ) → None[source]

Set `channel`’s vertical offset to `offset` (volts).

### get_vertical_offset(channel: int) → float[source]

Read back `channel`’s vertical offset (volts).

### set_coupling( coupling: Coupling, channel: int, ) → None[source]

Set AC/DC input coupling on `channel`.

### get_coupling( channel: int, ) → Coupling[source]

Read back input coupling on `channel`.

### set_probe_attenuation( factor: float, channel: int, ) → None[source]

Set `channel`’s probe attenuation ratio (e.g. 1, 10, 100, 1000).

### get_probe_attenuation(channel: int) → float[source]

Read back `channel`’s probe attenuation ratio.

### set_horizontal_scale(seconds_per_div: float) → None[source]

Set the timebase to `seconds_per_div`. Applies globally to all channels.

### get_horizontal_scale() → float[source]

Read back the timebase (seconds/div).

### get_sample_rate() → float[source]

Read back the current sample rate (samples per second).

This is the effective hardware rate the scope is acquiring at; it
depends on the timebase, memory depth, and interpolation settings.

### set_acquisition_mode( mode: AcquisitionMode, ) → None[source]

Set the acquisition mode.

Drivers should raise `NotImplementedError` for `AcquisitionMode`
values their scope doesn’t support (e.g. Keysight 1200X has no
ENVELOPE mode).

### get_acquisition_mode() → AcquisitionMode[source]

Read back the current acquisition mode.

### set_average_count(count: int) → None[source]

Set the number of waveforms to average. Only takes effect in `AcquisitionMode.AVERAGE`.

### get_average_count() → int[source]

Read back the waveforms-to-average count.

### run() → None[source]

Start continuous (free-running) acquisition.

### stop() → None[source]

Stop acquisition. Leaves the captured data intact for `fetch_waveform` / `measure`.

### single() → None[source]

Arm a single-shot acquisition.

Non-blocking — use `get_acquisition_state` to poll for STOPPED, or
prefer `digitize()` which combines arming and waiting.

### digitize(timeout: float) → None[source]

``` SEQuence``+``RUN ```, then `*OPC?` under a scoped VISA timeout. `clear()` on timeout to restore the session.

### get_acquisition_state() → AcquisitionState[source]

Read back the acquisition run state (RUNNING / STOPPED).

### fetch_waveform( channel: int, ) → WaveformData[source]

Fetch the waveform from `channel` over `RIBinary` (signed 16-bit).

### setup_measurement( measurement_type: ScopeMeasurementType, channel: int, ) → None[source]

Ensure a persistent measurement slot exists for this type and channel.

Uses `MEASUrement:ADDMEAS <type>` to create the slot atomically with
the target type — this avoids the race where `ADDNew "MEAS<n>"` +
`MEAS<n>:TYPe` creates a slot that briefly computes under the scope’s
default type (typically Period) before the type change takes effect,
causing the first `measure()` call to return a stale, wrong-type
value. `ADDMEAS` doesn’t take a name; the new slot’s name (the scope
auto-assigns the next `MEAS<n>`) is recovered by diffing
`MEASUrement:LIST?` before and after the add.

Tektronix computes measurements during acquisition, so the slot
must exist before the scope triggers for results to be valid.

### clear_measurements() → None[source]

Delete every measurement slot on the scope and reset the local cache.

### measure( measurement_type: ScopeMeasurementType, channel: int, ) → float[source]

Read a built-in measurement from a persistent slot; the vendor’s invalid sentinel maps to `NaN`.

### set_trigger_source(channel: int) → None[source]

Set the trigger source to analog `channel`.

Drivers typically cache this value because the trigger-level SCPI on
some scopes requires the source channel in the same command.

### set_trigger_type( trigger_type: TriggerType, ) → None[source]

Set the trigger type (EDGE, PULSE, …).

### set_trigger_level(level: float) → None[source]

Set the trigger threshold to `level` (volts). Applies to the configured trigger source.

### set_trigger_slope( slope: TriggerSlope, ) → None[source]

Set the trigger edge slope (RISING / FALLING / EITHER).

### set_trigger_mode( mode: TriggerMode, ) → None[source]

Set the trigger sweep mode (AUTO / NORMAL).

AUTO forces an acquisition if no trigger fires within the timeout;
NORMAL waits indefinitely for a real trigger.

### force_trigger() → None[source]

Force a trigger event immediately, regardless of the configured conditions.

### get_trigger_status() → TriggerStatus[source]

Read back the trigger status (ARMED / READY / TRIGGERED / …).

### save_screenshot( filepath: str, to_instrument: bool = False, ) → bytes[source]

Capture a screenshot.

Parameters:
:   - **filepath**

      Output path. When `to_instrument=False` this is a host
      path; when `True` it is a path on the scope’s filesystem
      (USB stick, internal storage).
    - **to_instrument**

      When `True`, the scope writes the file itself and
      this returns `b""`. When `False`, the image is transferred
      to the host, written to `filepath`, and the raw bytes are
      returned for in-memory use.

### save_settings( name: str, to_instrument: bool = False, ) → bytes[source]

Save the current scope setup. Path semantics mirror [`save_screenshot()`](https://dev.nominal.io/instro/ref/instruments/instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.md#instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.save_screenshot "instro.scope.drivers.tektronix_2series.Tektronix2SeriesMSO.save_screenshot").

### load_settings( name: str, from_instrument: bool = False, ) → None[source]

Recall a scope setup from `name`.

With `from_instrument=True` the scope reads from its own filesystem;
otherwise the host reads `name` and pushes the bytes to the scope.
After loading, the calling `InstroScope` should invalidate its
tracked `ScopeState` and resync if a fresh view is needed.