Scope

From SweepMe! Wiki
Jump to navigation Jump to search

The Module 'Scope' is designed for implementing oscilloscopes by creating Device Classes.

Device Class development

Supported parameters

An oscilloscope has many parameters that are needed before a certain configuration is reproduced. Sometimes it is easier to change parameters directly at the device. To not overwrite certain parameters when starting a measurment, we recommend to add "As is" to each ComboBox. In that case, the Device Class should not send any command to the oscilloscope.

TriggerSource

A ComboBox to provide possible trigger sources such as the channels of the oscilloscope or an external trigger in port

TriggerCoupling

A ComboBox to provide the trigger coupling that defines which mode is used to get triggered, e.g. it can be 'AC', 'DC', or high frequency ('HF').

TriggerSlope

A ComboBox to provide the trigger slope, e.g. a rising flank, a falling flank or both

TriggerLevel

A LineEdit to provide the trigger level at which the signal is recognized and the time is zeroed.

TriggerHysteresis

A LineEdit to provide the trigger hysteresis (i.e. a voltage) around the trigger level within the trigger is not initiated again.

TriggerDelay

A LineEdit to provide the trigger delay time in seconds.

TriggerTimeout

A LineEdit to provide the trigger timeout in seconds. If the oscilloscope is triggered externally, the timeout must be larger than the time it needs to send the trigger. In case an oscilloscope receives no trigger, the Device Class should stop the instrument from waiting for a trigger and stop the measurement.

Acquisition

A ComboBox to provide how acquisition is done. Typically, the acquisition is done 'Continuous'. However, if the data related to a single trigger event needs to be measured, one should provide a mode like 'Single'.

Average

A ComboBox to provide typical values that can be used for averaging, e.g. 1, 2, 4, 8 ...

SamplingRate

A Line Edit to provide the numbers of sample per second.

TimeRange

A ComboBox to provide different modes that can be used to define the time span that is used for collecting the data.

TimeRangeValue

A LineEdit to get the number that is specifying the time range. For example, if TimeRange is 'Time range [s]' one can insert the time span of the captured signal. If the TimeRange is 'Time scale [s/div]' one has to insert the time span of a single division.

TimeOffsetValue

A LineEdit to get the offset time in seconds to shift x-axis horizontally.

VoltageRange

A ComboBox to select in which way the value of Channel<i>_Range is given, e.g. "Voltage range in V" or "Voltage range V/div".

Channel<i>

A CheckBox for each channel <i> that tells you whether the channel should be used or not.

Channel<i>_Name

The name that the user gave to channel <i>. Please use it do define self.variables accordingly.

Channel<i>_Range

The voltage range of channel <i>.

Channel<i>_Offset

The voltage offset of channel <i>.

Channel<i>_Impedance

The impedance value of channel <i>.

Channel<i>_ACDC

The coupling of channel <i>. Please use Channel<i>_Coupling for version >= 1.5.4.x

Channel<i>_Coupling

The coupling of channel <i>, e.g. 'AC' or 'DC'

Channel<i>_Probe

The probe of channel <i>. If not automatically detected one might have to provide options like '1:1' or '10:1'