Danfoss Fault Manager Operating guide
User Manual
PLUS+1® GUIDE Software
PLUS+1® Function Block Library—Fault
Manager
www.danfoss.com
User Manual
PLUS+1® Function Block Library—Fault Manager
Revision history Table of revisions
Date Changed Rev
September 2019 Updated book number 0103
June 2019 Added Service Tool screen for Standard license 0102
May 2019 First edition 0101
2 | © Danfoss | September 2019 AQ316177216676en-000103
User Manual
PLUS+1® Function Block Library—Fault Manager
Contents
Fault Manager Overview
Modular System Design.................................................................................................................................................................4
Design, Build, and Add the Fault Management Features to an Application
Before You Begin.............................................................................................................................................................................. 5
Add Fault Management to Your Application.........................................................................................................................5
Determine the Fault Manager Features to Create................................................................................................................5
Complete the Fault-Definition Spreadsheet.......................................................................................................................... 5
Defining Fault Severity Levels................................................................................................................................................ 6
Adding and Moving Spreadsheet Columns...................................................................................................................... 6
Make Fault Connections in the Function Block.....................................................................................................................7
Fault_Mgr_Std Function Block
Inputs....................................................................................................................................................................................................8
Outputs................................................................................................................................................................................................ 8
Fault_Clock Function Block...........................................................................................................................................................8
Inputs...............................................................................................................................................................................................9
Outputs...........................................................................................................................................................................................9
FltMgr_IntFace Function Block....................................................................................................................................................9
Expand Space for Fault History.............................................................................................................................................. 9
Rcd_Set........................................................................................................................................................................................... 9
Change Namespace Value............................................................................................................................................... 10
Fault Manager Service Tool Screens
Configure the Service Tool Screens.........................................................................................................................................11
Install the .p1d File................................................................................................................................................................... 12
Configure the FaultDescriptions.js file..............................................................................................................................12
Launch the Fault Monitor...................................................................................................................................................... 12
Example Fault Manager Service Tool Screen with Professional License....................................................................13
Example Fault Manager Service Tool Screen with Standard License..........................................................................14
Use the Detailed Fault Manager Service Tool Screen.......................................................................................................14
Fault_DM_1_2_ Iface Function Block
Inputs..................................................................................................................................................................................................15
Outputs..............................................................................................................................................................................................15
©
Danfoss | September 2019 AQ316177216676en-000103 | 3
User Manual
PLUS+1® Function Block Library—Fault Manager
Fault Manager Overview
The Fault Manager allows you to design and develop fault management functions for machine
applications in an simple, iterative manner.
Your input to a macro-enabled spreadsheet is used to generate all of the PLUS+1® GUIDE interface files
that are needed to monitor each connected, potential fault source in a machine.
The Fault Manager also generates an interface file for service tool screens, making it easy to display
current faults, as well as the history of previous faults and how often they occur.
The Fault Manager consists of components that are available as an SDL library in PLUS+1® GUIDE. To add
fault management features to an application, drag the desired components onto the GUIDE canvas and
make a simple connection.
You can successfully compile your application at this point, even before connecting any components that
might generate errors. This flexibility lets you define the application's faults iteratively, over time. During
development, you may complete or tweak information in the fault-definition spreadsheet then re-run the
macro. All the new or updated interface files are then created for the application.
Modular System Design
The Fault Manager Library contains components that can be used to add diagnostic functions to
applications on an as-needed basis.
The modular design of the Fault Manager lets your application collect diagnostic data from services such
as CANopen and J1939.
The Fault Manager Standard function block collects data that can be used for Diagnostic Messages (DM)
DM1 and DM2.
The assembled Fault Management system is limited only by the memory available in the controller. The
Fault Manager Standard option can handle up to 3375 individual faults, including faults of the Fault
Manager itself.
4 | © Danfoss | September 2019 AQ316177216676en-000103
User Manual
PLUS+1® Function Block Library—Fault Manager
Design, Build, and Add the Fault Management Features to an Application
Determine the fault management features to add to the application, complete the fault-definition
spreadsheet, and connect faults to the Fault input bus of the Fault Manager block in the PLUS+1® GUIDE
application.
Before You Begin
Before you add Fault Manager components to your application, make sure you have the required
software tools installed.
Ensure these software programs and libraries are installed on the computer where you develop
applications:
•
PLUS+1® GUIDE version 10.1 or later.
•
PLUS+1® Service Tool version 10.1 or later.
•
Download and install the Fault Manager library in PLUS+1® GUIDE.
•
Microsoft Excel.
Add Fault Management to Your Application
Open the application that you want to add fault management to, then drag and drop the desired Fault
Management components onto the development canvas.
You can add the desired Fault Manager function block options to your application, even before any
potential fault sources are connected.
1. Select the Function tab in the right panel of PLUS+1® GUIDE.
2. Expand the Fault Manager library, then select the Fault Manager block you want to use in your
application. For Fault Manager Standard, select Fault_Mgr_Std.
3. Drag the function block onto the PLUS+1® GUIDE canvas.
4. In the window that appears, click Yes to confirm that you want to add the interface files and the
spreadsheet to your application.
The interface files and spreadsheet are added to the Project Manager panel.
5. Connect the two block inputs HstClear and HstErase to False Constant components. Later, you can
use these inputs to add optional external control over history memory.
You can compile the application successfully at this point. Or, if desired, you can complete the faultdefinition spreadsheet with as much information as is ready, gradually adding fault management
functions to the application.
Determine the Fault Manager Features to Create
Design the fault management functions wanted in the application, such as the types of fault information
to collect and how this information is used.
This work helps you complete the macro-enabled spreadsheet, where you will enter:
•
The variable name for the fault in PLUS+1® GUIDE.
•
The fault description, for use in a service tool application.
•
Number of severity levels required and the severity level of each fault. Severity level zero is the
highest level.
•
Whether or not the fault should be latching.
•
SPN/FMI numbers for each fault if DM1 and DM2 are used.
•
Do not enter information into the DM4 column.
Complete the Fault-Definition Spreadsheet
Complete the fault-definition spreadsheet with the fault features desired, then run the macro to generate
the interface files that make fault management available in the application.
When completing the fault-definition spreadsheet, follow these rules and recommendations:
©
Danfoss | September 2019 AQ316177216676en-000103 | 5
User Manual
PLUS+1® Function Block Library—Fault Manager
Design, Build, and Add the Fault Management Features to an Application
•
When entering PLUS+1® GUIDE Variable Names, ensure the first character is a lowercase letter (a-z)
and the last character is either a lowercase letter or number (0-9). This is a limitation of the underlying
language structure. If you use an uppercase letter in these locations, the uppercase letter is changed
to lowercase when you click BUILD PROJECT in order to be compatible with PLUS+1® GUIDE.
You are not required to complete all the fields on the spreadsheet. However, the recommended
minimum fields to complete for each fault are:
•
PLUS+1® GUIDE Variable Name
•
Short Fault Description
•
Indicate if the fault is latched. Define most faults as latching, except those you want to clear when the
fault is removed, such as calibration faults.
•
Fault Severity Level. See Defining Fault Severity Levels for more information.
If you are just trying to learn more about the Fault Manager, note that only one column of the
spreadsheet – the first one, GUIDE Variable Name – must be completed before you run the BUILD
PROJECT macro.
After completing the only required column, connect the faults to the function block's Fault input bus in
PLUS+1® GUIDE, then compile the application. Using this approach, all faults are then assumed to be nonlatching and have maximum (zero) severity. Also, no descriptions are available for the Service Tool.
If SPN and FMI are left blank, zeros are used as inputs.
1. Open the spreadsheet: by double-clicking EnterFaultDefinitions.xlsm in the Documents folder in
the Project Manager panel.
Complete each column of the spreadsheet with the desired information.
Only one column is mandatory: GUIDE Variable Name.
a) From the Project Manager tab in PLUS+1® GUIDE, open the Documents folder.
b) Double click on the EnterFaultDefinitions.xlsm file to open it in Excel.
2. Click BUILD PROJECT.
3. In PLUS+1® GUIDE, accept the prompts to overwrite the interface files.
Interface files are created, as are the faults that are to be connected in the application.
Defining Fault Severity Levels
Follow these recommendations when defining the fault severity levels.
Severity level 0 is the highest level in this system.
To define how many severity levels are needed, set the severity levels at the extreme ends with just two
faults. A system is created with that many levels.
For example, if you set one fault to 0 and another to 3, a four-level severity system is created, leaving the
in-between levels empty internally, ready for use. It is suggested that you fully populate the severity
levels when possible to avoid unused and forgotten levels.
To revise the layout:
1. Change spreadsheet entries.
2. Click BUILD PROJECT to re-run the macro.
Adding and Moving Spreadsheet Columns
You can move columns in the spreadsheet as well as add user-defined columns to the spreadsheet.
Use the usual Excel steps to add or move columns. If you are moving a column, make sure to highlight an
entire column and not just the data within the column before the move. Moving data to a column where
that data is not intended to be used may result in data type mismatch errors and incorrect operation of
the Fault Manager.
6 | © Danfoss | September 2019 AQ316177216676en-000103
Loading...