PLUS+1® Compliant Function Block Library—Output Function Blocks
Contents
Risk Reduction
Design, Test, and Secure to Reduce Risks................................................................................................................................4
Function Block Example.................................................................................................................................................................8
Function Block Connections.........................................................................................................................................................9
Status Logic........................................................................................................................................................................................ 9
Function Block Example.............................................................................................................................................................. 14
Function Block Connections...................................................................................................................................................... 16
Status Logic......................................................................................................................................................................................16
Function Block Connections...................................................................................................................................................... 21
Identical Function Blocks Need Different Namespace Values to Successfully Compile...................................... 21
Danfoss | February 201911062084 | AQ00000275en-000101 | 3
Page 4
User Manual
PLUS+1® Compliant Function Block Library—Output 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.
PLUS+1® Compliant Function Block Library—Output 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 | February 201911062084 | AQ00000275en-000101 | 5
Page 6
User Manual
PLUS+1® Compliant Function Block Library—Output Function Blocks
PVE_Driver Function Block
Use the PVE_Driver function block to control a PVE (Proportional Valve Electric) valve through a PWM
(pulse-width modulation) output.
You can use this function block’s Enbl input and Supply output to implement power management in
your application. For more information, see the Technical Information document supplied with your
PVE product.
Inputs
The inputs to the PVE_Driver function block are described.
Use only the data types specified in this table. Other data types cause compiler errors.
ItemTypeRangeDescription
ChkPtBOOL——
Plus MaxU160–10000The Output value produced by a positive Input value of 10000. Duty value for the maximum plus valve
Plus StrtU160–10000The Output value produced by a positive Input value of 1. Duty value for the threshold plus valve
Minus MaxU160–10000The Output value produced by a negative Input value of -10000. Duty value for the maximum minus
Minus StrtU160–10000The Output value produced by a negative Input value of -1. Duty value for the threshold minus valve
NeutU160–10000The Output value when either the:
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.
output.
1000 = 10.00%
output.
1000 = 10.00%
valve output.
1000 = 10.00%
output.
1000 = 10.00%
Input value equals 0.
•
Enable input goes false.
•
Duty value for a neutral valve output.
1000 = 10.00%
PLUS+1® Compliant Function Block Library—Output Function Blocks
PVE_Driver Function Block
Function Block Connections
Connections you can make with the PVE_Driver function block are described.
Description
Item
1
2The maximum positive direction Output value produced by a positive Input value of 10000.
3The threshold positive direction Output value produced by a positive Input value of 1.
4The maximum negative direction Output value produced by a negative Input value of -10000.
5The threshold negative direction Output value produced by a negative Input value of -1.
6The Output value when either the:
7
8Input command.
9Outputs a bus with all of the function block's input and output signals.
10Reports the status of the function block.
11Reports the faults of the function block.
12If true, then:
13Output command.
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.
•
Input value equals 0.
•
Enable input goes false.
•
If true, then:
The Output value follows changes in the Input value.
•
The Supply output goes true if the Input value is not 0.
•
Enable input is true.
•
Input value is not 0.
•
Status Logic
This topic describes how status logic is indicated for the function block.
ConditionHex
Invalid setup.0x80081000
*
Bit 16 set to 1 identifies a standard Danfoss status or fault code.
Danfoss | February 201911062084 | AQ00000275en-000101 | 11
Page 12
User Manual
PLUS+1® Compliant Function Block Library—Output Function Blocks
PVE_Driver Function Block
IEC 61508-3 Annex D Supplemental Information
The following table provides IEC 61508-3 Annex D supplemental information.
Item
Function block name
Function block version
Function block development
environment
Compatible hardware
Function block developed in
compliance with
Competence required of
function block integrator
Contacting Danfoss
Description
PVE_Driver.
4.0.
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.
PLUS+1® Compliant Function Block Library—Output Function Blocks
PWM_Driver Function Block
Use the PWM_Driver function block to control an electronic displacement coil (EDC) or other similar
control devices that use pulse-width modulation (PWM) signals to control their displacement.
Depending on how you configure the output of your controller, you can use this generic function block
to:
Control an EDC controlled through current.
•
Control an EDC controlled through duty cycles.
•
Inputs
The inputs to the PWN_Driver function block are described.
Use only the data types specified in this table. Other data types cause compiler errors.
ItemTypeRangeDescription
ChkPtBOOL——
MaxU160–30000The maximum Output value produced by an Input value of 10000.
StrtU160–30000The minimum Output value produced by an Input value of 1.
InputU160–10000Input command.
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.
Coil parameter for the maximum output. This is the end current in a closed-loop control system.
1000 = 100.0 mA (for a controller configured to control an output through current).
10000 = 100.00% (for a controller configured to control an output through duty-cycles).
Coil parameter for the minimum output. This is the threshold current in a closed-loop control system.
1000 = 100.0 mA (for a controller configured to control an output through current).
10000 = 100.00% (for a controller configured to control an output through duty-cycles).
1000 = 10.00%
Outputs
The outputs of the PWM_Driver function block are described.
ItemTypeRangeDescription
IOBus——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.
StatusU16——Reports the status of the function block.
This output follows the standard bitwise scheme described in the Status Logic topic.
FaultU16——Reports the faults of the function block.
This output follows the standard bitwise scheme described in the Status Logic topic.
OutputU160–30000PWM duty or current command used to drive the control.
Danfoss | February 201911062084 | AQ00000275en-000101 | 15
Page 16
User Manual
PLUS+1® Compliant Function Block Library—Output Function Blocks
PWM_Driver Function Block
Function Block Connections
Connections you can make with the function block are described.
Description
Item
1
2The maximum Output value produced by an Input value of 10000.
3The minimum Output value produced by an Input value of 1.
4Input command.
5Outputs a bus with all of the function block's input and output signals.
6Reports the status of the function block.
7Reports the faults of the function block.
8Output command.
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.
ConditionHex
Invalid setup.0x80081000
*
Bit 16 set to 1 identifies a standard Danfoss status or fault code.
*
BinaryCauseResponseCorrection
Strt ≥ Max
Strt or Max value is out of
range.
Output = 0
Fault Logic
This topic describes how fault logic is indicated for the function block.
ConditionHex
Input value is too low.0x80010001Input value < 0.
Input value is too high.0x80020010Input value > 10000.
*
Bit 16 set to 1 identifies a standard Danfoss status or fault code.
*
Binary CauseResponseCorrection
Output = 0
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.
Ensure that Max > Strt.
Return Strt and Max values to
Danfoss | February 201911062084 | AQ00000275en-000101 | 17
Page 18
User Manual
PLUS+1® Compliant Function Block Library—Output Function Blocks
PWM_Driver Function Block
IEC 61508-3 Annex D Supplemental Information
The following table provides IEC 61508-3 Annex D supplemental information.
Item
Function block name
Function block version
Function block development
environment
Compatible hardware
Function block developed in
compliance with
Competence required of
function block integrator
Contacting Danfoss
Description
PWM_Driver.
4.0.
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.
Danfoss | February 201911062084 | AQ00000275en-000101 | 19
Page 20
User Manual
PLUS+1® Compliant Function Block Library—Output Function Blocks
ErrorHistory Function Block
Outputs
The outputs of the ErrorHistory function block are described.
ItemTypeRangeDescription
IOBus——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.
FullBOOL——Indicates that all records are full. New location/type combinations are not stored in the function block’s
internal EEPROM. A second function block can be used to store more records.
T—the function block has no more memory locations available to store error records.
•
F—the function block has at least one memory location available to store an error record.
•
DataOutBus——Contains signals to be passed to another ErrorHistory function block. This allows for more location/
type combinations to be stored in EEPROM.
Outputs:
LocList signal.
•
TypeList signal.
•
Assigned signal.
•
Ten sub-buses labeled EE_0, EE_1, EE_2, EE_3, EE_4, EE_5, EE_6, EE_7, EE_8, and EE_9. Signals
•
within these buses provide access to error record values.
LocList Array[
TypeList Array[
Assigned Array[
EE_xBus——Each EE_x bus (where x is a value from 0 to 9) connects to a memory location. Memory components in
Loc
Type
OC
Last
First
0–255Array of location codes for active errors.
20]U8
0–255Array of error type codes for active errors.
20]U8
——Array where each index indicates whether the corresponding index in the LocList and TypeList has
20]BO
OL
0–255Outputs the error location code stored at the memory location connected to Bus_x.
U8
0–255Outputs the error type code stored at the memory location connected to Bus_x.
U8
0–255Outputs the total occurrences for the error stored at the memory location connected to Bus_x.
U8
0–4, 294, 967, 295Outputs the time stamp of the last error stored at the memory location connected to Bus_x. Time units
U32
0–4, 294, 967, 295Outputs the time stamp of the first error stored at error stored at a memory location connected to
U32
Use as an input to a second ErrorHistory function block.
Use as an input to a second ErrorHistory function block.
been stored.
Can also be used as an input to a second ErrorHistory function block.
T—the corresponding index in the LocList and TypeList has been stored.
•
F—the corresponding index in the LocList and TypeList has not been stored.
•
these memory locations store error records. The function block has ten memory locations to store ten
error records. Signals in each EE_x sub-bus output the error information stored at these memory
locations.
Each EE_x sub-bus has five signals:
PLUS+1® Compliant Function Block Library—Output Function Blocks
ErrorHistory Function Block
Function Block Connections
Connections you can make with the function block are described.
Description
Item
1
2A positive transition clears all the function block’s error records.
3Bus input for LocList, TypeList, and Assigned signals.
4Outputs a bus with all of the function block's input and output signals.
5
6Outputs:
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—the function block has no more memory locations available to store error records.
•
F—the function block has at least one memory location available to store an error record.
•
Ten sub-buses labeled EE_0, EE_1, EE_2, EE_3, EE_4, EE_5, EE_6, EE_7, EE_8, and EE_9. Signals within these buses provide access to error
•
record values.
LocList signal. Use as an input to a second ErrorHistory function block.
•
TypeList signal. Use as an input to a second ErrorHistory function block.
•
Assigned signal. Use as an input to a second ErrorHistory function block.
•
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.
PLUS+1® Compliant Function Block Library—Output Function Blocks
ErrorHistory Function Block
IEC 61508-3 Annex D Supplemental Information
The following table provides IEC 61508-3 Annex D supplemental information.
Item
Function block name
Function block version
Function block development
environment
Compatible hardware
Function block developed in
compliance with
Competence required of
function block integrator
Contacting Danfoss
Description
ErrorHistory.
4.0.
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.
2800 East 13th Street
Ames, IA 50010, USA
Phone: +1 515 239 6000
Danfoss
Power Solutions Trading
(Shanghai) Co., Ltd.
Building #22, No. 1000 Jin Hai Rd
Jin Qiao, Pudong New District
Shanghai, China 201206
Phone: +86 21 3418 5200
Products we offer:
Comatrol
www.comatrol.com
Turolla
www.turollaocg.com
Hydro-Gear
www.hydro-gear.com
Daikin-Sauer-Danfoss
www.daikin-sauer-danfoss.com
DCV directional control
•
valves
Electric converters
•
Electric machines
•
Electric motors
•
Hydrostatic motors
•
Hydrostatic pumps
•
Orbital motors
•
PLUS+1® controllers
•
PLUS+1® displays
•
PLUS+1® joysticks and
•
pedals
PLUS+1® operator
•
interfaces
PLUS+1® sensors
•
PLUS+1® software
•
PLUS+1® software services,
•
support and training
Position controls and
•
sensors
PVG proportional valves
•
Steering components and
•
systems
Telematics
•
Danfoss Power Solutions is a global manufacturer and supplier of high-quality hydraulic and
electric components. We specialize in providing state-of-the-art technology and solutions
that excel in the harsh operating conditions of the mobile off-highway market as well as the
marine sector. Building on our extensive applications expertise, we work closely with you to
ensure exceptional performance for a broad range of applications. We help you and other
customers around the world speed up system development, reduce costs and bring vehicles
and vessels to market faster.
Danfoss Power Solutions – your strongest partner in mobile hydraulics and mobile
electrification.
Go to www.danfoss.com for further product information.
We offer you expert worldwide support for ensuring the best possible solutions for
outstanding performance. And with an extensive network of Global Service Partners, we also
provide you with comprehensive global service for all of our components.
Local address:
Danfoss can accept no responsibility for possible errors in catalogues, brochures and other printed material. Danfoss reserves the right to alter its products without notice. This also applies to products
already on order provided that such alterations can be made without subsequent changes being necessary in specifications already agreed.
All trademarks in this material are property of the respective companies. Danfoss and the Danfoss logotype are trademarks of Danfoss A/S. All rights reserved.