diff --git a/doc/processes/instrument_details/ARGUS-Instrument-Details.md b/doc/processes/instrument_details/ARGUS-Instrument-Details.md new file mode 100644 index 000000000..cf70a3173 --- /dev/null +++ b/doc/processes/instrument_details/ARGUS-Instrument-Details.md @@ -0,0 +1,142 @@ +# ARGUS + +This page collects information that will be useful for the implementation of the IBEX control system on ARGUS. +## Background & Timeline ## +ARGUS is a general purpose muon spectrometer at ISIS, on TS1. The [ARGUS](https://www.isis.stfc.ac.uk/Pages/argus.aspx) web page describes the background to the instrument. + +## Control System ## +ARGUS will migrate from the SECI control system to the IBEX control system in MMMMMMMM YYYY. + +## ARGUS Equipment ## +The equipment listed below is used on ARGUS. Please add new information (e.g. new items of equipment, new notes, information about drivers, etc. to this table). + +Manufacturer | Model | Type | Connection | Driver | Notes | +------------ | ------------- | ------------- | ------------- | ------------- | ------------------------------------------- +ISIS | DAE 2 | Detector Electronics | Ethernet | | [see DAE note](#argus_note-dae) +ISIS | ??? | ISIS Vacuum System | | |[see Vacuum System note](#argus_note-vacuum-system) +Pfeiffer | TPG300 | Vacuum Gauge | RS-232 | EPICS | [see Vacuum System note](#argus_note-vacuum-system) +Eurotherm | Temperature Controller | All models at ISIS | RS-232 | [EPICS](http://www.aps.anl.gov/epics/modules/manufacturer.php#Eurotherm) | [see Eurotherm note](#argus_note-eurotherm) +Julabo | FP-50 | Water Bath | RS-232 | | [see Water Bath note](#argus_note-water-baths) +Julabo | FP-52 | Water Bath | RS-232 | | [see Water Bath note](#argus_note-water-baths) +[KEPCO](http://www.kepcopower.com/bop.htm) | BOP 100-10MG | Bi-Polar Power Supply | RS232 | #187 |[see Kepco note](#argus_note-kepco) +Kepco | BIT 4886 | I/F card | GPIB, RS-232 | | [see Kepco note](#argus_note-kepco) +Thurlby | EX355P | PSU | ??? | | [see Thurlby note](#argus_note-thurlby) +Danfysik | 8000 | PSU | RS232 | DFKPS | [see Danfysik note](#argus_note-danfysik) +TDK | Lambda Genesys | PSU | RS232 | TDK_ LAMBDA_ GENESYS | [see Genesys note](#argus_note-genesys) | +Neocera | LTC-21 | Temperature Controller | RS-232 | | [see Neocera note](#argus_note-neocera) +Oxford Instruments | Triton | Dilution Fridge | RS-232 | | [see Oxford Instruments note](#argus_note-oxford-instruments) +Oxford Instruments | Mercury | Temperature Controller | RS-232 | | [see Oxford Instruments note](#argus_note-oxford-instruments) +Oxford Instruments | | Cryogenic Equipment | RS-232 | | [see Oxford Instruments note](#argus_note-oxford-instruments) +LakeShore | 332 | Temperature Controller | RS-232 | [EPICS](http://www.aps.anl.gov/epics/modules/manufacturer.php#Lakeshore) | [see LakeShore note](#argus_note-lakeshore ) +Lakeshore | 372 | Temperature Controller | | | [see Lakeshore note](#argus_note-lakeshore ) +LakeShore | 460 | Gaussmeter | RS-232 | [EPICS](http://www.aps.anl.gov/epics/modules/manufacturer.php#Lakeshore) | [see LakeShore note](#argus_note-lakeshore ) +Cryomagnetics | LM500| Liquid Cryogen Level Monitor | RS-232 | | [see Cryomagnetics note](#argus_note-cryomagnetics) +Leiden Cryogenics| GHS-2T-1T-700 | Dilution Fridge| | | [see Leiden Cryogenics note](#argus_note-leiden-cryogenics) + +{#argus_note-dae} +##### Note: DAE ##### +See multi-detector and single-detector below. + +{#argus_note-vacuum-system} +##### Note: Vacuum System ##### +TPG300 support is implemented via [#216](https://github.com/ISISComputingGroup/IBEX/issues/216) and [#2063](https://github.com/ISISComputingGroup/IBEX/issues/2063) + +{#argus_note-eurotherm} +##### Note: Eurotherm ##### +[Eurotherms](http://www.facilities.rl.ac.uk/isis/computing/ICPdiscussions/ARGUS/ARGUS_Eurotherms.jpg) are used to control temperature Orange Cryostat, CCR and Furnace devices. + +{#argus_note-water-baths} +##### Note: Water Baths ##### +1. Julabo Water Bath + * no information on specific Julabo Water Baths - maybe ARGUS uses water baths from the pool? + * consult the [Julabo commands](/specific_iocs/temp_controllers/julabo_commands.xlsx) spreadsheet for specific details of which set of commands are used individual water baths. +1. See also [Water Baths](https://www.isis.stfc.ac.uk/Pages/Water-Baths.aspx) list + +{#argus_note-kepco} +##### Note: Kepco ##### +1. [Kepco BIT 4886](http://www.kepcopower.com/bit.htm) is an interface card for Kepco bi-polar ([BOP](http://www.kepcopower.com/bop.htm)) power supplies. See also `C:\LabVIEW Modules\Drivers\Kepco 4886 Serial` +1. [Kepco BOP 100-10MG PSU](http://www.kepcopower.com/bophimod.htm).
See also [#3005](https://github.com/ISISComputingGroup/IBEX/issues/3005) + +{#argus_note-thurlby} +##### Note: Thurlby ##### +Thurlby EX355P PSU - see [#155](https://github.com/ISISComputingGroup/IBEX/issues/155) and [#198](https://github.com/ISISComputingGroup/IBEX/issues/198). + +[Thurlby Thandar Instruments EX355P PSU](https://www.aimtti.com/product-category/dc-power-supplies/aim-ex-rseries) + +{#argus_note-danfysik} +##### Note: Danfysik ##### +1. [Danfysik Power Supplies](http://www.danfysik.com/en/products/power-supplies/): model 8000 appears to have been superseded by model 8500. +1. [User and Software Manuals](http://www.facilities.rl.ac.uk/isis/computing/ICPdiscussions/Forms/AllItems.aspx?RootFolder=%2Fisis%2Fcomputing%2FICPdiscussions%2FPower%20Supplies&FolderCTID=0x01200027AD8F05966A2748B3B04C98BB5B442B&View={F2C33C51-70E6-4343-B937-2C59A2568306}&InitialTabId=Ribbon%2EDocument&VisibilityContext=WSSTabPersistence) for System 8500. +1. See [#1208](https://github.com/ISISComputingGroup/IBEX/issues/1208) for comms settings. + +{#argus_note-genesys} +##### Note: Genesys ##### +1. [TDK Lambda Genesys Power Supplies](https://uk.tdk-lambda.com/products/programmable-power-supplies/). +1. [Safety, User and Programming Manuals](http://www.facilities.rl.ac.uk/isis/computing/ICPdiscussions/Forms/AllItems.aspx?RootFolder=%2Fisis%2Fcomputing%2FICPdiscussions%2FPower%20Supplies&FolderCTID=0x01200027AD8F05966A2748B3B04C98BB5B442B&View={F2C33C51-70E6-4343-B937-2C59A2568306}&InitialTabId=Ribbon%2EDocument&VisibilityContext=WSSTabPersistence) for System 8500. +1. See also [#983](https://github.com/ISISComputingGroup/IBEX/issues/983), [#2276](https://github.com/ISISComputingGroup/IBEX/issues/2276), [#2458](https://github.com/ISISComputingGroup/IBEX/issues/2458) + +{#argus_note-neocera} +##### Note: Neocera ##### +Low temperature experiments?[Neocera LTC-21 Manual](http://www.submm.caltech.edu/~sharc/technical/LTC-21%20manual.pdf) + +{#argus_note-oxford-instruments} +##### Note: Oxford Instruments ##### +1. Dilution fridge: [models](https://www.isis.stfc.ac.uk/Pages/Dilution-Refrigerators.aspx) to be determined. + * Triton LabVIEW Driver : `C:\LabVIEW Modules\Drivers\Triton` + * Triton Documentation : `C:\LabVIEW Modules\Drivers\Triton\Documentation` + * See also [#2915](https://github.com/ISISComputingGroup/IBEX/issues/2915) +1. Blue Cryostat: [models](https://www.isis.stfc.ac.uk/Pages/Oxford-Variox-Cryostats.aspx) to be determined. + +{#argus_note-lakeshore} +##### Note: LakeShore ##### +1. [Model 332](https://www.lakeshore.com/products/Cryogenic-Temperature-Controllers/Model-332/Pages/Overview.aspx) temperature controller. Model 332 has now been superseded by [Model 335](https://www.lakeshore.com/products/Cryogenic-Temperature-Controllers/Model-335/Pages/Overview.aspx). +1. On muon instruments, the Triton fridges have an additional Lakeshore controller (the 372) to allow control and continuous readout of the sample temperature (the OI software doesn't allow this using the in-built Lakeshore, despite the unit having a dedicated channel for the sample thermometry). +1. [Model 372](https://www.lakeshore.com/products/categories/overview/temperature-products/ac-resistance-bridges/model-372-ac-resistance-bridge-temperature-controller) temperature controller. +1. [Model 460](https://www.lakeshore.com/products/Gaussmeters/Model-460-3-Channel-Gaussmeter/Pages/Overview.aspx) gaussmeter. Model 460 has now been superseded by [Model F71](https://www.lakeshore.com/products/Gaussmeters/F71-F41-teslameters/Pages/Overview.aspx). +1. There are [EPICS drivers](https://epics-controls.org/resources-and-support/modules/hardware-support/) for a variety of Lakeshore devices. + +{#argus_note-cryomagnetics} +##### Note: Cryomagnetics ##### +1. LM500 model appears to have been superseded by [Model LM-510 Liquid Cryogen Monitor](https://www.cryomagnetics.com/products/model-lm-510-liquid-cryogen-monitor/). [Spec sheet for the LM500](http://www.cryomagnetics.com/manuals/LM-500c.pdf) is still available. See also spec sheets and manual on [ICPDiscussions](http://www.facilities.rl.ac.uk/isis/computing/ICPdiscussions/Forms/AllItems.aspx?RootFolder=%2Fisis%2Fcomputing%2FICPdiscussions%2FCryogenics&FolderCTID=0x01200027AD8F05966A2748B3B04C98BB5B442B&View={F2C33C51-70E6-4343-B937-2C59A2568306}&InitialTabId=Ribbon%2EDocument&VisibilityContext=WSSTabPersistence). + +{#argus_note-leiden-cryogenics} +##### Note: Leiden Cryogenics ##### +1. ARGUS appears to have a Leiden Dilution Fridge. + 1. Manufacturer: [Leiden Cryogenics](https://leiden-cryogenics.com/) + 1. Manufacturer VI: `C:\LabVIEW Modules\Instruments\ARGUS\ARGUS - LEIDEN Dilution Fridge` + * The VI appears to date from 2004. + * This model of dilution fridge (the GHS-2T-1T-700) is probably obsolete. It is no longer listed on the web-site. + +{#argus_note-mclennan} +##### Note: McLennan ##### +Support for McLennan devices is well established (see [#1099](https://github.com/ISISComputingGroup/IBEX/issues/1099) and [#1100](https://github.com/ISISComputingGroup/IBEX/issues/1100) and subsequent tickets. + * muon instruments don't use motors in their sample environment + +## ARGUS SECI Configs ## +Document information about ARGUS SECI configs here. + +Configuration Name | Sub-Configurations | Last Accessed | Required | +---------------------------------------|----------------------------------------------------|---------------|----------| +ARGUS_place_holder1.conf | - | dd/mm/yyyy | - | +ARGUS_place_holder2.conf | - | dd/mm/yyyy | - | + +## ARGUS Genie Scripts ## +Similarly, Document information about ARGUS SECI Genie scripts here. + +## ARGUS Notes ## +ARGUS has the following specialist panels: +1. serial port commands - individual commands via serial port (cf. SDTEST) +1. ARGUS [zero field controller](/specific_iocs/magnets/Zero-field-controller) +1. CHRONUS Danfysik +1. MUON [Zero field controller (magnetselected.vi)](/specific_iocs/magnets/Zero-field-controller) +1. ARGUS Leiden Dilution Fridge +1. ARGUS Danfysik +1. ARGUS [Zero field controller](/specific_iocs/magnets/Zero-field-controller) + +## Obsolete ARGUS Equipment & SECI Configs ## +The equipment listed below is referenced in SECI config files on ARGUS. It is highly likely that the config files are no longer relevant (they are old, dating from 2011 or 2012), therefore, the references are to devices that are obsolete or simply not used on ARGUS. + +Manufacturer | Model | Type | Connection | Driver | Notes | +------------ | ------------- | ------------- | ------------- | ------------- | ------------------------------------------- +GALIL | [DMC2280](http://www.galilmc.com/products/dmc-22x0.php) | Motion Controller | Ethernet | [EPICS](http://www.aps.anl.gov/epics/modules/manufacturer.php#Galil%20Motion%20Control) | | +McLennan | PM600 | Motion Controller | RS-232 | [EPICS](http://www.aps.anl.gov/epics/modules/manufacturer.php#McLennan%20Servo%20Supplies) | [see McLennan note](#argus_note-mclennan) diff --git a/doc/processes/instrument_details/HIFI-Instrument-Details.md b/doc/processes/instrument_details/HIFI-Instrument-Details.md new file mode 100644 index 000000000..df0223bce --- /dev/null +++ b/doc/processes/instrument_details/HIFI-Instrument-Details.md @@ -0,0 +1,137 @@ +# HIFI + +This page collects information that will be useful for the implementation of the IBEX control system on HIFI. +## Background & Timeline ## +HIFI is high magnetic-field muon instrument at ISIS, on TS1. The [HIFI](https://www.isis.stfc.ac.uk/Pages/HIFI.aspx) web page describes the background to the instrument. + +## Control System ## +HIFI will migrate from the SECI control system to the IBEX control system in MMMMMMMM YYYY. + +## HIFI Equipment ## +The equipment listed below is used on HIFI. Please add new information (e.g. new items of equipment, new notes, information about drivers, etc. to this table). + +Manufacturer | Model | Type | Connection | Driver | Notes | +------------ | ------------- | ------------- | ------------- | ------------- | ------------------------------------------- +ISIS | DAE 2 | Detector Electronics | Ethernet | | [see DAE note](#hifi_note-dae) +GALIL | [DMC2280](http://www.galilmc.com/products/dmc-22x0.php) | Motion Controller | Ethernet | [EPICS](http://www.aps.anl.gov/epics/modules/manufacturer.php#Galil%20Motion%20Control) | [see motion note](#hifi_note-motion) +??? | | 4-blade jaws | | | [see Jaws note](#hifi_note-jaws) +ISIS | ??? | ISIS Vacuum System | | |[see Vacuum System note](#hifi_note-vacuum-system) +Pfeiffer | TPG300 | Vacuum Gauge | RS-232 | EPICS | [see Vacuum System note](#hifi_note-vacuum-system) +Eurotherm | Temperature Controller | All models at ISIS | RS-232 | [EPICS](http://www.aps.anl.gov/epics/modules/manufacturer.php#Eurotherm) | [see Eurotherm note](#hifi_note-eurotherm) +Aeroflex/IFR | 2030 | Signal Generator | RS-232 | | [see Aeroflex note](#hifi_note-aeroflex) +Julabo | FP-50 | Water Bath | RS-232 | | [see Water Bath note](#hifi_note-water-baths) +Julabo | FP-52 | Water Bath | RS-232 | | [see Water Bath note](#hifi_note-water-baths) +~Haake~ | ~N6~ | ~Water Bath~ | ~RS-232~ | | [see Water Bath note](#hifi_note-water-baths) +Neocera | LTC-21 | Temperature Controller | RS-232 | | [see Neocera note](#hifi_note-neocera) +ICE | | Oxford ICE Cube | ??? | | [see Oxford ICE Cube note](#hifi_note-oxford-ice-cube) +[CAEN](http://www.caen.it/csite/HomePage.jsp) | V895 | Discriminator | ??? | |[see CAEN note](#hifi_note-caen) +Oxford Instruments | Triton | Dilution Fridge | RS-232 | | [see Oxford Instruments note](#hifi_note-oxford-instruments) +Oxford Instruments | Mercury | Temperature Controller | RS-232 | | [see Oxford Instruments note](#hifi_note-oxford-instruments) +Oxford Instruments | | Cryogenic Equipment | RS-232 | | [see Oxford Instruments note](#hifi_note-oxford-instruments) +LakeShore | 218 | | RS-232 | [EPICS](http://www.aps.anl.gov/epics/modules/manufacturer.php#Lakeshore)| [see LakeShore note](#hifi_note-lakeshore ) +LakeShore | 340 | | RS-232 | [EPICS](http://www.aps.anl.gov/epics/modules/manufacturer.php#Lakeshore) | [see LakeShore note](#hifi_note-lakeshore ) +Lakeshore | 372 | Temperature Controller | | | [see Lakeshore note](#hifi_note-lakeshore ) +Metrolab | PT2025 | Teslameter | | | [see Metrolab note](#hifi_note-metrolab) + +{#hifi_note-dae} +##### Note: DAE ##### +See multi-detector and single-detector below. + +{#hifi_note-motion} +##### Note: Motion ##### +There is a project relating to the motion on the South Side Muons in progress, this information may be out of date + +{#hifi_note-jaws} +##### Note: Jaws ##### +Provide information about HIFI jaws. + +{#hifi_note-vacuum-system} +##### Note: Vacuum System ##### +TPG300 support is implemented via [#216](https://github.com/ISISComputingGroup/IBEX/issues/216) and [#2063](https://github.com/ISISComputingGroup/IBEX/issues/2063) + +{#hifi_note-eurotherm} +##### Note: Eurotherm ##### +[Eurotherms](http://www.facilities.rl.ac.uk/isis/computing/ICPdiscussions/HIFI/HIFI_Eurotherms.jpg) are used to control temperature Orange Cryostat, CCR and Furnace devices. + +{#hifi_note-aeroflex} +##### Note: Aeroflex/IFR ##### +Aeroflex has been through a complicated series of sales in recent years. The [Aeroflex manuals](https://www.avionteq.com/document/IFR-2030-opt-006-specification-sheet.pdf) are probably a good place to start, along with any existing VIs. See also [IFR 2023A](https://www.atecorp.com/products/ifr/2023a). + +There appears to be no driver for the Aeroflex 2023A in `C:\LabVIEW Modules\`. However, there is a driver for an Aeroflex 2030 in `C:\LabVIEW Modules\Drivers\Aeroflex 2030`. + +{#hifi_note-water-baths} +##### Note: Water Baths ##### +1. Julabo Water Bath + * no information on specific Julabo Water Baths - maybe HIFI uses water baths from the pool? + * consult the [Julabo commands](/specific_iocs/temp_controllers/julabo_commands.xlsx) spreadsheet for specific details of which set of commands are used individual water baths. +1. Haake Water Bath is now obsolete (replaced by Julabo, according to instrument scientist) + * ~Haake Water Bath (apparently the following Haake water bath: WB9)~ + * ~Haake N6 Water Bath. Haake has now been taken over by [ThermoFisher](https://www.thermofisher.com/uk/en/home/life-science/lab-equipment/water-baths-circulators-chillers.html). N6 model may be obsolete. Check existing SECI VI for logic and manual (see `C:\LabVIEW Modules\Drivers\Haake N6`).~ +1. See also [Water Baths](https://www.isis.stfc.ac.uk/Pages/Water-Baths.aspx) list + +{#hifi_note-neocera} +##### Note: Neocera ##### +Low temperature experiments?[Neocera LTC-21 Manual](http://www.submm.caltech.edu/~sharc/technical/LTC-21%20manual.pdf) + +{#hifi_note-oxford-ice-cube} +##### Note: Oxford ICE Cube ##### +What is the Oxford ICE Cube? LabVIEW drivers are located here: `C:\LabVIEW Modules\Drivers\ICEOxford` + +{#hifi_note-caen} +##### Note: CAEN ##### +The [CAEN V895](http://www.caen.it/csite/CaenProd.jsp?parent=11&idmod=49) is a 16-channel Leading Edge Discriminator. +See also `C:\LabVIEW Modules\Drivers\Caen`. + +{#hifi_note-oxford-instruments} +##### Note: Oxford Instruments ##### +1. Dilution fridge: [models](https://www.isis.stfc.ac.uk/Pages/Dilution-Refrigerators.aspx) to be determined. + * Triton LabVIEW Driver : C:\LabVIEW Modules\Drivers\Triton + * Triton Documentation : C:\LabVIEW Modules\Drivers\Triton\Documentation + * See also [#2915](https://github.com/ISISComputingGroup/IBEX/issues/2915) +1. Blue Cryostat: [models](https://www.isis.stfc.ac.uk/Pages/Oxford-Variox-Cryostats.aspx) to be determined. + +{#hifi_note-lakeshore} +##### Note: LakeShore ##### +1. [Model 218](http://www.lakeshore.com/products/Cryogenic-Temperature-Monitors/Model-218/Pages/Overview.aspx): +1. [Model 336](http://www.lakeshore.com/products/cryogenic-temperature-controllers/model-336/Pages/Overview.aspx): +1. [Model 340](http://www.lakeshore.com/products/Cryogenic-Temperature-Controllers/Model-340/Pages/Overview.aspx): this model is now obsolete, having been replaced by the 336 and 350 models. +1. On muon instruments, the Triton fridges have an additional Lakeshore controller (the 372) to allow control and continuous readout of the sample temperature (the OI software doesn't allow this using the in-built Lakeshore, despite the unit having a dedicated channel for the sample thermometry). +1. [Model 372](https://www.lakeshore.com/products/categories/overview/temperature-products/ac-resistance-bridges/model-372-ac-resistance-bridge-temperature-controller) temperature controller. +1. There are [EPICS drivers](https://epics-controls.org/resources-and-support/modules/hardware-support/) for a variety of Lakeshore temperature controllers. + +{#hifi_note-metrolab} +##### Note: Metrolab ##### +1. [PT2025 NMR Precision Teslameter](https://www.metrolab.com/products/pt2025/) + * The PT2025 is now obsolete. Replaced by model PT2026. + * See `C:\LabVIEW Modules\Instruments\HIFI\Metrolab PT2025 NMR` for SECI VI + * See `\\isis\shares\ISIS_Experiment_Controls\Metrolab PT2025 Teslameter` for the technical manual. + + +## HIFI SECI Configs ## +Document information about HIFI SECI configs here. + +Configuration Name | Sub-Configurations | Last Accessed | Required | +---------------------------------------|----------------------------------------------------|---------------|----------| +HIFI_place_holder1.conf | - | dd/mm/yyyy | - | +HIFI_place_holder2.conf | - | dd/mm/yyyy | - | + +## HIFI Genie Scripts ## +Similarly, Document information about HIFI SECI Genie scripts here. + +## HIFI Notes ## +HIFI has the following specialist panels: +1. MUSR RF Kit +1. EMU MUON FrontEnd +1. HIFI CryoMag Client +1. HIFI Group 3 Hall Probe +1. HIFI Field Viewer +1. HIFI Laser Power +1. HIFI Laser Timing +1. HIFI Laser Client +1. HIFI Magnets +1. HIFI Metrolab PT2025 (NMR Readout) +1. MUON FrontEnd Magnet Monitoring +1. MUON Jaws + +HIFI also has the following system: +1. MUON Script (generator) \ No newline at end of file diff --git a/doc/processes/instrument_details/OFFSPEC-Instrument-Details.md b/doc/processes/instrument_details/OFFSPEC-Instrument-Details.md new file mode 100644 index 000000000..bb6383dd6 --- /dev/null +++ b/doc/processes/instrument_details/OFFSPEC-Instrument-Details.md @@ -0,0 +1,235 @@ +# OFFSPEC + +## Background & Timeline ## +OFFSPEC is an advanced reflectometer instrument at ISIS, on TS2. The [OFFSPEC](https://www.isis.stfc.ac.uk/Pages/OFFSPEC.aspx) web page describes the background to the instrument. + +This page collects information that will be useful for the implementation of the IBEX control system on OFFSPEC. + +## Information about OFFSPEC (and reflectometers in general) ## + +![Offspec bench setup](OffSpec.png) + +Bench moves so that angle is correct this requires motors at front and back to change positions and the bench to slide in and out. This maintains the distance from the detector to the sample in an arc. + +## Control System ## +OFFSPEC will migrate from the SECI control system to the IBEX control system in MMMMMMMM YYYY. + +## OFFSPEC Equipment ## +The equipment listed below is used on OFFSPEC. Please add new information (e.g. new items of equipment, new notes, information about drivers, etc. to this table). + + +| VI | Config(s) | Config last updated | IBEX equivalent | +|--------------------------------------| --- | --- | --- | +| `beam logger.vi` | | | standard IBEX | +| `dae control.vi` | | | standard IBEX / ISISDAE | +| `delft/coldasever.vi` | `OFFSPEC-DELFT-MAIN.conf` | 18/05/2022 | https://github.com/ISISComputingGroup/IBEX/issues/7437 | +| Eurotherm | | | EUROTHRM | +| galil | | | standard IBEX / GALIL | +| Glassman LV power supply | `OFFSPEC - no logging.conf` | 2019 | Obsolete, not required | +| Hitachi L7100 | | | *Obsolete* | +| Mk3 Chopper | | | MK3CHOPR | +| Jasco 4180 | | | JSCO4180 | +| Julabo (several models) | | | JULABO | +| Kepco | | | KEPCO | +| Keyence TM 3001P | | | KYNCTM3K | +| Knauer K-6 | | | KNRK6 | +| Knauer 1050 | | | KNR1050 | +| motion control (various) | | | REFL - assume being handled in https://github.com/ISISComputingGroup/IBEX/issues/6245 | +| Newport SMC100 | | | SMC100 | +| Nima Trough | | | NIMATRO | +| Mercury ITC | | | MERCURY_ITC | +| SM300-5 (power supply) | | | https://github.com/ISISComputingGroup/IBEX/issues/4461 | +| Tektronix AFG 3000 series | | | TEKAFG3XXX | +| Thurlby EX355P | | | TTIEX355P | +| Thurlby TGA1240 | | | None (hardware is obsolete; functionality to be replaced by Tektronix function generators - we should not need to convert this driver) | +| Thurlby TSX 3510P | all | - | https://github.com/ISISComputingGroup/IBEX/issues/7434 | +| Aladdin-1000 syringe pump | | | ALDN1000 | +| WPI 2XX syringe pump | | | SP2XX | +| `inter galil dio` | | | Digital i/o already covered in GALIL ioc | +| `surf galil dio` | | | Digital i/o already covered in GALIL ioc | +| `delft_dc_mc - front panel.vi` | | | https://github.com/ISISComputingGroup/IBEX/issues/7492 | +| `delft/eltromatdriver` | all | - | https://github.com/ISISComputingGroup/IBEX/issues/7494 | +| `delft/hfcontroldriver` | DELFT, NIMA, "Single Config" | 2011/2012 | Deprecated, not required | +| `hydrocell` | | | One-off user kit; not required | +| ISIS sample environment (digital i/o) | | | https://github.com/ISISComputingGroup/IBEX/issues/7436 | +| Linkam | | | LINKAM95 | +| Newport motor | | | NEWPORT | +| OFFSPEC BH | | | Functionality covered in IBEX by a combination of KEPCO, KHLY2400, and scans library. https://github.com/ISISComputingGroup/IBEX/issues/7435 to write equivalent scans script to existing VI | +| OFFSPEC DELFT RF | | | https://github.com/ISISComputingGroup/IBEX/issues/7493 | +| OFFSPEC high level | | | REFL | +| PI motion stage | | | PIMOT | +| Danfysik | | | DFKPS | +| ITC 503 | | | ITC503 | + +
+ Older information: + +``` +Manufacturer | Model | Type | Connection | Driver | Notes | +------------ | ------------- | ------------- | ------------- | ------------- | ------------------------------------------- +ISIS | DAE 2 | Detector Electronics | Ethernet | | [see DAE note](#note-dae) +ISIS | Mk3 | Chopper | N/A | | [see Chopper note](#note-chopper) +GALIL | [DMC2280](http://www.galilmc.com/products/dmc-22x0.php) | Motion Controller | Ethernet | [EPICS](http://www.aps.anl.gov/epics/modules/manufacturer.php#Galil%20Motion%20Control) | | +??? | | 4-blade jaws | | | [see Jaws note](#note-jaws) +ISIS | ??? | ISIS Vacuum System | | |[see Vacuum System note](#note-vacuum) +Pfeiffer | TPG300 | Vacuum Gauge | RS-232 | EPICS | [see Vacuum System note](#note-vacuum) +Eurotherm | Temperature Controller | All models at ISIS | RS-232 | [EPICS](http://www.aps.anl.gov/epics/modules/manufacturer.php#Eurotherm) | [see Eurotherm note](#note-eurotherm) +Julabo | FL1703 | Re-circulating Cooler | RS-232 | | [see Julabo note](#note-julabo) +Julabo | FL300 | Re-circulating Cooler | RS-232 | | [see Julabo note](#note-julabo) +Julabo | FP-50 | Water Bath | RS-232 | | [see Julabo note](#note-julabo) +Julabo | FP-52 | Water Bath | RS-232 | | [see Julabo note](#note-julabo) +Keithley | 2400 | Source Meter | RS-232 | | [see Keithley note](#note-keithley) +[Knauer](http://www.knauer.net/) | K6 | Electric valve drive | RS232 | |[see Knauer note](#note-knauer) +[Knauer](http://www.knauer.net/) | 1050 | HPLC pump | ??? | | [see Knauer HPLC note](#note-knauerHPLC) +~Hitachi~ | ~L-7100~ | ~HPLC pump~ | ??? | | [see Hitachi note](#note-hitachi) +[Jasco](https://jascoinc.com/products/chromatography/)| PU-4180 | HPLC pump| ??? | | [see JASCO HPLC note](#note-jasco-hplc-pump) +Nima Trough | ??? | Trough | ??? | | [see Nima Trough note](#note-nima-trough) +[KEPCO](http://www.kepcopower.com/bop.htm) | BOP 100-10MG | Bi-Polar Power Supply | RS232 | #187 |[see Kepco note](#note-kepco) +[KEPCO](http://www.kepcopower.com/bop.htm) | BIT 4886 | I/F card | GPIB, RS-232 | |[see Kepco note](#note-kepco) +[KEPCO](http://www.kepcopower.com/bop.htm) | BOP 50-2M-4886 | Bi-Polar Power Supply | RS232 | |[see Kepco note](#note-kepco) +Delta-Elektronika | SM300-5 | PSU | ??? | | [see Delta Elektronika note](#note-delta-elektronika ) +Thurlby | EX355P | PSU | ??? | | [see Thurlby note](#note-thurlby) +Thurlby | TGA1240 | Arbitrary Waveform Generator | ??? | | [see Thurlby note](#note-thurlby) +Thurlby | TSX3510P | PSU | ??? | | [see Thurlby note](#note-thurlby) +Oxford Instruments | Mercury | Temperature Controller | RS-232 | | [see Oxford Instruments note](#note-oxford-instruments) +Oxford Instruments | ITC503 | Cryogenic System | | | [see Oxford Instruments note](#note-oxford-instruments) +Tektronix | AFG 3021B | Function Generator | Ethernet | #237 |[see Tektronix note](#note-tektronix) +[Linkam](http://www.linkam.co.uk/) | T95 | | RS232 | |[see Linkam note](#note-linkam) +Watson Marlow | 323 | Peristaltic Pump | ??? | | [see Peristaltic Pumps note](#note-peristaltic-pumps) +WPI | Aladdin-1000 | Syringe Pump | ??? | | [see Syringe Pumps note](#note-syringe-pumps) +WPI | SP2xx | Syringe Pump | ??? | | [see Syringe Pumps note](#note-syringe-pumps) + +##### Note: DAE ##### +See multi-detector and single-detector below. + +##### Note: Choppers ##### +OFFSPEC has a Mk3 chopper.
+ +##### Note: Jaws ##### +Provide information about OFFSPEC jaws. + +##### Note: Vacuum System ##### +TPG300 support is implemented via [#216](https://github.com/ISISComputingGroup/IBEX/issues/216) and [#2063](https://github.com/ISISComputingGroup/IBEX/issues/2063) + +##### Note: Eurotherm ##### +[Eurotherms](http://www.facilities.rl.ac.uk/isis/computing/ICPdiscussions/OFFSPEC/OFFSPEC_Eurotherms.jpg) are used to control temperature Orange Cryostat, CCR and Furnace devices. + + +##### Note: Julabo ##### +OFFSPEC uses Julabo water baths & re-circulating coolers +1. [Julabo FL1703](https://www.julabo.com/en/products/recirculating-coolers/fl1703-recirculating-cooler) +1. [Julabo FL300](https://www.julabo.com/en/products/recirculating-coolers/fl300-recirculating-cooler) +1. Julabo Water Bath (which models?) + +##### Note: KEPCO ##### +1. [Kepco BOP 100-10MG PSU](http://www.kepcopower.com/bophimod.htm).
See also [#3005](https://github.com/ISISComputingGroup/IBEX/issues/3005) +1. [Kepco BIT 4886](http://www.kepcopower.com/bit.htm) is an interface card for Kepco bi-polar ([BOP](http://www.kepcopower.com/bop.htm)) power supplies. +1. [KEPCO BOP 50-2M-4886 PSU](http://www.kepcopower.com/bophimod.htm).
See also [#188](https://github.com/ISISComputingGroup/IBEX/issues/188) & [#200](https://github.com/ISISComputingGroup/IBEX/issues/200) + +##### Note: Keithley ##### +1. [Keithley 2400 Series Source Meter](https://uk.tek.com/keithley-source-measure-units/keithley-smu-2400-series-sourcemeter).
+See also tickets [#1826](https://github.com/ISISComputingGroup/IBEX/issues/1826), [#2695](https://github.com/ISISComputingGroup/IBEX/issues/2695), [#2801](https://github.com/ISISComputingGroup/IBEX/issues/2801) and [#3176](https://github.com/ISISComputingGroup/IBEX/issues/3176). + +##### Note: Hitachi ##### +Hitachi L-7100 HPLC pump (no longer supported at ISIS). ~Can't find L-7100 on [Hitachi web-site](http://www.hitachi-hightech.com/global/about/corporate/group/hhs (may be obsolete). Check existing SECI VI for logic and manual.~ + +##### Note: JASCO HPLC Pump ##### +[JASCO HPLC pump](https://jascoinc.com/products/chromatography/hplc/modules/hplc-pumps/) is a new (for ISIS) model of HPLC pump. + * See `C:\LabVIEW Modules\Drivers\Jasco PU-4180 HPLC Pump\Documentation` for documentation. + * See also [#3743](https://github.com/ISISComputingGroup/IBEX/issues/3743) & [#3923](https://github.com/ISISComputingGroup/IBEX/issues/3923) + +##### Note: Knauer ##### +1. Knauer K-6 Electric Valve Drive. [Knauer web site](https://www.knauer.net)
+ * K-6 model appears to have been superseded. Check existing SECI VI for logic and manual. + * Support now implemented (28-03-2019). See [#3781](https://github.com/ISISComputingGroup/IBEX/issues/3781). + +##### Note: Knauer HPLC ##### +Knauer HPLC 1050 [Knauer HPLC 1050 is discontinued.](https://www.knauer.net/en/discontinued-smartline-pump-1050-successor-azura-p-61l/p14161). Check existing SECI VI for logic and manual. + 1. Support now implemented (04-01-2019). See [#3262](https://github.com/ISISComputingGroup/IBEX/issues/3262). + +##### Note: Nima Trough ##### +Nima Trough: SECI used a manufacturer supplied VI. We may need to do the same in IBEX (via lvDCOM).
+ * **Note:** NIMA Technologies Ltd now seems to be part of [Biolin Scientific](https://www.biolinscientific.com/ksvnima).
+ * The NIMA trough is used regularly on SURF. The manufacturer supplied VI is used to view graphs showing information about thin films. + * The manufacturer has made additional software available for download. A copy of this software is located in `\\isis\shares\ISIS_Experiment_Controls\NIMA Trough\Nima_TR8.1.zip`. + * Support now implemented (25-05-2019). See [#3783](https://github.com/ISISComputingGroup/IBEX/issues/3783) + +##### Note: Delta-Elektronika ##### +1. Delta-Elektronika SM300-5 is a DC power supply. It is listed on page for [Delta-Elektronika SM1500 series](http://www.delta-elektronika.nl/en/products/dc-power-supplies-1500w-sm1500-series.html) products. + +##### Note: Thurlby ##### +[Thurlby Thandar Instruments](https://www.aimtti.com/) +1. [Thurlby Thandar Instruments EX355P PSU](https://www.aimtti.com/product-category/dc-power-supplies/aim-ex-rseries) + * see [#155](https://github.com/ISISComputingGroup/IBEX/issues/155) and [#198] + * IOC & OPI updated (18-07-2019). See [#3784](https://github.com/ISISComputingGroup/IBEX/issues/3784) +(https://github.com/ISISComputingGroup/IBEX/issues/198). +1. [Thurlby TGA1240 Arbitrary Waveform Generator](https://www.aimtti.com/product-category/arbitrary-generators/aim-tga1240series) +1. [Thurlby TSX3510P DC Power Supply](https://www.aimtti.com/product-category/dc-power-supplies/aim-tsxseries) + +##### Note: Oxford Instruments ##### +1. Support for OI ITC503 created as part of [#2593](https://github.com/ISISComputingGroup/IBEX/issues/2593) +1. Support for Mercury Temperature Controller was created as part of [#2840](https://github.com/ISISComputingGroup/IBEX/issues/2840) + +##### Note: Linkam ##### +There are VIs for this.
+See also [Linkam T95 controller](http://www.linkam.co.uk/t95-system-controllers/) and tickets [#1106](https://github.com/ISISComputingGroup/IBEX/issues/1106), [#1496](https://github.com/ISISComputingGroup/IBEX/issues/1496), [#1509](https://github.com/ISISComputingGroup/IBEX/issues/1509). + +##### Note: Peristaltic Pumps ##### +1. [Watson Marlow 323 Peristaltic Pump](http://www.watson-marlow.com/gb-en/range/watson-marlow/300-tube-pumps/323d/) + * Support now implemented (14-08-2019). See [#3786](https://github.com/ISISComputingGroup/IBEX/issues/3786) + +##### Note: Syringe Pumps ##### +1. [WPI Aladdin-1000 Syringe Pump](https://www.wpi-europe.com/products/pumps--microinjection/laboratory-syringe-pumps/al1000-220.aspx) + * Support now implemented (20-06-2019). See [#3787](https://github.com/ISISComputingGroup/IBEX/issues/3787) +1. [WPI SP2xx Syringe Pump](https://www.wpi-europe.com/products/pumps--microinjection/laboratory-syringe-pumps.aspx) - check specific model. + * Support now implemented (05-07-2018). See [#3261](https://github.com/ISISComputingGroup/IBEX/issues/3261) + +##### Note: Tektronix ##### +1. Tektronix Function Generator: [AFG 3021B](https://www.tek.com/datasheet/afg3000-series) + * See also [#237](https://github.com/ISISComputingGroup/IBEX/issues/237) + +##### Note: ISIS Environment Monitor ##### +1. The ISIS Environment Monitor is a device to monitor various environmental properties (temperature, pressure, humidity, etc). There is an existing list of commands and a VI to work from. + +## OFFSPEC Notes ## +OFFSPEC has the following specialist panels/systems: +1. OFFSPEC High Level +1. OFFSPEC Delft System +1. OFFSPEC ISIS Sample Environment +1. OFFSPEC Linkam + * [see Linkam note](#noteLinkam) +1. OFFSPEC Newport Piezo Stage +1. OFFSPEC BH (KEPCO 100-10MG & Keithley 2400) + * [see Kepco note](#noteKepco) & [see Keithley note](#noteKeithley) +1. OFFSPEC Delft RF +1. OFFSPEC PI Motion Stage +1. POLREF Danfysik +1. SURF Galil DIO +1. INTER Galil DIO + +OFFSPEC has the following devices under motion control: +1. benches +1. coarse jaws +1. FOMs (Frame Overlap Mirror) +1. jaws +1. laser gimbal +1. OFFSPEC Analyser +1. point detector +1. Polarizer +1. reflectometer sample stack + +## OFFSPEC SECI Configs ## +Document information about OFFSPEC SECI configs here. + +Configuration Name | Sub-Configurations | Last Accessed | Required | +---------------------------------------|----------------------------------------------------|---------------|----------| +OFFSPEC_place_holder1.conf | - | dd/mm/yyyy | - | +OFFSPEC_place_holder2.conf | - | dd/mm/yyyy | - | + +``` + +
+ +## OFFSPEC Genie Scripts ## +Similarly, Document information about OFFSPEC SECI Genie scripts here. + diff --git a/doc/processes/instrument_details/OffSpec.png b/doc/processes/instrument_details/OffSpec.png new file mode 100644 index 000000000..f1df1b721 Binary files /dev/null and b/doc/processes/instrument_details/OffSpec.png differ diff --git a/doc/processes/instrument_details/PEARL-Instrument-Details.md b/doc/processes/instrument_details/PEARL-Instrument-Details.md index 93167c4be..04c4caf0a 100644 --- a/doc/processes/instrument_details/PEARL-Instrument-Details.md +++ b/doc/processes/instrument_details/PEARL-Instrument-Details.md @@ -23,23 +23,23 @@ PEARL will migrate from the SECI control system to the IBEX control system. ## PEARL Equipment ## The equipment listed below is used on PEARL. Please add new information (e.g. new items of equipment, new notes, information about drivers, etc. to this table). -Manufacturer | Model | Type | Connection | Driver | Notes | ------------- | ------------- | ------------- | ------------- | ------------- | ------------------------------------------- -ISIS | DAE 2 | Detector Electronics | Ethernet | | [see DAE note](#note-dae) +Manufacturer | Model | Type | Connection | Driver | Notes | +------------ | ------------- | ------------- |---------------| ------------- | ------------------------------------------- +ISIS | DAE 2 | Detector Electronics | Ethernet | | [see DAE note](#note-dae) ISIS | Mk3 Chopper | Chopper | Ethernet/.NET | #169 | [see Mk3 Chopper note](#pearl_note-mk3-chopper) | -GALIL | [DMC2280](http://www.galilmc.com/products/dmc-22x0.php) | Motion Controller | Ethernet | [EPICS](http://www.aps.anl.gov/epics/modules/manufacturer.php#Galil%20Motion%20Control) | [see Galil note](#note-galil) | -[LINMOT](http://www.linmot.com/) | [P0x-23](http://www.linmot.com/fileadmin//user_upload/Downloads/software-firmware/servo-drives/linmot-talk-1-3-x/UserManual_1r3_e_recent.pdf) | Linear Motors and Motion Controller | RS-232 | [#2098](https://github.com/ISISComputingGroup/IBEX/issues/2098) | [see LinMot note](#note-linmot) | -??? | ??? | 1 x 4-blade jaws | | | [see Jaws note](#note-jaws) -[Pfeiffer](http://www.pfeiffer-vacuum.com/products/measurement/container.action) | TPG300 | ISIS Vacuum System | RS232 | #216 |[see Pfeiffer note](#note-pfeiffer) -Eurotherm | Temperature Controller | All models at ISIS | RS-232 | [EPICS](http://www.aps.anl.gov/epics/modules/manufacturer.php#Eurotherm) | [see Eurotherm note](#note-eurotherm) -LakeShore | 336| Temperature Controller | RS-232 | [EPICS](http://www.aps.anl.gov/epics/modules/manufacturer.php#Lakeshore) | [see LakeShore note](#note-lakeshore ) -~Oxford Instruments~ | ~ITC503~ | ~Cryogenic System~ | | | [see Oxford Instruments note](#note-oxford-instruments) -Sorensen | High-PT | PSU | | | [see Sorensen note](#note-sorensen) -Pace | 5000 | Pressure Controller | RS-232 | | [see Pace note](#note-pace) -ISIS | PEARL | Pressure Cell Controller | | | [see Pressure Cell Controller note](#note-pressure-cell-controller) -ISIS | PEARL | MMP ~200~ or 210 Pressure Transducer | | | [see PEARL Pressure Transducer note](#note-pearl-pressure-transducer) -ISIS | PEARL | Temperature Controller | | | [see PEARL Temperature Controller note](#note-pearl-temperature-controller) -ISIS | ??? | Cold Valve| | | [see Cold Valve note](#note-cold-valve) +GALIL | [DMC2280](http://www.galilmc.com/products/dmc-22x0.php) | Motion Controller | Ethernet | [EPICS](http://www.aps.anl.gov/epics/modules/manufacturer.php#Galil%20Motion%20Control) | [see Galil note](#note-galil) | +[LINMOT](http://www.linmot.com/) | [P0x-23](http://www.linmot.com/fileadmin//user_upload/Downloads/software-firmware/servo-drives/linmot-talk-1-3-x/UserManual_1r3_e_recent.pdf) | Linear Motors and Motion Controller | RS-232 | [#2098](https://github.com/ISISComputingGroup/IBEX/issues/2098) | [see LinMot note](#note-linmot) | +??? | ??? | 1 x 4-blade jaws | | | [see Jaws note](#note-jaws) +[Pfeiffer](http://www.pfeiffer-vacuum.com/products/measurement/container.action) | TPG300 | ISIS Vacuum System | RS232 | #216 |[see Pfeiffer note](#note-pfeiffer) +Eurotherm | Temperature Controller | All models at ISIS | RS-232 | [EPICS](http://www.aps.anl.gov/epics/modules/manufacturer.php#Eurotherm) | [see Eurotherm note](#note-eurotherm) +LakeShore | 336| Temperature Controller | RS-232 | [EPICS](http://www.aps.anl.gov/epics/modules/manufacturer.php#Lakeshore) | [see LakeShore note](#note-lakeshore ) +~Oxford Instruments~ | ~ITC503~ | ~Cryogenic System~ | | | [see Oxford Instruments note](#note-oxford-instruments) +Sorensen | High-PT | PSU | | | [see Sorensen note](#note-sorensen) +Pace | 5000 | Pressure Controller | RS-232 | | [see Pace note](#note-pace) +ISIS | PEARL | Pressure Cell Controller | | | [see Pressure Cell Controller note](#note-pressure-cell-controller) +ISIS | PEARL | MEAS M905 Pressure Transducer | RS485 | | [see PEARL Pressure Transducer note](#note-pearl-pressure-transducer) +ISIS | PEARL | Temperature Controller | | | [see PEARL Temperature Controller note](#note-pearl-temperature-controller) +ISIS | ??? | Cold Valve| | | [see Cold Valve note](#note-cold-valve) ##### Note: DAE ##### Main Detector banks + one working fixed monitor upstream of sample position. diff --git a/doc/specific_iocs/motor_extensions/Sample-Changer-Support-Module.md b/doc/specific_iocs/motor_extensions/Sample-Changer-Support-Module.md index d2feb5d47..d36ced465 100644 --- a/doc/specific_iocs/motor_extensions/Sample-Changer-Support-Module.md +++ b/doc/specific_iocs/motor_extensions/Sample-Changer-Support-Module.md @@ -9,6 +9,24 @@ An example sampleChanger + motionSetpoints configuration can be found in [sample - `SLOT_DETAILS_FILE`: Path to a slot details XML file. - `SAMPLE_LKUP_FILE`: Path to the sample.txt file that should be written by this module +## Background + +There are two different models of two-tier sample changer at ISIS. Both models are very similar; from the point of view of the control system they are effectively the same. The earlier of the two models is used on SANS2D [pictured ​here](http://www.isis.stfc.ac.uk/sample-environment/soft-condensed-matter/sample-changers-and-cell-racks/kit/two-tiered-sample-changer/two-tiered-sample-changer14341.html). The newer model is used on LARMOR. + +Each tier on the sample changer can hold two racks side-by-side. Different types of rack are used to hold different types of sample cartridge. The number of cartridges per rack depends on the size of the cartridge - the larger the cartridge, the fewer cartridges will fit in a rack. At present there are 3 types of rack (holding different styles of sample cartridge). + +1. Rectangular – 10 position +1. Double stopper – 7 position +1. Banjo style (with 1, 2 or 5mm gaps) – 7 position + +Racks can be mixed and matched as required. For example, the sample changer could be configured with (say): a 10-position, rectangular rack and a 7-position, Banjo style rack on the top tier and two 7-position, Double stopper racks on the bottom tier, which would allow an experiment to use 31 samples. A picture of the [LARMOR sample changer](http://www.facilities.rl.ac.uk/isis/computing/ICPdiscussions/Larmor/LAMOR%20RACK%20VIEW.jpg) shows an alternative configuration. + +With the current types of rack, the two tier sample changer can hold a maximum of 40 samples (4 x 10-position rectangular racks; 2 on each tier). Diagrams of various types of Banjo-style cartridges are available: [Banjo 1mm gap)](http://www.facilities.rl.ac.uk/isis/computing/ICPdiscussions/Larmor/BANJO-CELL-RACK.pdf), [Banjo 2mm gap)](http://www.facilities.rl.ac.uk/isis/computing/ICPdiscussions/Larmor/BANJO-CELL-RACK-2MM.pdf), [Banjo 5mm gap)](http://www.facilities.rl.ac.uk/isis/computing/ICPdiscussions/Larmor/BANJO-CELL-RACK-5MM.pdf). + +The positions of the samples in each rack are known. Motors are used to drive the tiers, so that each sample can be positioned in the beam. + +The Sample Changer IOC needs to allow a scientist to select any sample loaded into the sample changer. The maximum number of positions is 40 (based on current rack designs, but this could change in the future). Each position comprises a name and an (x, y) coordinate pair. The scientist will select positions by their names. + ## What to do after changing racks 1. Edit Instrument/Settings/machinename/configurations/motionSetPoints/sampleChanger.xml setting the `rack_type`, `xoff` and `yoff` attributes. @@ -107,4 +125,30 @@ and the offset. This if the slot has x=1, the position has x=2 and the slot has The x position corresponds to machinename:username:MOT:STACK:Y and the y position corresponds to machinename:username:MOT:STACK:ZLO. -Position names are created by concatenating the position name and the slot name (or `sample_suffix`, see above). \ No newline at end of file +Position names are created by concatenating the position name and the slot name (or `sample_suffix`, see above). + +## Images + +### Banjo rack +![Banjo](sans_sample_changer/131144968-496a52d1-0fa9-4b43-9d9d-ca58974193f8.jpg) + +### Banjo Sample +![Banjo_sample](sans_sample_changer/131144984-9d347067-7893-4a07-ab4d-6782fa2ea74e.jpg) + +### Skinny Rack +![Skinny](sans_sample_changer/131145026-117618fb-37f0-47a4-b3a4-28fa33bc38f6.jpg) + +### Skinny Sample +![Skinny_sample](sans_sample_changer/131145043-69114cdd-ef52-42fe-82d0-48a7e3c48ee6.jpg) + +### Wide Rack +![Wide_SANS2D](sans_sample_changer/131146548-1297c2a1-b7a4-4ae6-93f7-8929499930b5.jpg) + +### Beam position Calibration +![Beam_calibration_sample](sans_sample_changer/131145008-a829e99d-ffb1-408b-9f17-a9c021388417.jpg) + +### Sample Changer X Axis movement +![Sample_changer_X_Axis_GIF](sans_sample_changer/131147524-27f89f1e-caf8-4714-a760-25be4da85780.gif) + +### Sample Changer X and Y Axis Movement +![Sample_changer_X_Y_GIF (2)](sans_sample_changer/131150501-7d3805e1-1a08-4175-881a-7788a711c58d.gif) diff --git a/doc/specific_iocs/motor_extensions/ZOOM-DMS.md b/doc/specific_iocs/motor_extensions/ZOOM-DMS.md new file mode 100644 index 000000000..70bb7b1ec --- /dev/null +++ b/doc/specific_iocs/motor_extensions/ZOOM-DMS.md @@ -0,0 +1,23 @@ +# ZOOM Detector motion system + +## Setup + +In your config folder, set up a file `NDWxxxx\configurations\galil\axes.cmd` with the following content: + +``` +$(IFDMC01) dbLoadRecords("$(AXIS)/db/axis.db","P=$(MYPVPREFIX)MOT:,AXIS=DISK:BEAMSTOP1:X,mAXIS=MTR0101") +$(IFDMC01) dbLoadRecords("$(AXIS)/db/axis.db","P=$(MYPVPREFIX)MOT:,AXIS=DISK:BEAMSTOP1:Y,mAXIS=MTR0102") +$(IFDMC01) dbLoadRecords("$(AXIS)/db/axis.db","P=$(MYPVPREFIX)MOT:,AXIS=DISK:BEAMSTOP2:X,mAXIS=MTR0103") +$(IFDMC01) dbLoadRecords("$(AXIS)/db/axis.db","P=$(MYPVPREFIX)MOT:,AXIS=DISK:BEAMSTOP2:Y,mAXIS=MTR0104") +$(IFDMC01) dbLoadRecords("$(AXIS)/db/axis.db","P=$(MYPVPREFIX)MOT:,AXIS=STRIP:BEAMSTOP,mAXIS=MTR0105") +$(IFDMC01) dbLoadRecords("$(AXIS)/db/axis.db","P=$(MYPVPREFIX)MOT:,AXIS=DETECTORS,mAXIS=MTR0106") +$(IFDMC01) dbLoadRecords("$(AXIS)/db/axis.db","P=$(MYPVPREFIX)MOT:,AXIS=BAFFLE,mAXIS=MTR0107") +``` + +This allows us to create "aliases" for the DMS axes. It assumes we are using IOC `GALIL_01`. If using `GALIL_0n`, change `IFDMC01` to `IFDMC0n` and `MTR010m` to `MTR0n0m` (i.e. `MTR0101` becomes `MTR0201` for `n=2`). Unless otherwise stated, we'll assume we're working with `GALIL_01`. + +**Don't forget the new line at the end of the file or the final line will not be processed and the Baffle will appear disconnected.** + +Start `GALIL_01`. Don't forget to set the appropriate macros. + +Create a synoptic with component `detector motion system`, no synoptic macros are required. \ No newline at end of file diff --git a/doc/specific_iocs/motor_extensions/ZOOM-PGC.md b/doc/specific_iocs/motor_extensions/ZOOM-PGC.md new file mode 100644 index 000000000..fcbcf915f --- /dev/null +++ b/doc/specific_iocs/motor_extensions/ZOOM-PGC.md @@ -0,0 +1,48 @@ +# ZOOM Polariser, Guide and Collimator + +## Introduction + +This is a single-axis Galil-controlled device that has 3 pre-defined stop positions. + +## Setup + +To set up the PGC, complete the following steps: + +### Create the Galil axis configuration + +Go to `C:\Instrument\Settings\Config\NDX[DEVICE_NAME]\configurations\galil` and create a file called `motionsetpoints.cmd` if one doesn't already exist. Add the following: + +``` +$(IFDMC01) epicsEnvSet "LOOKUPFILE2" "$(ICPCONFIGROOT)/motionSetPoints/pgc.txt" +$(IFDMC01) motionSetPointsConfigure("LOOKUPFILE2","LOOKUPFILE2") +$(IFDMC01) dbLoadRecords("$(MOTIONSETPOINTS)/db/motionSetPoints.db","P=$(MYPVPREFIX)LKUP:PGC:,TARGET_PV1=$(MYPVPREFIX)MOT:MTR0102,TARGET_RBV1=$(MYPVPREFIX)MOT:MTR0102.RBV,TARGET_DONE=$(MYPVPREFIX)MOT:MTR0102.DMOV,TOL=1,LOOKUP=LOOKUPFILE2") + +``` + +**Don't forget to add a new line at the end of the final or the final line won't be read** + +Note that there are several points of customisation here: + 1. The `01` in `IFDMC01` refers to the Galil number. If you are using IOC `GALIL_02` then this should instead be `IFDMC02` + 1. References to `MTR0102` should point to the motor you wish to use. If, for instance, you are using `GALIL_06`, axis 3, this should be `MTR0603`. Be careful to replace all the references, there are 3. + 1. Make sure that the lookup file, `LOOKUPFILE2` is unique in this file. You might have to use a difference name if `LOOKUPFILE2` is already taken. So long as the name is consistent, it will work. + +### Set up the motion set points +Create a file called `C:\Instrument\Settings\Config\NDX[DEVICE_NAME]\configurations\motionSetPoints\pgc.txt`. You may have to create the directory as well if it doesn't exist already. Add the following: + +``` +Polariser -2 +Guide 0 +Collimator 2 +``` + +There are several points of customisation: + +1. The names provide a guide to which position corresponds to which component. You can name these however you like and will be used to populate the buttons in the OPI. +1. The second column is for the motor positions corresponding to each component. These will have to be set corresponding to the device setup. + +### Set up the OPI + +Open a PGC OPI as normal either via a synoptic of the devices screen. Typical value for the macros are + +1. `PGC`: `PGC`. This will only be different if you've changed the prefix in `motionsetpoints.cmd`. That is not recommended. +1. `MM`: `MOT:MTR0102`. This corresponds to the motor record being used for the PGC and, combined with the `MOT` prefix, will correspond to the value you used when setting up `motionsetpoints.cmd` \ No newline at end of file diff --git a/doc/specific_iocs/motor_extensions/ZOOM-sample-stack.md b/doc/specific_iocs/motor_extensions/ZOOM-sample-stack.md new file mode 100644 index 000000000..bf9e4176b --- /dev/null +++ b/doc/specific_iocs/motor_extensions/ZOOM-sample-stack.md @@ -0,0 +1,19 @@ +# ZOOM Sample Stack + +The sample stack is set up on zoom using an `axes.cmd` file. The file should be in `Instrument/Settings/config/NDWxxxx/configurations/galil/axes.cmd` + +An example of an `axes.cmd` file is given below: +``` +$(IFDMC01) dbLoadRecords("$(AXIS)/db/axis.db","P=$(MYPVPREFIX)MOT:,AXIS=STACK:X,mAXIS=MTR0101") +$(IFDMC01) dbLoadRecords("$(AXIS)/db/axis.db","P=$(MYPVPREFIX)MOT:,AXIS=STACK:Y,mAXIS=MTR0102") +$(IFDMC01) dbLoadRecords("$(AXIS)/db/axis.db","P=$(MYPVPREFIX)MOT:,AXIS=STACK:ZHI,mAXIS=MTR0103") +$(IFDMC01) dbLoadRecords("$(AXIS)/db/axis.db","P=$(MYPVPREFIX)MOT:,AXIS=STACK:THETA,mAXIS=MTR0104") +$(IFDMC01) dbLoadRecords("$(AXIS)/db/axis.db","P=$(MYPVPREFIX)MOT:,AXIS=STACK:PSI,mAXIS=MTR0105") +$(IFDMC01) dbLoadRecords("$(AXIS)/db/axis.db","P=$(MYPVPREFIX)MOT:,AXIS=STACK:CHI,mAXIS=MTR0106") +$(IFDMC01) dbLoadRecords("$(AXIS)/db/axis.db","P=$(MYPVPREFIX)MOT:,AXIS=STACK:ZLO,mAXIS=MTR0107") +$(IFDMC02) dbLoadRecords("$(AXIS)/db/axis.db","P=$(MYPVPREFIX)MOT:,AXIS=STACK:XRAIL,mAXIS=MTR0201") +$(IFDMC02) dbLoadRecords("$(AXIS)/db/axis.db","P=$(MYPVPREFIX)MOT:,AXIS=STACK:YRAIL,mAXIS=MTR0202") +``` +This will set up the first 7 motors on one GALIL controller, and the last two motors (which relate to movement along/perpendicular to a set of rails) on another GALIL controller. Depending on the final setup, these values will need to be adjusted so that each PV points at the correct controller. + +NOTE: `STACK:XRAIL` is not actually a galil controller, but a Beckhoff motor controller. From IBEX's perspective, this is a read only device (a separate, independent system will be used to set the values). \ No newline at end of file diff --git a/doc/specific_iocs/motor_extensions/sans_sample_changer/131144968-496a52d1-0fa9-4b43-9d9d-ca58974193f8.jpg b/doc/specific_iocs/motor_extensions/sans_sample_changer/131144968-496a52d1-0fa9-4b43-9d9d-ca58974193f8.jpg new file mode 100644 index 000000000..03917fc3a Binary files /dev/null and b/doc/specific_iocs/motor_extensions/sans_sample_changer/131144968-496a52d1-0fa9-4b43-9d9d-ca58974193f8.jpg differ diff --git a/doc/specific_iocs/motor_extensions/sans_sample_changer/131144984-9d347067-7893-4a07-ab4d-6782fa2ea74e.jpg b/doc/specific_iocs/motor_extensions/sans_sample_changer/131144984-9d347067-7893-4a07-ab4d-6782fa2ea74e.jpg new file mode 100644 index 000000000..e2bafb72f Binary files /dev/null and b/doc/specific_iocs/motor_extensions/sans_sample_changer/131144984-9d347067-7893-4a07-ab4d-6782fa2ea74e.jpg differ diff --git a/doc/specific_iocs/motor_extensions/sans_sample_changer/131145008-a829e99d-ffb1-408b-9f17-a9c021388417.jpg b/doc/specific_iocs/motor_extensions/sans_sample_changer/131145008-a829e99d-ffb1-408b-9f17-a9c021388417.jpg new file mode 100644 index 000000000..f4474ba8b Binary files /dev/null and b/doc/specific_iocs/motor_extensions/sans_sample_changer/131145008-a829e99d-ffb1-408b-9f17-a9c021388417.jpg differ diff --git a/doc/specific_iocs/motor_extensions/sans_sample_changer/131145026-117618fb-37f0-47a4-b3a4-28fa33bc38f6.jpg b/doc/specific_iocs/motor_extensions/sans_sample_changer/131145026-117618fb-37f0-47a4-b3a4-28fa33bc38f6.jpg new file mode 100644 index 000000000..576e76620 Binary files /dev/null and b/doc/specific_iocs/motor_extensions/sans_sample_changer/131145026-117618fb-37f0-47a4-b3a4-28fa33bc38f6.jpg differ diff --git a/doc/specific_iocs/motor_extensions/sans_sample_changer/131145043-69114cdd-ef52-42fe-82d0-48a7e3c48ee6.jpg b/doc/specific_iocs/motor_extensions/sans_sample_changer/131145043-69114cdd-ef52-42fe-82d0-48a7e3c48ee6.jpg new file mode 100644 index 000000000..4c0b2df57 Binary files /dev/null and b/doc/specific_iocs/motor_extensions/sans_sample_changer/131145043-69114cdd-ef52-42fe-82d0-48a7e3c48ee6.jpg differ diff --git a/doc/specific_iocs/motor_extensions/sans_sample_changer/131146548-1297c2a1-b7a4-4ae6-93f7-8929499930b5.jpg b/doc/specific_iocs/motor_extensions/sans_sample_changer/131146548-1297c2a1-b7a4-4ae6-93f7-8929499930b5.jpg new file mode 100644 index 000000000..b0e5291b5 Binary files /dev/null and b/doc/specific_iocs/motor_extensions/sans_sample_changer/131146548-1297c2a1-b7a4-4ae6-93f7-8929499930b5.jpg differ diff --git a/doc/specific_iocs/motor_extensions/sans_sample_changer/131147524-27f89f1e-caf8-4714-a760-25be4da85780.gif b/doc/specific_iocs/motor_extensions/sans_sample_changer/131147524-27f89f1e-caf8-4714-a760-25be4da85780.gif new file mode 100644 index 000000000..eb5bc55bd Binary files /dev/null and b/doc/specific_iocs/motor_extensions/sans_sample_changer/131147524-27f89f1e-caf8-4714-a760-25be4da85780.gif differ diff --git a/doc/specific_iocs/motor_extensions/sans_sample_changer/131150501-7d3805e1-1a08-4175-881a-7788a711c58d.gif b/doc/specific_iocs/motor_extensions/sans_sample_changer/131150501-7d3805e1-1a08-4175-881a-7788a711c58d.gif new file mode 100644 index 000000000..3b03afb4c Binary files /dev/null and b/doc/specific_iocs/motor_extensions/sans_sample_changer/131150501-7d3805e1-1a08-4175-881a-7788a711c58d.gif differ diff --git a/doc/specific_iocs/temp_controllers/Eurotherm.md b/doc/specific_iocs/temp_controllers/Eurotherm.md index 89575d777..c45beda7e 100644 --- a/doc/specific_iocs/temp_controllers/Eurotherm.md +++ b/doc/specific_iocs/temp_controllers/Eurotherm.md @@ -87,6 +87,27 @@ The scaling factors are always powers of 10. To determine the scaling factors, start the IOC in modbus mode, then for each parameter on each sensor, check using the Eurotherm menus that the number in the Eurotherm itself equals what IBEX reports. **Check carefully** as, for example, a PID parameter of `1.5` looks quite similar to `15`, but will cause temperature control to be entirely incorrect! +## Read rates + +Eurotherms come in a number of different configurations, namely crates with varying number of sensors. For typical baud rates, there is a limit to how much data can be communicated across a serial line. This have proven problematic in the past for configurations using 3 or more sensors. In the latest version of the IOC (3.0.0 at time of writing), the frequency of requests per sensor is inversely proportional to the number of sensors, so the overall request rate stays constant. + +The reads are split between slow reads and fast reads. The slow reads are split into 5 blocks. When communicating with the Eurotherm, the IOC will query each block of slow reads sequentially along with a fast read. In other words, the read sequence for each sensor goes: + +``` +Read slow block 1 +Read fast +Read slow block 2 +Read fast +... +Read slow block 5 +Read fast block +[Repeat] +``` + +The time taken for each block is defined as the variable `SECONDS_PER_READ` in `.../ioc/EUROTHRM/iocBoot/iocEUROTHRM-IOC-01/st-timing.cmd` + +The with the `SECONDS_PER_READ` set to 0.08 this would mean each block takes roughly 0.5s per sensor; `second per read [0.08] * (number of reads in a fast block + number of reads in a slow block [3 + 3]) * num of read`. There are 5 blocks in total so all parameters are reread every 2.5s per sensor. On a 3 sensor crate this would be a temperature read every 1.5s and a refresh of all parameters every 7.5s. + ## Troubleshooting - If you're having trouble with the Eurotherm-based automatic needle valve controller (i.e. on WISH), see [Automatic needle valve controller wiki](Automatic-Needle-Valve-Controller) @@ -95,4 +116,8 @@ To determine the scaling factors, start the IOC in modbus mode, then for each pa If the P,I,D, Max Output all look OK, and the setpoint readback suggests a setpoint has been sent, but the heater output remains 0, then one possibility is that the Eurotherm is in Manual not automatic mode - there is a Manual/Automatic switch on the front panel on the Eurotherm hardware. The Eurotherm IOC does not tell the Eurotherm how much power to deliver directly, it sends P,I,D and max output and the Eurotherm itself decides how much power to deliver (heater readback) - +## Resources + +- [Eurotherm IOC Repository](https://github.com/ISISComputingGroup/EPICS-ioc/tree/master/EUROTHRM) +- [Eurotherm IOC System Tests](https://github.com/ISISComputingGroup/EPICS-IOC_Test_Framework/blob/master/tests/eurotherm.py) +- [Eurotherm2k Support Repository](https://github.com/ISISComputingGroup/EPICS-eurotherm2k/tree/master) diff --git a/doc/spelling_wordlist.txt b/doc/spelling_wordlist.txt index 8a8dbe86f..b5610ffa4 100644 --- a/doc/spelling_wordlist.txt +++ b/doc/spelling_wordlist.txt @@ -148,6 +148,7 @@ cryo Cryocon cryomag cryomagnet +Cryomagnetics cryomagnets cryosms cset