Helium production registration/control program

cryogeen(1) cryogeen(1)

NAME
cryogeen - helium production registration/control program.

SYNOPSIS
cryogeen [-h] [-c | -s] [-mpx] [-mix]

DESCRIPTION
General
cryogeen is a program to registrate and control the
machinery of the cryogenic department located in the
Kamerlingh Onnes Laboratory. It supports both local opera-
tion (server mode) and remote operation (client mode) via
the telephone network with a modem.

The setup at the cryogenic department consists of a pro-
grammable logic controller (PLC), two helium depth indica-
tors (HDI), a digital weight indicator (DWI) and a Rulbus
rack. These devices are all connected to a personal com-
puter (PC) that runs the cryogeen program described here.
The PC is connected to the telephone network with a modem
to enable remote operation. Connected to the Rulbus rack
are two helium flow meters, a helium valve, the pres-
suremeters of the Koch liquefactors and the Koch tempera-
ture monitors.

With cryogeen you can make various graphs of Helium pro-
duction, gas flow, Koch liquefactor pressures and tempera-
tures, compressor usage and get an overview of the signal
panel of the switch board, control the four buttons of the
switch board and look at a history of events and actions
of the switch board (PLC).

The four buttons you can control are:

- Compressor clean on / off,

- Compressor dirty on / off,

- Koch liquefier clean He-gas / dirty He-gas,

- Mix valve on / off.

In the locally operated program you can control various
time settings and calibrate the gas flow and compressor
measurements; in the remotely operated program you can
control the screensave time and switch board signal update
interval.

Finally in the locally operated program, you can control
filling of a dewar from the 1000 l or 5000 l barrel using
a valve or a Helium pump, either controlled by the Helium
level in the barrel or by the weight of the dewar being

29 Jan 1996 Algemene Dienst 1

cryogeen(1) cryogeen(1)

filled.

Commandline Options
cryogeen can be executed with the following commandline
options.

Specifying -h gives an overview of the usage of the pro-
gram.

With option -c cryogeen behaves as the client or home pro-
gram, while with option -s cryogeen acts as the server or
local cryogenic department program. Only one of the
options -c and -s may be specified at one time.

The COM-port to use for the modem can be specified with
option -mpx where x denotes the number of the port.

The interrupt-number to use for the modem can be specified
with option -mix where x denotes the number of the inter-
rupt. If no interrupt is to be used, specify a zero
value.

Once a certain setting has been specified, it is saved in
the params.dat file, and it is not necessary to specify
this setting the next time the program is run.

Parameter File
The params.dat file contains the settings of the program
as last used. It is in binary format, directly related to
the internal structure of the ParamRecord record.

History File
cryogeen keeps a record of events and actions of the
switch board in the file history.dat. There is also an
ASCII version of this file with the name history.txt. An
example of the content of the ASCII file is shown below.

02-02-1995 11:05:00 AAN : Ballon schoon helium op 100%
02-02-1995 11:05:00 UIT : Werkschakelaar kompr. vuil helium
02-02-1995 11:05:00 AAN : Zuig KOCH pakket 3

Helium Counter File
cryogeen keeps a record of two Helium flows, nine gasmeter
readings and two compressor-on times in the ASCII file
counters.txt. The format of this file is shown below
(only last three lines are part of the file).

29 Jan 1996 Algemene Dienst 2

cryogeen(1) cryogeen(1)

|----------|-------------|--------------------------------------------------------------|--------------|
10 11 1994 0 0 393439 475446 250588 119128 50888 571167 160217 999800 999823 1542 1888
11 11 1994 2573 0 393861 476674 250767 119221 51054 571403 160217 999800 999823 1587 2081
12 11 1994 4522 0 394257 477053 250767 119231 51336 571600 160217 999800 999823 1635 2151

Flow- and gasmeters have a calibration factor of 0.1
m3/count.

Helium Level File
cryogeen keeps a record of the Helium level in the 1000 l
and 5000 l barrels and a flow, six pressures and two tem-
peratures of the two Koch liquefiers. For each day a sepa-
rate file is produced with a name of the format yyyym-
mdd.txt, e.g.: 19940916.txt. The format of this file is
shown below (only last line is part of the file).

|Time |Level |Koch 1 |Koch 2
| | |Flow Pressure Temp| like Koch 1
| |[mm] |[l] [psi] [psi] [psi] [psi] [bar] [psi] [K] |
|mm ss| 1k 5k| PI32 PI33 PI34 PI39 PI60 PI35 1 2|
|-----|-------|------------------------------------------------------|
16 58 209 471 80 1.747 1.457 1.718 1.992 1.512 1.708 2 4

Helium Volume File
The helium volume files hevolum1.txt and hevolum2.txt con-
tain the level to volume calibration data for the 1000 l
and 5000 l barrel respectively. Both files are identical
ASCII files. An example is shown below.

1000 l barrel:

|Level |Volume |
|mm |l |
|------|-------|
0 0
25 2.36
...
1075 1106.30
1082 1106.50

5000 l barrel:

|Level |Volume |
|mm |l |
|------|-------|
0 0
50 20
...
400 900
1500 4700

29 Jan 1996 Algemene Dienst 3

cryogeen(1) cryogeen(1)

Compiling
To compile the cryogeen program, first go to the src sub-
directory in the project rootdirectory.

To make the client or home program, load the client.bp
configuration file in the Borland Pascal Integrated Devel-
opment Environment with Options|Open. In this configura-
tion the CLIENT conditional definition has been specified
with Options|Compiler|Conditional definitions. Then do a
Compile|Build to create the executable.

To make the server program, load the server.bp configura-
tion file. In this file the SERVER conditional definition
has been specified. Then do a Compile|Build to create the
executable.

Testing
For testing purposes the following conditional definitions
may be defined:

1) PLCTest : The PLC interface is simulated.

2) HardTest : The Rulbus Hardware is simulated.

and the following booleans in 'Cryodef' can be set:

3) RS232Test : Serial ports are used instead of Modems.

4) Test : General test condition (Communication testmessages).

DIAGNOSTICS
cryogeen gives an exit status of 1 when an error is found
on the commandline, one of the directories is not there
and it is not created when prompted or the hevolum[12].txt
files cannot be found. Otherwise it returns a 0 exit sta-
tus.

FILES
rootDir ::= exeDir\.. rootDir is derived from the
directory in which the program
is located.

rootDir\bin\cryogeen.exe the program,

rootDir\bgi\* Borland Graphics Interface
files,

29 Jan 1996 Algemene Dienst 4

cryogeen(1) cryogeen(1)

rootDir\data\params.dat program's parameter settings,

rootDir\data\history.dat history of events and actions
from PLC (binary),

rootDir\data\history.txt history of events and actions
from PLC (text),

rootDir\data\counters.txt Helium flow meters counter
file,

rootDir\data\hevolum1.txt Helium level to volume cali-
bration (1000 l),

rootDir\data\hevolum2.txt Helium level to volume cali-
bration (5000 l),

rootDir\level\yyyymmdd.txt daily Helium level files
(e.g.: 19940916.txt).

EXAMPLE
cryogeen -s -mp4 -mi0

AUTHOR
M.J. Moene

29 Jan 1996 Algemene Dienst 5