...
Naming
...
Conventions
...
for
...
Control
...
System
...
Devices
...
Note: this document is currently being updated. Notably, the examples are not yet finalized.
...
Defining a Naming Convention for devices in the LCLS Control System has been an iterative process. The first version was a variation on the existing SLAC SLC Naming Scheme. With the LCLS and the addition of X-Ray transport lines and experimental halls, we decided to extend the Original LCLS scheme to what is described here.unmigrated-wiki-markup
...
...
...
...
...
...
...
...
...
...
...
...
Wiki Markup |
---|
{center}*DeviceType* : *Area* : *Position* |
|
...
...
...
...
...
...
...
...
...
...
Wiki Markup |
---|
{center}*QUAD* : *IN20* : *122* |
|
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
Wiki Markup |
---|
{center}*DeviceType* : *Area* : *Position* : *Attribute* |
|
...
Wiki Markup |
---|
The _DeviceType_ and _Position_ fields also have optional characters. We can denote optional symbols with *\[* and *\]*, so the names can be described as: |
|
...
Wiki Markup |
---|
{center}*\[* DeviceType *\]* *DeviceDetail* : *Area *: *\[* PositionPrefix *\]* *Position* : *Attribute* |
|
...
To summarize: - A Device is named by 3 fields, separated by 2 colons.
- A function or parameter of a device, known internally to the Control System as a Process Variable (PV) is named by the 3-field device name followed by another colon, and the Attribute field.
|
Constraints
- All fields are required to be Upper Case characters.
- The entire name is currently restricted to 28 characters or less.
- The DeviceType is between 3 and 9 characters in length. The generic type of device is denoted by 3 or 4 characters, and may optionally be followed by an underscore with 3 or 4 more characters to indicate details of that device.
- The Area field is 4 characters in length, and describes one of the 21 areas currently in the LCLS Accelerator.
- The Position field can be up to 4 characters in length, which includes either an optional 1-character position prefix followed by 3 digits (for devices associated with the beam line) or 2-character prefix followed by an index for non-beam-line devices which are itemized.
- The Attribute field must be 12 characters or less.
...