codac core system 5.3 cs-studio release...

PDF generated on 27 Jun 2016DISCLAIMER : UNCONTROLLED WHEN PRINTED – PLEASE CHECK THE STATUS OF THE DOCUMENT IN IDM

User Manual

CODAC Core System 5.3 CS-Studio Release Notes

In CODAC Core System 5.3, CS-Studio 4.3 with some ITER specific add-ons has been released with the following new features, bug fixes and known problems.

Approval Process Name Action AffiliationAuthor Utzel N. 23 Jun 2016:signed IO/DG/COO/SCOD/CSD/CDCCo-AuthorsReviewers Di Maio F. 23 Jun 2016:recommended IO/DG/COO/SCOD/CSD/CDCApprover Park M. 27 Jun 2016:approved IO/DG/COO/SCOD/CSD/CDC

Document Security: Internal UseRO: Stepanov Denis

Read Access AD: ITER, AD: External Collaborators, AD: IO_Director-General, AD: EMAB, AD: OBS - Control System Division (CSD) - EXT, AD: OBS - CODAC Section (CDC) - EXT, AD: OBS - CODAC Section (CDC), AD: Auditors, AD: ITER Management Assessor, project administrator, RO

IDM UID

SMSET5VERSION CREATED ON / VERSION / STATUS

23 Jun 2016 / 1.1 / Approved

EXTERNAL REFERENCE / VERSION

PDF generated on 27 Jun 2016DISCLAIMER : UNCONTROLLED WHEN PRINTED – PLEASE CHECK THE STATUS OF THE DOCUMENT IN IDM

Change Log

CODAC Core System 5.3 CS-Studio Release Notes (SMSET5)

Version Latest Status Issue Date Description of Change

v0.0 In Work 20 Jun 2016

v1.0 Signed 21 Jun 2016 Description of the new features, main bug fixes and known bugs and limitations

v1.1 Approved 23 Jun 2016 Some typos fixed and update version for HTML as some character and format were not properly converted

CS-Studio Release Notes Page 1 of 10

Table of Contents

1 Introduction .........................................................................................................................21.1 CODAC Core System Context...................................................................................21.2 Purpose.........................................................................................................................21.3 Scope.............................................................................................................................21.4 Related documents ......................................................................................................2

2 New Features........................................................................................................................32.1 Navigation Pane ..........................................................................................................32.2 Alarms List ..................................................................................................................42.3 OPIs Map.....................................................................................................................52.4 Alarm Page ..................................................................................................................62.5 New LED representation............................................................................................62.6 Text input new label property ...................................................................................72.7 Standard Analog and Digital faceplates ...................................................................72.8 OPIs path in development and runtime environment .............................................82.9 Miscellanea features....................................................................................................8

3 Main bug fixes......................................................................................................................94 Known Bugs and Limitations ...........................................................................................10

4.1 Icons too small on 4K screen....................................................................................104.2 The flash timing of symbols is not synchronised for all flashing states ...............104.3 Connection between widgets in different linking containers ................................104.4 Issue with archived data retrieval ...........................................................................10


1 Introduction

1.1 CODAC Core System Context

In CODAC Core System 5.3, CS-Studio 4.3 with some ITER specific add-ons has been released.

1.2 Purpose

The purpose of the Release Notes document is to communicate major new features and changes in this release of the CS-Studio as integrated in CODAC Core System 5.3. It also documents known problems and workarounds.

1.3 Scope

This document describes CS-Studio 4.3 for ITER which includes:

Operator Interface (OPI) – BOY - that connects to the control system, animates graphical widgets according to EPICS process Variable (PV) value, alarm status/severity and connection/RW status, shows PV’s range and alarm limits definition and allows the operator to interact with the process by providing input data and sending commands,

Alarm System – BEAST - that monitors alarm triggers in the control system and provides essential support to the operator by warning him of situations that need his attention, showing guidance, allowing him to open dedicated displays, execute commands and acknowledge raised alarms,

PON Archive System – BEAUTY - that monitors archived EPICS PVs in the control system and provides a graphical user interface for displaying live and historic data in a plot, making some computation, adding annotations and exporting samples into different file formats such as Excel spread sheet or Matlab,

Electronic Logbook – OLOG - that registers events entered manually or generated automatically during operation to keep track of problems, human decisions or actions which were taken during the course of the activity and which may have had an impact on the outcome of the activity.

Sequence of EPICS commands automation – SCAN.

1.4 Related documents

[RD1] CODAC Core System CS-Studio User Guide (QVBYD8 v1.0)[RD2] CSS all in one (BFGP5Q v1.8)


2 New Features

2.1 Navigation Pane

The navigation button animation reflects the highest severity of the corresponding alarm tree CBS node in order for the operator to navigate quickly on the area in active alarm state as illustrated on Figure 2-1, which shows that in CBS2 BUIL-B55 there are 2 areas in MINOR active alarm state. If an alarm requires to be acknowledged, the button is flashing at 2Hz.

Figure 2-1 CBS3 BUIL-B55-CW and BUIL-B55-VA are in MINOR active alarm state

Hovering the mouse over a navigation button, the tooltip will show the number of latched alarms on the corresponding alarm tree node as illustrated on Figure 2-2.

Figure 2-2 Navigation button tooltip includes the number of latched alarms information

Finally, making a right-click on a navigation button will allow the operator to acknowledge directly the alarm node and subsequent alarms as illustrated on Figure 2-3.

Figure 2-3 Navigation button “Latched Alarm” context menu


2.2 Alarms List

The Alarms List provides the operator with a list of all latched alarms and provides the functionality to navigate through the alarms tree and view additional information about alarms. A latched alarm is the first highest occurrence of an un-acknowledged alarm. If an alarm goes from minor to major state, the latched alarm will correspond to the major state, time and value. If an alarm flickers between cleared and alarm states, the latched alarm will correspond to the first time the highest alarm was triggered.

Each entry in an alarm list shows:

Tick box to acknowledge the alarm, Alarm priority symbol – major , minor , major cleared but not yet acknowledged ,

minor cleared , major acknowledged but not yet recovered , minor acknowledged . Disconnection/Invalid alarm symbols - , , ,

Alarm description, Date and time, Current severity and status. This information could be [OK – NO ALARM] if the condition that

triggered the alarm has returned to normal. Such cleared alarm will remain in the list until acknowledged by the operator (latched behaviour) but displayed in reverse video,

Alarm PV, Value of the setting transgressed, Alarm ID.

The background colour of the alarm message reflects the priority of the latched alarm and the alarm priority symbol flashes at 2Hz until acknowledged by the operator.

The Alarms List is using the standard operator user interface layout with the following specific zones:

Status Bar which provides the user with a high-level overview of ITER’s overall status, Alarms List which lists all latched alarms on the given alarm tree CBS node, Navigation Pane extended to the screen width that allows the user to navigate through the alarm

tree based on the CBS, and this in 5 clicks maximum.

The new Alarms List as illustrated on Figure 2-4 can be opened from any navigation button by a right-click Actions Open in a new window the Alarms List.

Figure 2-4 Alarms List on CBS2 BUIL-B55


2.3 OPIs Map

The OPIs Map provides the operator with a structured list of all OPIs used in the navigation. The map includes drop-down menu buttons that allow the operator to open directly the OPI, open the alarms list related to this OPI or open another OPIs map with the selected OPI highlighted.

The animation of the drop-down menu button is similar to a navigation button: the foreground colour reflects the highest severity of the corresponding alarm tree CBS node/leaf in order for the operator to see quickly which area is in alarm state, the tooltip shows the number of latched alarms on the corresponding alarm tree node, a context menu is available to acknowledge directly the alarm tree node and subsequent alarms.

The new OPIs Map as shown on Figure 2-5 can be opened from any navigation button by a right-click Actions Open in a new tab the OPIs Map.

Figure 2-5 OPIs Map buttons reflect the highest severity of the alarm tree CBS node


2.4 Alarm Page

For each defined alarm, an alarm page has to be designed according to a standard layout accessible from boy templates Alarm.opi and AlarmPage.opi.

To ease the development, SDD is generating for an I&C project all ITER-{pv_name}_Alarm.opi and prepares the alarm description in ITER-{pv_name}_AlarmPage.opi.

What remains to be designed is the alarm procedure and PV trends as illustrated on Figure 2-5.

Figure 2-6 Alarm Page for the PV UTIL-S15-BG93:MUT2-ET4

2.5 New LED representation

As requested by Operation, the LED widget default properties and behaviour have changed:

Off state colour = light brown On state colour with no alarm = Green On state colour with minor alarm = Yellow On state colour with major alarm = Red On/Off disconnected state colour = Magenta

Two standard rules have been attached to the LED widget as illustrated on Figure 2-7.

Figure 2-7 Standard rules for the LED ON and OFF properties

Figure 2-8 gives the details of the Alarm LED ON State Color rule definition.


Figure 2-8 LED On Color property rule definition

Tip: To add the rules on existing OPI, just validate the OPI and make a quick fix.

2.6 Text input new label property

It is now possible to add directly a label to an input field instead of adding a Label widget to the Text Input widget. By default, the label position is above the entry field as illustrated on Figure 2-9.

Figure 2-9 Text input label above the entry field

2.7 Standard Analog and Digital faceplates

Standard faceplates have been designed to display PV and alarm information for analog / digital input and output as illustrated on Figure 2-10.

Figure 2-10 Analog and digital input standard faceplate


They are accessible from boy templates faceplates and can be integrated as any faceplate by defining an action as illustrated on Figure 2-11.

Figure 2-11 Analog input faceplate action

2.8 OPIs path in development and runtime environment

To standardise the OPI path between development and runtime environment, a new linked boy folder is created under the I&C project folder which points to src/main/boy folder during the development phase.

This linked folder is mainly used to refer to an alarm page as /{I&C project}/boy/ITER-{pv_name}_Alarm.opi in order to open it within the workspace from the alarm pane and the alarms list.

2.9 Miscellanea features

The faceplate demo resources make use of control native widgets in order to have the next focus feature with the TAB or ENTER keys to go to the next entry field or control button.

The period for repeated annunciation of active alarms has been disabled (nagging period).


3 Main bug fixesThe issue with modal dialogs in full screen have been fixed. In 5.2, popup windows such as “Show macros”, “Dump PV List” or any error messages were displayed behind the OPI running in full screen which prevented to validate and close the dialog.

The alarm pane connection/disconnection issue in case of alarm server timeout is solved. In case of disconnection, the alarm pane is now disabled and a “Disconnected” message is displayed on top of the table. When the alarm server is back online, the alarm pane reconnects automatically to the list of alarms and is enabled.

The action label “Go to” on navigation buttons was incomplete. The description of the CBS as defined in the navigation xml configuration file has been added. Example: “Go to Monitoring of Cooling Water System”.


4 Known Bugs and Limitations

4.1 Icons too small on 4K screen

This a known issue of Eclipse and shall be resolved in the next release.

4.2 The flash timing of symbols is not synchronised for all flashing states

This issue will be solved for the next release.

4.3 Connection between widgets in different linking containers

The problem occurs only if the default routing is changed by the developer.

Figure 4-1 shows two super object valves in two different linking containers and standard / non-standard routing connections between widgets. Once the mimic is integrated into the canvas, the non-standard routing connection goes outside the frame.

Figure 4-1 Non default routing issue


4.4 Issue with archived data retrieval

It could happen that no archived data are retrieved and plotted due to a database error traced in the console - org.postgresql.util.PSQLException: ERROR: portal "C_n" does not exist.


codac core system 5.3 cs-studio release...

Documents