APSU PVs

The APS-U has changed many of the process variables(PVs) used for the last 25 years. This includes PVs related to EPS (or FEEPS), PSS, status, insertion devices, etc. Sometimes only the PV name has changed but in some instances the old PV does not have a direct replacement.

This wiki will help to describe what is new, what has been removed, and how to convert to using some of the new PVs available.

All APS-U PVs

All of the PVs currently served by the APS-U are listed in the files in the directory /APSshare/C2/iocinfo/pvdata/. This is an rsync of the oxygen-based directory /net/helios/C2/iocinfo/pvdata/. The files located in this directory are named after the IOC which hosts those PVs. By grepping through the files, one can determine if a PV exists or if the name has changed.

% grep -s XFD:srCurrent /APSshare/C2/iocinfo/pvdata/*
/APSshare/C2/iocinfo/pvdata/siocblops:XFD:srCurrent

A useful tool located in /APSshare/bin called 'pvExist' will also confirm whether a PV is valid and what IOC is hosting it:

% /APSshare/bin/pvExist XFD:srCurrent
Using IOC_INFO environment variable /APSshare/C2/iocinfo
siocblops:XFD:srCurrent
% /APShare/bin/pvExist XFD:srCurrent1
Using IOC_INFO environment variable /APSshare/C2/iocinfo
XFD:srCurrent1 not found

EPS (or FEEPS) PVs

Here are the Equipment Protection System PVs for APS-U. Compare to the old PVs as described at https://epics.anl.gov/bcda/aps/frontendpvs.php

Note that there are not 'xx' or 'yy' display subs - only 'Z' and 'a') In other words, display substitution is Z=Sxxyy, a=SxxyyFE where:

     xx = 2 digit sector number
     yy = BM or ID

Changed

Old PV Name:                  New PV Name:
EPS:xx:yy:PS1:POSITION  Sxxyy-FEEPS:PS1:PositionM
                                   0     Moving
                                   1     Closed
                                   3     Open
                                   4     Position Error

EPS:xx:yy:PS2:POSITION  Sxxyy-FEEPS:PS2:PositionM
                                   0     Moving
                                   1     Closed
                                   3     Open
                                   4     Position Error

EPS:xx:yy:SS1:POSITION  Sxxyy-FEEPS:SS1:PositionM
                                   0     Moving
                                   1     Closed
                                   3     Open
                                   4     Position Error

EPS:xx:yy:SS2:POSITION  Sxxyy-FEEPS:SS2:PositionM
                                   0     Moving
                                   1     Closed
                                   3     Open
                                   4     Position Error

EPS:xx:yy:FEV:POSITION  Sxxyy-FEEPS:FEV:PositionM
                                   0     Moving
                                   1     Closed
                                   3     Open
                                   4     Position Error

EPS:xx:yy:BIV:POSITION  Sxxyy-FEEPS:BIV:PositionM
                                   0     Moving
                                   1     Closed
                                   3     Open
                                   4     Position Error

New

These PVs are new and were not present before:

Sxxyy-FEEPS:TripsExistM
     0 OFF (No Trip)
     1 ON  (Trip(s) Exist)

Sxxyy-FEEPS:FaultsExistM
     0 OFF (No Fault)
     1 ON  (Fault(s) Exist)

Sxxyy-FEEPS:WarningsExistM
     0 OFF (No Warning)
     1 ON  (Warning(s) Exist)

Sxxyy-FEEPS:ShutterPermitWarnM
     0 OFF (No Warning from BLEPS)
     1 ON  (Warning(s) Exist from BLEPS)

Sxxyy-FEEPS:VacuumPermitWarnM
     0 OFF (No Warning from BLEPS)
     1 ON  (Warning(s) Exist from BLEPS)

Removed

The following PVs have been removed and there is no replacement:

EPS:xx:yy:PS1:STATUS
EPS:xx:yy:PS2:STATUS
EPS:xx:yy:SS1:STATUS
EPS:xx:yy:SS2:STATUS
EPS:xx:yy:SV:STATUS
EPS:xx:yy:SV:POSITION
EPS:xx:yy:FV:STATUS
EPS:xx:yy:FV:POSITION
EPS:xx:yy:FEV:STATUS
EPS:xx:yy:BIV:STATUS
EPS:xx:yy:CC1:RDY
EPS:xx:yy:CC2:RDY
EPS:xx:yy:VAC:CC1:RDY
EPS:xx:yy:VAC:CC2:RDY
EPS:xx:yy:MM:F

PSS PVs

There have been a significant amount of PV changes with the PSS PVs. Unfortunately there is no easy translation tool from older PVs to the new APSU PSS PVs.

Each beamline could look at the PSS Input/Output EPICS screens to determine what their new PVs are. This can be done by starting up /APSshare/adlsys/xfd-display then selecting the light blue PSS button, then selecting the drop-down blue button for the beamline (e.g. 27-ID). From there select either "Inputs" or "Outputs". If the beamline is a Gen4 system, then select either "Systems" or "Stations". These 2 EPICS screens will display all of the PSS PVs and you can find the appropriate ones needed.

According to the SI group, for Gen3 PSS system the shutter control PVs did not change. Only the Gen4 systems PVs were changed. For this second run in 2024, the Gen4 systems will be 8ID, 9ID, 15ID, 16BM, 19ID, 20ID, 22ID, 25ID (to be completed after the Aug 2024 shutdown), 31ID, 33ID and 34ID. See the following example PSS Gen4 PVs where:

     xx = 2 digit sector number
     yy = BM or ID
Old Gen PSS PV's                 New Gen4 PSS PV's
PA:xxyy:STA_A_FES_OPEN_PL            Sxxyy-PSS:FES:BeamBlockingM
PA:xxyy:STA_D_SDS_OPEN_PLS           Sxxyy-PSS:SDS:BeamBlockingM
PA:xxyy:STA_A_SEARCHED_PL            Sxxyy-PSS:StaA:SecureM
PA:xxyy:STA_C_SEARCHED_PL            Sxxyy-PSS:StaC:SecureM
PA:xxyy:STA_D_SEARCHED_PL            Sxxyy-PSS:StaD:SecureM

APS Status PVs

The following describes the status PVs. These can be compared to the previous PVs which are explained at https://epics.anl.gov/bcda/aps/statuspvs.php

Changed

S:DesiredMode
     0     State Unknown
     1     USER OPERATIONS
     2     SUPLEMENTAL TIME
     3     Not Used
     4     ASD Studies
     5     NO BEAM
     6     MAINTENANCE
S:ActualMode
     0     State Unknown
     1     NO BEAM
     2     Injecting
     3     Stored Beam
     4     Delivered Beam
     5     MAINTENANCE

OLD PV                              NEW PV
ACIS:ShutterPermit            RF-ACIS:FePermit:Sect1To35IdM (1-35 Beamlines)
                              RF-ACIS:FePermit:35Bm38AmM    (35BM and 38AM Beamlines)
ACIS:ShutterPermit            XFD:ShutterPermit             (alias to RF-ACIS:FePermit:Sect1To35IdM)
S:SRcurrentAI                 XFD:srCurrent

Unchanged

S:OrbitCorrection:CC
S:OrbitControlLawXFineBO
S:OrbitControlLawYFineBO
S:FillNumber
XFD:srCurrent
S:SRtimeCP & S:SRcurrentCP
S:SRdateCP
XFD:LifeTimeHrs
XFD:message1
XFD:message2
XFD:message3
XFD:message4
XFD:message5
XFD:message6
XFD:message14
XFD:message15
XFD:message17
XFD:message18
OPS:TimeOfDaySI
Liquid Nitrogen Distribution System Information PVs

Removed

SRFB:GBL:LoopStatusBI
SRFB:GBL:VLoopStatusBI
SRFB:GBL:HLoopStatusBI
SRFB:dsp2:xRMSmotion30HzPkM
SRFB:dsp2:yRMSmotion30HzPkM
S:VID1:filteredXemittance
S:VID1:filteredYemittance
S:VID1:filteredCoupling
ALL TopUp related information PVs

Insertion Device PVs

Here is a list of old and new PV names for insertion devices. The names have changed but there is no change to their meanings.

Note that there is no sector 4 CPU and the messages for the message PVs are still the same as well.

Compare this to the previous page at https://epics.anl.gov/bcda/aps/idpvs.php

$(xx) = 2 digit sector number
$(yy) = US or DS (Position of ID in storage ring straight)
(Note: there are not any xx or yy display subs, display substitution is P=SxxID:yyID)

Changed

Control Process Variables

---

Old PV Name:                  New PV Name:
ID$(xx):GapSet                S$(xx)ID:$(yy)ID:GapSetC
ID$(xx):TaperGapSet           S$(xx)ID:$(yy)ID:TaperGapSetC
ID$(xx):ScanGap               S$(xx)ID:$(yy)ID:ScanGapC
ID$(xx):ScanEnergy            S$(xx)ID:$(yy)ID:ScanEnergyC
ID$(xx):EnergySet             S$(xx)ID:$(yy)ID:EnergySetC
ID$(xx):TaperEnergySet        S$(xx)ID:$(yy)ID:TaperEnergySetC
ID$(xx):DeadbandGap           S$(xx)ID:$(yy)ID:DeadbandGapC
ID$(xx):HarmonicValue         S$(xx)ID:$(yy)ID:HarmonicValueC
ID$(xx):Start                 S$(xx)ID:$(yy)ID:StartC
ID$(xx):Stop                  S$(xx)ID:$(yy)ID:StopC

Monitor Process Variables

---

ID$(xx):Gap                   S$(xx)ID:$(yy)ID:GapM
ID$(xx):TaperGap              S$(xx)ID:$(yy)ID:TaperGapM
ID$(xx):Energy                S$(xx)ID:$(yy)ID:EnergyM
ID$(xx):TaperEnergy           S$(xx)ID:$(yy)ID:TaperEnergyM
ID$(xx):Busy                  S$(xx)ID:$(yy)ID:BusyM
ID$(xx):Message1              S$(xx)ID:$(yy)ID:Message1M
ID$(xx):Message2              S$(xx)ID:$(yy)ID:Message2M
ID$(xx):Message3              S$(xx)ID:$(yy)ID:Message3M
ID$(xx):OldGapSet             S$(xx)ID:$(yy)ID:OldGapSetM
ID$(xx):Taper                 S$(xx)ID:$(yy)ID:TaperM
ID$(xx):EncoderSelect         S$(xx)ID:$(yy)ID:LinearEncoderUsedM
ID$(xx):PositionAccuracy      S$(xx)ID:$(yy)ID:PositionAccuracyM
ID$(xx):Location              S$(xx)ID:$(yy)ID:LocationM
ID$(xx):Device                S$(xx)ID:$(yy)ID:DeviceM
ID$(xx):Version               S$(xx)ID:$(yy)ID:$(dd)VersionM
      Where dd = HPMU, Rev (Revolver), STI (2-Motor ID)
ID$(xx):ShClosedTime          ID$(xx)(zz):ShClosedTime
      Where zz = us or ds
ID$(xx):MotorSpeed            S$(xx)ID:$(yy)ID:MotorSpeedC
ID$(xx):GapReturn             S$(xx)ID:$(yy)ID:GapReturnM
ID$(xx):TaperGapReturn        S$(xx)ID:$(yy)ID:TaperGapReturnM
ID$(xx):TotalPower            S$(xx)ID:$(yy)ID:TotalPowerM
ID$(xx):ExpectedPower         S$(xx)ID:$(yy)ID:ExpectedPowerM
ID$(xx):AccessSecurity        S$(xx)ID:$(yy)ID:AccessSecurityC
ID$(xx):DeviceLimit           S$(xx)ID:$(yy)ID:DeviceLimitM

Removed

The synchronous scanning PVs (those beginning with SS) have been removed. It is unlikely that any beamline was using these PVs.