/ 
Lab-Measurement-3.760
⭐ Starred 10 / Lab::Moose::Instrument::KeysightDSOS604A

NAME

Lab::Moose::Instrument::KeysightDSOS604A - Keysight DSOS604A infiniium S-Series Oscilloscope.

VERSION

version 3.760

SYNOPSIS

use Lab::Moose;

... (some brief example how it is used)

METHODS

Used roles:

Lab::Moose::Instrument::Common

save_measurement

$keysight->save_measurement(value => 'C:\Users\Administrator\Documents\Results\my_measurement');

Save all current measurements on screen to the specified path.

measure_vpp

$keysight->measure_vpp(source => 'CHANnel1');

Query the Vpp voltage of a specified source.

save_waveform

$keysight->save_waveform(source => 'CHANnel1', filename => 'C:\Users\Administrator\Documents\Results\data2306_c1_5',format => 'CSV');

Save the waveform currently displayed on screen. source can be a channel, function, histogram, etc, filename specifies the path the waveform is saved to and format can be BIN CSV INTernal TSV TXT H5 H5INt MATlab.

The following file name extensions are used for the different formats: =item BIN = file_name.bin =item CSV (comma separated values) = file_name.csv =item INTernal = file_name.wfm =item TSV (tab separated values) = file_name.tsv =item TXT = file_name.txt =item H5 (HDF5) = file_name.h5 In the H5 format, data is saved as floats. In this case, the data values are actual vertical values and do not need to be multiplied by the Y increment value. =item H5INt (HDF5) = file_name.h5 In the H5INt format, data is saved as integers. In this case, data values are quantization values and need to be multiplied by the Y increment value and added to the Y origin value to get the actual vertical values. =item MATlab (MATLAB data format) = file_name.mat

save_measurements

$keysight->save_measurements(filename => 'C:\Users\Administrator\Documents\Results\my_measurements');

WIP

force_trigger

$keysight->force_trigger();

Force a trigger event by command.

trigger_level

$keysight->trigger_level(channel => 'CHANnel1', level => 0.1);

Adjust the trigger source and level.

acquire_mode

$keysight->acquire_mode(value => 'HRESolution');

Allowed values: ETIMe, RTIMe, PDETect, HRESolution, SEGMented, SEGPdetect, SEGHres

acquire_hres

$keysight->acquire_hres(value => 'BITF16');

Specify the resolution for the High Resolution acquisition mode.

acquire_points

$keysight->acquire_points(value => 40000);

Specify the amount of data points collected within an acquisition window. 40000 seems to be the minimum. Using this command adjusts the sample rate automatically.

timebase_range

$keysight->timebase_range(value => 0.00022);

Manually adjust the Oscilloscopes time scale on the x axis.

timebase_reference

$keysight->timebase_reference(value => 'LEFT');

Specify where the time origin is on the display. By default it is centered. Allowed values: LEFT CENTer RIGHt

timebase_ref_perc

$keysight->timebase_ref_perc(value => 15);

Shift the time origin by 0% to 100% in the opposite direction than timebase_reference, 100% would shift the origin from left to right or the other way around.

timebase_clock

$keysight->timebase_clock(value => 'OFF')

Enable or disable the Oscilloscopes 10 MHz REF IN BNC input (ON or OFF) or the 100MHz REF IN SMA input (HFRequency or OFF). When either option is enabled, the the external reference input is used as a reference clock for the Oscilloscopes horizonal scale instead of the internal reference clock.

waveform_format

$keysight->waveform_format(value => 'WORD');

This command controls how the data is formatted when it is sent from the oscilloscope, and pertains to all waveforms. The default format is ASCii.

waveform_source

$keysight->waveform_source(value => 'CHANnel1');

Select a source to the acquired waveform. Allowed values: CHANnel1, CHANnel2, CHANnel3, CHANnel4, CLOCk

channel_input

$keysight->channel_input(channel => 'CHANnel1', parameter => 'DC50');

parameter can be either =item DC — DC coupling, 1 MΩ impedance. =item DC50 | DCFifty — DC coupling, 50Ω impedance. =item AC — AC coupling, 1 MΩ impedance. =item LFR1 | LFR2 — AC 1 MΩ input impedance. When no probe is attached, the coupling for each channel can be AC, DC, DC50, or DCFifty. If you have an 1153A probe attached, the valid parameters are DC, LFR1, and LFR2 (low-frequency reject).

channel_differential

$keysight->channel_differential(channel => 'CHANnel1', mode => 'ON');

Turns on or off differential mode. 'mode' can be ON OFF 1 0.

channel_range/channel_offset

$keysight->channel_range(channel => 'CHANnel1', range => 1);
$keysight->channel_offset(channel => 'CHANnel1', offset => 0.2);

Allows for manual adjustment of the Oscilloscopes vertical voltage range and -offset for a specific channel. Requires differential mode to be turned on.

COPYRIGHT AND LICENSE

This software is copyright (c) 2021 by the Lab::Measurement team; in detail:

Copyright 2021       Andreas K. Hüttel, Fabian Weinelt

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.