From 9305bb0f3381bd7dc7eb4734cb29864ec32e4e95 Mon Sep 17 00:00:00 2001 From: cvs Date: Fri, 17 Oct 2003 13:22:08 +0000 Subject: [PATCH] Updated alias and samenv docs (M.Z.) --- doc/manager/alias.htm | 18 ++++++---- doc/user/samenv.htm | 78 +++++++++++++++++++------------------------ 2 files changed, 46 insertions(+), 50 deletions(-) diff --git a/doc/manager/alias.htm b/doc/manager/alias.htm index 19b6e41d..9b6d8b8f 100644 --- a/doc/manager/alias.htm +++ b/doc/manager/alias.htm @@ -20,22 +20,28 @@ access internal SICS interfaces like the drive command or others. Object aliases are installed into SICS with the SICSAlias command:
-
SicsAlias newname oldname +
SicsAlias oldname newname
This command installs newname as alias for the object oldname.
SicsAlias can only be used within initialization scripts. SicsAlias is - considrered deprecated and can be replaced with the superior runtime + considered deprecated and can be replaced with the superior runtime aliases described below.

Runtime Aliases

Runtime aliases are full object aliases which can be configured into the - system at run time by a SICS manager. The syntax looks like this: + system at run time by a SICS manager. +The syntax looks like this:

-
definealias SICSobject aliasname +
DefineAlias aliasname SICSobject
This defines aliasname to be the alias for the SICS object SICSobject. -
definealias aliasname -
This command deltes the alias aliasname. + It is not needed that SICSobject already exists. If SICSobject is already + an alias, it is translated before definition. + Multiple translation is possible, depending on the order of definition. + When an alias is used, and it does not point to an existing object, + the behaviour is the same as if an unknown object would have been used. +
DefineAlias aliasname +
This command deletes the alias aliasname.

Command Aliases

diff --git a/doc/user/samenv.htm b/doc/user/samenv.htm index 535583eb..69daa9f5 100644 --- a/doc/user/samenv.htm +++ b/doc/user/samenv.htm @@ -18,10 +18,10 @@ devices.
  • LakeShore Model 340 temperature controllers.
  • Oxford Instruments ITC-4 or ITC-503 temperature controllers. -
  • Dilution Cryostat. +
  • Old Dilution Cryostat (obsolete).
  • Haake waterbath thermostat. -
  • The CryoFurnace with its Neocera LTC-11 temperature -controller. +
  • The Neocera LTC-11 temperature +controller (obsolete, was used for the Cryofurnace).
  • Eurotherm Temperature Controller.
  • Bruker Magnet Controller.
  • The Risoe A1931 Temperature Controller. @@ -190,6 +190,15 @@ handling is set. Valid values are:
    SafeValue
    The value to drive the controller to when an error has been detected and Safe error handling is set. +
    MaxWait +
    Maximal time in minutes to wait in a drive temperature command. +If maxwait is set to 0: If the temperature is not reached within tolerance, +it waits indefinitely. +
    Settle +
    Wait time [minutes] after reaching temperature. Indicates how long to wait +after reaching temperature. If the temperatures goes again out +of tolerance during the settling time, the time outside tolerance +is not taken into account.

    @@ -263,41 +272,24 @@ that special device. All of the general commands listed above work as well! This is the temperature controller for cryogenic applications and should replace at least the Oxford & Neocera controllers at SINQ.

    The control is handled by a seperate server process TECS (TEmperature -Control Server) and is initialized by default. If there is already an other -device selected, it must be deleted and TECS must be reinstalled: +Control Server) and is initialized by default on most instruments. If there is already an other +device selected, it must be deleted with:

    -EVFactory del temperature
    -EVFactory new temperature tecs +EVFactory del temperature
    -The sample environment device is selected automatically by a coding in the -plug of the sensor/heater cable(s). If this does not work (plugs without -coding or temporarely use of a wrong cable) you may select the device -with +and TECS must be reinstalled with:
    -temperature device device +tecs on
    -You may want to verify the selected device with -
    -temperature device -
    -The actually known devices (April 2000) are: -
      -
    • orange cryostats: ill1 (50mm), ill2 (70mm), -ill3 (cryofurnace), ill4 (FOCUS), ill5 (100 mm) -
    • closed cycles: cti1, cti2, cti3, cti4, -cti5 (maxi), cti6 (FOCUS), apd (TriCS), ccr4k (4K) -
    • other: hef4c (He-flow cryostat 4circle), sup4t (4 T supraconducting magnet) -
    +(This is just an abbreavation for EVFactory new temperature tecs)

    +More details can be found on the Sample Environment Home Page

    ITC-4 and ITC-503 Temperature Controllers

    These temperature controller were fairly popular at SINQ. They are manufactured by Oxford Instruments. At the back of this controller is a RS-232 -socket which must be connected to a Macintosh computer running the SINQ -terminal server program via a serial cable. Please make sure with a different -Macintosh or a PC that the serial line is OK and the ITC-4 responding before -plugging it in. +socket which must be connected to a terminal server via a serial cable.

    ITC-4 Initialisation

    @@ -306,14 +298,12 @@ An ITC-4 can be configured into the system by: EVFactory new Temp ITC4 computer port channel This creates an ITC-4 controller object named Temp within the system. The -ITC-4 is expected to be connected to the serial port channel at the -Macintosh computer computer running the SINQ terminal server program -listening at port port. For example: +ITC-4 is expected to be connected to the serial port channel of the serial +port server porgramm at localhost listening at the specified port. For example:

    -EVFactory new Temp ITC4 lnsp22.psi.ch 4000 7 +EVFactory new Temp ITC4 localhost 4000 7
    -connects Temp to the Macintosh named lnsp22, serial port 6 -(7 above is no typo!), listening at port 4000. +connects Temp to the serial port 7, listening at port 4000.

    ITC-4 Additional Parameters

    @@ -322,7 +312,7 @@ The ITC-4 has a few more parameter commands:

    timeout
    Is the timeout for the Macintosh terminal server program waiting for responses from the ITC-4. Increase this parameter if error messages -containg ?TMO appear. +contaning ?TMO appear.
    sensor
    Sets the sensor number to be used for reading temperature.
    control @@ -341,17 +331,17 @@ the comma.

    Installing an ITC4 step by step

      -
    1. Connect the ITC temperature controller to port 6 on the Macintosh -serial port extension box. Port 6 is specially configured for dealing with +
    2. Connect the ITC temperature controller to port 7 on the terminal server +box. Port 7 is specially configured for dealing with the ideosyncracies of that device. No null modem is needed.
    3. Install the ITC4 into SICS with the command:
      -evfactory new name Macintoshname 4000 7
      -Thereby replace name with the name you want to address the ITC4 in SICS. A -good choice for a name is temperature, as such a value will be written to data files. +evfactory new temperature localhost 4000 7
      +You may choose an other name than "temperature", but then it is in general not stored +in the data file. Please note, that SICS won't let you use that name if it already exists. For instance if you already had a controller in there. Then the command:
      evfactory del name
      -will help. Macintoshname is the name of the instrument Macintosh PC. +will help.
    4. Configure the upper and lowerlimits for your controller appropriatetly.
    5. Figure out which sensor you are going to use for reading temperatures. Configure the sensor and the divisor parameter accordingly. @@ -373,7 +363,7 @@ current one.

      ITC-4 Trouble Shooting

      If the ITC-4 does not respond at all, make sure the serial connection to -the Macintosh is working. Use standard RS-232 debugging procedures for doing +is working. Use standard RS-232 debugging procedures for doing this. The not responding message may also come up as a failure to connect to the ITC-4 during startup. @@ -452,7 +442,7 @@ temperature sensor val val can be either intern or extern.

      -

      Dilution Cryostat

      +

      Old Dilution Cryostat (Obsolete)

      This is a large ancient device for reaching very low temperatures. This cryostat can be configured into SICS with the command: @@ -540,7 +530,7 @@ a magnetic field. This is so in order to support SICS control logic. You can read values at all times explicitly using magnet current or magnet field.

      -

      The CryoFurnace.

      +

      Old CryoFurnace Controller (Obsolete)

      The CryoFurnace at PSI is equipped with a Neocera LTC-11 temperature controller. This controller can control either an heater or an analag output