| Panel | |
|---|---|
Table of Contents
|
| Anchor | ||||
|---|---|---|---|---|
|
Overview
The FACET facility is controlled by a combination of the VMS-based SCP control system, and EPICS. EPICS controls are centered in the new experimental region in LI20, and include these subsystems: profile monitor, collimator/motion, bunch length monitor, wire scanner and event. Magnet, bpm and toroid subsystems in the new LI20 region are controlled by the SCP. A single EPICS controlled profile monitor will eventually reside in LI10.
All other FACET controls are SCP-based.
This document is a basic FACET control system physics development guide, with references to documents containing complete information.
...
I. Logging into the FACET control system network
The FACET EPICS control system resides on its own MCC-based private network, parallel to and separate from the LCLS network. The FACET server that will be used for physics work is:
- facet-srv01
The FACET and LCLS directory structures have a parallel naming convention:
- LCLS top-level directory: /usr/local/lcls
- FACET top-level directory: /usr/local/facet
To log into the FACET network from a linux terminal session:
- Account setup:
- Your afs unix account must be added to the facet group. Contact Ken Brobeck (x2558).
- You will be logging into the facet network as the shared fphysics account. For personal matlab settings, Mike Zelazny (x3673) will set you up with an (optional) user-specific directory and environment (ENVS script file) under fphysics.
- Login:
- Bring up a linux terminal window:
- from an MCC OPI or linux box click the terminal icon on the desktop
- from Windows use Secure CRT or XWin-32
- Log into mcclogin with your afs account:
ssh mcclogin - From mcclogin, log into facet-srv01 as the fphysics account
ssh fphysics@facet-srv01 - When prompted, enter your user number assigned by Mike (or 0 if you don't have one.)
- With Mike's setup, you are now in /home/fphysics/userid (e.g. /home/fphysics/fred)
- Bring up a linux terminal window:
...
II. FACET edm displays: facethome
facethome is the toplevel display for the FACET accelerator. It is similar to lclshome, a grid showing all areas and subsystems, with clickability into the various displays.
To run facethome from a terminal session on the facet network (see above) enter:
- enter
facethome &
at the command prompt
To run facethome from a an MCC opi:
- click the facethome icon on the display
...
III. SCP
To run a SCP from a terminal session window:
- you will need a VMS account on MCC. To get one, please contact Ken Brobeck (x2558)
- from your afs account on mcclogin, log into mcc and run the scp:
ssh mcc
scp xt userid (e.g. scp xt fred)
To run a SCP from facethome:
- click the "SCP..." button
...
IV. Matlab
...
For a complete overview, detailed instructions and examples please refer to the "MATLAB Programmer's Guide for FACET physicists", which can be found here:
/usr/local/facet/tools/matlab/programming_guide_matlab_facet.
...
docx and
...
...
Here
...
are
...
a
...
few
...
excerpts:
...
Environment
...
setup
...
After
...
you
...
log
...
onto
...
a
...
Linux
...
machine
...
using
...
the
...
fphysics
...
account,
...
you'll
...
need
...
to
...
customize
...
the
...
environment
...
for
...
matlab.
...
Once
...
Mike
...
Z.
...
has
...
set
...
up
...
your
...
user
...
directory
...
under
...
fphysics
...
as
...
described
...
in
...
II.
...
above,
...
add
...
these
...
commands
...
to
...
your
...
/home/fphysics/userid/ENVS
...
file,
...
and
...
they
...
will
...
be
...
automatically
...
invoked
...
every
...
time
...
you
...
log
...
in.
...
Note:
...
All
...
strings
...
are
...
case-sensitive.
...
- source
...
- /usr/local/facet/tools/script/ENVS_facet.bash
...
- export
...
- EPICS_CA_MAX_ARRAY_BYTES=40000000
...
- (if
...
- you'll
...
- be
...
- using
...
- OTR
...
- image
...
- data)
...
- export
...
- DISPLAY=your_IP_address:0
...
- (if
...
- you're
...
- logging
...
- in
...
- from
...
- Windows)
...
Note:
...
your_IP_address
...
can
...
be
...
found
...
after
...
running
...
ipconfig
...
on
...
Windows.
...
Starting
...
matlab
...
- If
...
- you
...
- want
...
- the
...
- full
...
- GUI
...
- development
...
- environment,
...
- type
matlab - If you want to run applications only and/or
...
- do
...
- some
...
- basic
...
- scripting
...
- (recommended),
...
- type
matlab -nodesktop
...
- -nosplash
...
This
...
- starts
...
- the
...
- fully
...
- working
...
- command-line
...
- version
...
- that
...
- requires
...
- much
...
- less
...
- resources.
...
Directories
- tested matlab scripts that are shared can be found here:
/usr/local/facet/tools/matlab/toolbox
...
- matlab
...
- scripts
...
- developed
...
- by
...
- the
...
- FACET
...
- software
...
- engineering
...
- group
...
- are
...
- here:
...
/usr/local/facet/tools/matlab/src
...
CVS
All shared matlab scripts are stored in the version control system, CVS. LCLS and FACET matlab scripts share their CVS repository, so there are many LCLS-specific scripts to be found in the toolbox and src directories, alongside the FACET and so-called "accelerator-agnostic"
...
versions.
...
For
...
much
...
more
...
info
...
see
...
the
...
Programmer's
...
Guide.
...
...
V.
...
BSA:
...
beam
...
synchronous
...
acquisition
For a complete overview, detailed instructions and examples please refer to the "MATLAB Programmer's Guide for FACET physicists", which can be found here:
/usr/local/facet/tools/matlab/programming_guide_matlab_facet.doc
...
and
...
...
Here
...
is
...
a
...
short
...
description:
...
A
...
LCLS
...
event
...
system
...
has
...
been
...
setup
...
to
...
read
...
devices
...
synchronous
...
with
...
beam
...
crossing,
...
such
...
as
...
BPMS
...
and
...
toroids.
...
FACET
...
beam
...
synchronous
...
acquisition
...
will
...
interface
...
with
...
both
...
EPICS
...
and
...
the
...
VMS-based
...
SCP.
...
Implementation
...
of
...
this
...
interface
...
is
...
currently
...
in
...
process.
...
The
...
BSA
...
system
...
will
...
be
...
usable
...
from
...
within
...
Matlab
...
with
...
a
...
few
...
simple
...
calls.
...
Note
...
that
...
this
...
is
...
not
...
implemented
...
for
...
image
...
data
...
collection,
...
which
...
is
...
described
...
in
...
a
...
separate
...
section
...
of
...
the
...
Programmer's
...
Guide.
...
Basically,
...
the
...
steps
...
for
...
using
...
BSA
...
are:
...
- Reserve
...
- an
...
- event
...
- definition
...
- Change
...
- default
...
- parameters
...
- Start
...
- data
...
- acquisition
...
- Release
...
- event
...
- definition
...
(see
...
Programmer's
...
Guide
...
for
...
the
...
all
...
the
...
info
...
and
...
examples
...
you'll
...
need)
...
...
VI.
...
AIDA
...
http://www.slac.stanford.edu/grp/cd/soft/aida/
...
VIII.
...
Useful
...
links
...
labCA |
...
commands |
...
...
all about AIDA |
...
...
CVS commands |
...
...
Device database |
...