NAME

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

VERSION

version 3.611

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.