FunctionMLGearWriteRatSlpPipe Network motion icon

Description

Set the Ratio Slope value of a selected Gear Pipe Block. Ratio Slope sets the limit at which step changes in ratio are implemented.


  • Be sure to set RatioSlope < (Ratio * EtherCAT Update Rate). The Gear block will make a jump (without a ramp) from one gear to the next when the RatioSlope is greater than the Ratio change factor multiplied by the update rate scale factor.


  • Values lower then 1.0 can be entered, but require a leading zero (for example 0.8 instead of .8)


  • The GEAR block output will add a position offset to the GEAR block input when using a RatioSlope. See RatioSlope Offset in the Examples below.

Arguments

Input

BlockID

Description

ID number of an initialized Gear Pipe Block

 

Data type

DINT

 

Range

[-2147483648, 2147483648]

 

Unit

N/A

 

Default

Slope

Description

New Ratio Slope value to be assigned to selected Gear Pipe Block. Values lower then 1.0 can be entered, but require a leading zero (for example 0.8 instead of .8)

 

Data type

LREAL

 

Range

 

Unit

1/sec

 

Default

Output

Default (.Q)

Description

Returns TRUE if Ratio Slope value is changed in the selected Gear Pipe Block

See more details here.

 

Data type

BOOL

 

Unit

N/A

Return Type

BOOL

Related Functions

MLGearReadOffSlp

MLGearInit

Example

Structured Text

 

//Set the Ratio Slope value of Gear1 Pipe Block to 100

MLGearWriteRatSlp(PipeNetwork.GEAR1, 100.0);

 

Ladder Diagram

MLGearWriteRatSlp: LD example

Function Block Diagram

MLGearWriteRatSlp: FBD example

RatioSlope Offset

If MLGearWriteRatSlp is set as to generate a ramp (instead of a step) when going from a gear ratio of 1 to 2, then there will be a position offset when the gear ratio settles as 2. In the image below the ratio goes from 1.0 to 2.0; Green is PN Gear Block Output and Red is Gearbox Input.

  1. Green line: PN Gear Block Output
  2. Red line: PN Gearbox Input
  3. When the ratio is changed
  4. Phase difference

If MLGearWriteRatSlp is set without a ramp, , then there will not be an offset.

  1. Green line: PN Gear Block Output
  2. Red line: PN Gearbox Input
  3. When the ratio changes
  4. Synched

Go back to the top of the page [Top]