Danfoss PLUS 1 Operating guide
User Manual
PLUS+1® GUIDE Software
PLUS+1 Function Block Library—Filter
Function Blocks
www.danfoss.com
User Manual
PLUS+1® Compliant Function Block Library—Filter Function Blocks
Revision history Table of revisions
Date Changed Rev
January 2019 Version of Time Ramp is 4.0.1 0102
January 2019 Rebranding 0101
May 2016 Updates for new library version. DA
December 2014 —— CA
2 | © Danfoss | January 2019 11062070 | AQ00000101en-000102
User Manual
PLUS+1® Compliant Function Block Library—Filter Function Blocks
Contents
Risk Reduction
Design, Test, and Secure to Reduce Risks................................................................................................................................4
Design...................................................................................................................................................................................................4
Test.........................................................................................................................................................................................................4
Secure................................................................................................................................................................................................... 5
Exp_Filter Function Block
Inputs....................................................................................................................................................................................................6
Outputs................................................................................................................................................................................................ 7
Function Block Connections.........................................................................................................................................................7
Fault Logic...........................................................................................................................................................................................7
Identical Function Blocks Need Different Namespace Values to Successfully Compile.........................................7
Change Namespace Value.......................................................................................................................................................8
IEC 61508-3 Annex D Supplemental Information.................................................................................................................9
Median_Filter Function Block
Inputs..................................................................................................................................................................................................10
Outputs..............................................................................................................................................................................................10
Function Block Connections...................................................................................................................................................... 11
Status Logic......................................................................................................................................................................................11
Identical Function Blocks Need Different Namespace Values to Successfully Compile...................................... 11
Change Namespace Value.....................................................................................................................................................12
IEC 61508-3 Annex D Supplemental Information.............................................................................................................. 13
Average_Filter Function Block
Inputs..................................................................................................................................................................................................14
Outputs..............................................................................................................................................................................................15
Function Block Connections...................................................................................................................................................... 15
Status Logic......................................................................................................................................................................................15
Identical Function Blocks Need Different Namespace Values to Successfully Compile...................................... 15
Change Namespace Value.....................................................................................................................................................16
IEC 61508-3 Annex D Supplemental Information.............................................................................................................. 17
Soft_Ramp Function Block
Outputs..............................................................................................................................................................................................19
Inputs..................................................................................................................................................................................................20
Function Block Connections...................................................................................................................................................... 21
Status Logic......................................................................................................................................................................................22
Fault Logic........................................................................................................................................................................................ 22
Split and Dwell Tm Values.......................................................................................................................................................... 23
Sft Strt and Sft End Values...........................................................................................................................................................27
Identical Function Blocks Need Different Namespace Values to Successfully Compile...................................... 29
Change Namespace Value.....................................................................................................................................................30
IEC 61508-3 Annex D Supplemental Information.............................................................................................................. 31
Time_Ramp Function Block
Inputs..................................................................................................................................................................................................33
Outputs..............................................................................................................................................................................................33
Function Block Connections...................................................................................................................................................... 34
Function Block Values.................................................................................................................................................................. 35
Identical Function Blocks Need Different Namespace Values to Successfully Compile...................................... 35
Change Namespace Value.....................................................................................................................................................36
IEC 61508-3 Annex D Supplemental Information.............................................................................................................. 37
©
Danfoss | January 2019 11062070 | AQ00000101en-000102 | 3
User Manual
PLUS+1® Compliant Function Block Library—Filter Function Blocks
Risk Reduction
Design, test, and secure applications that you develop to reduce risks of personal injury and equipment
damage.
Design, Test, and Secure to Reduce Risks
Applications created with PLUS+1® GUIDE typically control equipment such as tractors, cranes, and
harvesters.
Using heavy, powerful, and mobile off-road equipment always involves the risk of personal injury and
equipment damage, even when this equipment is operating under normal operating conditions.
Abnormal operating conditions greatly increase the risk of personal injury and equipment damage.
The PLUS+1® program has no automatic protections against these risks. The tool has no protection
against the risks that result from bugs in the tool software, errors in the tool manual, or incompatibilities
between software versions of the tool.
You must:
•
Design your application to reduce these risks.
•
Test your application to reduce these risks.
•
Secure your application against unauthorized changes in its operating parameters to reduce these
risks.
Design
Test
As you design your application, you must include the fault checking and the error handling needed to
reduce risks in normal and abnormal operating conditions.
Consider the following when developing fault checking and error handling for your PLUS+1® GUIDE
application:
•
How the machine is normally used.
•
Possible operator errors and their consequences.
•
Industry safety standards and legal requirements.
•
Input and output failures and their consequences. These failures can include:
Joystick, sensor, and other inputs suddenly going to ±100 % or to 0 %.
‒
Joystick, sensor, and other inputs suddenly going to ±100 % or to 0 %.
‒
Outputs that control machinery direction, speed, and force suddenly changing direction or going
‒
to ±100 % or to 0 %.
Decide how likely each failure is. The more likely a failure, the more you need to protect against
the consequences of the failure.
•
The sequence of events and consequences of a fault or error.
•
The sequence of events and consequences of an emergency stop.
After creating an application, you are responsible for testing the application.
Download your application to hardware and test its operation under both normal and abnormal
operating conditions. Make sure:
•
Individual inputs produce expected outputs.
•
Fault handling and error checking work as designed.
You must repeat your tests when you make configuration, calibration, or software changes to the
application.
4 | © Danfoss | January 2019 11062070 | AQ00000101en-000102
User Manual
PLUS+1® Compliant Function Block Library—Filter Function Blocks
Risk Reduction
Secure
You have the responsibility to secure your application against unauthorized changes.
Always use the PLUS+1® GUIDE program’s Toolkey feature to restrict access to your application’s
operating parameters.
•
Without Toolkey protection, there is an increased risk that unauthorized personnel could use the
PLUS+1® Service Tool program to change your application’s operating parameters.
Changes in your application’s operating parameters might cause unexpected machinery movement
that results in personal injury and equipment damage.
•
Toolkey protection reduces the risk that unauthorized personnel could use the PLUS+1® program to
change your application’s operating parameters.
Refer to How to Use the Toolkey to Restrict Service Tool Access to Application Values in the PLUS+1—How-to
chapter of the PLUS+1 GUIDE User Manual (Danfoss part 10100824).
©
Danfoss | January 2019 11062070 | AQ00000101en-000102 | 5
User Manual
PLUS+1® Compliant Function Block Library—Filter Function Blocks
Exp_Filter Function Block
Use the Exp_Filter function block as a first-order lag, low-pass filter that is specified by the time constant
T1.
The Exp_Filter function block provides filtering to reduce noise in an input or to slow down changes in a
signal to give a less aggressive output.
Typical uses for this function block include:
Reducing random signal noise on an analog input.
•
Slowing down the response in a digital control.
•
Note that while an increase in this function block's T1 value can reduce signal noise, it can also reduce
the response of the system.
Inputs
The inputs to the Exp_Filter function block are described.
Use only the data types specified in this table. Other data types cause compiler errors.
Item Type Range Description
ChkPt BOOL ——
T1 U16 0–65535 T1 (Time Constant) is the exponential function time constant.
Bpas BOOL ——
Input S32 -100000–100000 The signal to be filtered.
True—include the function block’s built-in Advanced Checkpoint with Namespace in the compiled
•
LHX download file.
False—exclude the function block’s built-in Advanced Checkpoint with Namespace components
•
from the compiled LHX download file.
If T1 < Loop Tm, then the function block uses the Loop Tm as its T1 value.
1000 = 1000 ms.
•
T—Turns filtering off. Output = Input.
•
F—Turns filtering on. Output is determined by normal exponential function.
Bpas (Bypass) disables the filter function and can be used to preset the output.
6 | © Danfoss | January 2019 11062070 | AQ00000101en-000102
User Manual
PLUS+1® Compliant Function Block Library—Filter Function Blocks
Exp_Filter Function Block
Outputs
The outputs of the Exp_Filter function block are described.
Item Type Range Description
IO Bus —— Outputs a bus with all of the function block's input and output signals.
This bus provides a convenient way to distribute this function block's signals to your application.
Fault U16 —— Reports the faults of the function block.
This output follows the standard bitwise scheme described in the Status Logic topic.
Output S32 -100,000–100,000 The Input signal after filtering.
Function Block Connections
Connections made with the Exp_Filter function block are described.
Description
Item
1
2 The exponential function time constant.
3
4 The signal to be filtered.
5 Outputs a bus with all of the function block's input and output signals.
6 Reports the faults of the function block.
7
True—include the function block’s built-in Advanced Checkpoint with Namespace in the compiled LHX download file.
•
False—exclude the function block’s built-in Advanced Checkpoint with Namespace components from the compiled LHX download file.
•
•
T—Turns filtering off. Output = Input.
•
F—Turns filtering on. Output is determined by normal exponential function.
The Input signal after filtering.
Fault Logic
This topic describes how fault logic is indicated for the function block.
Condition Hex
Input value is too low. 0x8001
Input value is too high. 0x8002 0010 Input value is greater than
*
Bit 16 set to 1 identifies a standard Danfoss status or fault code.
*
Cause
Binary
0001
Input value is less than -100,000. The function block clamps its
100,000.
Response
Input at -100,000.
The function block clamps its
Input at 100,000.
Correction
Return the the Input to within its
±100,000 range.
Identical Function Blocks Need Different Namespace Values to Successfully Compile
If you use the same function block more than once in an application, you must change each function
block’s namespace value to avoid compiler errors.
All function blocks contain Advanced Checkpoint with Namespace components that enable the PLUS+1
Service Tool to read block input and output values.
Some function blocks contain non-volatile memory components that store function block operating
parameters.
©
Danfoss | January 2019 11062070 | AQ00000101en-000102 | 7
®
User Manual
PLUS+1® Compliant Function Block Library—Filter Function Blocks
Exp_Filter Function Block
Both these components use memory names (“aliases”) to allocate memory. Identical memory names
cause compiler errors.
The namespace value adds a unique prefix to each component name to avoid errors. Keep each
namespace value short to save controller memory.
Change Namespace Value
To successfully compile your application, change the namespace value for function blocks that are used
more than once in an application.
1. In the PLUS+1® GUIDE menu bar, click the Query/Change button.
2. Click on the function block whose namespace you want to set to a unique value.
The Edit Page window opens.
3. In the Edit Page window, enter a meaningful Namespace value.
Namespace values are case-sensitive.
•
To save controller memory, use a short namespace value.
•
4. Press Enter.
5. Repeat these steps to enter unique namespace values for other identical function blocks.
8 | © Danfoss | January 2019 11062070 | AQ00000101en-000102
User Manual
PLUS+1® Compliant Function Block Library—Filter Function Blocks
Exp_Filter Function Block
IEC 61508-3 Annex D Supplemental Information
The following table provides IEC 61508-3 Annex D supplemental information.
Item
Function block name Exp_Filter
Function block version 4.0.
Function block development
environment
Compatible hardware
Function block developed in
compliance with
Competence required of
function block integrator
Contacting Danfoss
Description
PLUS+1® GUIDE version 8.1 and later.
Verified in the PLUS+1® GUIDE compile process.
When the PLUS+1® GUIDE compiler finds a function block that is incompatible with hardware, it aborts the compile
process and logs an error message. The error message gives the location of the function block and states “Error 80:
component not supported in hwd.”
Danfoss Software Product Development Process (PDP), which includes ISO 9001 and IEC 61508-3 standards.
The knowledge, competence, and training required to:
Understand this manual.
•
Use the PLUS+1® GUIDE program to develop a machine control application.
•
Follow quality software practices to develop a machine control application.
•
https://www.danfoss.com/en/products/software/dps/plus1-software-services-support-and-training/plus1-support-andservices
©
Danfoss | January 2019 11062070 | AQ00000101en-000102 | 9
User Manual
PLUS+1® Compliant Function Block Library—Filter Function Blocks
Median_Filter Function Block
The Median_Filter function block conditions a signal by outputting the median (middle) of the most
current input sample.
Up to seven samples can be used with a configurable interval between each sample for calculating the
median or middle value.
Typical uses for this function block include:
Reducing random signal noise on an analog input.
•
Slowing down the response in a digital control.
•
Note that while an increase in the sample time or sample number can reduce signal noise, it can also
reduce the response of the system.
Inputs
The inputs to the Median_Filter function block are described.
Use only the data types specified in this table. Other data types cause compiler errors.
Input Type Range Description
ChkPt BOOL ——
Smpl Tm U16 0–65535 Smpl Tm (Sample Time) sets the interval between consecutive input samples.
Smpl Nmbr U8 0–7 Smpl Nmbr sets the number of samples used in the calculation of the median value.
Input S16 -32768–32767 The signal to be filtered.
True—include the function block’s built-in Advanced Checkpoint with Namespace in the compiled
•
LHX download file.
False—exclude the function block’s built-in Advanced Checkpoint with Namespace components
•
from the compiled LHX download file.
When the Smpl Tm is:
•
Equal to zero, the function block bypasses the filter function.
•
Less than the Loop Tm (OS.ExecTime), the function block uses the Loop Tm as its Smpl Tm.
1000 = 1000 ms.
The function block bypasses the filter function when the Smpl Nmbr equals zero.
Outputs
The outputs of the Median_Filter function block are described.
Item Type Range Description
IO
Status U16 —— Reports the status of the function block.
Output S16 -32768–32767 The Input signal after filtering.
Bus
—— Outputs a bus with all of the function block's input and output signals.
This bus provides a convenient way to distribute this function block's signals to your application.
This output follows the standard bitwise scheme described in the Status Logic topic.
10 | © Danfoss | January 2019 11062070 | AQ00000101en-000102
User Manual
PLUS+1® Compliant Function Block Library—Filter Function Blocks
Median_Filter Function Block
Function Block Connections
Connections made with the Median_Filter function block are described.
Item Description
1
2 Sets the interval between consecutive input samples.
3 Sets the number of sample used in the calculation of the middle value.
4 The signal to be filtered.
5 Outputs a bus with all of the function block's input and output signals.
6 Reports the status of the function block.
7 The Input signal after filtering.
True—include the function block’s built-in Advanced Checkpoint with Namespace in the compiled LHX download file.
•
False—exclude the function block’s built-in Advanced Checkpoint with Namespace components from the compiled LHX download file.
•
Status Logic
This topic describes how status logic is indicated for the function block.
Status Hex
Invalid setup. 0x8008 1000
*
Bit 16 set to 1 identifies a standard Danfoss status or fault code.
*
Binary Cause
Smpl Nmbr input is greater than
7.
LoopTm input is out of range.
Response Correction
The function block clamps its
Smpl Nmbr input at 7,
The function block clamps its
LoopTm input at 1,
Identical Function Blocks Need Different Namespace Values to Successfully Compile
If you use the same function block more than once in an application, you must change each function
block’s namespace value to avoid compiler errors.
All function blocks contain Advanced Checkpoint with Namespace components that enable the PLUS+1
Service Tool to read block input and output values.
Some function blocks contain non-volatile memory components that store function block operating
parameters.
Both these components use memory names (“aliases”) to allocate memory. Identical memory names
cause compiler errors.
The namespace value adds a unique prefix to each component name to avoid errors. Keep each
namespace value short to save controller memory.
Make the Smpl Nmbr input less
than 8.
Return the LoopTm input to
within 1–65,535 range.
®
©
Danfoss | January 2019 11062070 | AQ00000101en-000102 | 11
User Manual
PLUS+1® Compliant Function Block Library—Filter Function Blocks
Median_Filter Function Block
Change Namespace Value
To successfully compile your application, change the namespace value for function blocks that are used
more than once in an application.
1. In the PLUS+1® GUIDE menu bar, click the Query/Change button.
2. Click on the function block whose namespace you want to set to a unique value.
The Edit Page window opens.
3. In the Edit Page window, enter a meaningful Namespace value.
Namespace values are case-sensitive.
•
To save controller memory, use a short namespace value.
•
4. Press Enter.
5. Repeat these steps to enter unique namespace values for other identical function blocks.
12 | © Danfoss | January 2019 11062070 | AQ00000101en-000102
Loading...