/ 
Lab-Measurement-3.610
River stage zero No dependents
/ Lab::Instrument::OI_Mercury::Level

NAME

Lab::Instrument::OI_Mercury::Level - Oxford Instruments Mercury Cryocontrol level meter

VERSION

version 3.610

SYNOPSIS

use Lab::Instrument::OI_Mercury::Level;

my $m=new Lab::Instrument::OI_Mercury::Level(
  connection_type=>'Socket', 
  remote_port=>7020, 
  remote_addr=>1.2.3.4,
);

DESCRIPTION

The Lab::Instrument::OI_Mercury::Level class implements an interface to the Oxford Instruments Mercury cryostat control level meter.

The Mercury uses a command language that looks a bit like SCPI but is actually incompatible with that specification.

METHODS

get_he_level

$he=$m->get_he_level('DB5.L1');

Read out the designated liquid helium level meter channel. Result is in percent as calibrated.

get_he_level_resistance

$he=$m->get_he_level_resistance('DB5.L1');

Read out the designated liquid helium level meter channel. Result is the raw sensor resistance.

get_n2_level

$he=$m->get_n2_level('DB5.L1');

Read out the designated liquid nitrogen level meter channel. Result is in percent as calibrated.

get_n2_level_frequency

$he=$m->get_n2_level_frequency('DB5.L1');

Read out the designated liquid nitrogen level meter channel. Result is the raw internal frequency value.

get_temperature

$t=$m->get_temperature('MB1.T1');

Read out the designated temperature channel. Result is in Kelvin.

get_catalogue

$mcat=$m->get_catalogue();
print "$mcat\n";

Returns the hardware configuration of the Mercury system. A typical response would be

STAT:SYS:CAT:DEV:GRPX:PSU:DEV:MB1.T1:TEMP:DEV:GRPY:PSU:DEV:GRPZ:PSU:DEV:PSU.M1:PSU:DEV:PSU.M2:PSU:DEV:GRPN:PSU:DEV:DB5.L1:LVL

Here, each group starting with "DEV:" describes one hardware component. In this case, we obtain for example:

DEV:GRPX:PSU     |
DEV:GRPY:PSU     |- a 3-axis magnet power supply unit
DEV:GRPZ:PSU     |
DEV:MB1.T1:TEMP  -- a temperature sensor
DEV:DB5.L1:LVL   -- a cryogen level sensor

In each of these blocks, the second component after "DEV:" is the UID of the device; it can be used in other commands such as get_level to address it.

CAVEATS/BUGS

probably many

SEE ALSO

Lab::Instrument

COPYRIGHT AND LICENSE

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

Copyright 2017       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.