Documentation

# Generic Linear Actuator

Generic linear actuator driven from DC voltage source or PWM driver

• Library:
• Simscape / Electrical / Electromechanical / Mechatronic Actuators ## Description

The Generic Linear Actuator block implements a model of a generic linear actuator designed to be driven from a DC voltage source or a PWM driver. Define force-speed characteristics in terms of tabulated values for powering the motor at the rated voltage. This functionality enables you to model a motor without referencing an equivalent circuit.

The motor or actuator architecture determines the way in which electrical losses depend on force. For example, a DC motor has losses that are proportional to the square of the current. As force is proportional to current, losses are also proportional to mechanical force. Most motors have an electrical loss term that is proportional to the square of mechanical force. The Generic Linear Actuator block calculates this loss term using the Motor efficiency (percent) and Speed at which efficiency is measured parameters that you provide.

Some motors also have a loss term that is independent of force. An example is a shunt motor where the field winding draws a constant current regardless of load. The Force-independent electrical losses parameter accounts for this effect.

The motor efficiency is the mechanical power divided by the sum of the mechanical power and both electrical loss terms. The block assumes that the speed at which the motor efficiency is defined is in the motoring quadrant and, therefore, positive.

You can operate the block in the reverse direction by changing the sign of the voltage applied. The H-Bridge block, for example, reverses motor direction if the voltage at the REV port is greater than the Reverse threshold voltage parameter. However, if you are using the block in reverse, specify the force-speed data for forward operation:

• Positive forces and positive speeds in the motoring quadrant.

• Positive force and negative speeds in the generating counterclockwise quadrant.

• Negative force and positive speed in the generating clockwise quadrant.

### Thermal Port

The block has an optional thermal port, hidden by default. To expose the thermal port, right-click the block in your model, and then from the context menu select Simscape > Block choices > Show thermal port. This action displays the thermal port H on the block icon, and exposes the Temperature Dependence and Thermal Port parameters.

Use the thermal port to simulate the effects of copper resistance losses that convert electrical power to heat. For more information on using thermal ports and on the Temperature Dependence and Thermal Port parameters, see Simulating Thermal Effects in Rotational and Translational Actuators.

## Assumptions and Limitations

• The force-speed curve data corresponds only to the rated voltage, so the block produces accurate results only when driven by plus or minus the rated voltage.

• The block requires you to provide force-speed data for the full range over which you use the actuator. To use the actuator in the generating and braking regions, provide additional data outside of the normal motoring region.

• Model behavior is sensitive to force-speed data. For example, no-load speed is correctly defined and finite only when the data crosses the speed axis.

• To drive the block from the H-Bridge block:

• Do not place any other blocks between the H-Bridge and the Generic Linear Actuator blocks.

• In the H-Bridge block dialog box, set the Freewheeling mode to ```Via one semiconductor switch and one freewheeling diode``` . Selecting `Via two freewheeling diodes` does not set the bridge output voltage to zero when the PWM input signal is low.

• In the H-Bridge, Generic Linear Actuator, and Controlled PWM Voltage block dialog boxes, ensure that the Simulation mode is the same for all three blocks.

## Ports

### Conserving

expand all

Electrical conserving port associated with the actuator positive terminal.

Electrical conserving port associated with the actuator negative terminal.

Mechanical translational conserving port associated with the actuator case.

Mechanical translational conserving port associated with the plunger.

## Parameters

expand all

### Electrical Force

Specify a vector of speeds, including their units, for your force-speed data.

Specify a vector of forces, including their units, for your force-speed data.

Indicate the voltage for which the device you are modeling is rated.

Efficiency that the block uses to calculate force-dependent electrical losses.

Speed that the block uses to calculate force-dependent electrical losses.

Fixed electrical loss associated with the actuator when the force is zero.

If you set the Simulation mode parameter to `PWM`, apply a PWM waveform switching between zero and rated volts to the block electrical terminals. The current drawn from the electrical supply is equal to the amount required to deliver the mechanical power and to compensate for electrical losses. If the applied voltage exceeds the rated voltage, the resultant force scales proportionately. However, applying anything other than the rated voltage can provide unrepresentative results.

If you set the Simulation mode parameter to `Averaged`, the force generated in response to an applied voltage ${V}_{av}$ is

`$\frac{{V}_{av}}{{V}_{rated}}×F\left(v\right)$`

where$F\left(v\right)$ is the force value at speed $v$. The current drawn from the supply is such that the product of the current and ${V}_{av}$ is equal to the average power that is consumed.

### Mechanical

Mass of the moving part of the motor. The value can be zero.

Linear damping. The value can be zero.

Speed of the plunger at the start of the simulation.

### Temperature Dependence

This tab appears only for blocks with exposed thermal port. For more information, see Thermal Port.

Resistance temperature coefficient.

The temperature for which the actuator parameters are defined.

### Thermal Port

This tab appears only for blocks with exposed thermal port. For more information, see Thermal Port.

The thermal mass is the energy required to raise the temperature by one degree.

Temperature of the thermal port at the start of simulation.