CCS Engineering Tools The tools are used help

CCS Engineering Tools The tools are used help development and debugging of VLT SW control applications This presentation will provide a general view of the most used engineering tools. Mauro Comin – INS Workshop 2008

CCS Engineering Tools – Database Browser The database browser provides a tool to see the database structure § ccsei. Db can display the database of WS or LCU environments § The database tree is made by “points” (like directories in file system) § Points have a “symbolic name” and an “alias” § Points contain “attributes”, which contain the real data Mauro Comin – INS Workshop 2008

CCS Engineering Tools – Database Browser An attribute is described by the following parameters § Name § Attribute Type : defines the structure of the data SCALAR, VECTOR or TABLE § Data Type : defines the db. INT 8, db. UINT 16, db. FLOAT, db. BYTES 16, … § Quality : it applies for scanned attributes of to those defined with the calculation engine. § Value Mauro Comin – INS Workshop 2008

CCS Engineering Tools – Database Attribute Editing Database attributes can be edited to modify their values § Attributes of type SCALAR can be edited directly in the list of attributes § There is a “editing” dialog for each data type Ø Scalars Ø Vectors Ø Tables Mauro Comin – INS Workshop 2008

CCS Engineering Tools – Database Calculation Engine The calculation Engine (CE) allows the user to use database attributes in expressions to derive database values Ø ccsei. Db provides a way to prototype Calculation Engine (CE) functions By default the user cannot edit CE definitions > Export WITH_CCS_SETCE=ON Allows the user to change online the CE expressions Two new buttons can be used to modify the expression Mauro Comin – INS Workshop 2008

CCS Engineering Tools – Database Monitor Ø Monitor Database values § Elements can easily added from Db Browser § List of monitored attributes can be saved in files § Data can be saved in files and. . later on. . displayed as plots The sampling time can be adjusted Start monitoring the database … and attributes optionally the data can be saved in a file Mauro Comin – INS Workshop 2008

CCS Engineering Tools – Message Window The message command window provides an interface to the message and command interface for processes in WS and LCU environments § The user can send commands. . see received replies … and the whole error stack Other interesting functionality § Load and check CDT tables § Simulated setup window § Command scripts Mauro Comin – INS Workshop 2008

CCS Engineering Tools – Command Help Window A new tools allows the user to get help for commands. It’s a stand alone GUI that provides the list of commands for a given process > ccsei. Cmd. Help rdb. Server . . or directly the help for a given command > ccsei. Cmd. Help rdb. Server DBDATON Mauro Comin – INS Workshop 2008

CCS Engineering Tools – Historian History points are … history it readsmanager samples is the core of all with History tables are used to collect database data for apoints long. The period ofthe time the attributes historianand … itstores takes the caredata of the specific ID : “ 65411” configuration into the history of the table history table Database historian config History Point 2 Get List of History Points his. DHMngr History Point 1 Class 65411 Store Sampled data history config Get Hist. Point Configuration setups statstics User enters new Configuration History Point 3 The user interacts with the Attributes sampled by his. DHMngr and their value are historian ALWAYS through stored in the history table the history manager. Mauro Comin – INS Workshop 2008

CCS Engineering Tools – Historian § § History tables can be started/stopped according to several conditions At any write on sampled attributes At any write on start/stop trigger attributes At a given time According to the value of the start/stop attributes : > , < , >=, <= , != Mauro Comin – INS Workshop 2008

CCS Engineering Tools – History Table Commands Interaction with the history tables is done by sending commands to the history manager. This applies to GUIs as well as to scripts. The most common commands are : § CFGSTUP – Configure the history table § HTCLEAR – Clear the history table § HTCRTL – Control the status of the history table : ARM, DISARM, ENABLE, DISABLE § ONESHOT – Force the reading of all sampled attributes Mauro Comin – INS Workshop 2008

CCS Engineering Tools – his. Config. Tool A set of graphical interfaces provides the basis for the user interaction with the history tables § his. Config. Tool – shows the list of all known history tables and their status It provides a set of basic commands “Data Configuration” allows the user to see the data collected by the history table “Setup Configuration” allows the user to see the data collected by the history table Mauro Comin – INS Workshop 2008

CCS Engineering Tools – plot. Display The plot. Display allows the user to graphically display data. Shared Memory Area Plot Configuration Plot Buffers New Configuration Get Access to Shared Memory Configuration New Data Re. Configure Plot New Data Display Data Plot points are database points Notify There is one plot. Display for each plotall !! with specific ID : Terminatio n Databas User enters “ 65501” new Attach New plot. Display e …Getit. Event read the data On the shared memory and plots Configuration New. Configuratio n plot. Server plot. Display Plot Point Read New Configuration Read Data based on Polling or on event Plot Source Data The plot. Server takesthe care … it reads samples of the plot configuration attributes and stores the data into a shared memory area Mauro Comin – INS Workshop 2008

CCS Engineering Tools – plot. Display The plot module provides some macros to help defining the plot points /vlt/VLT 2008/CCSLite/dbl/plot. COMMON_DEFS. class ATTRIBUTE Table "curves" (4) BEGIN Value ( plot. CURVES_ENTRY 1(1000, "red", 1, -1, 1, "pen 1", plot. CURVES_ENTRY 1(1000, "green", 1, -1, 1, "pen 2", plot. CURVES_ENTRY 1(1000, "yellow", 0, -1, 1, "pen 3", plot. CURVES_ENTRY 1(1000, "blue", 0, -1, 1, "pen 4", ) END ATTRIBUTE Table "traits" (24) BEGIN Value ( plot. TRAITS_ENTRY 1(0, "magenta", "red", 0), plot. TRAITS_ENTRY 1(1, "cyan", "green", 0), plot. TRAITS_ENTRY 1(2, "turquoise", "yellow", 0), plot. TRAITS_ENTRY 1(3, "salmon", "blue", 0) ) END 0, 1, 2, 0, plot. DATA_XY, "[]", "[]" ), ), ), ) ATTRIBUTE Table "limits" (4) BEGIN Value ( plot. LIMIT_ENTRY(0, 0, "white", "[]"), plot. LIMIT_ENTRY(0, 0, "white", "[]") ) END Mauro Comin – INS Workshop 2008

CCS Engineering Tools – plot configuration A set of graphical interfaces provides the basis for the user interaction with the history tables § plot. Selector – shows the list of all known plot points and their status § plot. Config. Tool configures the common parameters of the plot -e. g. - x label, Scaling, division, number of pens, … § plot. Config. Penl configures single curve. -e. g. - y label, updating mode, color, scaling, division, … Mauro Comin – INS Workshop 2008

CCS Engineering Tools – plot features § Data can be displayed as single curve. . or displayed in groups § Data read from a db attribute with “Bad Quality” are marked § The “Application Text” are used to describe what the curve shows Mauro Comin – INS Workshop 2008

CCS Engineering Tools – plot advanced features New features are available since the 2007 release § Limit Lines – For each “plot” the user can define a lower/upper limit line § The user can “shade” the portion of the curve falling below/above the limit lines § Shading can also be used to “enhance” differences between curves Mauro Comin – INS Workshop 2008

CCS Engineering Tools – plot. File. Display The plot. File. Display is used to draw plots from data stored in ASCII files § Data should be arranged in columns !! … each line representing a single “record” § The number of records shown in the plot can be configured. Mauro Comin – INS Workshop 2008

CCS Engineering Tools – sampling tool The sampling tool provides a flexible way to collect data from WS or LCU databases. § Data are sampled in “polling”. § WS attributes are sampled in sec. § LCU attributes are sampled defining : - Report Period - Sampling Rate (down to 50 msec) § The list of attributes can be saved in a file § The data can be saved in a file § Plots are automatically generated during sampling Mauro Comin – INS Workshop 2008

CCS Engineering Tools – sampling script API The sampling tool provides a script API that allows the user to : § Start sampling in “background” - i. e. - no plots generated § Start/stop several sampling tasks at the same time The script API is made of two calls : samp. Start -v -d -n <1|0> <file. Name> <plot point> <env. Name> <env. Type> <sample. Rate> <report. Rate> <DB attribute list> samp. Stop -v -d -n <plot point> <env. Name> <env. Type> Example : Data are not displayed but only stored in a file : samp. Start -n 1 ". /file. Name" samp. PEN 8 lte 47 LCU 1 4 <DB attribute list> Mauro Comin – INS Workshop 2008

CCS Engineering Tools To finish I would like to provide some general guidelines. § Use history tables to record long term statistics § Use ccsei. Db. Monitor to monitor DB attributes from several environments § Use samp. Ctrl to get a FAST sampling from of the LCU database § Use samp. Ctrl to quickly plot data from the WS or LCU databases § plot. File. Display is able to plot ASCII data files as long as the data are stored in columns § Due to the last two points … always define a few plot points for general usage § Use CCS macros to define plot points § . . and even more important if there are missing features … let us know before investing time for a custom made solution !! Mauro Comin – INS Workshop 2008

CCS Engineering Tools … now the it’s your turn to “play” … have fun … histor y … this and more in … ccsei. Msg samp. Ctrl VLT-MAN-ESO-17210 -3816 ccsei. Db plot. Displa y … Thanks For Your Attention Mauro Comin – INS Workshop 2008