PVSS/Fw

1
ALICE DCS Naming Conventions

• PVSS/Fw
• OPC/DIM
• Network

Peter Rosinsky Peter Chochula, ACC team
2
General principles

• ALICE-wide DCS names standardization
• Assure smooth dvelopmentoperation
• Avoid conflicts
• Required/recommended by
• PVSS
• DP names, system names in distrib. system,
• JCOP framework
• Access control, DP, FSM,
• Other SW
• Good practices
• Meaning of privileges, user groups,
• Avoid exceptions

3
Applicability

• Mandatory
• system names
• project names
• OPC server names
• DIM server names
• DIM services
• datapoint names and type names
• network attached devices
• Strongly recommended
• panel names
• detector-specific script names

4
Composition of names

• Basic rule prefix_objName
• prefix unique code for subdetector or subsystem
• small letters, treated as a single word
• objName standard
• interCap notation first letter always small
• should be meaningful (functionality, location)
• objName exceptions
• datapoint types begin with capital letter (JCOP
  convention)
• FSM (objects, commands, states) all capital
  letters, underscore-separated
• FED DIM services and commands all capital
  letters
• DIM commands prefix omitted (DNS per
  subdetector)

5
Prefixes
Code Sub-detector or system Code Sub-detector or system
spd ITS SPD mtr Muon trigger
sdd ITS SDD zdc ZDC
ssd ITS SSD Emc EMCAL
tpc TPC Tri Trigger
trd TRD hlt HLT
tof TOF daq Central DAQ
phs PHOS dcs DCS
cpv CPV fra Front absorber
hmp HMPID saa Small angle abs.
fmd FMD sfr Space frame
pmd PMD l3m L3 magnet
v00 V0 dim Dipole magnet
t00 T0 bmp Beam pipe
mch Muon tracker exh Experimental hall
int Integration otr Other(not classif.)
6
Subsystems
Sub-System name Abbreviation
Low Voltage lv
High Voltage hv
Very High Voltage vhv
Crate Control cra
Environment env
Cooling coo
Gas gas
Front-end and ReadOut Electronics fero
Calibration cal
Laser las
Rack rck
Alignment aln
7
Controlled/monitored quantities
Physical quantity Abbreviation
Voltage v
Current i
Temperature t
Pressure p
Flow f
Humidity rh
8
Parameters
Parameter type Abbreviation
Monitored value mon
Setpoint value set
Trip value trip
Error limit (high limit, low limit, boolean) errHi, errLo, err
9
FSM

• SMI compatiblity ? UPPERCASE
• interCap notation cant be used ? underscore as a
  separator
• FSM naming rule DET_OBJECT_NAME
• DET three letter detector/subsystem code
• OBJECT_NAME meaningful description following the
  detector conventions

10
DIM

• FED DIM server
• one DIM DNS server per detector (on Operator
  Node) to be compatible with FED API (common
  commands)
• any external client should use this
  detector-specific DNS
• FSM DIM
• one central DIM DNS server for all (FSM tree)
• DIM services
• Follow the rules for DPs (prefix_objName)
• DIM commands
• can skip the prefix part

11
Examples

• DP type and Datapoint name
• Agd_seuRegisterSettings (DPT)
• agd_seuRegisterSettings (DP)
• AGD_seuRegisterSettings (DPT)
• agd_SeuRegisterSettings (DP)
• OPC server agd_opcWiener1
• FSM AGD_SIDEA_SECTOR3_MODULE1_LV

12
Other elements

• System names, projects, panels, scripts,
• follow the rule prefix_objName
• defined prefix, meaningful names
• PVSS Projects
• use the same name as systems
• note system number is assigned by ACC (use web
  form)
• DCS numbering convention
• fully compatible with ALICE rules
• as stated in Guidelines

13
Networked devices

• Must be unique across CERN!
• alidcs prefix reserved for P2 production
  installation
• ? do NOT register name beginning with this for
  the labs!
• convention only, no automatic restrictions by
  NETOPS
• regular checks foreseen
• Basic rule alidcsXXXNNN
• XXX three-letter device type code
• current list on the next slide
• NNN sequential number
• Examples
• alidcscom123, alidcscae013, alidcsdig002

14
Device codes
device code
computer com
CAEN cae
Wiener wie
PLC plc
DIGI boxes dig
BCAM bca
Switch swi
other (auxilliary) device aux
15
Production computers

• Names alidcscom001-999
• not descriptive, but rather inventory name
• Computer aliases (also unique across CERN!)
• encode detector and role
• Basic rule aliDETXXNNN
• DET three-letter detector code
• XX WN (worker node) or ON (operator node)
• NNN sequential number
• Verbose description
• use the LANDB description field for more (short
  meaningful)
• will be printed as a label and placed near your
  computer

16
Title

• Text
• text
• Text
• text