/ 
Lab-Measurement-3.800
River stage zero No dependents
/ Lab::Instrument::Keithley2000

NAME

Lab::Instrument::Keithley2000 - Keithley 2000 digital multimeter

VERSION

version 3.800

SYNOPSIS

use Lab::Instrument::Keithley2000;
my $DMM=new Lab::Instrument::Keithley2000(0,22);
print $DMM->get_value('VOLTAGE:DC');

DESCRIPTION

The Lab::Instrument::Keithley2000 class implements an interface to the Keithley 2000 digital multimeter.

CONSTRUCTOR

my $DMM=new(\%options);

METHODS

get_value

$value=$DMM->get_value($function);

Make a measurement defined by $function with the previously specified range and integration time.

$function
 FUNCTION  can be one of the measurement methods of the Keithley2000.

	"current:dc" --> DC current measurement 
	"current:ac" --> AC current measurement 
	"voltage:dc" --> DC voltage measurement 
	"voltage:ac" --> AC voltage measurement 
	"resisitance" --> resistance measurement (2-wire)
	"fresistance" --> resistance measurement (4-wire)

get_T

$value=$DMM->get_value($sensor, $function, $range);

Make a measurement defined by $function with the previously specified range and integration time.

$sensor
SENSOR  can be one of the Temperature-Diodes defined in Lab::Instrument::TemperatureDiodes.
$function
 FUNCTION  can be one of the measurement methods of the Keithley2000.

	"diode" --> read out temperatuer diode
	"resisitance" --> resistance measurement (2-wire)
	"fresistance" --> resistance measurement (4-wire)
$range
RANGE  is given in terms of amps or ohms and can be   1e-5 | 1e-4 | 1e-3 | MIN | MAX | DEF   or   0...101e6 | MIN | MAX | DEF | AUTO  .
DEF  is default  AUTO  activates the AUTORANGE-mode.
DEF  will be set, if no value is given.

config_measurement

$K2000->config_measurement($function, $number_of_points, $time, $range);

Preset the Keithley2000 for a TRIGGERED measurement.

WARNING: It's not recomended to perform triggered measurments with the KEITHLEY 2000 DMM due to unsolved timing problems!!!!!

$function
 FUNCTION  can be one of the measurement methods of the Keithley2000.

	"current:dc" --> DC current measurement 
	"current:ac" --> AC current measurement 
	"voltage:dc" --> DC voltage measurement 
	"voltage:ac" --> AC voltage measurement 
	"resisitance" --> resistance measurement (2-wire)
	"fresistance" --> resistance measurement (4-wire)
$number_of_points

Preset the NUMBER OF POINTS to be taken for one measurement TRACE . The single measured points will be stored in the internal memory of the Keithley2000. For the Keithley2000 the internal memory is limited to 1024 values.

$time

Preset the TIME duration for one full trace. From TIME the integration time value for each measurement point will be derived [NPLC = (TIME *50Hz)/NOP]. Expected values are between 0.21 ... 20000 seconds.

$range
RANGE  is given in terms of amps, volts or ohms and can be   0...+3,03A | MIN | MAX | DEF | AUTO  ,   0...757V(AC)/1010V(DC) | MIN | MAX | DEF | AUTO   or   0...101e6 | MIN | MAX | DEF | AUTO  .	
DEF  is default  AUTO  activates the AUTORANGE-mode.
DEF  will be set, if no value is given.

trg

$K2000->trg();

Sends a trigger signal via the GPIB-BUS to start the predefined measurement. The LabVisa-script can immediatally be continued, e.g. to start another triggered measurement using a second Keithley2000.

abort

$K2000->abort();

Aborts current (triggered) measurement.

active

$K2400->abort();

Returns '1' if the current triggered measurement is still active and '0' if the current triggered measurement has allready been finished.

wait

$K2400->abort();

WAIT until triggered measurement has been finished.

get_data

@data = $K2000->get_data();

Reads all recorded values from the internal buffer and returnes them as an array of floatingpoint values. Reading the buffer will start immediately after the triggered measurement has finished. The LabVisa-script cannot be continued until all requested readings have been recieved.

set_function

$K2000->set_function($function);

Set a new value for the measurement function of the Keithley2000.

$function
 FUNCTION  can be one of the measurement methods of the Keithley2000.

	"current:dc" --> DC current measurement 
	"current:ac" --> AC current measurement 
	"voltage:dc" --> DC voltage measurement 
	"voltage:ac" --> AC voltage measurement 
	"resisitance" --> resistance measurement (2-wire)
	"fresistance" --> resistance measurement (4-wire)

set_range

$K2000->set_range($function,$range);

Set a new value for the predefined RANGE for the measurement function $function of the Keithley2000.

$function
 FUNCTION  can be one of the measurement methods of the Keithley2000.

	"current:dc" --> DC current measurement 
	"current:ac" --> AC current measurement 
	"voltage:dc" --> DC voltage measurement 
	"voltage:ac" --> AC voltage measurement 
	"resisitance" --> resistance measurement (2-wire)
	"fresistance" --> resistance measurement (4-wire)
$range
RANGE  is given in terms of amps, volts or ohms and can be   0...+3,03A | MIN | MAX | DEF | AUTO  ,   0...757V(AC)/1010V(DC) | MIN | MAX | DEF | AUTO   or   0...101e6 | MIN | MAX | DEF | AUTO  .	
DEF  is default  AUTO  activates the AUTORANGE-mode.
DEF  will be set, if no value is given.

set_nplc

$K2000->set_nplc($function,$nplc);

Set a new value for the predefined NUMBER of POWER LINE CYCLES for the measurement function $function of the Keithley2000.

$function
 FUNCTION  can be one of the measurement methods of the Keithley2000.

	"current:dc" --> DC current measurement 
	"current:ac" --> AC current measurement 
	"voltage:dc" --> DC voltage measurement 
	"voltage:ac" --> AC voltage measurement 
	"resisitance" --> resistance measurement (2-wire)
	"fresistance" --> resistance measurement (4-wire)
$nplc

Preset the NUMBER of POWER LINE CYCLES which is actually something similar to an integration time for recording a single measurement value. The values for $nplc can be any value between 0.01 ... 10.

Example: Assuming $nplc to be 10 and assuming a netfrequency of 50Hz this results in an integration time of 10*50Hz = 0.2 seconds for each measured value. Assuming $number_of_points to be 100 it takes in total 20 seconds to record all values for the trace.

set_averaging

$K2000->set_averaging($count, $filter);

Set a new value for the predefined NUMBER of POWER LINE CYCLES for the measurement function $function of the Keithley2000.

$count
COUNT  is the number of readings to be taken to fill the  AVERAGING FILTER .  COUNT  can be 1 ... 100.
$filter
FILTER  can be  MOVING  or  REPEAT . A detailed description is refered to the user manual.

display_on

$K2000->display_on();

Turn the front-panel display on.

display_off

$K2000->display_off();

Turn the front-panel display off.

display_text

$K2000->display_text($text);
print $K2000->display_text();

Display a message on the front panel. The multimeter will display up to 12 characters in a message; any additional characters are truncated. Without parameter the displayed message is returned.

display_clear

$K2000->display_clear();

Clear the message displayed on the front panel.

reset

$K2000->reset();

Reset the multimeter to its power-on configuration.

CAVEATS/BUGS

probably many

SEE ALSO

Lab::Instrument

COPYRIGHT AND LICENSE

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

Copyright 2013-2014  Christian Butschkow
          2016       Simon Reinhardt
          2017       Andreas K. Huettel
          2020       Andreas K. Huettel

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