Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library...

26
Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

Transcript of Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library...

Page 1: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

Technical Information

Propel Application Library (PAL)Software Function Blocks

powersolutions.danfoss.com

Page 2: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

Revision history Table of revisions

Date Changed Rev

Dec 2017 First version 0101

Technical InformationPropel Application Library (PAL) Software Function Blocks

2 | © Danfoss | Dec 2017 | BC00000396en-US0101

Page 3: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

IntroductionWhat is PAL......................................................................................................................................................................................... 4

Basic FunctionsBraking..................................................................................................................................................................................................5Automotive Creep............................................................................................................................................................................5Creep.....................................................................................................................................................................................................5Basic Drive Curve (modifier)......................................................................................................................................................... 6Drive State machine with FNR + Hold.......................................................................................................................................7Engine Control (basic).....................................................................................................................................................................8Engine Control with Temperature Limitation........................................................................................................................82 pin FNR Switch............................................................................................................................................................................... 83 pin FNR Switch (push button).................................................................................................................................................. 93 pin FNR Switch (held).................................................................................................................................................................. 9Output block 3 pin FNR (LED)....................................................................................................................................................10Hydrostatic Core block (basic)...................................................................................................................................................10Hydrostatic Core Drive State block..........................................................................................................................................11Hydrostatic Core block (jump).................................................................................................................................................. 12Inching function............................................................................................................................................................................. 13Redundant Pedal............................................................................................................................................................................13Pedal................................................................................................................................................................................................... 14

Advanced FunctionsCommand Modifier....................................................................................................................................................................... 15Cruise Control (basic)....................................................................................................................................................................15Cruise Control with Jog Up / Down.........................................................................................................................................16ECO Mode ........................................................................................................................................................................................ 16Hydromotor Overspeed Protection.........................................................................................................................................17Max Hydromotor Torque Control............................................................................................................................................ 17Stop to Shift..................................................................................................................................................................................... 18Temperature Derate......................................................................................................................................................................18Vehicle Speed Limitation............................................................................................................................................................ 19

Service tool and Documentation

System Builder Sales ToolGeneral...............................................................................................................................................................................................21Explanation of cards......................................................................................................................................................................22Using the Card Game....................................................................................................................................................................23

Technical InformationPropel Application Library (PAL) Software Function Blocks

Contents

© Danfoss | Dec 2017 | BC00000396en-US0101 | 3

Page 4: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

What is PAL

PLUS+1® GUIDE allows to implement different software libraries e.g. WFC, PAL. Each library consists ofone or more packages which includes different function blocks.

One of the libraries is PAL, which stands for Propel Application Library.

Through use of Danfoss PLUS+1® and PAL, you can develop complete propel systems for mobilemachinery or easily integrate any PAL function block into your existing propel system — regardless of thesystem configuration or hardware in use.

PAL not only provides you a competitive advantage by allowing for superior machine performance, butalso can dramatically reduce your development time - getting you to market faster. The reason for this isthat PAL supports the entire propel software development process, and is aligned with other PLUS+1®compliance blocks.

PAL offers two different library packages.

The “PAL Basic” library package and the “PAL Advanced Power Management (PAL APM)” library package.The PAL basic library package offers a lot of function blocks to design simple propel solutions (e.g. for onepump and one motor). PAL APM library package offers function blocks to get a better driving behavior by“cruise control” or fuel saving by an “eco mode” function block – this means function blocks for advancedfeatures for propel solutions. On the following pages, the function blocks of the former mentionedpackages will be explained further to provide a more detailed overview.

PAL function blocks can used with all MCxx and SCxx Controllers - to use PAL on Application Hardware isnot required.

A pre-condition for using PAL is a PLUS+1® GUIDE Professional license (min. version 8.1 or higher)required! PAL will not work with the Guide Express License.

Both PAL library packages can got by a license. The PAL Basic is a free license. The non free licenses arevalid for a limited time and can be renewed by a yearly subscription for each library package. For eachfunction block of the PAL library package will have the following documents and software files part of thescope:• PLUS+1® Software Function Block

• Safety Manual and Programmers Guide as .pdf file

• Service Tool Screen as P1D file

• User Manual snippet in MS Word format

Technical InformationPropel Application Library (PAL) Software Function Blocks

Introduction

4 | © Danfoss | Dec 2017 | BC00000396en-US0101

Page 5: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

Braking

The Braking function has the purpose of reducing a Drive Command by a Brake Command. Both signalscan be read from a lever, potentiometer or pedal. The function can reduce the Drive Command down tocomplete Stop.

The following diagram illustrates in a simplified way how the function block works:

Braking

Brake Command

Drive Command inSubtract & Limit Drive Command outOverride

Stop Request

Automotive Creep

An Automotive drive Mode uses the engine rpm as the setpoint signal for the drive curves. The enginerpm is measured with a PPU or received via CAN message. This engine rpm signal is virtually reduced bythe Creep Command, the setpoint for the drive curves is reduced as well.

With a Creep Command = 100% the Engine Speed In is directly send to the Engine Speed Out signal. Byparameter a “minimum Engine Speed out” can be defined. A Creep Command = 0% will reduce theEngine Speed in to the “minimum Engine Speed out”.

This function requires a creep pedal or potentiometer being installed on the machine. The creep signalneeds to be prepared as a percentage value (e.g. by using Pedal function block).

The following diagram illustrates in a simplified way how the function block works.

Automotive Creep

Creep Command

Engine Speed in

Scale & Limit Engine Speed outActivation

Parameter

Creep

Creeping is a function to scale (reduce) the Drive Command In proportionally.

With a Creep Command = 100% the Drive Command in is equal to the Drive Command out. A CreepCommand = 0% will reduce the Drive Command out to 0%. This function requires a creep pedal orpotentiometer being installed on the machine. The creep signal needs to be prepared as a percentagevalue (e.g. by using Pedal function block).

The following diagram illustrates in a simplified way how the function block works.

Technical InformationPropel Application Library (PAL) Software Function Blocks

Basic Functions

© Danfoss | Dec 2017 | BC00000396en-US0101 | 5

Page 6: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

Creeping

Multiply & Limit Activation

Parameter

CreepCommand

DriveCommand in

DriveCommand out

Basic Drive Curve (modifier)

Basic Drive Curve is a function that modifies an Input Drive Command with a 6-point profile. Apercentage factor is used to modify the output of the profile. If a stop request is received, the OutputDrive Command is pulled to zero. The final output is time-ramped at a rate settable by time rateparameters.

The following diagram illustrates in a simplified way how the function block works.

Time RampProfile

Calculation,

Soften & Adjust

Parameters

Ramp AdjustStop Request

Drive Factor

Input DriveCommand

OutputDrive Command

StopCommand

Basic Drive Curve (modifier)

Vehicle Speed

DriveFactor

StopRequest

InputLimitation

OutputMargin

Ramp Times

Technical InformationPropel Application Library (PAL) Software Function Blocks

Basic Functions

6 | © Danfoss | Dec 2017 | BC00000396en-US0101

Page 7: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

Drive State machine with FNR + Hold

The Drive State Machine is a function between a FNR to choose the driving direction and the hydraulicpower transmission for driving (pump + hydromotor). The Drive State Machine sets the Direction Statebased on the request given via Direction Request (FNR). The Start Protection can block the DirectionRequest e.g. if the engine rpm is too low.

The function Hold Direction can hold (store) the Direction Request if there is a reason not to change thedriving direction e.g. vehicle speed is too fast for a safe direction change.

The following diagram illustrates in a simplified way how the function block works.

Range Check

State Machine

Stop

Forward

ForwardBraking

ForwardReversal

ReverseBraking

ReverseReversal

Reverse

Hold Direction

Start Protection

DirectionRequest

Drive State

Direction State

Stop Request

Drive State Machine with FNR + Hold

Override

Technical InformationPropel Application Library (PAL) Software Function Blocks

Basic Functions

© Danfoss | Dec 2017 | BC00000396en-US0101 | 7

Page 8: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

Engine Control (basic)

The Engine Control Basic is a function that converts a Drive Command into an Engine Speed Commandand passes the output command through a time ramp. This requires an interface to the diesel enginesuch as a CAN bus or throttle actuator.

The following diagram illustrates in a simplified way how the function block works.

Engine SpeedCommand

DriveCommand

Engine Control (basic)

Scale Ramp

Parameter

Engine Control with Temperature Limitation

This function converts a Drive Command into an Engine Speed command and passes the outputcommand through a time ramp. If the measured Temperature is below a threshold value the enginespeed command will be limited to a parameter value and the output Limited Range will indicate that theengine speed limitation is active. This function block shall be used for generating an engine speedsetpoint. This requires an interface to the diesel engine such as a CAN bus or throttle actuator.

The following diagram illustrates in a simplified way how the function block works.

Scale Ramp

Parameter

Temperature Limitation

Limited

Engine Control withTemperature Limitation

DriveCommand

Temperature

Engine SpeedCommand

2 pin FNR Switch

The FNR 2 Switch function block generates a Driving Direction request (Forward, Neutral or Reverse)based on Forward Switch and Reverse Switch. If Forward Switch is active exclusively, the DirectionRequest will be Forward. If Reverse Switch is active exclusively, the Direction Request will be Reverse. If noswitch is active, the Direction Request will be Neutral. If both switches are active for more than ErrorDelay Time, a fault will be declared and the Driving Direction request output is forced to Neutral.

The following diagram illustrates in a simplified way how the function block works.

FNR Logic

Fault Detection

Parameter

Forward Input

Reverse InputDrivingDirection

Override

2 pin FNR Switch

Technical InformationPropel Application Library (PAL) Software Function Blocks

Basic Functions

8 | © Danfoss | Dec 2017 | BC00000396en-US0101

Page 9: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

3 pin FNR Switch (push button)

The FNR 3 Pushbutton function block generates a Driving Direction request (Forward, Neutral or Reverse)based on Forward Pushbutton, Reverse Pushbutton and Neutral Pushbutton. If Forward Pushbutton isactive exclusively, the Direction Request will be Forward. If Reverse Pushbutton is active exclusively, theDirection Request will be Reverse. If Neutral Pushbutton is active exclusively, the Direction Request willbe Neutral. If no Pushbutton is active the last Direction Request will be kept. If more than one pushbuttonis active at the same time for more than Error Delay Time, a fault will be declared and the DrivingDirection request output is forced to Neutral.

The following diagram illustrates in a simplified way how the function block works.

FNR Logic

Fault Detection

Override

Parameter

3 pin FNR Switch(push button)

Forward Input

Reverse Input

Neutral Input

DrivingDirection

3 pin FNR Switch (held)

The FNR 3 Switch function block generates a Driving Direction request (Forward, Neutral or Reverse)based on three input signals. The signal must be held (continuously). If Forward Switch is activeexclusively, the Direction Request will be Forward. If Reverse Switch is active exclusively, the DirectionRequest will be Reverse. If Neutral Switch is active exclusively, the Direction Request will be Neutral. Ifnone or more than one switch is active for more than Error Delay Time, a fault will be declared and theDriving Direction request output is forced to Neutral.

The following diagram illustrates in a simplified way how the function block works.

FNR Logic

Fault Detection

Override

Parameter

3 pin FNR Switch(held)

Forward Input

Reverse Input

Neutral Input

DrivingDirection

Technical InformationPropel Application Library (PAL) Software Function Blocks

Basic Functions

© Danfoss | Dec 2017 | BC00000396en-US0101 | 9

Page 10: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

Output block 3 pin FNR (LED)

This FNR LED Output block derives three output signals Forward, Reverse and Neutral from the inputDriving Direction. It can be used to control direction indication lamps.

The following diagram illustrates in a simplified way how the function block works.

Limit DecodeDrivingDirection

Output Forward

Output NeutralOutput Reverse

Output Block3 pin FNR (LED)

Hydrostatic Core block (basic)

This function block takes an input Drive Command and converts it into a Hydrostatic Command. It allowsimplementing different drive concepts for pump and motor such as Automotive Control and Non-Automotive Control. The Drive Command can be from various signals. For Automotive Control the drivecommand will be the engine speed. For implementing a Non-Automotive Control the drive commandcan be a pedal position or a hydrostatic ratio command. There’s no specific hardware for this functionblock required. It is recommended that the engine goes to Low Idle instead of High Idle in case of anerror (e.g. lost connection).

The following diagram illustrates in a simplified way how the function block works.

Parameter

Profile

Error

RampDrive Command HydrostaticCommand

Hydrostatic Core block(basic)

Technical InformationPropel Application Library (PAL) Software Function Blocks

Basic Functions

10 | © Danfoss | Dec 2017 | BC00000396en-US0101

Page 11: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

Hydrostatic Core Drive State block

This function block takes an input Drive Command and converts it into a Hydrostatic Command. It allowsimplementing different drive concepts for pump and motor such as Automotive Control and Non-Automotive Control. The drive command can be from various signals. For Automotive Control the drivecommand will be the engine speed. For implementing a Non-Automotive Control the drive commandcan be a pedal position or a hydrostatic ratio command.

Different sets of parameters are used for internal profile and time ramp depending on the actual drivestate. The input drive command is automatically forced to zero when the Drive State is at Braking,Reversal, Stop, Parking or an undefined state. So only when drive state is Forward or Reverse the drivecommand will be forwarded to the corresponding profile. There’s no specific hardware for this functionblock required. It is recommended that the engine goes to Low Idle instead of High Idle in case of anerror (e.g. lost connection).

The following diagram illustrates in a simplified way how the function block works.

Parameter

Profile

Error

Ramp

Parameter Selector

Force To Zero

Drive State

Drive Command HydrostaticCommand

Hydrostatic Core Drive State block

Technical InformationPropel Application Library (PAL) Software Function Blocks

Basic Functions

© Danfoss | Dec 2017 | BC00000396en-US0101 | 11

Page 12: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

Hydrostatic Core block (jump)

This function block is intended to be used for controlling NFPE pumps.

This function block takes an input Drive Command and converts it into a hydrostatic command. It allowsimplementing different drive concepts for pumps such as Automotive Control and Non-AutomotiveControl. The drive command can be from various signals. For Automotive Control the drive command willbe the engine speed. For implementing a Non-Automotive Control the drive command can be a pedalposition or a hydrostatic ratio command.

Different sets of parameters are used for internal profile and time ramp depending on the actual drivestate. The input Drive Command is automatically forced to zero when the Drive State is at Braking,Reversal, Stop, Parking or an undefined state. Only when drive state is Forward or Reverse the DriveCommand will be forwarded to the corresponding profile.

In this kind of hydrostatic core function block it is possible to perform a jump of the hydrostaticcommand. The jump feature is useful when implementing an Automotive Control using a NFPE pump.Typically the current controlling a NFPE pump is overdriven to ensure that the pump is at maximumdisplacement. When triggering a Reversal, Braking or Stop state the pump current will ramp down, butwithout any vehicle deceleration as long as the pump current is above a machine specific threshold. Thejump feature allows skipping this current range by jumping directly to this threshold. There’s no specifichardware for this function block required. It is recommended that the engine goes to Low Idle instead ofHigh Idle in case of an error (e.g. lost connection).

The following diagram illustrates in a simplified way how the function block works.

Parameter

Profile

Error

Ramp

Parameter Selector

Jump Function

Force To Zero

Drive State

Drive CommandHydrostaticCommand

Hydrostatic Core block(jump)

Technical InformationPropel Application Library (PAL) Software Function Blocks

Basic Functions

12 | © Danfoss | Dec 2017 | BC00000396en-US0101

Page 13: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

Inching function

The Inching signal reduces the drive command. A 0% Inch Signal leaves the drive command unchanged(Drive Command in = Drive Command out). A 100% Inch signal reduces the Drive Command out to 0. TheInch Command can be profiled by an 8 point profile.

The following diagram illustrates in a simplified way how the function block works.

Inching

ActivationProfile Multiply & Limit

Parameter

Inch Command

Drive Command in

DriveCommand out

Redundant Pedal

The Redundant Pedal function block converts a voltage signal from a pedal into a percentage output.This percentage output is based on the signal characteristics of the sensor. A built-in calibration routinecan capture the electric signal at each end of the sensor’s range. This function block scales its outputbetween 0% and 100%. It also uses a redundant pedal signal input to monitor if the nominal signal workswell.

The following diagram illustrates in a simplified way how the function block works.

Redundant PedalParameter

RedundantSignal

Nominal Signal

Supply Voltage

RedundancyCheck

LinearScale Calibration Override

FaultDetection

PedalStatus

PedalCommand

Pressed

Technical InformationPropel Application Library (PAL) Software Function Blocks

Basic Functions

© Danfoss | Dec 2017 | BC00000396en-US0101 | 13

Page 14: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

Pedal

The Pedal function block converts a voltage signal from a pedal into a percentage output. Thispercentage output is based on the signal characteristics of the sensor. A built-in calibration routine cancapture the electric signal at each end of the sensors range. This function block scales its output between0% and 100%.

The following diagram illustrates in a simplified way how the function block works.

Pedal

Linear Scale

Fault Detection

Override

Parameter

Calibration

Pedal Status Pressed

Nominal Signal

Supply Voltage

PedalCommand

Technical InformationPropel Application Library (PAL) Software Function Blocks

Basic Functions

14 | © Danfoss | Dec 2017 | BC00000396en-US0101

Page 15: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

Command Modifier

The Command Modifier function block is used to modify a command signal by adding adjust value. Thiscould be a different control functions (e.g. Motor Overspeed Protection, Engine Overspeed Protection,Speed Limiter, Antistall …).

Furthermore the Command Modifier function block calculates a hold signal for each of the controlfunctions. The hold signals allow to hold the adjust value of a control function with a lower priority at itsmomentary value if another control function with a higher priority becomes active (adjust value nolonger zero).

The following diagram illustrates in a simplified way how the function block works.

Range Check and Limitation

Apply Adjust Values

Priority

Command Modifier

Priority 1 adjustment

Priority 3 adjustment

Priority 2 adjustment

Priority 4 adjustmentPriority 5 adjustmentPriority 6 adjustmentPriority 7 adjustment

Priority 8 adjustment

Command in

Priority 2 hold

Priority 3 hold

Priority 4 hold

Priority 5 holdPriority 6 holdPriority 7 hold

Priority 8 hold

Command adjust

Command out

Cruise Control (basic)

The Cruise Control function stores (freeze) the Drive Command value (vehicle speed) when activated. Thecruise operation can be deactivated and resumed.

The following diagram illustrates in a simplified way how the function block works.

Active

a

b

a > b

Time Ramp

Only rampingthe transitionsat deactivationand resume

ErrorResume

EnableActivate

Deactivate

Drive Command In

ControlLogic

Mem

UpdateOverrideLogic

Drive Command Out

Cruise Control (basic)

Technical InformationPropel Application Library (PAL) Software Function Blocks

Advanced Functions

© Danfoss | Dec 2017 | BC00000396en-US0101 | 15

Page 16: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

Cruise Control with Jog Up / Down

The Cruise Control function stores (freeze) the Drive Command value (vehicle speed) when activated. Thecruise operation can be deactivated and resumed. The stored value can be increased or decreased insteps.

The following diagram illustrates in a simplified way how the function block works.

ActivateDeactivate

ActivationLogic

Mem

Active

Updatea

b

a > bOverride

Logic

Enable_B

Time Ramp

Active

Inc/DecLogic

Update

ErrorCruise Control with Jog Up / Down

DriveCommand in

DriveCommand out

Increase

Decrease

Reset

ECO Mode

An ECO Mode is used to drive the vehicle with reduced engine rpm at the maximum vehicle speed. Thehydrostatic driveline need to be oversized (faster) to be able to reduce the engine rpm.

The Drive Command (e.g. from the drive pedal) creates the Engine Speed Command. If the ECO Mode isenabled but not active, then PI controller of the ECO Mode function serves as a speed limiter. When acertain vehicle speed is reached and maintained for a defined time, the ECO Mode will be activated andreduces the engine speed automatically. Then the PI controller works as a constant speed drive (CSD).The pump displacement must in turn be increased to keep the vehicle speed on the same level with areduced engine speed.

The ECO Mode is automatically switched off (inactive), if the vehicle slows down, the Drive Command(pedal) drops or the Drive State is changed.

The following diagram illustrates in a simplified way how the function block works.

Scale Ramp

Parameter

Modifier

PI Controller

ECO Activation

ECO Mode Hold

Vehicle Speed

Enable ECO on

Drive Command Engine SpeedCommand

ECO Mode

Technical InformationPropel Application Library (PAL) Software Function Blocks

Advanced Functions

16 | © Danfoss | Dec 2017 | BC00000396en-US0101

Page 17: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

Hydromotor Overspeed Protection

The function block compares the actual hydro motor speed with the parameter value for maximumallowed speed. If actual speed is below maximum speed the hydro motor Overspeed Adjust will be zero.If actual speed is above maximum speed the function calculates a negative overspeed adjust value. Thisvalue is later applied to another command (e.g. pump or hydro motor command depending on the usedcomponents) to reduce the hydro motor speed

The following diagram illustrates in a simplified way how the function block works.

Parameter

PI Controller

Hold

ActiveHydromotor Speed Overspeed

Adjust

HydromotorOverspeed Protection

Max Hydromotor Torque Control

The Max Hydromotor Torque block will command the Hydromotor to max displacement until a definedvehicle speed is reached. This will provide the max torque/tractive force when starting from stop. TheHydromotor command for the drive profile will be overwritten as long as the function is active.

The following diagram illustrates in a simplified way how the function block works.

Parameter

Active

Vehicle Speed

HydromotorCommand in

HydromotorCommand out

Max HydromotorTorque Control

Selector

Enable

Technical InformationPropel Application Library (PAL) Software Function Blocks

Advanced Functions

© Danfoss | Dec 2017 | BC00000396en-US0101 | 17

Page 18: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

Stop to Shift

The Stop to Shift function block prevents gear shifting if vehicle speed is too high. It holds the last gearcommand at the output as long as the vehicle speed is above the parameter „Allow Shift Speed“. If thevehicle speed is below the parameter value and Enable input is true then the requested gear command isforwarded.

When starting the microcontroller the gear command at the output is set to a default value, defined byparameter.

This function requires a gearbox which can only shift in standstill.

A fault of the PPU used for measuring the vehicle speed can cause shifting at too high speeds. If the PPUhas a fault detection then this could be used to suppress the shifting.

The following diagram illustrates in a simplified way how the function block works.

Memorize

Parameter

Allow Shifting

Enable

Vehicle Speed

Gear Command in Gear Command out

Stop to Shift

Temperature Derate

The Temperature Derate block modifies an input command by multiplying it by a percentagetemperature factor. This factor is derived from a temperature input feeding into a 6-point profile. A TimeRamp is used directly on the profile output to smooth the result of any steep-sloped profiles. If thefunction becomes inactive, the input command is passed straight through by multiplying by 100%. Thepurpose of this function is to protect your system when it is too hot or too cold.

Technical InformationPropel Application Library (PAL) Software Function Blocks

Advanced Functions

18 | © Danfoss | Dec 2017 | BC00000396en-US0101

Page 19: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

Vehicle Speed Limitation

The Vehicle Speed Limitation compares actual Vehicle Speed with Max Vehicle Speed in Forward andReverse direction. Depending on the selected driving direction one of the limits is used. If the Limit isreached a correction signal (Speed Limit adjust) is modified. This value is intended to limit the vehiclespeed by applying it to another command (e.g. drive command).

The following diagram illustrates in a simplified way how the function block works.

Direction StateActive

Parameter

Enable B

Drive Command Speed Limitation Adjustment

Hold

Vehicle Speed Limitation

PIController

Technical InformationPropel Application Library (PAL) Software Function Blocks

Advanced Functions

© Danfoss | Dec 2017 | BC00000396en-US0101 | 19

Page 20: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

Example: Braking

Screen ‘Braking’

Select the ‘Braking’ screen.

This screen gives an overview of adjusting the Braking function.

The Braking function has the purpose to reduce a Drive Command that is read from a lever,potentiometer or pedal by a braking signal that is given by another input. The function can reduce thedrive setpoint down to zero if a Stop Request is set by another function.

Description

Drive Command In The command for driving. Drive command comes from a foot pedal, lever orpotentiometer.

Brake Command The command for decreasing driving speed. Brake command comes from a foot pedal,lever or potentiometer.

Stop Request Digital (Boolean) input signal. Stop request command.1 (True): Perform Braking regardless of the Brake Command input0 (False): Normal action

Limit Input Signal after subtraction and switch, input to the limitation.

Drive Command Out Modified Drive Command.

Fault This signal indicates if an input fault is declared. It’s a bitwise code, so multiple items canbe reported at a time. The following fault codes are provided:0x0000: No fault0x8002: Drive Command In/Brake Command value is/are too high

Material Number Material/identification number of the overall software application.

Software Version Software version number of the overall software application.

Start-up Procedures

There is no particular start-up procedure needed for this function.

Fault Analysis

If Drive Command In or Brake Command is greater than 100.00% then Fault displays 0x8002 and DriveCommand In or Brake Command is clamped to 100.00%.

Technical InformationPropel Application Library (PAL) Software Function Blocks

Service tool and Documentation

20 | © Danfoss | Dec 2017 | BC00000396en-US0101

Page 21: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

General

The PAL System Builder Sales Tool is a kind of card game to support the visualization of propel softwaresolutions with PAL function blocks during the design phase of the propel software development process.

One deck of cards of the System Builder Sales Tool consist of:• in total of 61 cards incl. one instruction card

• 37 software function blocks of the PAL Basic and PAL APM library package

• 12 blank cards for customized functions (4 of each color)

• 11 compliance block cards (4 motor driver, 4 pump driver, speed and pressure sensors)

Technical InformationPropel Application Library (PAL) Software Function Blocks

System Builder Sales Tool

© Danfoss | Dec 2017 | BC00000396en-US0101 | 21

Page 22: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

Explanation of cards

4 different card types (1x compliance 3x function blocks):GREY = compliance blocks BLUE = input fct. blocks

YELLOW = function blocks ORANGE = output fct. blocks

4 different library packages: (Basic) Basic & (APM) Advanced Power Management cards are available! (MM) Multi-Motor & (DuPa) Dual Path

cards will follow after finishing their development

4 different function block groups: Only important for software developers tofind the selected function block easier in the library – same symbols at the

library for Front Add-on, Engine Core, Hydrostatic Core, Rear Add-on

Naming of function block (1 card = 1 function block)e.g. „Hydrostatic Core“ is the name of this function block and describe mainfunctionshortly, but some are available with different subfunctions like here „Drive State“. It

is also a „Hydrostatic Core“ fb available as „Basic“ or „DS w. Jump“

This

sym

bols

how

sth

atth

isfu

nctio

nbl

ock

ispa

rtof

the

„Bas

ic“

libra

rypa

ckag

e. S

o it

isea

sy t

ofin

d fo

rth

eso

ftw

are

deve

lope

rw

hich

libra

rypa

ckag

ehe

nee

dsto

get

this

fbfo

rhi

spr

opel

soft

war

eso

lutio

n.

This symbol is a group symbol and stands in this case for the „Hydrostatic Core“ group. This allows the software developer to find this function block very easy in the

library. Other group symbols are like Front Add-on, Engine Core or Rear Add-on.

Blue area = Input signals which are necessary for this fbYellow area = Short discription of the function of the blockOrange area = Ouput signals which the function block delivers

Technical InformationPropel Application Library (PAL) Software Function Blocks

System Builder Sales Tool

22 | © Danfoss | Dec 2017 | BC00000396en-US0101

Page 23: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

Using the Card Game

The best way is to take a white sheet of paper to lay the function block cards on it or a white board tostick the cards on it.

At first it makes sense to connect the Danfoss products like a motor, pump or sensor with the complianceblocks as also the remaining sensors like FNR switch or braking lights with the controller – “bring thesensors and actors in the controller”. Now, select the necessary PAL function blocks as card stick or laythem on the paper which should show the memory of the controller and connect the PAL function blocksand compliance blocks with drawn lines. If a function block is not available in the deck of cards of the PALSystem Builder Sales Tool it is possible to use one of the blank function block cards and write (with a non-permanent pen) a specific name on it, add it to the paper.

This procedure helps to have very fast a first picture of the software design on the paper – make a photoand the next step of the software development can start in PLUS+1® GUIDE with PAL:

Technical InformationPropel Application Library (PAL) Software Function Blocks

System Builder Sales Tool

© Danfoss | Dec 2017 | BC00000396en-US0101 | 23

Page 24: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

Technical InformationPropel Application Library (PAL) Software Function Blocks

24 | © Danfoss | Dec 2017 | BC00000396en-US0101

Page 25: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

Technical InformationPropel Application Library (PAL) Software Function Blocks

© Danfoss | Dec 2017 | BC00000396en-US0101 | 25

Page 26: Software Function Blocks - Danfossfiles.danfoss.com/documents/TI Propel Application Library PAL...Technical Information Propel Application Library (PAL) Software Function Blocks powersolutions.danfoss.com

Danfoss Power Solutions is a global manufacturer and supplier of high-quality hydraulic andelectronic components. We specialize in providing state-of-the-art technology and solutionsthat excel in the harsh operating conditions of the mobile off-highway market. Building onour extensive applications expertise, we work closely with our customers to ensureexceptional performance for a broad range of off-highway vehicles.

We help OEMs around the world speed up system development, reduce costs and bringvehicles to market faster.

Danfoss – Your Strongest Partner in Mobile Hydraulics.

Go to www.powersolutions.danfoss.com for further product information.

Wherever off-highway vehicles are at work, so is Danfoss. We offer expert worldwide supportfor our customers, ensuring the best possible solutions for outstanding performance. Andwith an extensive network of Global Service Partners, we also provide comprehensive globalservice for all of our components.

Please contact the Danfoss Power Solution representative nearest you.

Local address:

Danfoss Power Solutions GmbH & Co. OHGKrokamp 35D-24539 Neumünster, GermanyPhone: +49 4321 871 0

Danfoss Power Solutions ApSNordborgvej 81DK-6430 Nordborg, DenmarkPhone: +45 7488 2222

Danfoss Power Solutions (US) Company2800 East 13th StreetAmes, IA 50010, USAPhone: +1 515 239 6000

Danfoss Power Solutions Trading(Shanghai) Co., Ltd.Building #22, No. 1000 Jin Hai RdJin Qiao, Pudong New DistrictShanghai, China 201206Phone: +86 21 3418 5200

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 productsalready on order provided that such alterations can be made without 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.

© Danfoss | Dec 2017 | BC00000396en-US0101

Products we offer:

• Bent Axis Motors

• Closed Circuit Axial PistonPumps and Motors

• Displays

• Electrohydraulic PowerSteering

• Electrohydraulics

• Hydraulic Power Steering

• Integrated Systems

• Joysticks and ControlHandles

• Microcontrollers andSoftware

• Open Circuit Axial PistonPumps

• Orbital Motors

• PLUS+1® GUIDE

• Proportional Valves

• Sensors

• Steering

• Transit Mixer Drives

Comatrolwww.comatrol.com

Turolla www.turollaocg.com

Hydro-Gearwww.hydro-gear.com

Daikin-Sauer-Danfosswww.daikin-sauer-danfoss.com