Lab::Instrument::HP34401A - HP/Agilent 34401A digital multimeter (deprecated)
version 3.899
use Lab::Instrument::HP34401A; my $Agi = new Lab::Instrument::HP34401A({ connection => new Lab::Connection::GPIB( gpib_board => 0, gpib_address => 14, ), }
This module belongs to a deprecated legacy module stack, frozen and not under development anymore. Please port your code to the new API; its documentation can be found on the Lab::Measurement homepage, https://www.labmeasurement.de/.
The Lab::Instrument::HP34401A class implements an interface to the 34401A digital multimeter by Agilent (formerly HP). This module can also be used to address the newer 34410A and 34411A multimeters, but doesn't include new functions. Use the Lab::Instrument::HP34411A class for full functionality (not ported yet).
my $Agi=new(\%options);
$hp->fetch();
Fetches the instrument buffer. Returns an array of values.
$hp->autozero($setting);
$setting can be 1/'ON', 0/'OFF' or 'ONCE'.
When set to "ON", the device takes a zero reading after every measurement. "ONCE" perform one zero reading and disables the automatic zero reading. "OFF" does... you get it.
$hp->configure_voltage_dc($range, $integration_time, $resolution);
Configures all the details of the device's DC voltage measurement function.
$range is a positive numeric value (the largest expected value to be measured) or one of 'MIN', 'MAX', 'AUTO'. It specifies the largest value to be measured. You can set any value, but the HP/Agilent 34401A effectively uses one of the values 0.1, 1, 10, 100 and 1000V.
$integration_time is the integration time in seconds or MIN MAX DEF. This implicitly sets the provided resolution.
$resolution sets the resolution of the measurment. If set, $integration_time is overwritten.
$hp->configure_voltage_dc_trigger($range, $integration_time, $count, $delay, $resolution)
Configures the device for successive triggered reading events. Does not initiate the trigger facility. Reading can then be performed calling triggered_read(). The first three parameters are just passed to configure_voltage_dc.
$count is an integer for the number of successive readings that follow one single trigger event.
$delay is the delay in seconds between these readings.
@data = $hp->triggered_read();
Sends a trigger pulse and fetches the values from the instrument buffer once the reading is finished.
Sends a read trigger to the device. It does not initialize the trigger facility.
Initializes the trigger facility. The device is then in the state "waiting for trigger".
$data = hp->get_value();
Inherited from Lab::Instrument::Multimeter. Performs a single reading in the current configuration.
$datum=$Agi->get_voltage_dc($range,$resolution);
Preset and make a dc voltage measurement with the specified range and resolution.
$datum=$Agi->get_voltage_ac($range,$resolution);
Preset and make a ac voltage measurement with the specified range and resolution.
$datum = $hp->get_current_dc($range,$resolution);
Preset and make a dc current measurement with the specified range and resolution.
$datum = $hp->get_current_ac($range,$resolution);
Preset and make a ac current measurement with the specified range and resolution.
$resistance=$Agi->get_resistance($range,$resolution);
Preset and measure resistance with specified range and resolution.
$resistance=$Agi->get_4wresistance($range,$resolution);
Preset and measure the four way resistance with specified range and resolution.
Returns a status string from the device.
Returns the error string from the device.
$hp->pl_freq($new_freq); $npl_freq = $hp->pl_freq();
Get/set the power line frequency at your location (50 Hz for most countries, which is the default). This is the basis of the integration time setting (which is internally specified as a count of power line cycles, or PLCs). The integration time will be set incorrectly if this parameter is set incorrectly.
$Agi->display_text($text); print $Agi->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. Inherited from Lab::Instrument::Multimeter
$Agi->set_display_state($state);
Turn the front-panel display on ($state = "ON") or off ($state = "OFF").
Range is given in terms of volts and can be [0.1|1|10|100|1000|MIN|MAX|DEF]. DEF is default.
[0.1|1|10|100|1000|MIN|MAX|DEF]
DEF
Resolution is given in terms of $range or [MIN|MAX|DEF]. $resolution=0.0001 means 4 1/2 digits for example. The best resolution is 100nV: $range=0.1; $resolution=0.000001.
$range
[MIN|MAX|DEF]
$resolution=0.0001
$range=0.1
$resolution=0.000001
Preset and make an ac voltage measurement with the specified range and resolution. For ac measurements, resolution is actually fixed at 6 1/2 digits. The resolution parameter only affects the front-panel display.
$datum=$Agi->get_current_dc($range,$resolution);
$datum=$Agi->get_current_ac($range,$resolution);
Preset and make an ac current measurement with the specified range and resolution. For ac measurements, resolution is actually fixed at 6 1/2 digits. The resolution parameter only affects the front-panel display.
$device->trigger_mode($intt, $range, $count, $delay, $resolution)
Configure the multimeter for a triggered reading.
The integration time in seconds. You can also set "MIN" or "MAX". This value is overwritten if the resolution is specified.
The range for the measurment.
The number of measurements which are performed after one single trigger impulse.
The delay between the $count measurements (the integration time is not included).
$count
The resolution for the measurement. If given, this overwrites the $intt parameter.
$intt
$data = $device->trigger_read()
Sends a trigger signal and fetches the value(s) from the multimeter.
$device->trigger()
Sends a trigger signal to the device.
$data = $device->fetch()
Fetches the data which is currently in the output buffer of the device.
$Agi->scroll_message($message);
Scrolls the message $message on the display of the HP.
$message
$Agi->beep();
Issue a single beep immediately.
($err_num,$err_msg)=$Agi->get_error();
Query the multimeter's error queue. Up to 20 errors can be stored in the queue. Errors are retrieved in first-in-first out (FIFO) order.
$Agi->reset();
Reset the multimeter to its power-on configuration.
probably many
Lab::Instrument
Lab::Instrument::Multimeter
Lab::Instrument::HP3458A
This software is copyright (c) 2023 by the Lab::Measurement team; in detail:
Copyright 2005-2006 Daniel Schroeer 2009 Andreas K. Huettel, Daniela Taubert 2010 Andreas K. Huettel, Daniel Schroeer 2011 Andreas K. Huettel, Florian Olbrich 2012 Alois Dirnaichner, Florian Olbrich 2013 Alois Dirnaichner, Andreas K. Huettel 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.
To install Lab::Measurement::Legacy, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Lab::Measurement::Legacy
CPAN shell
perl -MCPAN -e shell install Lab::Measurement::Legacy
For more information on module installation, please visit the detailed CPAN module installation guide.