Installation Notes
Java
Oracle Java Platform 8 (JDK) must be installed. Installation packages can be downloaded from here:
Java Platform, Standard Edition: http://www.oracle.com/technetwork/java/javase/downloads/index.html
Note: Open-JDK cannot be used because of the lack of JavaFX support.
Java 9/10
Current version of CS-Studio doesn't run on the Java 9/10 VM. If you have installed Java 9 (possibly because you are evaluating or working with it) and Java 8, then you need to tell CS-Studio to used Java 8.
On MacOS X
- Right-click on the ESS CS-Studio.app application and select Show Package Contents menu item;
- Navigate into the
Contents/Eclipse
folder and edit theESS CS-Studio.ini
file; - Before
--launcher.library
add the following two lines:
-vm
/Library/Java/JavaVirtualMachines/jdk1.8.0_181.jdk/Contents/Home/jre/bin
where jdk1.8.0_181.jdk
should be replaced by the Java 8 version you have installed.
On CentOS
- Edit the
/opt/cs-studio/ESS CS-Studio.ini
file; - Before
--launcher.library
add the following two lines:
-vm
/usr/java/jdk1.8.0_181/jre/bin
where jdk1.8.0_181
should be replaced by the Java 8 version you have installed.
On Windows (Unsupported Platform)
- Edit the
ESS CS-Studio.ini
file inside the application folder; - Before
--launcher.library
add the following two lines:
-vm
C:\Program Files\Java\jdk1.8.0_181\jre\bin\
where jdk1.8.0_181
should be replaced by the Java 8 version you have installed.
Memory
CS-Studio runs pretty well on machine with at least 4 GBytes. If it must be run from inside the ESS DM, at least 8 GBytes are necessary, allocating 4 for the DM.
css-update
The supported method to update CS-Studio in the DM is described here.
Documentation
- Documentation about ESS version of CS-Studio can be found at the ESS CS-Studio homepage.
- Compatibility notes can be found at the CS-Studio Compatibility Notes and Known Bugs page.
Development
Ver. 4.6.1.12
What Is Changed
- BOY Fix: Combo box: Ignore mouse wheel on Linux without breaking use on Mac.
- RDB Archive Fix: Write NaN for scalar component of zero-sized array.
- Display Builder Fix: Don't use image cache in edit mode in Picture and Symbol widgets.
- Display Builder Fix: Refresh embedded display when changing its macros.
- Display Builder Fix: Reload Display in editor mode should check whether the file is saved.
- Display Builder Update: Text widgets use their text in tool tip's
$(pv_value)
.
Production
Ver. 4.6.1.11 (28.11.2018)
Various fixes and updates.
What Is Changed
- Display Builder Fix: More object disposed when an OPI is closed, speeding up GC.
- Display Builder Fix: Further improvements on Meter widgets initial PV value display.
- Display Builder Fix: Tooltip not working in Ellipse, Arc, Polygon and Polyline.
- Display Builder Fix: Vertical scrollbar widget not redrawn when height changed.
- Display Builder Update: Debug option to show update rate in plots.
- Display Builder Update: Added missing labels to ByteMonitor widget.
- Display Builder Update: Added missing "foreground" property to CheckBox and Image widgets.
- Phoebus Integration New: Added integration with the Phoebus Alarms applications.
- Phoebus Integration New: Added integration with the Phoebus ChannelFinder application.
Ver. 4.6.1.10 (23.10.2018)
Various fixes and updates.
What Is Changed
- Display Builder Fix: Symbol widget not always loading images correctly.
- Display Builder Fix: Better handling of SVGs in Symbol and Picture widgets.
- Display Builder Fix: Gauges and Meter widgets not initially displaying the current PV value.
- Display Builder Fix: Knob widget in strange state if right-clicked into the thumb lane.
- Display Builder Fix: Spinner widget autonomously spinning if right-clicked or dragged on its buttons.
- Display Builder Fix: ScrollBar widget autonomously increasing/decreasing if right-clicked on its buttons.
- Display Builder Fix: ScaledSlider widget updating value is right-clicked on its thumb lane.
- Display Builder Fix: Meter widget minor ticks can disappear if minimum is negative and minor thicks space is non-integer.
- Display Builder Update: Meters examples.
Ver. 4.6.1.9 (02.10.2018)
Various fixes and updates.
What Is Changed
- Display Builder Fix: '!' used in text inside rules converted to 'not'.
- Display Builder Fix: Newly (empty) created Table widget not attached to a PV displays one strange cell of data.
- Display Builder Update: It is now possible to choose which
.opi
files should be opened in BOY when the action is performed inside a Display Builder OPI. By default all.opi
files will be opened by BOY unless the same file with extension.bob
is found instead. - Display Builder Update: Script API help.
- Display Builder Update: Jython script engine updated to ver. 2.7.1.
- Display Builder New: Added a property to allow verbose
.bob
files. - Display Builder New: Slider Button widget.
- BOY Fix: Reverted the default named colours and fonts, leaving only the specific Display Builder's non-default ones.
- EDM/EDL Converter Update: Settings updated.
Ver. 4.6.1.8 (03.09.2018)
Various fixes and updates.
What Is Changed
- CS-Studio Fix: Problems connecting to MySQL databases after driver updates.
- CS-Studio Update: Improved the build system to keep only the last 7 builds of the development version.
- BOY: Added Display Builder's colours and fonts definition to BOY's ones.
- Display Builder Update: Table widget behaviour now similar to a spreadsheet (e.g. Excel).
Ver. 4.6.1.7 (23.08.2018)
Various fixes and updates.
What Is Changed
- Archiver Fix: The archive engine takes time to start and archive samples.
- Data Browser Fix: Cancel button fails on to cancel search if it is taking a long time.
- Data Browser Fix: Automatic value axes naming can be wrong sometimes.
- Data Browser Update: In non-scrolling mode, the future area is shaded gray.
- Data Browser Update: Help page.
- Data Browser Update: Allow plot_bins as scaling factor for display width.
- Display Builder Fix: BLUE-BORDER colour.
- Display Builder Fix: Single-image Symbol widget not properly saved if created by D&D.
- Display Builder Fix: Symbol widget not updated if a symbol file is updated.
- Display Builder Fix: Text not perfectly centred in LEDs.
- Display Builder Fix: Widget initial
value
update in case PV sent value before listening. - Display Builder Fix: No context menu in standalone windows.
- Display Builder Fix:
ScriptUtil.closeDisplay(widget)
not working for standalone windows. - Display Builder New: Allow dragging widget's primary "pv_name" as text from the OPI runtime.
- Display Builder Update: Added LEDs colours to ESS colour themes.
- Display Builder Update: Flat LEDs, improving their contrast and legibility.
- Display Builder Update: Added
line_color
to LED and MultiStateLED. - Display Builder Update: X/Y Plot with unnamed tracks will not display the EGU.
- Display Builder Update: More details in Plot Configuration Dialog.
- Waveform View Update: support multiple traces.
- CS-Studio New: First implementation of a Phoebus integration plugin.
- CS-Studio Update: MySQL drivers updated to ver. 8.
Ver. 4.6.1.6 (02.08.2018)
Various fixes and updates.
What Is Changed
- Display Builder Fix: PVs can't contain '=' inside their name.
- Display Builder Fix: Rules using expressions with <= and >= are no more working.
- Display Builder Update: X/Y Plot allows scalar, showing them only when Point Type is different from None.
Ver. 4.6.1.5 (27.07.2018)
Various fixes and updates.
What Is Changed
- Fix: ESS fonts not correctly loaded when the folder name contains blanks.
- Fix: Archiver link to a PV can't be established if the PV name has macro inside.
- Fix: PVUtil.getVType(…) made visible to scripts.
- Fix: Locales are ignored when changing a PV value.
- Fix: NPE on right-clicking the runtime of an empty display model.
- Fix: Missing Data Browser foreground colour.
- Fix: Initial symbol (not SVG) not displayed by Symbol widget.
- Fix: SVGs no more displayed by BOY.
- New: Logarithmic X scale in X/Y Plot widget.
- New: Confirmation dialog added to CheckBoxWidget, RadioWidget, ComboWidget, ActionWidget.
- New: Find Widgets… menu item in the Overview tree contextual menu.
- Update: Display Builder Script API help.
Ver. 4.6.1.4 (18.06.2018)
Various fixes and updates.
Ver. 4.6.1.3 (05.06.2018)
New font selector. Widget name editable from Overview. Bug fixes and improvements.
Ver. 4.6.1.2 (22.05.2018)
Improved SVG visualisation. Standalone windows always on top of the main one.
Ver. 4.6.1.1 (17.05.2018)
Eclipse RCP 4.7 Oxygen, and bug-fixes.
Ver. 4.6.1.0 (27.04.2018)
New features, performance improvements and bug-fixes.
Ver. 4.5.7.1 (21.03.2018)
New features, performance improvements and bug-fixes.
Ver. 4.5.7.0 (08.03.2018)
New features including improved workflow and usability in Rules dialog, performance improvements and bug-fixes.
Ver. 4.5.6.1 (13.02.2018)
New features including improved workflow and usability in Rules dialog, performance improvements and bug-fixes.
Ver. 4.5.6.0 (31.01.2018)
New features including Thumb Wheel widget, performance improvements and bug-fixes.
Ver. 4.5.1.1 (24.10.2017)
Mostly bug fixes and performance improvements.
Ver. 4.5.1.0 (28.08.2017)
First version including the Knob widget for Display Builder.
Ver. 4.5.0.2 (07.08.2017)
Including SymbolWidget and TextSymbolWidget.
Ver. 4.5.0.1 (10.07.2017)
Various improvements and bug fixes.
Ver. 4.5.0.0 (22.03.2017)
Web menu items pointing to ESS services.
Ver. 4.4.1.4 (14.03.2017)
First version including meters and gauges widgets in Display Builder.
Ver. 4.4.1.3 (31.01.2017)
First version including the new Data Sources preference pages.
Ver. 4.4.1.2 (16.01.2017)
First version including the new Data Sources preference pages.
Ver. 4.4.1.1 (18.10.2016)
First version including the new Display Builder OPI engine.
Ver. 4.4.1.0 (26.08.2016)
First official ESS version of CS-Studio.
Community Editions
CS-Studion Community Editions (CE).