Accelerating the pace of engineering and science

# Documentation Center

• Trial Software

# Generic Linear Actuator

Model generic linear actuator driven from DC voltage source or PWM driver

## Library

Translational 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 adds the Temperature Dependence and Thermal port tabs to the block dialog box.

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 tab parameters, see Simulating Thermal Effects in Rotational and Translational Actuators.

## Basic Assumptions and Limitations

This block has the following 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.

## Dialog Box and Parameters

### Electrical Force Tab

Speed values

Specify a vector of speeds, including their units, for your force-speed data. The default value is [ -15 -10 -5 0 5 10 15 20 25 30 ] m/s.

Force values

Specify a vector of forces, including their units, for your force-speed data. The default value is [ 4 3.5 3 2.5 2 1.5 1 0.5 0 -0.5 ] N.

Rated voltage

Indicate the voltage for which the device you are modeling is rated. The default value is 12 V.

Motor efficiency (percent)

Efficiency that the block uses to calculate force-dependent electrical losses. The default value is 70.

Speed at which efficiency is measured

Speed that the block uses to calculate force-dependent electrical losses. The default value is 20 m/s.

Force-independent electrical losses

Fixed electrical loss associated with the actuator when the force is zero. The default value is 2 W.

Simulation mode

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. PWM is the default setting.

If you set the Simulation mode parameter to Averaged, the force generated in response to an applied voltage is

where is the force value at speed . The current drawn from the supply is such that the product of the current and is equal to the average power that is consumed.

### Mechanical Tab

Plunger mass

Mass of the moving part of the motor. The default value is 0.1 kg. The value can be zero.

Linear damping

Linear damping. The default value is 1e-05 N/(m/s). The value can be zero.

Initial plunger speed

Speed of the plunger at the start of the simulation. The default value is 0 m/s.

## Ports

This block has the following ports:

+

Positive electrical conserving port

-

Negative electrical conserving port

C

Mechanical translational conserving port connected to the actuator case

R

Mechanical translational conserving port connected to the plunger