From 703d169ccf0a6fa66871a3ba8a5eb08de98fb99c Mon Sep 17 00:00:00 2001 From: cvs Date: Fri, 17 Oct 2003 13:45:15 +0000 Subject: [PATCH] M.Z. --- doc/user/samenv.htm | 341 ++++++++++++++++++++++---------------------- 1 file changed, 171 insertions(+), 170 deletions(-) diff --git a/doc/user/samenv.htm b/doc/user/samenv.htm index 69daa9f5..c1f8539a 100644 --- a/doc/user/samenv.htm +++ b/doc/user/samenv.htm @@ -18,16 +18,19 @@ devices.
  • LakeShore Model 340 temperature controllers.
  • Oxford Instruments ITC-4 or ITC-503 temperature controllers. -
  • Old Dilution Cryostat (obsolete).
  • Haake waterbath thermostat. -
  • The Neocera LTC-11 temperature -controller (obsolete, was used for the Cryofurnace).
  • Eurotherm Temperature Controller.
  • Bruker Magnet Controller.
  • The Risoe A1931 Temperature Controller.
  • The PSI-EL755 Magnet Controller.
  • The PSI-DSP Magnet Controller, also known as -SLS controller. +SLS controller. + +Obsolete: +

    @@ -65,7 +68,7 @@ for understanding SICS environment device handling. Then there will be another section discussing the special devices known to the system.

    -

    SampleEnvironment Error Handling

    +

    Sample Environment Error Handling

    A sample environment device may fail to stay at its preset value during a measurement. This condition will usually be detected by the emon. The question is how to deal with this problem. The requirements for this kind of error @@ -310,7 +313,7 @@ connects Temp to the serial port 7, listening at port 4000. The ITC-4 has a few more parameter commands:
    timeout -
    Is the timeout for the Macintosh terminal server program waiting for +
    Is the timeout for the SerPortServer waiting for responses from the ITC-4. Increase this parameter if error messages contaning ?TMO appear.
    sensor @@ -410,9 +413,8 @@ within the tolerance. That is the temperature value you wanted after all.

    This is sort of a bucket full of water equipped with a temperature control system. The RS-232 interface of this device can only be operated at -4800 baud max. This is why it has to be connected to the serial printer port -of the Macintosh serial port server computer. This makes the channel number to -use for initialisation a 1 always. The driver for this device has been +4800 baud max. This is why it has to be connected to a specially configured port. +The driver for this device has been realised in the Tcl extension language of the SICS server. A prerequisite for the usage of this device is that the file hakle.tcl is sourced in the SICS initialisation file and the command inihaakearray has been published. @@ -422,11 +424,11 @@ initialisation parameters, second install the device with evfactory. A command procedure is supplied for the first step. Thus the initialisation sequence becomes:

    -inihaakearray name-of-array macintosh-computer name port channel
    +inihaakearray name-of-array localhost name port channel
    evfactory new temperature tcl name-of-array
    An example for the SANS:
    -inihaakearray eimer lnsp25.psi.ch 4000 1
    +inihaakearray eimer localhost 4000 1
    evfactory new temperature tcl eimer
    Following this, the thermostat can be controlled with the other environment @@ -442,35 +444,6 @@ temperature sensor val val can be either intern or extern.

    -

    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: -

    -EVFactory new Temp dillu computer port channel table.file
-
    -Temp is the name of the dilution controller command in SICS, dillu is the -keyword which selects the dilution driver, computer, port and channel are -the parameters of the Macintosh-PC running the serial port server program. -table.file is the fully qualified name of a file containing a translation -table for this cryostat. The readout from the dilution controller is a -resistance. This table allows to interpolate the temperature from the -resistance measurements and back. Example: -
    -evfactory new temperature dillu lnsp19.psi.ch 4000 1 dilu.tem
-
    -installs a new dilution controller into SICS. This controller is connected -to port 1 at the Macintos-PC with the newtwork adress lnsp19.psi.ch. On this -macintosh-PC runs a serial port server program listening at TCP/IP port -4000. The name of the translation table file is dilu.tem. -

    -

    -The dilution controller has no special commands, but two caveats: As of -current (October 1998) setting temperatures does not work due to problems -with the electronics. Second the dilution controller MUST be connected to -port 1 as only this port supports the 4800 maximum baud rate this device -digests. -

    Bruker Magnet Controller B-EC-1

    This is the Controller for the large magnet at SANS. The controller is a @@ -480,24 +453,23 @@ an external hall sensor at the magnet. In current mode, the output curren of the device is controlled. This magnet can be configured into SICS with a command syntax like this:

    -evfactory new name bruker Mac-PC Mac-port Mac-channel +evfactory new name bruker localhost port channel

    name is a placeholder for the name of the device within SICS. A good suggestion (which will be used throughout the rest of the text) is magnet. -bruker is the keyword for selecting the bruker driver. Mac-PC is the name of -the Macintosh PC to which the controller has been connected, Mac-Port is the -port number at which the Macintosh-PC's serial port server listens. -Mac-channel is the RS-232 channel to which the controller has been +bruker is the keyword for selecting the bruker driver. port is the +port number at which the serial port server listens. +channel is the RS-232 channel to which the controller has been connected. For example (at SANS): 

    -evfactory new magnet bruker lnsp25.psi.ch 4000 9
+evfactory new magnet bruker localhost 4000 9

    creates a new command magnet for a Bruker magnet Controller connected to -serial port 9 at lnsp25. +serial port 9.

    In addition to the standard environment controller commands this magnet controller understands the following special commands: @@ -530,6 +502,158 @@ 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 Eurotherm Temperature Controller

    +

    +At SANS there is a Eurotherm temperature controller for the sample heater. + This and probably other Eurotherm controllers can be configured into SICS +with the following command. The eurotherm needs to be connected with a + nullmodem adapter. +

    +evfactory new name euro Mac-PC Mac-port Mac-channel +
    +

    +

    +name is a placeholder for the name of the device within SICS. A good +suggestion is temperature. +euro is the keyword for selecting the Eurotherm driver. port is the +port number at which the serial port server listens. +channel is the RS-232 channel to which the controller has been +connected. WARNING: The eurotherm needs a RS-232 port with an unusual + configuration: 7bits, even parity, 1 stop bit. Currently only the SANS + port 13 is + configured like this! Thus, an example for SANS and the name temperature + looks like: +

    +evfactory new temperature euro localhost 4000 13
+
    +

    +

    +There are two further gotchas with this thing: +

      +
    • The eurotherm needs to operate in the EI-bisynch protocoll mode. This has +to be configured manually. For details see the manual coming with the machine. +
    • The weird protocoll spoken by the Eurotherm requires very special control + characters. Therefore the send functionality usually supported by a SICS + environment controller could not be implemented. +
    +

    +

    The Risoe A1931 Temperature Controller

    +

    +This is a temperature controller of unknown origin (probably built at +Risoe) which is coming with the Risoe instruments. This temperature +controller is connected to the computer systems through a GPIB bus and +controller. A A1931 temperature controller is configured into SICS +through the command: +

    +evfactory new temperature-name a1931 gpib-controller-name gpibaddress +
    +This creates a new command temperature-name. gpib-controller-name is +the name of a GPIB controller within SICS. A GPIB controller is +configured into SICS with the command MakeGPIB as described in the +SICS managers documentation. gpibaddress is the address of the A1931 on the +GPIB bus. +

    +

    +A A1931 temperature device understands a couple of additional commands +on top of the standard set: +

    +
    temperature sensor val +
    The A1931 can switch control to various sensors. This command +allows to query the control sensor (command without parameter) or set +the control sensoe (command with parameter). +
    temperature file filename +
    The A1931 can be configured through files containing calibration +commands. Sich file can be loaded into the A1931 through the file +subcommand. The full path of filename must be given. +
    +

    +

    The PSI-EL755 Magnet Controller

    +

    +This is magnet controller developed by the electronics group at +PSI. It consists of a controller which interfaces to a couple of power +supplies. The magnets are then connected to the power supplies. The +magnetic field is not controlled directly but just the power output of +the power supply. Also the actual output of the power supply is NOT +read back but just the set value after ramping. This is a serious +limitation because the computer cannot recognize a faulty power supply +or magnet. The EL755 is connected to SICS with the command: +

    +evfactory new name el755 localhost port channel index +
    + with port and channel being the usual data items for + describing the location of the EL755-controller at the + serial port server. index is special and is the number of the power + supply to which the magnet is connected. An example: +
    +evfactory new maggi el755 localhost 4000 5 3
+
    +connects to power supply 3 at the EL755-controller connected to lnsa09 +at channel 5. The magnet is then available in the system as maggi. No +special commands are supported for the EL755. +

    + +

    PSI-DSP Magnet Controller

    +

    +The PSI-DSP magnet controller has been developed by the PSI +electronics group, most notably by Lukas Tanner, for the +SLS. However, these controllers are now being used at SINQ as +well. This controller has a binary command protocoll and thus the send +command does not work for it. In order to handle this protocoll SICS +has to bypass the usual SerPortServer mechanism for communicating with +serial devices +and to connect to the terminal server directly. This also implies one +gotcha: +The PSI-DSP works only at specially configured terminal server +ports.The terminal server +port to which the PSI-DSP is connected MUST be configured to: +115200 baud, 8 data bits, 1 stop bit, odd parity. In general a system +manager is required to do this. The PSI-DSP also requires a null-modem +connector between the box and the terminal server. Once these hurdles +have been mastered, the PSI-DSP can be configured into SICS with the +command: +

    +evfactory new name psi-dsp terminalservername port +
    +with name being the name of the magnet in SICS, terminalservername the +name of the terminal server, for example psts224 and port being the +address of the binary port on the terminal server. This is usually +the serial port number at the terminal server plus 3000. An example: +
    +evfactory new maggi psi-dsp psts224 3016 +
    +configures a magnet named maggi which is connectd to port 16 at the +terminal server psts224. maggi can now be read and driven like any +other environment device. +

    +

    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: +

    +EVFactory new Temp dillu computer port channel table.file
+
    +Temp is the name of the dilution controller command in SICS, dillu is the +keyword which selects the dilution driver, computer, port and channel are +the parameters of the Macintosh-PC running the serial port server program. +table.file is the fully qualified name of a file containing a translation +table for this cryostat. The readout from the dilution controller is a +resistance. This table allows to interpolate the temperature from the +resistance measurements and back. Example: +
    +evfactory new temperature dillu lnsp19.psi.ch 4000 1 dilu.tem
+
    +installs a new dilution controller into SICS. This controller is connected +to port 1 at the Macintos-PC with the newtwork adress lnsp19.psi.ch. On this +macintosh-PC runs a serial port server program listening at TCP/IP port +4000. The name of the translation table file is dilu.tem. +

    +

    +The dilution controller has no special commands, but two caveats: As of +current (October 1998) setting temperatures does not work due to problems +with the electronics. Second the dilution controller MUST be connected to +port 1 as only this port supports the 4800 maximum baud rate this device +digests. +

    Old CryoFurnace Controller (Obsolete)

    The CryoFurnace at PSI is equipped with a Neocera LTC-11 temperature @@ -584,130 +708,7 @@ LTC-11 driver buffers the last temperature read for 5 seconds. Setting the mode of the LTC-11 is possible by computer, but not yet fully understood and therefore unusable.

    -

    The Eurotherm Temperature Controller

    -

    -At SANS there is a Eurotherm temperature controller for the sample heater. - This and probably other Eurotherm controllers can be configured into SICS -with the following command. The eurotherm needs to be connected with a - nullmodem adapter. -

    -evfactory new name euro Mac-PC Mac-port Mac-channel -
    -

    -

    -name is a placeholder for the name of the device within SICS. A good -suggestion is temperature. -euro is the keyword for selecting the Eurotherm driver. Mac-PC is the name of -the Macintosh PC to which the controller has been connected, Mac-Port is the -port number at which the Macintosh-PC's serial port server listens. -Mac-channel is the RS-232 channel to which the controller has been -connected. WARNING: The eurotherm needs a RS-232 port with an unusual - configuration: 7bits, even parity, 1 stop bit. Currently only the SANS - Macintosh port 13 (the last in the upper serial port connection box) is - configured like this! Thus, an example for SANS and the name temperature - looks like: -

    -evfactory new temperature euro lnsp25.psi.ch 4000 13
-
    -

    -

    -There are two further gotchas with this thing: -

      -
    • The eurotherm needs to operate in the EI-bisynch protocoll mode. This has -to be configured manually. For details see the manual coming with the machine. -
    • The weird protocoll spoken by the Eurotherm requires very special control - characters. Therefore the send functionality usually supported by a SICS - environment controller could not be implemented. -
    -

    -

    The Risoe A1931 Temperature Controller

    -

    -This is a temperature controller of unknown origin (probably built at -Risoe) which is coming with the Risoe instruments. This temperature -controller is connected to the computer systems through a GPIB bus and -controller. A A1931 temperature controller is configured into SICS -through the command: -

    -evfactory new temperature-name a1931 gpib-controller-name gpibaddress -
    -This creates a new command temperature-name. gpib-controller-name is -the name of a GPIB controller within SICS. A GPIB controller is -configured into SICS with the command MakeGPIB as described in the -SICS managers documentation. gpibaddress is the address of the A1931 on the -GPIB bus. -

    -

    -A A1931 temperature device understands a couple of additional commands -on top of the standard set: -

    -
    temperature sensor val -
    The A1931 can switch control to various sensors. This command -allows to query the control sensor (command without parameter) or set -the control sensoe (command with parameter). -
    temperature file filename -
    The A1931 can be configured through files containing calibration -commands. Sich file can be loaded into the A1931 through the file -subcommand. The full path of filename must be given. -
    -

    -

    The PSI-EL755 Magnet Controller

    -

    -This is magnet controller developed by the electronics group at -PSI. It consists of a controller which interfaces to a couple of power -supplies. The magnets are then connected to the power supplies. The -magnetic field is not controlled directly but just the power output of -the power supply. Also the actual output of the power supply is NOT -read back but just the set value after ramping. This is a serious -limitation because the computer cannot recognize a faulty power supply -or magnet. The EL755 is connected to SICS with the command: -

    -evfactory new name el755 Mac-PC Mac-port Mac-channel index -
    - with Mac-PC, Mac-port and Mac-channel being the usual data items for - describing the location of the EL755-controller at the Macintosh - serial port server. index is special and is the number of the power - supply to which the magnet is connected. An example: -
    -evfactory new maggi el755 lnsa09.psi.ch 4000 5 3
-
    -connects to power supply 3 at the EL755-controller connected to lnsa09 -at channel 5. The magnet is then available in the system as maggi. No -special commands are supported for the EL755. -

    -

    PSI-DSP Magnet Controller

    -

    -The PSI-DSP magnet controller has been developed by the PSI -electronics group, most notably by Lukas Tanner, for the -SLS. However, these controllers are now being used at SINQ as -well. This controller has a binary command protocoll and thus the send -command does not work for it. In order to handle this protocoll SICS -has to bypass the usual SerPortServer mechanism for communicating with -serial devices -and to connect to the terminal server directly. This also implies one -gotcha: -The PSI-DSP works only at specially configured terminal server -ports.The terminal server -port to which the PSI-DSP is connected MUST be configured to: -115200 baud, 8 data bits, 1 stop bit, odd parity. In general a system -manager is required to do this. The PSI-DSP also requires a null-modem -connector between the box and the terminal server. Once these hurdles -have been mastered, the PSI-DSP can be configured into SICS with the -command: -

    -evfactory new name psi-dsp terminalservername port -
    -with name being the name of the magnet in SICS, terminalservername the -name of the terminal server, for example psts224 and port being the -address of the binary port on the terminal server. This is usually -the serial port number at the terminal server plus 3000. An example: -
    -evfactory new maggi psi-dsp psts224 3016 -
    -configures a magnet named maggi which is connectd to port 16 at the -terminal server psts224. maggi can now be read and driven like any -other environment device. -