1. TOTEM Configuration Tools
Fernando Lucas Rodríguez
Naming Schema
Pinout Tables
XlsToCsv
Pvss scripts: Dp and Fsm
Generic Panel
Archiving/Alarms/Units
Calibration
Use Case

2. 1. Naming Schema Roman Pots http://edms.cern.ch/document/906715
Common naming schema for Electronics, DCS, DAQ and offline
Formal approval in EDMS

3. 2. Pinout Tables
G:\Users\c\cmsdcs\Public\CMS_DCS_Repository\CMSFrameworkComponents\TOTEM\totServices\source\totServices\
All TOTEM components, and documents stored in SVN.
Post-commit hook to sync with DFS and CMS installation
Contains all the electrical connectivity wire by wire from the sensor or motherboard up to the connection to the ELMB or Power Supply.
They are implemented using an excel table, but if a proper User Interface is developed, XML or Oracle could be used…
Cabling technicians, detector responsible, operators and DCS people discuss over the same table (printed copy).
They are stored in SVN, so changed can be traced back; not so easy, but possible. Would be easier with XML or plain text files.

4. 3. XlsToCsv
C:\XLStoCSV
Reads and parse the excel table (but could interface with a database if needed).
Heuristics to build the Hardware Names and Logic Names.
Heuristics to determine the Fsm DU LU CU type
Resulting names are checked against the Naming Schema (under development).
Generates two types of files:
List of Hardware Names and Logic Names.
Hierarchy of Fsm with proper Types.

6. 4. Pvss scripts: Dp and Fsm
G:\Users\c\cmsdcs\Public\CMS_DCS_Repository\CMSFrameworkComponents\TOTEM\totServices
They read the CSV file generated by XlsToCsv and generates the proper PVSS datapoint using the JCOP functions . They also set the Logic Names.
The FSM is also generated in the same way.
Crates and buses are generated if needed.
They stop the OPC managers and start the simulators while the generation of the DP to build the proper OPC addresses and puts back the old manager status.

7. 5. Generic Panel
Shows all the Logic Names that follow certain naming rules

8. 6. Archiving/Alarms/Units
G:\Users\c\cmsdcs\Public\CMS_DCS_Repository\CMSFrameworkComponents\TOTEM\totServices\source\totServices\totem-Meta.xml
Uses the Pvss Type and the last suffix of the LOGIC NAME to determine all those attributes.
They are set (ensured) for all the DP on the current system that fulfill the conditions.

9. 7. Calibration // CALIBRATION
if ((calibrationLinearOffsetPos>0) && (calibrationLinearSlopePos>0) && (calibrationLinearRangeFixPos>0)) {
if (totServices_CheckValidValue(conf[calibrationLinearOffsetPos]) && totServices_CheckValidValue(conf[calibrationLinearSlopePos]) && totServices_CheckValidValue(conf[calibrationLinearRangeFixPos]))
totServices_EnforceLogicName(conf[hardwareNamePos], conf[logicalNamePos]+"Raw");
string dpCalibration = "CALIBRATION"+fwDevice_HIERARCHY_SEPARATOR+conf[logicalNamePos];
totServices_GenerateLinearCalibrationDp(conf[hardwareNamePos],dpCalibration,conf[calibrationLinearOffsetPos],conf[calibrationLinearSlopePos],conf[calibrationLinearRangeFixPos]);
conf[hardwareNamePos] = dpCalibration; }
First only providing mV
Later we keep the same Logic Names and we do calibration and conversion into mbar
We archive the Hw name (mV), but the panels are linked to the Logic Name,

10. 7. Use Case
void totServices_GenerateAutoLv(string inputfile) { dyn_string csvFiles = totServices_GeneratePinoutCsv(inputfile); totServices_GenerateWienerInit(); totServices_ProcessPinoutCsv(csvFiles,totServices_GenerateFilterLv()); totServices_RegenerateWienerOpc(); totServices_GenerateWienerFinish(); // Regenerate FSM //totServices_RegenerateFsm(); totServices_SetEasyArchivingLv(true); totServices_SetEasyUnitsLv(true); } dyn_string totServices_GeneratePinoutCsv(string excelfile) return totServices_XlsToCsv(excelfile, "--config main.xml --action pinout");