File: README

This application currently runs on epics R7.0.3.1-1.0 and architecture - RTEMS-beatnik
Use recommended version rtems-4.10.2 rtems_p3 ssrlApps_p2
Ensure your IOCs boot with DHCP

=============== Automatic arhive list generation =============
Archive notes:
There are two basic archiving methods:

       1.  Archived "on change" ("monitor" mode).  In this mode an Archive Engine
           (an EPICS client) requests a CA monitor (that is, it subscribes to
           changes and the engine store all the values the server sends out).
           The archived PV ADEL value determines when values are sent.

       2.  Sampled periodically at a specified interval in seconds ("scan" mode).
           For sample intervals larger than a default (20 seconds), an Archive
           Engine requests a value from the CA server at the specified interval.
           For sample intervals less than or equal to the default (20 seconds),
           instead of actively requesting a value from the CA server at the specified
           interval an Archive Engine establishes a monitor and only saves values at the
           specified interval.

To archive a PV, add the PV to the appropriate template file in srcArchive/common folder. Archive files will be generated in <TOP>/archive directory.
Currently, <IOC>.archive file needs to be manually copied over to $IOC_DATA/$IOC/archive folder. 
The PVs will automatically be added to archive engine.

This will not work if you need to make any modification to PV name. Send the information directly to systems group.


================== Hardware ==================
The Motion Control Application uses the following controls hardware

Stepper Motors:
VME Hytec 8002 IP Carrier and 8601 Smart Motor Controller (SMC) IPAC Module.

Note: Hytec products are no longer available
https://www.electronicsarena.co.uk/companies/hytec-electronics/products
http://www.newwoodsolutions.co.uk/DataSheetHtml/8601.html
http://www.newwoodsolutions.co.uk/DataSheetHtml/8601.html


The HytecIP-SM-8601 is a single-width Industry Pack stepper motorcontroller producing four channels of logic level controlsignals for an external driver system. To see what Hytec offers for thesesystems follow one of these links:_
For small (<1amp) motors, the 8909U lowcost L/R driver.
For larger (up to 6amps bipolar drive) motors, the MDS8.

An EPICsdriver is available for this card. Allregisters exist within the Industry Pack I/O, ID and Interrupt areas; nomemory is present.

 Each channel has thefollowing features:- 
* A 32-bit step register, which sets the number of steps in the nextmovement, writeable and readable at any time, which counts down to '0'. 
* A 32-bit absolute position up/down counter, which records movements(writeable and readable). This counter counts all movements includingJOG. This counter may follow step pulses sent out from the board orcount encoder pulses from an external incremental encoder withquadrature outputs.
* A 16-bit Start/Stop Speed Register, which sets the speed at which amovement will start, programmed in steps per second.
* A 16-bit High Speed Register, which sets the speed at which the motorwill run after accelerating, programmed in steps per second.
* A 16-bit Ramp Rate Register, which sets the rate at which speed willincrease or decrease during ramping, programmed in steps per second persecond. Minimum value 64 s/s/s.
* A 16-bit Control and Status Register through which the status of thedrive, the controller and the limit switches can be observed (run/stop,hit limit, driver dead etc.).
* A 16-bit Interrupt Mask Register through which controls which CSR bitsmay generate interrupt.
* Counters can be read on the fly via a shadow register.
* A * Common Start*  register through which one or more channels can bestarted simultaneously, visible within each channel* s register area(write only).
* Each channel has four logic outputs and 8 logic inputs to cater for awide variety of applications.
* The ability to read the module identity, manufacturer, model, revisionsand serial number from an onboard ID ROM.

Size: Single widthIndustry Pack 1.8ins x 3.9 ins 
Operating temp:       0to 45 deg C ambient 
Number ofchannels: 4 motors  
Max. count: 32 bits. 
Data format: Binary 
Max steprate:   64KHz 
Input levels: 
TTL compatiblewith jumper selectable 4.7kW resistor pull-up or pull-down.
 
Power: 
+5V @180mA typical 
 

Gated ADC:
--------------
The Model V965 is a 1-unit wide VME 6U module housing 16 Charge-to-Digital 
Conversion channels with current integrating negative inputs (50 *  impedance). For each 
channel, the input charge is converted to a voltage level by a QAC (Charge to Amplitude 
Conversion) section. Each QAC output is then converted by two ADCs in parallel; one 
ADC is preceded by a x1 gain stage, the other by a x81 gain stage: a dual input range is 
then featured: 0 ÷ 800 pC (200 fC LSB) and 0 ÷ 100 pC (25 fC LSB); this allows to avoid 
saturation with big charge pulses while increasing resolution with small ones. 


The outputs of the QAC sections are multiplexed and subsequently converted by two fast 
12-bit ADCs. The ADCs use a sliding scale technique to improve the differential non-
linearity. Moreover the module allows Zero and Overflow suppression.  

 
The Mod. V965 converted pulses are stored into a VME-accessible 32 events buffer. 

The VME interface is VME64X standard compliant and features the A24/A32 and 
MultiCast addressing modes. The data readout occurs either in D32, BLT32, MBLT64 
mode, or in daisy chain with 32/64 bit Chained Block Transfers. The module features a 
fully programmable RORA interrupter.  
 
The board hosts the P1 and P2 VME connectors and fits into both V430 and standard 
VME 6U crates. It also supports the * live insertion* , allowing the User to insert (or 
remove) the board into (or from) the crate without switching it off. 
The Mod. V965A is the 8 channel version of the board, featuring all the other 
characteristics of the V965, except as otherwise indicated. 
  
LVDT Signals:
----------------
Three different type of VME modules are used to read
the LVDT signal, the Highland V550 and the Acromag IP330.


The Highland V550 V550 is a 6U, one-slot VME module which will acquire
 position data from up to eight LVDT (linear variable
 differential transformer) position sensors. The LVDT
 sensors are excited by an ultrastable synthesized
 sinewave generator, and conditioned by a precision
 16-bit A/D converter  followed by digital signal processing.
 The resident microprocessor supervises scanning and
 signal conditioning, and places updated  position data
 in VME-accessible dual-ported data registers for instant
 access from the VME bus.

 The V550 provides 16-bit resolution, allowing sub-micron
 measurement with commercially available LVDTs. Users may
 select a range of DSP filtering factors to trade off position
 noise against acquisition rate.

 The V550 provides unprecedented signal acquisition accuracy.
 Total RMS error (including absolute error, noise, and all drifts)
 is typically under 1.5 LSBs, equivalent to less than 25 PPM of
 full-scale span.


IP330A Industrial I/O Pack (IP) modules provide fast, high resolution A/D conversion.

 The IP330 has many features to improve your overall system throughput rate.
 You can scan all channels or define a subset for more frequent sampling.
 Burst mode scans selected channels at the maximum conversion rate. Uniform
 mode performs conversions at user-defined intervals. Both modes can scan
 continuously, or execute a single cycle upon receiving a trigger.
 "Mail box" memory allows the CPU to read the latest data in 32 storage
 buffer registers without interrupting the A/D converter.


The Industrial I/O Pack (IP) Series IP330A module is a 
precision 16-bit, high density, single size IP, with the capability to 
monitor 16 differential or 32 single-ended analog input channels.  
The IP330A utilizes state of the art Surface Mounted Technology 
(SMT) to achieve its high channel density.  Four units may be 
mounted on a carrier board to provide up to 64 differential or 128 
single-ended analog input channels per 6U-VMEbus system slot or 
ISA bus (PC/AT) system slot.  The IP330A offers a variety of 
features which make it an ideal choice for many industrial and 
scientific applications as described below. 


Model Operating Temperature Range 
IP330A 0 to 705 deg C 
IP330AE -40 to 85 deg C 

The Hytec IP-ADC-8413 is an Industry Pack that provides 16 channels of
simultaneously sampled analogue digitisation with the following characteristics:-
*	16 independent channels (one ADC per input)
*	16 bits resolution * 15 bits no missing codes
*	Single full-scale trim for hardware gain adjustment.
*	Software calibration by software driver possible using stored offset and gain parameters.
*	True full differential inputs.
*	+/-10V full-scale standard programmable to +/-5V full-scale resolution all inputs. 
*	Front-end instrumentation amplifiers can be factory set for gains of up to x1000.
*	FIFO memories for single sample and triggered sample readout (256K post-trigger samples)
*	Low offset error - +/- 2.5mV without software calibration. (+/-2LSBs after software calibration)
*	Low gain error - +/- 0.5% FS without software calibration.(+/-2LSBs after software calibration)
*	Low error drift  -  2ppm per deg C
*	High input impedance * 1Gohms.
*	Up to 160KHz sampling rate 
*	Simultaneous sampling * 70ns aperture delay time. Uncertainty time and channel matching 3ns.
*	System to plant isolation to 100V when externally powered by DC/DC converter option
*	Serial number, PCB issue and firmware issue held in ID PROM
*	8/32MHz system clock operation 
*	EPICS driver support

https://www.highlandtechnology.com/DSS/V550DS.shtml
https://www.slac.stanford.edu/grp/lcls/controls/global/hw/users_guides/slaconly/
https://www.slac.stanford.edu/grp/lcls/controls/global/hw/users_guides/vme/ip330_485j.pdf

Timing:
--------
Micro-Research Finland Oy VME-EVR-230 PCI Module
The VME-EVR-230 is a successor of the VME-EVR-200 which was designed for the Diamond Light Source. 
This board is targeted for subsystems that do not require the best timing precision. 
The performance is similar to the PMC and cPCI versions of the Event Receiver.

http://www.mrf.fi/index.php/vme-products/76-vme-event-receiver-wo-rf-vme-evr-230

================== EMAIL ==================
Sector 24:
BLM  LCLS-II Motion 

-----Original Message----
From: Fisher, Alan S. 
Sent: Thursday, September 29, 2016 5:30 PM
To: Luchini, Kristi L.
Subject: RE: LCLS-II Beam Loss Monitor in LI24

Hi Kristi,

 

I need four channels for three types of detector, with different requirements. Here’s what I know.

 

CAEN VME HV Module
--------------------
Polarity           Unipolar, and can only produce negative voltages. Because it’s unipolar, the HV is are 
                   set without regard for the sign, by asking for the absolute value of the voltage. When you ask for an 
                   output of 500 V, a meter confirms that the output is -500.

Archiver           Archive the voltages.

 

CAEN V965 Charge Digitizer
---------------------------
Polarity           Accepts only negative pulses and won't work with any offset that is even slightly 
                   positive. This is fine for photomultipliers, which is what they were developed for, and this is how we use them.

Range              There are two ADCs, with a low-signal ADC up to 100 pC and a high-signal ADC up to 
                   900 pC. My typical pulse might be 0.5 V into 50 ohms for 5 ns, or 50 pC. This is adjustable to some extent with the bias voltage.
Alarms             We will not need alarms for these channels, since they will be for testing rather than for MPS.

BSA                We want BSA data from these channels. 

Archiver           Archive all readings to compare losses to the nearby PICs and LIONs.

 

Detector 1
-----------
Type                  Diamond detector, standard polycrystalline type (called B2 by the manufacturer, Cividec)
Bias polarity         It can be biased either positive or negative. A negative bias gives an output pulse that is 
                      negative going and so compatible with the CAEN digitizer.
Bias                 The typical bias is ±500 V. We will use -500 V.
LOLO                  200 V
LO                    400 V
HI                    550 V
HIHI                  600 V
Limit               Set a software limit so that a user cannot request more than 600 V.
Current             I don’t know the specification for the current for this device, but it’s essentially a 10-pF 
                    capacitor. At 500 V, this amounts to 5 nC of charge. Only a fraction will normally be collected in each 
                    pulse. In the worst case, we have huge losses at 120 Hz, and it loses all its charge each time. That’s an 
                    average current of 600 nA, which is tiny for these supplies. I’ll set the channel for more.
Trip current        200 uA
Location            Between the first and second bends of BC2
Unit number         BLMD:LI24:740

 

Detector 2
-----------
Type                  Diamond detector, high-radiation polycrystalline type (called B4 by Cividec)
Bias polarity         It can be biased either positive or negative. A negative bias gives an output pulse that is 
                      negative going and so compatible with the CAEN digitizer.
Bias                  The typical bias is ±100 V. We will use -100 V.
LOLO                     30 V
LO                       60 V
HI                      150 V
HIHI                    180 V
Limit                   Set a software limit so that a user cannot request more than 180 V.
Trip current           200 uA
Location               Just after the second bend of BC2, near the energy collimator CE21
Unit number            BLMD:LI24:807

 

Detector 3
-------------
Type                  Same as Detector 1
Location              Between the third and fourth bend of BC2
Unit number           BLMD:LI24:860

 

Detector 4
----------
Type                  Photomultiplier collecting Cherenkov light from an optical fiber. We may also test a 
                      silicon photomultiplier (SiPM) there, but that will be later. The voltage needed for an SiPM is only +5 V 
                      using Hamamatsu’s power module, but I will provide that separately for my test.
Bias polarity         Negative
Bias                  The typical bias is -750 V. The absolute limit is -1000 V.

LOLO                  100 V
LO                    300 V
HI                    900 V
HIHI                  1000
Limit                 Set a software limit so that a user cannot request more than 1000 V.
Current               The resistor bias chain draws 360 uA when the bias voltage is set to the limit of 1000 V.
Trip current          800 uA
Location              The PMT will be in the Gallery directly above the LI24 wire scanner, and so we’ll borrow its unit number.
Unit number           BLMF:LI24:707

 

 

Let me know if I left something out.

 

Alan

================== End of EMAIL ==================


