Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Attributes that comprise the physics interface. Scalar unless otherwise specified

R/WNameDescription

SRF Example

(CM 2 Cavity 1)

Gun/Buncher Example
R/WRFMODECTRLRF mode control (SEL, SELA, SELAP, SEL Raw, Pulse, Chirp) ACCL:L1B:0210:RFMODECTRL N/A
RRFMODEReadback of current RF mode (SEL, SELA, SELAP, SEL Raw, Pulse, Chirp) ACCL:L1B:0210:RFMODE
R/WRFCTRLCavity on/off control. Off = LLRF drive set to 0. (SSA control will be different.) ACCL:L1B:0210:RFCTRL
RRFSTATEReadback of cavity RF on/off state ACCL:L1B:0210:RFSTATE

 N/A

RRFREADYFORBEAM

Indicates cavity is in an okay state for beam operation. Possible states:

Ready (numerical 1) = cavity RF is On and mode is SELAP

Not ready (numerical 0) = Ready criteria not met

ACCL:L1B:0210:RFREADYFORBEAM
R/WADES

Operation amplitude setpoint (MV)

(For SRF, this setting is used in SEL, SELA, SELAP modes.)

 ACCL:L1B:0210:ADES
RGDESGradient setpoint (MV/m) - readback only ACCL:L1B:0210:GDES N/A
RSEL_ASETSRF amplitude setpoint in SEL Raw, Pulse, Chirp modes. Is in units of % of full drive scale. ACCL:L1B:0210:AACT N/A
RGACTMeasured gradient from cavity probe (MV/m) ACCL:L1B:0210:GACT
R/WGACTMeasured gradient from cavity probe (MV/m) ACCL:L1B:0210:GACT
R/WAMAX

Maximum allowable amplitude (MV) - experts only

 ACCL:L1B:0210:AMAX
RGMAX

Maximum allowable gradient (MV/m) - readback only

 ACCL:L1B:0210:GMAX
R/WPDESOperation phase setpoint (degrees, where 0 is on-crest) ACCL:L1B:0210:PDES
RPACTMeasured phase from cavity probe (degrees) ACCL:L1B:0210:PACT
R/WPREFa.k.a.gold, phase offset used by LLRF to convert measured phase to one relative to on-crest operation, adjusted by beam phasing (degrees) ACCL:L1B:0210:PREF
R/WSEL_POFFSEL phase offset setpoint (not used in SELA/GDR mode) ACCL:L1B:0210:SEL_POFF N/A
RSEL_POFF_RBVSEL phase offset (not used in SELA/GDR mode) ACCL:L1B:0210:SEL_POFF_RBV N/A
RDFACTMeasured etune frequency (Hz)N/A
RDFMeasured detune frequency (Hz) using state space equation, cavity and forward signals - used to drive piezos ACCL:L1B:0210:DF N/A
RDFVALIDMeasured detune frequency (Hz) using state space equation, cavity and forward signals is valid. If it is not valid, its value cannot be used and the resonance system will not automatically change the piezo setting. In order for it to be valid, there must be sufficient cavity signal and it must be within +/- a couple hundred Hz. ACCL:L1B:0210:DFVALID N/A
RDF_FCMeasured detune frequency (Hz) using frequency counter method -  not used in resonance control, larger operating range than DF ACCL:L1B:0210:DF_FC N/A
RCHIRP:DFMeasured detune frequency (Hz) using chirp method -  only active in Chirp and Pulsed modes, primarily for use when cavity is many kHz out of tune, operating range of tens of kHz or more ACCL:L1B:0210:CHIRP:DF N/A
R/WALEMLEM computed integrated RF amplitude (MV) per cavity and per cryomodule ACCL:L1B:0210:ALEM
R/WPLEMLEM computed phase (deg) ACCL:L1B:0210:PLEM
R/WEGLEMLEM computed energy gain (MeV) ACCL:L1B:0210:EGLEM
R/WCHLEMLEM computed chirp (MeV) ACCL:L1B:0210:CHLEM
R/WCAV:FUDGBeam-based scale factor applied to cavity probe amplitude readback. Nominal value of 1. ACCL:L1B:0210:CAV:FUDG
RCavity design length - constant ACCL:L1B:0210:L N/A
RFREQCavity design frequency - constant ACCL:L1B:0210:FREQ N/A
RIMPEDCavity design shunt impedance - constant ACCL:L1B:0210:IMPED N/A
Tentative

 STAT

 Status bits in software (define the bits)


 HSTA Hardware status

SRF Interlocks - Per Cavity
 WINTLK_RESET_ALL Reset all latched faults from RFS and Resonance/Interlock chassisACCL:L1B:0210:INTLK_RESET_ALL
 RRFS:INTLK_FIRST Bit mask indicating which interlock fault was first detected by RFS.ACCL:L1B:0210:RFS:INTLK_FIRST N/A
 RRFS:FLTINTLK_FIRST For last captured fault waveform, bit mask indicating which interlock fault was first detected by RFSACCL:L1B:0210:RFS:FLTINTLK_FIRST N/A
RQUENCH_FLT


Cavity quench fault, from RFS chassis. Current status, latched status, bypass command, bypass status

ACCL:L1B:0210:QUENCH_FLT
RQUENCH_LTCHACCL:L1B:0210:QUENCH_LTCH
WQUENCH_BYPACCL:L1B:0210:QUENCH_BYP
RQUENCH_BYP_RBVACCL:L1B:0210:QUENCH_BYP_RBV
RSTEPTEMP_FLT

    

Stepper temperature fault, from Interlock chassis. Current status, latched status, bypass command, bypass status

ACCL:L1B:0210:STEPTEMP_FLT
RSTEPTEMP_LTCHACCL:L1B:0210:STEPTEMP_LTCH
WSTEPTEMP_BYP ACCL:L1B:0210:STEPTEMP_BYP
RSTEPTEMP_BYP_RBV ACCL:L1B:0210:STEPTEMP_BYP_RBV
RCPLRTEMP1_FLT


Coupler temperature 1 fault, from Interlock chassis. Current status, latched status, bypass command, bypass status

ACCL:L1B:0210:CPLRTEMP1_FLT
RCPLRTEMP1_LTCHACCL:L1B:0210:CPLRTEMP1_LTCH
WCPLRTEMP1_BYP ACCL:L1B:0210:CPLRTEMP1_BYP
RCPLRTEMP1_BYP_RBV ACCL:L1B:0210:CPLRTEMP1_BYP_RBV
RCPLRTEMP2_FLT


Coupler temperature 2 fault, from Interlock chassis. Current status, latched status, bypass command, bypass status

    
ACCL:L1B:0210:CPLRTEMP2_FLT
RCPLRTEMP2_LTCHACCL:L1B:0210:CPLRTEMP2_LTCH
WCPLRTEMP2_BYPACCL:L1B:0210:CPLRTEMP2_BYP
RCPLRTEMP2_BYP_RBVACCL:L1B:0210:CPLRTEMP2_BYP_RBV
RPLL_FLT

FPGA PLL lock fault, from RFS chassis. Current status, latched status. Cannot be bypassed.    

ACCL:L1B:0210:PLL_FLT
RPLL_LTCH ACCL:L1B:0210:PLL_LTCH
RIOCWDOG_FLT


EPICS IOC watchdog fault, from RFS chassis. Current status, latched status, bypass command, bypass status

ACCL:L1B:0210:IOCWDOG_FLT
IOCWDOG_LTCH ACCL:L1B:0210:IOCWDOG_FLT
IOCWDOG_BYP ACCL:L1B:0210:IOCWDOG_BYP
IOCWDOG_BYP_RBV ACCL:L1B:0210:IOCWDOG_BYP_RBV 
RSSA_FLT


SSA permit fault, from RFS chassis. Current status, latched status, bypass command, bypass status

ACCL:L1B:0210:SSA_FLT
SSA_LTCH ACCL:L1B:0210:SSA_LTCH
SSA_BYP ACCL:L1B:0210:SSA_BYP
SSA_BYP_RBV ACCL:L1B:0210:SSA_BYP_RBV
SRF Interlocks - Per Rack (A or B)

 RCPLRVAC[A,B]_FLT

   


Coupler vacuum fault, from Interlock chassis. Current status, latched status, bypass command, bypass status

    
ACCL:L1B:0200:CPLRVACA_FLT
 RCPLRVAC[A,B]_LTCHACCL:L1B:0200:CPLRVACA_LTCH
 WCPLRVAC[A,B]_BYP ACCL:L1B:0200:CPLRVACA_BYP
 RCPLRVAC[A,B]_BYP_RBV ACCL:L1B:0200:CPLRVACA_BYP_RBV
 RBMLNVAC[A,B]_FLT



Beamline vacuum fault, from Interlock chassis. Current status, latched status, bypass command, bypass status

    
ACCL:L1B:0200:BMLNVACA_FLT
 RBMLNVAC[A,B]_LTCHACCL:L1B:0200:BMLNVACA_LTCH
 WBMLNVAC[A,B]_BYP ACCL:L1B:0200:BMLNVACA_BYP 
 RBMLNVAC[A,B]_BYP_RBV ACCL:L1B:0200:BMLNVACA_BYP_RBV

 R

CRYOSUM[A,B]_FLT



Cryo summary fault, from local Cryo PLC. Current status, latched status, bypass command, bypass status

ACCL:L1B:0200:CRYOSUMA_FLT
 RCRYOSUM[A,B]_LTCHACCL:L1B:0200:CRYOSUMA_LTCH
 WCRYOSUM[A,B]_BYPACCL:L1B:0200:CRYOSUMA_BYP
 RCRYOSUM[A,B]_BYP_RBVACCL:L1B:0200:CRYOSUMA_BYP_RBV
   SRF Interlocks - Per Cryomodule - Tentative

 RCRYOSUM_FLT Cryo summary status from local Cryo PLC. Current status ACCL:L1B:0200:CRYOSUM_FLT 
 RHELEVEL_FLT Cryo Helium level status from local Cryo PLC. Current status ACCL:L1B:0200:HELEVEL_FLT
 RHEPRES_FLT Cryo Helium pressure status from local Cryo PLC. Current status ACCL:L1B:0200:HEPRES_FLT
 RCRYOHEARTBEAT_FLT Cryo PLC heartbeat fault. Generated by RF software when cryo data stops updating or updates too slowly ACCL:L1B:0200:CRYOPLC_HEARTBEAT
   SRF Cavity Characterization and Expert Settings
RQLOADEDLoaded QACCL:L1B:0210:QLOADED
RLDCOEFLorentz detuning coefficientACCL:L1B:0210:LDCOEF
RBCOEFMState space B coefficient magnitudeACCL:L1B:0210:BCOEFM
RBCOEFPState space B coefficient phaseACCL:L1B:0210:BCOEFP
RSSA:SLOPESSA curve parameter - slopeACCL:L1B:0210:SSA:SLOPE
RSSA:PEDSSA curve parameter - pedestalACCL:L1B:0210:SSA:PED
RSSA:MINXSSA curve parameter - min x ACCL:L1B:0210:SSA:MINX
RSSA:MAXR  Maximum drive to SSA, range 0 to 1. (Need better name.)ACCL:L1B:0210:QLOADED 
     
  Waveform Signals

Each SRF cavity has the following waveform signals:

Description PV name, <SIG> in following sectionAmplitude Units Power Units Phase 
 Drive (RFS chassis loopback) DRVsqrt(W) Wdegrees
 Forward Power FWDsqrt(W) Wdegrees 
 Reverse/Reflected Power REVsqrt(W)  Wdegrees 
 Cavity Probe CAVMV mWdegrees 
 DAC (FPGA internal, input to DAC that drives SSA) DAC% of full DAC scale (% of full DAC scale)^2degrees 
 Detune (see below) DFHz  N/A N/A

For SRF systems, these PVs are provided for CAV, FWD, REV, DAC (and DRV only during expert diagnostics/troubleshooting.) Example PVs are for CAV.

 <SIG>:AWF Signal amplitude waveformACCL:L1B:0210:CAV:AWF
R <SIG>:AMEAN Mean of <SIG>:AWFACCL:L1B:0210:CAV:AMEAN
R <SIG>:ASTD Standard deviation of <SIG>:AWFACCL:L1B:0210:CAV:ASTD
R <SIG>:ARSTD Standard deviation of <SIG>:AWF divided by mean of <SIG>:AWFACCL:L1B:0210:CAV:ARSTD 
R <SIG>:AMIN Minimum of <SIG>:AWFACCL:L1B:0210:CAV:AMIN
R <SIG>:AMAX Maximum of <SIG>:AWFACCL:L1B:0210:CAV:AWF 
 R <SIG>:PWF Signal phase waveformACCL:L1B:0210:CAV:PWF
 R <SIG>:PMEAN Mean of <SIG>:PWFACCL:L1B:0210:CAV:PMEAN 
R <SIG>:PSTD Standard deviation of <SIG>:PWFACCL:L1B:0210:CAV:PSTD 
 <SIG>:PRSTD Standard deviation of <SIG>:PWF divided by mean of <SIG>:PWFACCL:L1B:0210:CAV:PRSTD  
R <SIG>:PMIN Minimum of <SIG>:PWFACCL:L1B:0210:CAV:PMIN
R <SIG>:PMAX Maximum of <SIG>:PWFACCL:L1B:0210:CAV:PMAX
R <SIG>:PWRWF Signal power waveformACCL:L1B:0210:CAV:PWRWF
R <SIG>:PWRMEAN Mean of <SIG>:PWRWFACCL:L1B:0210:CAV:PWRMEAN
R <SIG>:PWRSTD Standard deviation of <SIG>:PWRWFACCL:L1B:0210:CAV:PWRSTD 
R <SIG>:PWRRSTD Standard deviation of <SIG>:PWRWF divided by mean of <SIG>:PWRWFACCL:L1B:0210:CAV:PWRRSTD
R <SIG>:PWRMIN Minimum of <SIG>:PWRWFACCL:L1B:0210:CAV:PWRMIN
R <SIG>:PWRMAX Maximum of <SIG>:PWRWFACCL:L1B:0210:CAV:PWRMAX
R <SIG>:IWF Signal I waveformACCL:L1B:0210:CAV:IWF
 <SIG>:QWF Signal Q waveformACCL:L1B:0210:CAV:AWF
R <SIG>:FLTAWF Fault waveform - signal amplitudeACCL:L1B:0210:CAV:FLTAWF
R <SIG>:FLTPWF Fault waveform - signal phaseACCL:L1B:0210:CAV:FLTPWF
Other SRF Waveform Signals:     
RDF:WF Detune frequency waveform. Calculated by software from cavity and forward signals. [Hz]ACCL:L1B:0210:DF:WF
RDF:MEANMean of DF:WFACCL:L1B:0210:DF:MEAN
RDF:STD Standard deviation of DF:WFACCL:L1B:0210:DF:STD 
RDF:MINMinimum of DF:WFACCL:L1B:0210:DF:MIN 
DF:MAX Maximum of DF:WFACCL:L1B:0210:DF:MAX 
RBW:WF Cavity bandwidth waveform. Calculated by software from cavity and forward signals.  [Hz]ACCL:L1B:0210:BW:WF 
RCTRL:IWFP/I Controller Output I waveform. Calculated by software from cavity and DAC signals. [% of full scale, range -1 to 1]ACCL:L1B:0210:CTRL:IWF 
CTRL:QWF P/I Controller Output Q waveform. Calculated by software from cavity and DAC signals. [% of full scale, range -1 to 1] ACCL:L1B:0210:CTRL:QWF  
CTRL:AWF P/I Controller Output amplitude waveform. Calculated by software from cavity and DAC signals. [% of full scale, range -1 to 1] ACCL:L1B:0210:CTRL:AWF  
RCTRL:FLTAWF Fault waveform - P/I Controller Output amplitudeACCL:L1B:0210:CTRL:FLTAWF
RCTRL:FLTPWF Fault waveform - P/I Controller Output phaseACCL:L1B:0210:CTRL:FLTPWF
R/WACQ_FLT_DELAYFault data trigger control. In % of total waveform data duration. 0% = all data is pre-fault, 100% = all data is post-faultACCL:L1B:0210:ACQ_FLT_DELAY
     
Feedback     
 AMPFB_GAIN_P_RBV Amplitude feedback proportional gain readback (units not yet determined)ACCL:L1B:0210:AMPFB_GAIN_P_RBV
R/W AMPFB_GAIN_P Amplitude feedback proportional gain setting (units not yet determined)ACCL:L1B:0210:AMPFB_GAIN_P 
 AMPFB_GAIN_I_RBV Amplitude feedback integral gain readback (units not yet determined)ACCL:L1B:0210:AMPFB_GAIN_I_RBV
R/W AMPFB_GAIN_I Amplitude feedback integral gain setting (units not yet determined)ACCL:L1B:0210:AMPFB_GAIN_I 
 PHAFB_GAIN_P_RBV Phase feedback proportional gain readback (units not yet determined)ACCL:L1B:0210:AMPFB_GAIN_P_RBV
R/W PHAFB_GAIN_P Phase feedback proportional gain setting (units not yet determined)ACCL:L1B:0210:AMPFB_GAIN_P 
 PHAFB_GAIN_I_RBV Phase feedback integral gain readback (units not yet determined)ACCL:L1B:0210:AMPFB_GAIN_I_RBV
R/W PHAFB_GAIN_I Phase feedback integral gain setting (units not yet determined)ACCL:L1B:0210:AMPFB_GAIN_I 
 AMPFB_LSUM Amplitude feedback is at lower limit while feedback is active. 0 if true (alarm state), 1 if false (good state)ACCL:L1B:0210:AMPFB_LSUM 
AMPFB_HSUM Amplitude feedback is at upper limit while feedback is active. 0 if true (alarm state), 1 if false (good state)ACCL:L1B:0210:AMPFB_HSUM 
 AMPFB
AMPFB_
HSUM
SUM Amplitude feedback is at either lower or upper limit while feedback is active. 0 if true (alarm state), 1 if false (good state)ACCL:L1B:0210:AMPFB_
HSUM 
SUM 
 PHAFB
PHAFB_LSUM Phase feedback is at lower limit while feedback is active. 0 if true (alarm state), 1 if false (good state)ACCL:L1B:0210:PHAFB_LSUM 
 PHAFB
PHAFB_HSUM Phase feedback is at upper limit while feedback is active. 0 if true (alarm state), 1 if false (good state)ACCL:L1B:0210:PHAFB_HSUM 
RPHAFB_SUMPhase feedback is at either lower or upper limit while feedback is active. 0 if true (alarm state), 1 if false (good state)ACCL:L1B:0210:PHAFB_SUM

Resonance control


NameDescriptionDescription

SRF Example

(CM2 Cavity 1)SRF Example

Gun/Buncher Example 
R/WSTEP:NSTEPSStepper tuner number of steps per move ACCL:L1B:0210:STEP:NSTEPS
WSTEP:MOV_REQ_NEGRequest stepper tuner move negative STEP:NSTEPS. Write 1 to request ACCL:L1B:0210:STEP:MOV_REQ_NEG
WSTEP:MOV_REQ_POSRequest stepper tuner move positive STEP:NSTEPS. Write 1 to request ACCL:L1B:0210:STEP:MOV_REQ_POS
RSTEP:STATWRDStepper controller status word readback ACCL:L1B:0210:STEP:STATWRD
RSTEP:STATWRD.B0Stepper controller status bit: motor moving; 1 = moving, 0 = not ACCL:L1B:0210:STEP:STATWRD.B0
RSTEP:STATWRD.B2Stepper controller status bit: motor done; 1 = done, 0 = not ACCL:L1B:0210:STEP:STATWRD.B2
RSTEP:STATWRD.B3Stepper controller status bit: at limit B; 1 = at limit, 0 = not. (The limit should never be reached.) ACCL:L1B:0210:STEP:STATWRD.B3
RSTEP:STATWRD.B4Stepper controller status bit: at limit A; 1 = at limit, 0 = not. (The limit should never be reached.) ACCL:L1B:0210:STEP:STATWRD.B4
RSTEP:CTRLWRDStepper controller status word readback ACCL:L1B:0210:STEP:CTRLWRD
RSTEP:CTRLWRD.B5Stepper controller status bit: move direction; 1 if negative, 0 if positive ACCL:L1B:0210:STEP:STATWRD.B0
RSTEP:STATMSG  High-level status message from stepper controller softwareACCL:L1B:0210:STEP:STATMSG 
PZT:ENABLEPiezo enable/disable control; set to 1 to enable, 0 to disableACCL:L1B:0210:PZT:ENABLE
 RPZT:ENABLESTATPiezo enable/disable status; 1 = enabled, 0 = disabledACCL:L1B:0210:PZT:ENABLESTAT 
PZT:MODECTRL

Piezo mode control; set to 1 for Integrator (feedback driven by RFS measured detune), 0 for DC control.

Integrator is the correct mode for normal operations.

ACCL:L1B:0210:PZT:MODECTRL
PZT:MODESTATPiezo mode status; 1 = Integrator, 0 = DCACCL:L1B:0210:PZT:MODESTAT
PZT:VCalculated piezo voltage ACCL:L1B:0210:PZT:V 
PZT:DF_RFS Detune measurement sent from RFS to Resonance chassis. This drives the piezo while in Integrator mode.ACCL:L1B:0210:PZT:DF_RFS 
PZT:DFVALID_RFS 

Detune measurement sent from RFS to Resonance chassis is valid. If it is not valid, the Integrator

will not change the piezo setting

ACCL:L1B:0210:PZT:DFVALID_RFS 
R/W PZT:DAC_SPDC voltage offset setting. Only used while in DC mode.ACCL:L1B:0210:PZT:DAC_SP
R/WPZT:INTEG_SP Optional Integrator setpoint. Can be used to compensate for observed systematic detune offset while in Integrator mode.ACCL:L1B:0210:PZT:INTEG_SP
RPZT:INTEG_SP_RBV Readback of optional Integrator setpoint.ACCL:L1B:0210:PZT:INTEG_SP_RBV
R/WPZT:BIAS

Piezo bias voltage setting. Nominally 25 V. Used to operate piezo away from range limits.

This should not change during normal operations.

ACCL:L1B:0210:PZT:BIAS
RPZT:BIAS_RBV

Readback of piezo bias voltage setting.

ACCL:L1B:0210:PZT:BIAS_RBV
RPZT:INTEG_AT_LIM

Piezo integrator (feedback) is at a limit of its range. This may require moving the stepper to re-center the piezo.

ACCL:L1B:0210:PZT:INTEG_AT_LIM

...