1. EPICS Overview Lecture 2 Matt Boyes

2. Class Outline SecureCRT/Xwin32 Review of some of Lecture 1
Setup/configuration
Review of some of Lecture 1
LCLSHome
EPICS LCLS Environment Setup
Networks
LCLSHome Displays
Display Tips
LCLS Network Details
Channel Access Permissions/Security

3. Class Outline (cont.) Lecture 2: Diagnostics and tools Archiver Viewer
StripTool
Message Log (CMLog)
Score
BPM Orbit Display/Buffered Data
IRMIS
Matlab GUIs
Correlation plots
Profile Monitor GUI
Command Line Tools
cainfo
caget
caput
Camonitor
CWget
Cwput
probe

4. SecureCRT
Instructions to install and Configure SecureCRT/X-Win32: lcls-dev ->EPICS Classes ->SecureCRT (Link at the bottom)

5. User Environment Setup
epicsReset.bash
Must be in bash shell
Channel Access settings
Necessary for running lclshome
LCLS EPICS Read Only Setup on Linux Login to lcls-prod02 with: (From outside SLAC: you can not go directly to this machine unless you use VPN or jump from another SLAC host) $ ssh -X -Y
Find out what shell you are running by typing echo $SHELL. Your shell will be either tcsh or bash. ex: $ echo $SHELL /bin/bash (I am running bash.)
If you are using tcsh, type this command to enter the bash shell before proceeding: $ bash
If you are using bash, type this command: $ source /afs/slac/g/lcls/epics/setup/epicsReset.bash
As an alternative you can skip the above step and instead copy the following file to your home directory. This file includes the command to source the setup script listed in the above. The advantage is that this script is executed automatically when you type bash. $ cp ~jingchen/.bashrc .
More info at -> EPICS Classes

7. Important Network Details
LCLS DEV clients (lcls-dev2) can not access CA Network PVs
LCLS DMZ clients (lcls-prod02) have read only access to CA Network PVs
EPICS Environment automatically setup for group accounts on CA Network Computers (host=lcls-srv01 users={physics, acclegr, iocegr})

8. Channel Access Permissions/Security
PV Read Only Access from DMZ computers (lcls-prod02)
PV Write Access from CA computers (lcls-srv01, sunrays, MCC computers)
IOCs can further restrict read/write access by username and by computer name (eoicdesk only)

9. LCLSHome To start LCLSHome, type [mboyes@lcls-prod02:~]$ lclshome
Top display is summary status by subsystem vs location
Complex areas are further divided, check help for details
Important Alarms/severity should propagate up from lower sub displays
Summary Alarms can by bypassed on LCLSHOME, a * indicates a PV in that location is bypassed.

10. Display Tips Graphs Some helpful EDM tips
Middle Mouse Click on a PV will show the PV name.
This can by dragged and dropped to copy/paste the PV name somewhere else.
Control + Middle Mouse Click on a PV
A message window will appear with helpful PV info (cainfo)
Additional operations will append message window until use clears window.
HOST IOC (where PV exists) is displayed, only works on production hosts (lcls-srv01)
Does not apply to SoftIOCs running on a linux server.
Graphs
Rubber banding to zoom

11. Display Tips (cont.) Some helpful EDM tips
Control + Shift + Middle Mouse Click on a PV
Brings up submenu to send PV to
Probe
Plot History in Matlab Window

12. Archiver Viewer It’s the EPICS History Plot Works on Dev and Prod
Can be started from LCLSHome Summary Screen Application Bar
Can save configurations, export data
Allows users to search for PVs using wildcards

13. Archiver Viewer (cont.)
Use formulas
Allows for Absolute, and relative time entry
Start 04/07/ :20: End 04/07/ :30:00.000
Start -3H End now
Can add/configure additional Y Scales and give them names
Apply new scales to multiple PVs at once.
Can disable PV from showing
Can Plot on PV against another using “JFreeChart For Correlations”

14. StripTool It’s a EPICS Chart Recorder Works on Dev and Prod
Can be started from command line
$ StripTool
$ StripTool <some config filename>
Can be started from LCLSHome Summary Screen Application Bar
Can save configurations (Save path different on Dev and Prod)
Can save data to file (Save path different on Dev and Prod)
Warning Long Data Ranges can take a long to to retrieve

15. Message Log (CMLog) Error Log Works Only on Prod
Can be started from LCLSHome Summary Screen Application Bar
Can Filter live data and search in the past
IOC Engineers can configure logging on PV changes

16. Score (Machine Configurations)
Save/Restore (Machine Snapshots)
Works Only on Prod
Can be started from LCLSHome Summary Screen Application Bar
Warning: Loading/Activating is Invasive to Operations

17. Score
Items are broken down by:
Region
Subsytem
Area

18. Score Analog Snapshots and Differences Used for Vacuum
Can more system can be added

19. BPM GUI Two applications BPM Orbit Display/Buffered Acquisition
Can be used to get Beam Synchronous Acquisition data (BSA)
All BSA devices can be sampled on each pulse and correlated.
BPM Orbit
BPM Z Plot can grab an instant reference and plot differences
Orbits can be saved
Orbits can be fit
Can show optic elements
Works Only on Prod
Can be started from LCLSHome Summary Screen Application Bar

20. BPM GUI (Cont.)
Two applications BPM Orbit Display/Buffered Data (Cont.)
Buffered Acquisition
Can be used to get data for all BSA devices
Can plot two against each other
Can Save Data
Plot Data, Histograms
Can use MAD or EPICS names

21. BPM GUI Two applications BPM Orbit Display/Buffered Data
Can be used to get Beam Synchronous Acquisition data (BSA)
All BSA devices can be sampled on each pulse and correlated.
BPM Orbit
BPM Z Plot can grab an instant reference and plot differences
Orbits can be saved
Orbits can be fit
Can show optic elements
Works Only on Prod
Can be started from LCLSHome Summary Screen Application Bar

22. IRMIS Can show PV details, and how it links to other PVs
Works on Dev and Prod
Can be started from LCLSHome Summary Screen Application Bar
Searchable and allows for wildcards
Can save results
Can show what IOC contains a given PV
Data is updated nightly

23. IRMIS (cont) Some IRMIS reports can be found online
Report generated daily:
query page for IOC info:
IRMIS primer:

24. Matlab GUIs- Correlation Plot
Works Only on Prod
Can be started from LCLSHome Summary Screen-> Matlab Gui-> Correlation Plot
Warning: Can be Invasive to Operations
Can control devices, do BSA, plot functions, fits results
Written by Henrik Loos
Can save config, save/export data

25. Matlab GUIs- Profile Monitor GUI
Used to look a Profile Monitor/Laser Images
Better than EPICS Displays
Fits, false color, higher update rate, change bit depth
Warning: Can be Invasive to Operations
Can insert Targets, and suppress beam for BKGD subtraction
Written by Henrik Loos

26. EPICS Command Line Tools
All Reads work from Prod and Dev, Writes are invasive and only work from Prod
cainfo
Get information about a PV
$ cainfo TORO:IN20:431:TMIT
TORO:IN20:431:TMIT
State: connected
Host: ioc-in20-im01.slac.stanford.edu:5068
Access: read, write
Data type: DBR_DOUBLE (native: DBF_DOUBLE)
Element count: 1
caget
Get a PV value
$ caget TORO:IN20:431:TMIT
TORO:IN20:431:TMIT
Caput
Write a PV value
$ caput VPIO:IN20:465:CALFACTORDES 1.0
Old : VPIO:IN20:465:CALFACTORDES
New : VPIO:IN20:465:CALFACTORDES 1

27. EPICS Command Line Tools
All Reads work from Prod and Dev, Writes are invasive and only work from Prod
Camonitor
Monitor a PV’s value, get an update ever time it changes (Contol+C to exit)
$ camonitor TORO:IN20:431:TMIT1H
TORO:IN20:431:TMIT1H :16:
TORO:IN20:431:TMIT1H :16:
TORO:IN20:431:TMIT1H :16:
TORO:IN20:431:TMIT1H :16:
TORO:IN20:431:TMIT1H :16:
CWget and caGet1
Usage: caGet1 [-w sec] <infile> [outfile]
This tool uses CA to get values in DBR_STRING form for a list of PVs.
Output results are sent to stdout or saved in a output file.
Cwput
Usage: caPut1 [-w sec] <infile>
This tool puts the set values to IOC channels. It reads an input
file which contains a list of pair values of channel_name & set_value
and puts the set_values into IOC through CA call. The set_value
must be in DBR_STRING form as created by caGet1.

28. EPICS Command Line Tools
All Reads work from Prod and Dev, Writes are invasive and only work from Prod
Probe
Can be launched from EDM (Middle Mouse Click +Control + Shift)
Command Line (probe)
Can read and write to PVs
Can show Information about:
Alarm limits
Bit/State decoding

29. Questions

30. Exercises StripTool Probe Archiver IRMIS Camonitor
1a: Create a StripTool and save it with a name starting with your initals
1b: Add the following PVs and adjust there scales.
VVPG:IN20:155:POSITION
TORO:IN20:431:TMIT
VGXX:IN20:113:P
Probe
1c: Use probe to understand what the PV VVPG:IN20:155:POSITION values map to?
Archiver
1d: Remake the Plot in question 1b
Change the Time to look at at 9:00am to at 11:00am
IRMIS
Q1:What ioc is the PV BEND:DMP1:400:BACT in?
Q2: How many BEND magnets are there in IN20? (Clue: each bend magnet should have one BACT PV
Q3: What is the IOC name(s) where they live?
Camonitor
camonitor BPMS:IN20:425:TMIT1H for about 20 updates
Try camonitor –h to look at options to do with camonitor