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
Design, test, and secure applications that you develop to reduce risks of personal injury and equipment damage.
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.
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
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
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.
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 |
—— |
• 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. |
|
|
|
|
T1 |
U16 |
0–65535 |
T1 (Time Constant) is the exponential function time constant. |
|
|
|
If T1 < Loop Tm, then the function block uses the Loop Tm as its T1 value. |
|
|
|
1000 = 1000 ms. |
|
|
|
|
Bpas |
BOOL |
—— |
• 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. |
|
|
|
|
Input |
S32 |
-100000–100000 |
The signal to be filtered. |
|
|
|
|
6 | © Danfoss | January 2019 |
11062070 | AQ00000101en-000102 |
User Manual
PLUS+1® Compliant Function Block Library—Filter Function Blocks
Exp_Filter Function Block
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. |
|
|
|
|
Connections made with the Exp_Filter function block are described.
Item |
Description |
|
|
1 |
• 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. |
|
|
2 |
The exponential function time constant. |
|
|
3 |
• T—Turns filtering off. Output = Input. |
|
• F—Turns filtering on. Output is determined by normal exponential function. |
|
|
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 |
The Input signal after filtering. |
|
|
This topic describes how fault logic is indicated for the function block.
Condition |
Hex* |
Binary |
Cause |
Response |
Correction |
Input value is too low. |
0x8001 |
0001 |
Input value is less than -100,000. |
The function block clamps its |
|
|
|
|
|
Input at -100,000. |
Return the the Input to within its |
Input value is too high. |
0x8002 |
0010 |
Input value is greater than |
The function block clamps its |
±100,000 range. |
|
|
|
100,000. |
Input at 100,000. |
|
|
|
|
|
|
|
* Bit 16 set to 1 identifies a standard Danfoss status or fault code.
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.
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
|
The following table provides IEC 61508-3 Annex D supplemental information. |
|
|
Item |
Description |
|
|
Function block name |
Exp_Filter |
|
|
Function block version |
4.0. |
|
|
Function block development |
PLUS+1® GUIDE version 8.1 and later. |
environment |
|
|
|
Compatible hardware |
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.” |
|
|
Function block developed in |
Danfoss Software Product Development Process (PDP), which includes ISO 9001 and IEC 61508-3 standards. |
compliance with |
|
|
|
Competence required of |
The knowledge, competence, and training required to: |
function block integrator |
• 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. |
|
|
Contacting Danfoss |
https://www.danfoss.com/en/products/software/dps/plus1-software-services-support-and-training/plus1-support-and- |
|
services |
|
|
© Danfoss | January 2019 |
11062070 | AQ00000101en-000102 | 9 |
User Manual
PLUS+1® Compliant Function Block Library—Filter Function Blocks
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.
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 |
—— |
• 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. |
|
|
|
|
Smpl Tm |
U16 |
0–65535 |
Smpl Tm (Sample Time) sets the interval between consecutive input samples. |
|
|
|
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. |
|
|
|
|
Smpl Nmbr |
U8 |
0–7 |
Smpl Nmbr sets the number of samples used in the calculation of the median value. |
|
|
|
The function block bypasses the filter function when the Smpl Nmbr equals zero. |
|
|
|
|
Input |
S16 |
-32768–32767 |
The signal to be filtered. |
|
|
|
|
Outputs |
|
|
|
|
|
The outputs of the Median_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. |
|
|
|
|
Status |
U16 |
—— |
Reports the status of the function block. |
|
|
|
This output follows the standard bitwise scheme described in the Status Logic topic. |
|
|
|
|
Output |
S16 |
-32768–32767 |
The Input signal after filtering. |
|
|
|
|
10 | © Danfoss | January 2019 |
11062070 | AQ00000101en-000102 |
User Manual
PLUS+1® Compliant Function Block Library—Filter Function Blocks
Median_Filter Function Block
Connections made with the Median_Filter function block are described.
Item |
Description |
|
|
1 |
• 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. |
|
|
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. |
|
|
This topic describes how status logic is indicated for the function block.
Status |
Hex* |
Binary |
Cause |
Response |
Correction |
|
|
|
|
Smpl Nmbr input is greater than |
The function block clamps its |
Make the Smpl Nmbr input less |
|
Invalid setup. |
0x8008 |
1000 |
7. |
Smpl Nmbr input at 7, |
than 8. |
|
|
|
|
||||
LoopTm input is out of range. |
The function block clamps its |
Return the LoopTm input to |
||||
|
|
|
||||
|
|
|
|
LoopTm input at 1, |
within 1–65,535 range. |
|
|
|
|
|
|
|
* Bit 16 set to 1 identifies a standard Danfoss status or fault code.
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.
© Danfoss | January 2019 |
11062070 | AQ00000101en-000102 | 11 |
User Manual
PLUS+1® Compliant Function Block Library—Filter Function Blocks
Median_Filter Function Block
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 |