2019 New POWER
User Manual v2.1
New POWER User Manual
Contents
Introduction ...... 4 About the project ...... 4 Software dependencies ...... 4 Names and Definitions ...... 6 Cycle ...... 6 Limits ...... 6 Configuration Files...... 7 Configuration file types ...... 7 Default configuration path ...... 7 Basic Configuration ...... 8 Navigating the application ...... 8 Config window and “After enabling” state ...... 9 Limits Configuration ...... 10 Navigating Limits Configurator ...... 10 Cycle Configuration ...... 11 Navigating Cycle Configurator ...... 11 Cycle Editor...... 12 Table Editor ...... 14 Saving/Loading Complete Power Supply Configurations ...... 15 Saving/Loading configuration for single Power Supply ...... 15 Saving/Loading configuration for all Power Supplies ...... 16 Operating the Software ...... 17 Enabling Power Supply ...... 17 Run Time Menu ...... 18 Turning Power Supply ON/OFF ...... 19 Verifying Power Supply limits ...... 20 Checking Power Supply status ...... 21 Checking FGC interlocks ...... 22 Debugging Power Supply (Expert Only) ...... 23 Executing Ramp ...... 24 Executing Cycle ...... 25 Executing Pre-Ramp ...... 26
2 | P a g e
New POWER User Manual
Synchronizing Cycles ...... 27 Synchronous Cycles preview window ...... 28 Collective Window ...... 29
3 | P a g e
New POWER User Manual
Introduction
About the project
New POWER application, developed in 2018 in order to replace the old powering software, serves the purpose of delivering easy-to-use user interface for operation and control of the Power Supplies and additional out-of-the-box features like cycle editors. Software dependencies
Application depends on multiple communication layers between Power Supply and Operator Console. The tool itself communicates with CMW-RDA (Control Middleware Remote Device Access) client via C++ libraries, which then is responsible for finding the correct FEC (Front-End Computer) and sharing the messages with the Gateway installed in it. Responsibility of carrying out the command messages and controlling the Power Supplies lays on the Gateway side along with the FGC (Function Generator/Controller) devices used to forward messages to Power Converters. Thus if the Gateway or FGC operates in faulty way, New POWER application may be inoperative too. In case of any concerns about this area, BE-CO (FEC/Gateway) and TE-EPC (FGC/Power Converters) groups should be contacted.
Figure 1. Exemplar diagram of command messages path in the system.
4 | P a g e
New POWER User Manual
Figure 2. Control Middleware (CMW) communication layers between RDA Client in Operator Console and RDA Server in the Gateway.
5 | P a g e
New POWER User Manual
Names and Definitions
Cycle
Cycles are collections of connected ramps that can be executed by Power Supply. User may create them using cycle and table editors and then they can be stored in .cyc or .csv files.
Figure 3. Cycle view from the application. Limits
Limits are values that characterize current range of Power Supply operation. If any ramp or cycle point crosses limits, application will return an error. There are two levels of limiting values, one of them are set by the operator in Limit Configuration window, the second by the expert in Init File file (operator limits must be contained in expert limits). Operator Limits can be stored in .xml files.
Figure 4. Limits view from the application.
6 | P a g e
New POWER User Manual
Configuration Files
Configuration file types
Application uses following configuration files (all of those files, excluding Init File, operator can load and save separately):
Init File – file that is being loaded when application starts, contains default paths for other configs and list of Power Supplies. Limit File – used to store default or operator-set Limits values. Cycle File – contains Cycle prepared earlier by the operator. Power Supply Config File – describes the Power Supply used in Init File. Collective Config File – list of all Power Supply configuration files paths. Default configuration path
In the “Options” tab user can change the path to the Collective Config File and save full application configuration.
Figure 5. Options tab in the application main window.
7 | P a g e
New POWER User Manual
Basic Configuration
Navigating the application
POWER application has three main tabs (windows) that serve different purposes:
Config – list of Power Supplies, Limit Editor and Cycle Editor access, saving and modifying configurations as well as enabling communication with devices. Run Time – keeping track of enabled Power Supplies and controlling them. Options – modifying default configuration path, saving collective configuration.
Figure 6. New POWER application main window.
8 | P a g e
New POWER User Manual
Config window and “After enabling” state
After starting application, you can show properties of Power Supply by pressing right arrow next to its name. Properties panel allows the user to:
1. View chosen Power Supply name and associated FGC version. 2. Use configuration buttons to edit current configurations. 3. Define Power Supply behavior after enabling it. Initialize – turns off the Power Supply, then establishes communication and sends Limits (use carefully as it will stop any Ramps/Cycles executed by the Power Supply at the moment). Keep state – establishes communication with the Power Supply and does not send any parameters (keeps last used state).
1.
2. 3.
Figure 7. Config window description.
9 | P a g e
New POWER User Manual
Limits Configuration
Navigating Limits Configurator
To open Limits Configuration window use gear button on properties box. If button is empty inside – there is no actual configuration in memory, if filled configuration is present. When the window opens, user can perform following actions:
1. Modify limits manually (Note: for FGC63 and newer Max Acceleration setting does not exist, thus user will see Infinite value, although Power Supply has some hardware acceleration limit itself). 2. Edit default ramp parameters. 3. Change the Power Supply mode. There are four possible setting: Magnet Circuit, Cable Circuit, Short Circuit and Test Configurations (Note: In Cable Circuit and Short Circuit modes, Inductance (mH) and Resistance (Ohm) fields are hidden as Power Supply refuses to change them). 4. Check the configuration file path, if current configuration is not yet saved, indicator will be empty. 5. Downloads present Limits values for chosen mode directly from the Power Supply. 6. Load from the file and save to the file all the Limits. 7. Confirm or cancel changes. Power Supply is Disabled – Confirm button accepts changes and keeps them in memory. Power Supply is Enabled and OFF – “Send to PS” button replaces “Confirm” button, changes will be automatically send after confirming. Power Supply is Enabled and ON – “Send to PS” button will be greyed out, as it is not possible to change Power Supply configurations when it operates.
1. 2. 3.
4. 6 . 7 . 5.
Figure 8. Limits configuration window.
10 | P a g e
New POWER User Manual
Cycle Configuration
Navigating Cycle Configurator
To open Cycle Configuration window use gear button on properties box. If button is empty inside – there is no actual configuration in memory, if filled configuration is present. When the window opens, user can perform following actions:
1. See the present Cycle loaded into memory. 2. Check the configuration file path, if current configuration is not yet saved, indicator will be empty. 3. Press Cycle Editor buttons to open them. 4. Clear the Cycle loaded into memory. 5. Confirm or cancel changes.
1. 3.
4.
5. 2.
Figure 9. Cycle configuration window.
11 | P a g e
New POWER User Manual
Cycle Editor
Cycle Editor is additional tool that operator can use to prepare Cycles by combining multiple graph segments. Each segment is either a Ramp or part of Sin/Cosin Wave. When the window opens, user can perform following actions:
1. Check the Cycle file path, if current Cycle is not yet saved, indicator will be empty. 2. See the Cycle under edition. Blue lines are already confirmed segments, red are only preview of what is being Added/Modified (Note: Only blue segments will be kept when user confirms the window). 3. Switch between edition modes: Add segment – allows the user to add ramp or wave at specified segment index. Edit segment – allows the user to modify or delete specified segment (Note: Editing Cycles containing Waves is rather not recommended as each wave consists of multiple small ramps/segments). Check cycle – allows the user to view report about the cycle. 4. Select parameters for the segment. 5. Graph palette (Move, Zoom etc…), Show the Power Supply Limits and Clear the Cycle buttons. 6. Confirm or Cancel new Cycle. Operator may load or save it to file as well in binary (.cyc) or spreadsheet (.csv) format.
1. 2.
3. 5. 6.
4.
Figure 10. Cycle Editor window.
12 | P a g e
New POWER User Manual
As mentioned previously Cycle can consist of two types of elements: Ramps and Sin/Cosin Waves. Ramp is generated according to the Start Current [A] and End Current [A] parameters. If the start and end values are the same, ramp length is derived from Time [s] field, otherwise it is calculated from Digital Parameters. Sin/Cosin Wave is generated according to P-P Amplitude [A], Offset [A] (start point), No. of segments (wave resolution), No. of periods and Length [s] parameters.
Figure 11. Ramp parameters.
Figure 12. Sin/Cosin Wave parameters.
13 | P a g e
New POWER User Manual
Table Editor
Table Editor is additional tool that operator can use to prepare Cycles based on arrays. It is highly advised to use cycle editor if possible since table editor does not check utilized parameters. When the window opens, user can perform following actions:
1. Check the Cycle file path, if current Cycle is not yet saved, indicator will be empty. 2. Add, Edit and Remove points in the Cycle. 3. See the preview of Cycle under edition. 4. Clear the Cycle button. 5. Confirm or Cancel new Cycle. Operator may load or save it to file in spreadsheet (.csv) format.
1. 3.
2. 4. 5.
Figure 13. Table editor window.
14 | P a g e
New POWER User Manual
Saving/Loading Complete Power Supply Configurations
After the user configures Power Supply with appropriate Limits and Cycle, application provides a possibility to save complete configuration either for one of the devices either for all. Saving/Loading configuration for single Power Supply
User can manage full configuration of single Power Supply using Save and Load buttons in the properties window. Following data will be saved/loaded: Power Supply name. FGC type. Path to Cycle file. Path to Limits file.
If Cycle or Limits configuration are not saved to files, the paths will not be saved either. Thus, the configuration will not be saved correctly.
Figure 14. Load and save complete Power Supply configuration.
15 | P a g e
New POWER User Manual
Saving/Loading configuration for all Power Supplies
User can manage full configuration of all used Power Supplies using Save Full Config and Load All Configs buttons. Only thing that will be saved/loaded are paths to Power Supply Configuration files. If Power Supply Configurations are not saved to files for some of the devices, the paths will not be saved either. Thus, the configurations will not be saved/loaded correctly (Note: Loading collective configuration requires all Power Supplies to be disabled).
Figure 15. Save and Load complete collective configuration.
If user tries to save collective configuration for all Power Supplies, compare window will pop-up. It helps user to see if configuration user wants to save is correct. Since the configuration is just a list of file paths to single Power Supply configurations, current setting that user is using may differ from the ones that will be saved (e.g. some settings have been changed but not saved).
Figure 16. Compare window view. Left column is a current configuration. Right column is the one that will be saved.
16 | P a g e
New POWER User Manual
Operating the Software
Enabling Power Supply
Pressing “ENABLE” button will make the software try to initialize and establish communication with the Gateway and FGC device. Status of the procedure is being showed in the Log box and in case of any errors user is informed by a dialog.
The enabling procedure depends on After enabling setting (Initialize or Keep state). For further explanation head to page 9 (Config window and “After enabling” state).
Figure 17. Enabling connection with Power Supply.
17 | P a g e
New POWER User Manual
Run Time Menu
Run time menu allows the user to control threads separately. Following actions are available:
1. User can select enabled Power Supply in drop down menu. 2. “DISABLE ALL” button disconnects all Power Supplies simultaneously. 3. Dock/Undock thread windows. 4. “Disable” button allows to disconnect particular Power Supply.
1. 2.
3.
4.
Figure 18. Run Time menu view.
18 | P a g e
New POWER User Manual
Turning Power Supply ON/OFF
Turning the Power Supply ON puts it in Idle state so it is ready to execute Ramp or Cycle. To turn Power Supply ON/OFF use the red button highlighted below (green in case of turning off). Current Power Supply status is visible inside the Info box.
Figure 19. Turning Power Supply ON/OFF.
19 | P a g e
New POWER User Manual
Verifying Power Supply limits
Application allows the user to proof-check current configuration inside the Power Supply in one of the Run Time window tabs named Limits. Configuration is being downloaded from the device on the moment of opening the tab, thus the operation can take up to a few second. In the message box below some additional information may be visible.
Figure 20. Checking limits loaded inside the Power Supply.
20 | P a g e
New POWER User Manual
Checking Power Supply status
Status tab in Run Time window allows having a fast look on current Power Supply state. Tab highlights with yellow color in case of Warning and red in case of Fault found in the FGC. Additionally:
1. If Warning or Fault indicators are enlighted user should proceed to check Interlocks tab for further details. 2. Message logs show history of commands sent to the Gateway. Copy to clipboard button below copies all messages data so the user can paste them into Excel/Word file.
1.
2.
Figure 21. Power Supply status view.
21 | P a g e
New POWER User Manual
Checking FGC interlocks
Interlocks tab lists existing Faults and Warnings inside the FGC device. For further information about these results contact TE-EPC group.
Figure 22. FGC interlocks status.
22 | P a g e
New POWER User Manual
Debugging Power Supply (Expert Only)
If the application runs in expert mode, additional Debugging tab is visible. It shows values of all variables obtained from FGC subscription. To see all of the variables undock and extend the window.
Figure 23. Debug view.
23 | P a g e
New POWER User Manual
Executing Ramp
Ramp execution can be performed in the General tab in Run Time window.
1. Before executing the ramp user can select parameters for the execution and Target I [A] which is current value to be reached. Then user can click on EXECUTE RAMP button to start the process. Any time Ramp can be stopped using ABORT RAMP button. 2. Actual current value and Ramp view in comparison to general Power Supply Limits range is visible on the right side of the window.
1. 2.
Figure 24. Executing ramp.
24 | P a g e
New POWER User Manual
Executing Cycle
To run Cycle go to Cycle tab in Run Time window. Following conditions must be met:
Power Supply in Idle state. Cycle loaded in memory (Cycle Configuration window). 1st point of a cycle and current value do not differ in significant way: o 1st point of cycle differs from the actual value maximally by +/-5%. o If the 5% is less than 0.5A then 1st point of cycle +/- 0.5 A.
Cycle window consists of following items:
1. Preview of a cycle that user wants to perform. 2. Run and Abort buttons.
1.
2.
Figure 25. Cycle execution view.
25 | P a g e
New POWER User Manual
Executing Pre-Ramp
If the third conditions is not met and actual current value differs from the 1st point of a cycle, Pre-Ramp procedure has to be executed to enable RUN button for a Cycle. After pressing PRE-RAMP button, application will execute a default ramp with a target current of 1st point of cycle. Default ramp parameters can be checked in Limits tab.
Figure 26. Pre-Ramp execution view.
26 | P a g e
New POWER User Manual
Synchronizing Cycles
Application implements a feature of synchronizing Cycles between many Power Supplies. User can execute only loaded Cycles for enabled and turned ON devices. Cycles can have different duration time and current ranges, however if one of them fails, all of them will be aborted. To open preview window user has to press RUN SYNCHRONOUSLY button.
Figure 27. Running Cycles synchronously.
27 | P a g e
New POWER User Manual
Synchronous Cycles preview window
Preview window gives to the user information about all enabled Power Supplies and loaded Cycles. Colour indicates state: Red – not ready, unavailable to be chosen. Grey – available to be chosen. Green – chosen to be run.
To start synchronous run user should perform following steps:
1. Refresh the window if needed. 2. Select Power Supplies to be run (Note: On the right side of the window there is a scroll bar in case in case not all of enabled Power Supplies are show).
3. Start or Cancel synchronous execution. 2.
1. 3.
Figure 28. Synchronous Cycles run preview window.
28 | P a g e
New POWER User Manual
Collective window
Collective window is accessible through drop down menu in Run Time window. It is created when Synchronous Cycles are started and is kept in memory until next synchronous run or shutdown of application. It serves informative purposes about Cycles progress. Not only it can be selected and undocked just like other Power Supply windows but also runs parallel to single Power Supplies control panels so user can still interact with each of them individually.
Additionally user can perform following actions:
1. Scroll through Power Supplies and its Cycles. 2. Use SCALE button to adapt all graphs to widest scale (longest duration and biggest range Cycle). Pressing button second time reactivates auto-scale for each graph. 3. Use ABORT ALL button to stop all cycles at once.
1.
2.
3.
Figure 29. Collective window for synchronous run view.
29 | P a g e
New POWER Manual | 2019
Patryk Jankowski