SPEAR Apps

SPEAR Controls

IOC and Host Programs

Quick Links

IOC Applications

OpenVms Host Programs

Unix Host Programs

General

SPEAR Host and Console List

SPEAR Soft IOC List

Remote Deployment using rdist

LCLS Commissioning High Level Physics Applications

IOC Applications

Name Brief Description Machine or Process Source

SpearTimestamp
Time stamp sync module interface. BPM,MCOR,FOFB,
PSM,Multi-Use IOCs $APP/drvSpearTimestamp

Orbit Interlock Interface IP module interface for orbit interlock reset and test and status of bypass, BPLD, beam current, RF enable, beamline open, and beamline stoppers. Multi-Use IOC $APP/multiUseApp/

Control Room Interface IP module interface for bucket and state display, kicker trigger enable, linac and BTS status, audio alarms, and bucket buttons, control and strobe. Multi-Use IOC $APP/multiUseApp/

BPM RMS Calculation BPM orbit U and V RMS calculation Multi-Use IOC $APP/multiUseApp/src/BPMRMSCalc.st

Feedback Monitor Checks that either fast or slow feedback is running and BPM RMS is OK. Triggers a BPM orbit history dump and control room audible alarm when problems. Multi-Use IOC $APP/multiUseApp/src/fdbkMon.st

Beam Orbit Post-Mortem Dump Triggers a BPM orbit post-mortem dump on orbit interlock fault. Multi-Use IOC $APP/multiUseApp/src/beamDump.st

VME Crate Interface CANbus interface for monitor/control of all Wiener VME crates. Multi-Use IOC $APP/multiUseApp/

BuckoMat Automatic injection of booster beam into SPEAR buckets Multi-Use IOC $APP/multiUseApp/src/buckoMat.st

Bucket Select SPEAR bucket pattern selection for use by BuckoMat. Sets the count of the number of shots each of 372 buckets gets during injection. Includes the active pattern and 5 pattern savesets. soft-iocbucket $APP/etherIocApp/Db/bucket*

ID Interface Interface to motors used for BL12-2 and BL13 insertion device control. Also includes records used by ID remote control. BL12-2, BL13 IOCs $APP/motorApp/

Beamline Calculations Beamline calculations including period, gap, gap state, magnetic field, K, and power. BL12-2 IOC $APP/motorApp/

MPS and Kicker PLC Interface SPEAR MPS, beamline MPS, and SPEAR kicker voltage.
Kicker Power Supply Sys Mgr Page soft-iocmps $APP/etherIocApp/Db/many files

SRS DG535 Timing Monitor and control the SRS DG535 delay generators.
Timing by PS System Manager soft-iocgpib $APP/etherIocApp/Db/DG*, kicker_timing*

RF Frequency Read RF frequency in SPEAR, booster, and linac via Agilent Hp53181A frequency counters. Set SPEAR RF frequency and BPM test tone via PTS 500 frequency synthesizers. soft-iocgpib $APP/etherIocApp/Db/gpib*

Linac RF Frequency Synchronization Synchronize linac frequency at the time of booster injection. b140-ioclinpac $APP/pacApp/

Beam Current Monitors Keithley 2002 multimeters to acquire DCCT and NPCT beam current readouts. Performs beam current calculations including average, lifetime, vacuum quality, and loss rate for 4 time intervals: Fast (1 sec), 10 sec, 60 sec, slow (180 sec). Updates beam current for CURMON every second. soft-iocgpib $APP/etherIocApp/

Matlab Interface PVs used by production matlab programs so that matlab calculations can be added to history plot (readbacks) and to allow operator input for matlab programs without GUIs in the control room (setpoints). Matlab programs must use the labCA interface to access PVs so that automatic reconnections are made after IOC restart. soft-iocmatlab $APP/etherIocApp/Db/config*, pinhole*

HLS Interface Gets Hydrostatic Leveling System (HLS) water levels around the beamlines. soft-iochls $APP/etherIocApp/Db/hls*

Alarm Monitor Interface Provides PVs for the ALARMSEQ process and alarm summaries. Also, provides PVs for the non-BCS topoff software interlocks and summaries. soft-iocalarm $APP/etherIocApp/Db/monitor*, configStatus*

SPEAR and Injector CAMAC Interface Monitors small subset of SPEAR and Injector CA server PVs to add calculations and support the alarm handler. Include injector PS monitoring. soft-ioccamac $APP/etherIocApp/Db/camac*, injectorPS*

Radiation Monitor Interface Interface to radiation monitors for BCS. SAPE 234. soft-iocrp $APP/etherIocApp/Db/neutron*, gamma*, rp*

Power Supply Control Ethernet, Bitbus, and Genesys Power Supply Control SPEAR,Booster PS IOCs, soft-iocps $APP/bitPSCApp

psControl Power supply standardization and ramp-off SPEAR PS IOC $APP/bitPSCApp/src/psControl.st

tspControl Power supply current control for TSP flashing and ramp-off SPEAR PS IOC $APP/bitPSCApp/src/tspControl.st

Pulse Signal Monitoring Digitizer waveform acquisition and processing. SPEAR PS, Linac PSM, Booster PSM IOCs $APP/devPsm

BCS TopOff Interface Remote digital input and output for Beam Containment System. SAPE 239. SPEAR,Booster PS IOCs $APP/bitPSCApp

MCOR 4kHz Control
Hardware interface,
Power Supply System Manager Page MCOR IOCs $APP/mcorApp

SPEAR BPMs SPEAR Electron and Photon BPM aquisition SPEAR BPM IOCs $APP/bpmAdcApp

Transport Line BPMs LTB/BTS Electron BPM aquisition LTB/BTS BPM IOC $APP/transBpmApp

Low Level RF (LLRF) Hardware interface and slow control SPEAR RF IOC $RF/rfApp

4kHz Controls
Fast corrector and BPM features / control
(PDF document here)
BPM, MCOR,FOFB IOCs
$APP/mcorApp, $APP/bpmAdcApp, $APP/fofbApp

OpenVMS Host Programs
To restart a program running on SPEAR1/2/3 or INJ02, a SPEAR system manager must log onto the machine running the program, get all privileges, and type the program name which will stop and restart the program. Contact a SSRL system manager to restart a program running on SSRL.

Name Description Machine Source

ACM Integral Read linac and BTS ACM values (from local injector control system) and calculate different electron charge integrals. Use the reset mini-procedure to reset the integrals before a new run. INJ02 [INJECTOR.CMSLIB.KERNEL]ACM.C

ALARM_HANDLER Read and store alarm messages, generate notifications as required. SPEAR1,2,3,INJ02 spear_root:[monitoring]alarm_handler.c

ALARMSEQ Manages alarms. SPEAR1 spear_root:[alarms]alarmseq.c

BEAMINT Calculate SPEAR beam integrals every second. Use the reset mini-procedure to reset the integrals before a new run. SPEAR3 spear_root:[beamint]beamint.c

BL_INTRLK Calculate product of beam current (DCCT) and beamline vacuum and periodicall update integrals. Close beamline stopper when integral is too high. SPEAR3 spear_root:[monitoring]bl_intrlk.c

BL12_INTRLK Protect the BL12-2 insertion device in vacuum magnets from radiation from uncontrolled beam. SPEAR3 spear_root:[monitoring]bl12_intrlk.c

BPMRACKTEMP Turn B116 and B132 BPM rack fans on and off to control temperature. SPEAR3 spear_root:[monitoring]bpmracktemp.c

CALSERVER Return PV values to webserver applications. SPEAR2 spear_root:[epics.calserver]calserver.c

CRATE_MONITOR Reboot MicroVax and generate an alarm message when a crash is detected. SPEAR3 spear_root:[monitoring]crate_monitor.c

CURMON Generate SPEAR beam current X display depending on selected machine mode SPEAR1 spear_root:[curmon]curmon.c

CURR_INTRLK Limit maximum SPEAR beam current and dump beam if beam current discrepancy SPEAR3 spear_root:[monitoring]curr_intrlk.c

HISTORYLOG_CA History Log Channel Access SPEAR1 spear_root:[history]historylog_ca.c

HISTORYLOG_RDB History Log RDB Update SPEAR1 spear_root:[history]historylog_rdb.c

HISTORYPLOT History Plot Viewer. When a new PV is added to history, historyplot needs to be restarted (or an old run accessed and then the new run). If 5 minutes has elapsed and historyplot still cannot access the new PV, a spear system manager must restart the SQL server. SPEAR1/2/3/SSRL spear_root:[history]historyplot.c

Insertion Device Control ID Remote Control SPEAR3 idl_user:[insertions]

MSG_HANDLER Message handler SPEAR1,2 spear_root:[monitoring]msg_handler.c

MCC_POWER Get values from MCC and update PVs on soft-iocps. SPEAR2 spear_root:[mcc_power]mcc_power.c

NETMON Network monitor SPEAR3 ????

PV_MONITOR Monitor PVs and update history RDB either every 2 seconds or on change SPEAR3 spear_root:[monitoring]pv_monitor.c

PVSERVER Get record list from each IOC and reply with all corresponding PV setpoints SPEAR1 spear_root:[history]pvserver.c

SPEAR_SERVER The SPEAR Control System Upgrade SPEAR3 user_disk:[cox.epics2005.ssrl_servers]

SPEAR_SIBYL SPEAR sibyl SPEAR2 spear_root:[spear_ssrl]spear_sibyl.for

TC_INTRLK Monitor all SPEAR thermocouple readouts. SPEAR3 spear_root:[monitoring]tc_intrlk.c

TSP TSP flashing SPEAR3 spear_root:[tsp]tsp.c

VACMON Run EDM control room vacuum display SPEAR2 spear_root:[init]vacmon.com

VACUUM_MONITOR Calculate vacuum parameters every second. SPEAR3 spear_root:[monitoring]vacuum_monitor.com

WEBSTAT Update SPEAR status talk_display.html web page. SSRL Unknown

XCAMAC XCAMAC SPEAR3 spear_root:[xcamac]xcamac.for

Unix Host Programs
Most of the following programs run using the spear AFS account. When connie is down, beldar is used instead.

Name Description Machine Config Files and Scripts

iocLogMsgServer Receive messages from iocLog clients and send them to the RDB event log via msg_handler connie $EPICS/app/iocLog/

caRepeater Forward IOC beacons to CA clients on this host all N/A

alh Send PV alarms to iocLogMsgServer connie $EPICS/app/alh/

Xvfb Virtual framebuffer X server required for alh connie $EPICS/app/alh/

channelWatcher Store PV setpoints and send setpoint changes to iocLogMsgServer connie $EPICS/app/cw/

gateway Serve SPEAR PVs to clients outside the firewall connie $EPICS/app/gtw/

etherIoc Soft IOCs all $APP/etherIocApp and $IOC/soft-ioc*

iocConsole Processes IOC console access using screen all $IOC/screenrc and screeniocs

Extensible Display Manager (EDM) EPICS GUI displays all SPEAR EDM Design Rules, SNS EDM Site

StripTool EPICS GUI strip chart tool all N/A

SPEAR EPICS | SPEAR Home | SSRL Computing/Networking | SSRL Home | SLAC Computing | SLAC Networking | SLAC Home
Contact: Stephanie Allison
Last Modified: Nov 23, 2009

Name	Brief Description	Machine or Process	Source
SpearTimestamp	Time stamp sync module interface.	BPM,MCOR,FOFB, PSM,Multi-Use IOCs	$APP/drvSpearTimestamp
Orbit Interlock Interface	IP module interface for orbit interlock reset and test and status of bypass, BPLD, beam current, RF enable, beamline open, and beamline stoppers.	Multi-Use IOC	$APP/multiUseApp/
Control Room Interface	IP module interface for bucket and state display, kicker trigger enable, linac and BTS status, audio alarms, and bucket buttons, control and strobe.	Multi-Use IOC	$APP/multiUseApp/
BPM RMS Calculation	BPM orbit U and V RMS calculation	Multi-Use IOC	$APP/multiUseApp/src/BPMRMSCalc.st
Feedback Monitor	Checks that either fast or slow feedback is running and BPM RMS is OK. Triggers a BPM orbit history dump and control room audible alarm when problems.	Multi-Use IOC	$APP/multiUseApp/src/fdbkMon.st
Beam Orbit Post-Mortem Dump	Triggers a BPM orbit post-mortem dump on orbit interlock fault.	Multi-Use IOC	$APP/multiUseApp/src/beamDump.st
VME Crate Interface	CANbus interface for monitor/control of all Wiener VME crates.	Multi-Use IOC	$APP/multiUseApp/
BuckoMat	Automatic injection of booster beam into SPEAR buckets	Multi-Use IOC	$APP/multiUseApp/src/buckoMat.st
Bucket Select	SPEAR bucket pattern selection for use by BuckoMat. Sets the count of the number of shots each of 372 buckets gets during injection. Includes the active pattern and 5 pattern savesets.	soft-iocbucket	$APP/etherIocApp/Db/bucket*
ID Interface	Interface to motors used for BL12-2 and BL13 insertion device control. Also includes records used by ID remote control.	BL12-2, BL13 IOCs	$APP/motorApp/
Beamline Calculations	Beamline calculations including period, gap, gap state, magnetic field, K, and power.	BL12-2 IOC	$APP/motorApp/
MPS and Kicker PLC Interface	SPEAR MPS, beamline MPS, and SPEAR kicker voltage. Kicker Power Supply Sys Mgr Page	soft-iocmps	$APP/etherIocApp/Db/many files
SRS DG535 Timing	Monitor and control the SRS DG535 delay generators. Timing by PS System Manager	soft-iocgpib	$APP/etherIocApp/Db/DG, kicker_timing
RF Frequency	Read RF frequency in SPEAR, booster, and linac via Agilent Hp53181A frequency counters. Set SPEAR RF frequency and BPM test tone via PTS 500 frequency synthesizers.	soft-iocgpib	$APP/etherIocApp/Db/gpib*
Linac RF Frequency Synchronization	Synchronize linac frequency at the time of booster injection.	b140-ioclinpac	$APP/pacApp/
Beam Current	Monitors Keithley 2002 multimeters to acquire DCCT and NPCT beam current readouts. Performs beam current calculations including average, lifetime, vacuum quality, and loss rate for 4 time intervals: Fast (1 sec), 10 sec, 60 sec, slow (180 sec). Updates beam current for CURMON every second.	soft-iocgpib	$APP/etherIocApp/
Matlab Interface	PVs used by production matlab programs so that matlab calculations can be added to history plot (readbacks) and to allow operator input for matlab programs without GUIs in the control room (setpoints). Matlab programs must use the labCA interface to access PVs so that automatic reconnections are made after IOC restart.	soft-iocmatlab	$APP/etherIocApp/Db/config, pinhole
HLS Interface	Gets Hydrostatic Leveling System (HLS) water levels around the beamlines.	soft-iochls	$APP/etherIocApp/Db/hls*
Alarm Monitor Interface	Provides PVs for the ALARMSEQ process and alarm summaries. Also, provides PVs for the non-BCS topoff software interlocks and summaries.	soft-iocalarm	$APP/etherIocApp/Db/monitor, configStatus
SPEAR and Injector CAMAC Interface	Monitors small subset of SPEAR and Injector CA server PVs to add calculations and support the alarm handler. Include injector PS monitoring.	soft-ioccamac	$APP/etherIocApp/Db/camac, injectorPS
Radiation Monitor Interface	Interface to radiation monitors for BCS. SAPE 234.	soft-iocrp	$APP/etherIocApp/Db/neutron, gamma, rp*
Power Supply Control	Ethernet, Bitbus, and Genesys Power Supply Control	SPEAR,Booster PS IOCs, soft-iocps	$APP/bitPSCApp
psControl	Power supply standardization and ramp-off	SPEAR PS IOC	$APP/bitPSCApp/src/psControl.st
tspControl	Power supply current control for TSP flashing and ramp-off	SPEAR PS IOC	$APP/bitPSCApp/src/tspControl.st
Pulse Signal Monitoring	Digitizer waveform acquisition and processing.	SPEAR PS, Linac PSM, Booster PSM IOCs	$APP/devPsm
BCS TopOff Interface	Remote digital input and output for Beam Containment System. SAPE 239.	SPEAR,Booster PS IOCs	$APP/bitPSCApp
MCOR 4kHz Control	Hardware interface, Power Supply System Manager Page	MCOR IOCs	$APP/mcorApp
SPEAR BPMs	SPEAR Electron and Photon BPM aquisition	SPEAR BPM IOCs	$APP/bpmAdcApp
Transport Line BPMs	LTB/BTS Electron BPM aquisition	LTB/BTS BPM IOC	$APP/transBpmApp
Low Level RF (LLRF)	Hardware interface and slow control	SPEAR RF IOC	$RF/rfApp
4kHz Controls	Fast corrector and BPM features / control (PDF document here)	BPM, MCOR,FOFB IOCs	$APP/mcorApp, $APP/bpmAdcApp, $APP/fofbApp

Name	Description	Machine	Source
ACM Integral	Read linac and BTS ACM values (from local injector control system) and calculate different electron charge integrals. Use the reset mini-procedure to reset the integrals before a new run.	INJ02	[INJECTOR.CMSLIB.KERNEL]ACM.C
ALARM_HANDLER	Read and store alarm messages, generate notifications as required.	SPEAR1,2,3,INJ02	spear_root:[monitoring]alarm_handler.c
ALARMSEQ	Manages alarms.	SPEAR1	spear_root:[alarms]alarmseq.c
BEAMINT	Calculate SPEAR beam integrals every second. Use the reset mini-procedure to reset the integrals before a new run.	SPEAR3	spear_root:[beamint]beamint.c
BL_INTRLK	Calculate product of beam current (DCCT) and beamline vacuum and periodicall update integrals. Close beamline stopper when integral is too high.	SPEAR3	spear_root:[monitoring]bl_intrlk.c
BL12_INTRLK	Protect the BL12-2 insertion device in vacuum magnets from radiation from uncontrolled beam.	SPEAR3	spear_root:[monitoring]bl12_intrlk.c
BPMRACKTEMP	Turn B116 and B132 BPM rack fans on and off to control temperature.	SPEAR3	spear_root:[monitoring]bpmracktemp.c
CALSERVER	Return PV values to webserver applications.	SPEAR2	spear_root:[epics.calserver]calserver.c
CRATE_MONITOR	Reboot MicroVax and generate an alarm message when a crash is detected.	SPEAR3	spear_root:[monitoring]crate_monitor.c
CURMON	Generate SPEAR beam current X display depending on selected machine mode	SPEAR1	spear_root:[curmon]curmon.c
CURR_INTRLK	Limit maximum SPEAR beam current and dump beam if beam current discrepancy	SPEAR3	spear_root:[monitoring]curr_intrlk.c
HISTORYLOG_CA	History Log Channel Access	SPEAR1	spear_root:[history]historylog_ca.c
HISTORYLOG_RDB	History Log RDB Update	SPEAR1	spear_root:[history]historylog_rdb.c
HISTORYPLOT	History Plot Viewer. When a new PV is added to history, historyplot needs to be restarted (or an old run accessed and then the new run). If 5 minutes has elapsed and historyplot still cannot access the new PV, a spear system manager must restart the SQL server.	SPEAR1/2/3/SSRL	spear_root:[history]historyplot.c
Insertion Device Control	ID Remote Control	SPEAR3	idl_user:[insertions]
MSG_HANDLER	Message handler	SPEAR1,2	spear_root:[monitoring]msg_handler.c
MCC_POWER	Get values from MCC and update PVs on soft-iocps.	SPEAR2	spear_root:[mcc_power]mcc_power.c
NETMON	Network monitor	SPEAR3	????
PV_MONITOR	Monitor PVs and update history RDB either every 2 seconds or on change	SPEAR3	spear_root:[monitoring]pv_monitor.c
PVSERVER	Get record list from each IOC and reply with all corresponding PV setpoints	SPEAR1	spear_root:[history]pvserver.c
SPEAR_SERVER	The SPEAR Control System Upgrade	SPEAR3	user_disk:[cox.epics2005.ssrl_servers]
SPEAR_SIBYL	SPEAR sibyl	SPEAR2	spear_root:[spear_ssrl]spear_sibyl.for
TC_INTRLK	Monitor all SPEAR thermocouple readouts.	SPEAR3	spear_root:[monitoring]tc_intrlk.c
TSP	TSP flashing	SPEAR3	spear_root:[tsp]tsp.c
VACMON	Run EDM control room vacuum display	SPEAR2	spear_root:[init]vacmon.com
VACUUM_MONITOR	Calculate vacuum parameters every second.	SPEAR3	spear_root:[monitoring]vacuum_monitor.com
WEBSTAT	Update SPEAR status talk_display.html web page.	SSRL	Unknown
XCAMAC	XCAMAC	SPEAR3	spear_root:[xcamac]xcamac.for