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

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.

Test

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	——	• 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

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.

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.

Fault Logic

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.

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	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

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	——	• 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

Function Block Connections

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.

Status Logic

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.

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.

© 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