Motor & Drive (System Level)

Generic motor and drive with closed-loop torque control

• 

Libraries:
Simscape / Electrical / Electromechanical / System-Level Modeling

Description

The Motor & Drive (System Level) block represents a generic motor and drive or servomotor with closed-loop torque control. Use this block to model a wide range of motor types at system level with application to both traction and actuation systems. The motors you can model include these brushless motors:

• Permanent magnet synchronous motor (PMSM):

  • Interior permanent magnet (IPM) motor or interior permanent magnet synchronous machine (IPMSM).

  • Surface permanent magnet (SPM) motor or surface permanent magnet synchronous machine (SPMSM).

• Brushless DC (BLDC) motor.

• Axial flux traction motor.

You can also model brushed motors with closed-loop torque control using a Motor & Drive (System Level) block.

To enable fast simulation at a system level, this block abstracts the motor, drive electronics, and control.

The block permits only the range of torques and speeds that the torque-speed envelope defines. In the default block configuration, you specify this data in the block dialog box as a set of speed data points and corresponding maximum torque values.

This figure shows the Cartesian quadrants definition.

This figure shows a typical torque-speed envelope for a torque-controlled motor and drive.

Specify the torque-speed envelope for the positive torque region only, that is, quadrants 1 and 4. The motor torque-speed envelope has the same profile when the motor is operating in a reverse direction (quadrants 2 and 3). If you specify the envelope only for positive speeds (quadrant 1 or, equivalently, the motoring region), then the block defines the quadrant 4 torque envelope as the mirror image of quadrant 1.

Instead of providing tabulated torque-speed data, you can specify a maximum torque and a maximum power. This results in the torque-speed envelope profile shown below. The other three operating quadrants are constrained by this same profile.

The block produces a positive torque acting from the mechanical C to R ports.

Note

Simscape™ Electrical™ includes several blocks that can model the same type of motor or actuator. You must choose a block that has sufficient modeling detail for the engineering design questions that you need to answer. However, do not use more detail than you need, because higher-fidelity models slow down simulation and are more complex to parameterize.

Blocks like the Motor & Drive (System Level) block use energy balancing or other abstraction methods. These models have a low level of fidelity. Use this block when you need a long simulation time, for example, to analyze drive cycles for electric vehicles. For more information about choosing the right block to model your motor at the right level of fidelity, see Choose Blocks to Model Motors or Actuators.

Intermittent Over-Torque Operation

To over-torque the motor for short periods of time, set the Allow intermittent over-torque parameter to Yes. In this case, you must specify the values for both the Continuous operation maximum torque envelope and the Intermittent operation maximum torque envelope parameters. Internally the block determines which torque envelope to apply based on the torque demand history. You can over-torque the motor drive if the torque demand has been less than the continuous operation torque envelope for more than the value specified in the Recovery time parameter. Over-torquing is disabled if over-torquing has been applied for longer than the value specified in the Over-torque time limit parameter.

For more application specific management of over-torquing, disable the over-torquing in the Motor & Drive block and externally implement the torque limiting in Simulink^® between the torque demand and the torque reference input port, Tr, of the Motor & Drive block.

Model Electrical Losses

The block allows both simplified and tabulated definition of electrical losses. The default, simplified, behavior is to model the losses as the sum of the following four terms:

• A series resistance between the DC power supply and the motor drive.

• Fixed losses independent of torque and speed, P₀. Use this to account for fixed converter losses.

• A torque-dependent electrical loss kτ², where τ is the torque and k is a constant. This represents ohmic losses in the copper windings.

• A speed-dependent electrical loss k_wω², where ω is the speed and k_w is a constant. This represents iron losses due to eddy currents.

This simplification of loss dependency on torque and speed might be sufficient for early design work, regardless of the underlying motor type and drive topology.

If you require more accuracy, or later in the design process, you can provide tabulated loss values as a function of motor speed and load torque. When using this option, provide data for all of the operating quadrants that your simulation will run in. If you provide partial data (for example, just for the quadrant 1 forward motoring region), then the other quadrants are assumed to repeat the same pattern of losses. This will normally be correct for the reverse motoring region, but may be an approximation for the braking/generating quadrants. The block does no extrapolation of loss values for speed and torque magnitudes that exceed the range of the table.

Finally, you can specify electrical losses by using tabulated efficiency data, instead of a single efficiency measurement or tabulated loss data. When using this option, also provide data for all of the operating quadrants that your simulation will run in. If you provide partial data (for example, just for the quadrant 1 forward motoring region), then the other quadrants are assumed to repeat the same pattern of losses.

The best practice is to provide tabulated loss data as a function of speed and torque, rather than tabulated efficiency data, because:

• Efficiency becomes ill-defined for zero speed or zero torque.

• Using losses, you can also account for fixed losses that are still present for zero speed or torque.

If you use the tabulated efficiencies option:

• The block converts the efficiency values you provide into losses and uses the tabulated losses for simulation.

• Efficiency values you provide for zero speed or zero torque are ignored, and losses are assumed zero when either torque or speed is zero.

• The block uses linear interpolation to determine losses. Provide tabulated data for low speeds and low torques, as required, to get the desired level of accuracy for lower power conditions.

• The block does no extrapolation of loss values for speed and torque magnitudes that exceed the range of the table.

When you provide tabulated loss or efficiency data, you can also specify it as a function of speed, load torque, and DC supply voltage. This option is useful when the supply voltage is not regulated and can vary during the simulation. One example is an electric vehicle drivetrain that does not have a DC-DC regulator upstream of the motor drive. Use the Motor & Drive (System Level) block to model the motor drive and provide tabulated loss or efficiency values as a function of motor speed, load torque, and DC supply voltage.

Plot Efficiency Map

The block allows you to visualize the map of the torque-speed envelope and the steady-state electrical efficiency of the motor and drive. To plot the efficiency map, either:

• Double-click the block in your block diagram and, in the Description tab, click Plot efficiency map.

• Right-click the block in your block diagram and, in the Electrical context menu, select Plot efficiency map.

This efficiency map does not include the losses generated by the External supply series resistance and Rotor damping parameters.

Model Thermal Effects

You can expose the thermal port to model the effects of losses that convert power to heat. To expose the thermal port, set the Modeling option parameter to either:

• No thermal port — The block does not contain a thermal port.

• Show thermal port — The block contains one thermal conserving port.

For more information about using thermal ports in actuator blocks, see Simulating Thermal Effects in Rotational and Translational Actuators.

Model Faults

To model a fault in the Motor & Drive (System Level) block, in the Faults section, click the Add fault hyperlink next to the fault that you want to model. In the Add Fault window, specify the fault properties. For more information about fault modeling, see Fault Behavior Modeling and Fault Triggering.

The Motor & Drive (System Level) block allows you to model an open-circuit fault. When the fault is triggered, the servomotor stops operating, zero current is taken from the supply side, and zero current is supplied to the load side.

Variables

To set the priority and initial target values for the block variables before simulation, use the Initial Targets section in the block dialog box or Property Inspector. For more information, see Set Priority and Initial Target for Block Variables.

Nominal values provide a way to specify the expected magnitude of a variable in a model. Using system scaling based on nominal values increases the simulation robustness. You can specify nominal values using different sources, including the Nominal Values section in the block dialog box or Property Inspector. For more information, see System Scaling by Nominal Values.

Examples

Brushless DC Motor

How a system-level model of a brushless DC motor (i.e. a servomotor) can be constructed and parameterized based on datasheet information. The motor and driver are modeled as a single masked subsystem. If viewing the model in Simulink®, select the Motor and driver block, and type Ctrl+U to look under the mask and see the model structure.

• Open Model

Motor Torque-Speed Curves

A comparison of the torque-speed characteristics for five different motor types. To select the motor type, right-click on the Electric Motor block and select Block Parameters (Subsystem) from the context menu. In the new window, specify the desired motor using the Label mode active choice parameter. All motors have been sized for roughly the same mechanical power rating.

• Open Model

Import Efficiency Map Data from Motor-CAD

Import efficiency map data from Motor-CAD to parameterize the Simscape™ Electrical™ Motor & Drive (System Level) block. This provides fast system-level simulation capability of a motor drive whilst still making accurate predictions about losses.

• Open Model

Mars Helicopter System-Level Design

Use Simscape™ Electrical™ to model a helicopter with coaxial rotors suitable to fly on Mars. This helicopter takes inspiration from Ingenuity, the robotic helicopter developed by NASA, which accomplished the first powered flight on another planet.

• Open Model

System-Level AC Drive

Model a system-level AC drive for an electric machine by using the AC-DC Converter (Three-Phase) block and Motor & Drive (System Level) block. The AC-DC converter represents a grid-side converter which provides a constant DC-link voltage. The Motor & Drive block acts as a generic AC electric machine with its DC-AC converter. This modeling approach provides fast system-level simulation without the switching events of the power converters.

• Open Model

Model a Motor Drive with Multiple Intermittent Torque Limits

Model a motor drive with multiple intermittent over-torque limits by using Simscape™ Electrical™.

• Since R2024a
• Open Model

Assumptions and Limitations

• The motor driver tracks a torque demand with a time constant Tc.

• Motor speed fluctuations due to mechanical load do not affect the motor torque tracking.

• The electrical connections must always be connected to a supply, such as a DC voltage source or a battery, that provides a positive voltage and is capable of delivering or absorbing the required power. To simulate turning the supply source on and off, see Model Faults.

Ports

Input

Tr — Reference torque demand

physical

Physical input port associated with the reference torque demand.

SW — Supply switch

physical

Physical input port associated with the supply switch.

Dependencies

To enable this port, in the Electrical Torque section, select the Enable supply switch parameter.

Output

W — Mechanical speed output

physical

Physical output port associated with the mechanical speed.

Conserving

+ — Positive electrical DC supply

electrical

Electrical conserving port associated with the positive electrical DC supply.

- — Negative electrical DC supply

electrical

Electrical conserving port associated with the negative electrical DC supply.

C — Motor case

mechanical

Mechanical rotational conserving port associated with the motor case.

R — Motor rotor

mechanical

Mechanical rotational conserving port associated with the motor rotor.

H — Thermal port

thermal

Thermal port.

Dependencies

To enable this port, set the Modeling option parameter to Show thermal port.

Parameters

Modeling option — Whether to enable thermal port

No thermal port (default) | Show thermal port

Whether to enable the thermal port of the block and model the effects of losses that convert power to heat.

Electrical Torque

Parameterize by — Torque Parameterization Method

Tabulate torque envelope with speed (default) | Maximum torque and power | Tabulate torque envelope with speed and supply voltage

Method to use to parameterize the torque:

• Tabulate torque envelope with speed — Provide the vectors of rotational speeds and corresponding maximum torque values.

• Maximum torque and power — Define the torque-speed envelope by providing values for maximum permissible torque and motor power.

• Tabulate torque envelope with speed and supply voltage — Provide the vectors of rotational speeds, the vectors of DC supply voltages, and the corresponding maximum torque values.

Allow intermittent over-torque — Intermittent over-torque option

No (default) | Yes

Whether to allow intermittent over-torque. For more information on over-torquing, see Intermittent Over-Torque Operation.

Continuous operation maximum torque envelope, T_c(w) — Vector of maximum torque values for continuous operation

[.09, .08, .07, 0] N*m (default)

Maximum torque values for permissible steady-state operation. These values correspond to the speeds in the Corresponding rotational speeds, w parameter and define the torque-speed envelope for the motor.

You can specify this parameter as either a row or column vector (since R2023a).

Dependencies

To enable this parameter, set the Parameterize by parameter to Tabulate torque envelope with speed.

Continuous operation maximum torque envelope, T_c(w, Vdc) — Vector of maximum torque values for continuous operation tabulated with speeds and voltages

[.09, .09, .09; .08, .08, .08; .07, .07, .07; 0, 0, 0] N*m (default) | 2-D vector of positive values

Maximum torque values for permissible steady-state operation. These values correspond to the speeds in the Corresponding rotational speeds, w parameter and to the voltages in the Corresponding DC supply voltage, Vdc parameter. This parameter defines the envelope with speed and supply voltage for the motor.

Dependencies

To enable this parameter, set the Parameterize by parameter to Tabulate torque envelope with speed and supply voltage.

Intermittent operation maximum torque envelope, T_i(w) — Vector of maximum torque values for intermittent operation

[.36, .32, .28, 0] N*m (default)

Maximum torque values during intermittent over-torquing operation.

You can specify this parameter as either a row or column vector (since R2023a).

Dependencies

To enable this parameter, set the Parameterize by parameter to Tabulate torque envelope with speed and the Allow intermittent over-torque parameter to Yes.

Intermittent operation maximum torque envelope, T_i(w,Vdc) — Vector of maximum torque values for intermittent operation tabulated with speeds and voltages

[.36, .36, .36; .32, .32, .32; .28, .28, .28; 0, 0, 0] N*m (default) | 2-D vector of positive values

Maximum torque values during intermittent over-torquing operation tabulated with speeds and voltages. The values of this parameter must be greater than the values of the Continuous operation maximum torque envelope, T_c(w, Vdc) parameter.

Dependencies

To enable this parameter, set the Parameterize by parameter to Tabulate torque envelope with speed and supply voltage and the Allow intermittent over-torque parameter to Yes.

Corresponding rotational speeds, w — Vector of rotational speeds

[0, 3750, 7500, 8000] rpm (default)

Rotational speeds for permissible steady-state operation. To avoid poor performance due to an infinite slope in the torque-speed curve, specify a vector of rotational speeds that does not contain duplicate consecutive values.

You can specify this parameter as either a row or column vector (since R2023a).

Dependencies

To enable this parameter, set the Parameterize by parameter to Tabulate torque envelope with speed.

Corresponding DC supply voltage, Vdc — Vector of DC supply voltages

[6, 12, 24] V (default) | vector of positive scalars

DC supply voltages for permissible steady-state operation. The values of this parameter must be strictly ascending.

You can specify this parameter as either a row or column vector (since R2023a).

Dependencies

To enable this parameter, set the Parameterize by parameter to Tabulate torque envelope with speed and supply voltage.

Continuous operation maximum torque — Maximum torque for continuous operation

0.1 N*m (default) | positive scalar

Maximum permissible motor torque during continuous operation.

Dependencies

To enable this parameter, set the Parameterize by parameter to Maximum torque and power.

Continuous operation maximum power — Maximum power for continuous operation

30 W (default) | positive scalar

Maximum permissible motor power during continuous operation.

Dependencies

To enable this parameter, set the Parameterize by parameter to Maximum torque and power.

Intermittent operation maximum torque — Maximum torque for intermittent operation

0.4 N*m (default) | positive scalar

Maximum permissible motor torque during intermittent over-torquing operation.

Dependencies

To enable this parameter, set the Parameterize by parameter to Maximum torque and power and the Allow intermittent over-torque parameter to Yes.

Intermittent operation maximum power — Maximum power for intermittent operation

120 W (default) | positive scalar

Maximum permissible motor power during intermittent over-torquing operation.

Dependencies

To enable this parameter, set the Parameterize by parameter to Maximum torque and power and the Allow intermittent over-torque parameter to Yes.

Over-torque time limit — Over-torque time limit

30 s (default) | positive scalar

Maximum amount of time for which you can continuously apply over-torquing.

Dependencies

To enable this parameter, set the Allow intermittent over-torque parameter to Yes.

Recovery time — Recovery time

60 s (default) | positive scalar

Amount of time for which the torque demand has to be less than the continuous operation torque envelope for the block to be able to apply over-torquing again.

Dependencies

To enable this parameter, set the Allow intermittent over-torque parameter to Yes.

Torque control time constant, Tc — Torque control time constant

0.02 s (default) | nonnegative scalar

Time constant with which the motor driver tracks a torque demand.

Enable supply switch — Option to enable supply switching

off (default) | on

Option to enable the switching on and the switching off of the motor.

Electrical Losses

Parameterize losses by — Electrical loss parameterization

Single efficiency measurement (default) | Tabulated loss data as a function of speed and torque | Tabulated efficiency data as a function of speed and torque | Tabulated loss data as a function of speed, torque, and DC supply voltage | Tabulated efficiency data as a function of speed, torque, and DC supply voltage

Electrical loss parameterization method:

• Single efficiency measurement — Model the losses as the sum of a constant term plus two additional terms that are proportional to the square of the torque and the square of the speed, respectively.

• Tabulated loss data as a function of speed and torque — Determine the losses by using a two-dimensional table lookup based on the provided tabulated data for motor speeds, load torques, and corresponding losses.

• Tabulated efficiency data as a function of speed and torque — Determine the losses by using a two-dimensional table lookup based on the provided tabulated data for motor speeds, load torques, and corresponding efficiencies.

• Tabulated loss data as a function of speed, torque, and DC supply voltage — Determine the losses by using a three-dimensional table lookup based on the provided tabulated data for motor speeds, load torques, DC supply voltages, and corresponding losses.

• Tabulated efficiency data as a function of speed, torque, and DC supply voltage — Determine the losses by using a three-dimensional table lookup based on the provided tabulated data for motor speeds, load torques, DC supply voltages, and corresponding efficiencies.

See Model Electrical Losses for details.

Motor and driver overall efficiency (percent) — Motor and driver overall efficiency

100 (default)

Overall efficiency of the motor and driver. The block defines overall efficiency as

$$\eta =100\frac{{\tau }_0{\omega }_0}{{\tau }_0{\omega }_0+P_0+k{\tau }_0^2+k_w{\omega }_0^2}$$

where:

• τ₀ is the Torque at which efficiency is measured parameter.

• ω₀ is the Speed at which efficiency is measured parameter.

• P₀ is the Fixed losses independent of torque or speed parameter.

• $$k{\tau }_0^2$$ is the torque-dependent electrical losses.

• k_wω² is the speed-dependent iron losses.

At initialization, the block solves the efficiency equation for k. The block neglects losses associated with the rotor damping.

Dependencies

To enable this parameter, set the Parameterize losses by parameter to Single efficiency measurement.

Speed at which efficiency is measured — Speed at which efficiency is measured

3750 rpm (default)

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

Dependencies

To enable this parameter, set the Parameterize losses by parameter to Single efficiency measurement.

Torque at which efficiency is measured — Torque at which efficiency is measured

0.08 N*m (default)

Torque that the block uses to calculate torque-dependent electrical losses.

Dependencies

To enable this parameter, set the Parameterize losses by parameter to Single efficiency measurement.

Iron losses at measurement speed — Iron losses at measurement speed

0 W (default)

Iron losses at the speed and torque at which you measure the efficiency.

Dependencies

To enable this parameter, set the Parameterize losses by parameter to Single efficiency measurement.

Fixed losses independent of torque and speed — Fixed losses independent of torque and speed

0 W (default)

Fixed electrical loss associated with the driver when the motor current and torque are zero.

Dependencies

To enable this parameter, set the Parameterize losses by parameter to Single efficiency measurement.

Vector of speeds (w) for tabulated losses — Vector of speeds for tabulated losses

[-8000, -4000, 0, 4000, 8000] rpm (default)

Vector of speed values to use for table lookup when calculating losses.

You can specify this parameter as either a row or column vector (since R2023a).

Dependencies

To enable this parameter, set the Parameterize losses by parameter to one of these settings:

• Tabulated loss data as a function of speed and torque

• Tabulated loss data as a function of speed, torque, and DC supply voltage

• Tabulated efficiency data as a function of speed and torque

• Tabulated efficiency data as a function of speed, torque, and DC supply voltage

Vector of torques (T) for tabulated losses — Vector of torques for tabulated losses

[0, .03, .06, .09] Nm (default)

Vector of torque values to use for table lookup when calculating losses.

You can specify this parameter as either a row or column vector (since R2023a).

Dependencies

To enable this parameter, set the Parameterize losses by parameter to one of these settings:

• Tabulated loss data as a function of speed and torque

• Tabulated loss data as a function of speed, torque, and DC supply voltage

• Tabulated efficiency data as a function of speed and torque

• Tabulated efficiency data as a function of speed, torque, and DC supply voltage

Vector of DC supply voltages (v) for tabulated losses — Vector of DC supply voltages for tabulated losses

[100, 250, 400] V (default)

Vector of DC supply voltages to use for table lookup when calculating losses.

You can specify this parameter as either a row or column vector (since R2023a).

Dependencies

To enable this parameter, set the Parameterize losses by parameter to Tabulated loss data as a function of speed, torque, and DC supply voltage or Tabulated efficiency data as a function of speed, torque, and DC supply voltage.

Corresponding losses, P(w,T) — Electrical losses corresponding to speed and torque

[1.49, 1.67, 2.21, 3.1; .42, .69, 1.14, 2.03; .06, .24, .78, 1.68; .42, .69, 1.14, 2.03; 1.49, 1.67, 2.21, 3.1] W (default)

Tabulated values for electrical losses as a function of speed and torque to use for 2-D table lookup. Each value in the matrix specifies the losses for a specific combination of speed and torque. The matrix size must match the dimensions defined in the Vector of speeds (w) for tabulated losses and Vector of torques (T) for tabulated losses parameters.

Dependencies

To enable this parameter, set the Parameterize losses by parameter to Tabulated loss data as a function of speed and torque.

Corresponding efficiency (percent), E(w,T) — Efficiency corresponding to speed and torque

[95, 95, 95, 95; 95, 95, 95, 95; 95, 95, 95, 95; 95, 95, 95, 95; 95, 95, 95, 95] (default)

Tabulated efficiency values, in percentages, as a function of speed and torque to use for 2-D table lookup.

This parameter models the conversion efficiency between the electrical energy and the mechanical energy when the temperature at the thermal port H is equal to the value of the Measurement temperature parameter in the Temperature Dependence section. If the temperature at the thermal port H is equal to a value between the Measurement temperature and Second measurement temperature, this block linearly interpolates the efficiency between the values ​​of each table.

Each value in the matrix specifies the efficiency for a specific combination of speed and torque. The matrix size must match the dimensions defined in the Vector of speeds (w) for tabulated losses and Vector of torques (T) for tabulated losses parameters. The block ignores the efficiency values you provide for zero speed or zero torque and assumes the losses are zero when either the torque or speed is zero. The block uses linear interpolation to determine losses. Provide tabulated data for low speeds and low torques as required to get the desired level of accuracy for lower power conditions.

Dependencies

To enable this parameter, set the Parameterize losses by parameter to Tabulated efficiency data as a function of speed and torque.

Corresponding losses, P(w,T,v) — Electrical losses corresponding to speed, torque and supply voltage

ones(5, 4, 3) W (default)

Tabulated values for electrical losses as a function of speed, torque, and DC supply voltage, to use for 3-D table lookup. Each value in the matrix specifies the losses for a specific combination of speed, torque, and DC supply voltage. The matrix size must match the dimensions defined by the Vector of speeds (w) for tabulated losses, Vector of torques (T) for tabulated losses, and Vector of DC supply voltages (v) for tabulated losses parameters.

Dependencies

To enable this parameter, set the Parameterize losses by parameter to Tabulated loss data as a function of speed, torque, and DC supply voltage.

Corresponding efficiency (percent), E(w,T,v) — Efficiency corresponding to speed, torque and supply voltage

95 * ones(5, 4, 3) (default)

Tabulated efficiency values, in percentages, as a function of speed, torque, and DC supply voltage, to use for 3-D table lookup. Each value in the matrix specifies the efficiency for a specific combination of speed, torque, and DC supply voltage. The matrix size must match the dimensions defined by the Vector of speeds (w) for tabulated losses, Vector of torques (T) for tabulated losses, and Vector of DC supply voltages (v) for tabulated losses parameters. The block ignores the efficiency values you provide for zero speed or zero torque and assumes the losses are zero when either torque or speed is zero. The block uses linear interpolation to determine losses. Provide tabulated data for low speeds and low torques as required to get the desired level of accuracy for lower power conditions.

Dependencies

To enable this parameter, set the Parameterize losses by parameter to Tabulated efficiency data as a function of speed, torque, and DC supply voltage.

External supply series resistance — External supply series resistance

0 Ohm (default) | nonnegative scalar

Equivalent resistance used in series with the DC supply to model electrical losses proportional to the driver supply current. The block assumes that the DC supply current is approximately constant under constant load conditions.

Mechanical

Rotor inertia — Rotor inertia

5e-6 kg*m^2 (default) | nonnegative scalar

Rotor resistance to change in motor motion. The value can be zero.

Rotor damping — Rotor damping

1e-5 N*m*s/rad (default) | nonnegative scalar

Rotor damping. The value can be zero.

Initial rotor speed — Initial rotor speed

0 rpm (default)

Rotor speed at the start of the simulation.

Faults

Open circuit fault — Option to add open circuit fault

Add fault (default)

Option to add an open circuit fault.

To add a fault, click the Add fault hyperlink.

Trigger fault at time — Time before entering faulted state

0 s (default) | nonnegative scalar

Simulation time at which the block enters the faulted state.

Dependencies

To enable this parameter, in the Fault Inspector window, set Trigger Type to Timed.

This parameter appears in the Trigger section of the Fault Inspector window. For more information, see Set Fault Triggers.

Temperature Dependence

To enable these parameters, set the Modeling option parameter to Show thermal port.

Resistance temperature coefficient — Resistance temperature coefficient

3.93e-3 1/K (default)

Parameter α in the equation defining resistance as a function of temperature, as described in Thermal Model for Actuator Blocks. The default value is for copper.

Dependencies

To enable this parameter, set the Parameterize losses by parameter in the Electrical Losses settings to Single efficiency measurement.

Measurement temperature — Measurement temperature

25 degC (default)

Temperature at which you define the motor parameters. If you parameterize electrical losses by tabulated loss data, then this value is the temperature at which you specify the Corresponding losses, P(w,T) parameter values in the Electrical Losses tab.

Second measurement temperature — Second measurement temperature

125 degC (default)

Temperature at which the values you specify in the Corresponding losses, P(w,T), at second measurement temperature parameter are given.

Dependencies

To enable this parameter, in the Electrical Losses section, set the Parameterize losses by parameter to either Tabulated loss data as a function of speed and torque, Tabulated efficiency data as a function of speed and torque, Tabulated loss data as a function of speed, torque, and DC supply voltage, or Tabulated efficiency data as a function of speed, torque, and DC supply voltage.

Corresponding losses, P(w,T), at second measurement temperature — Electrical losses corresponding to speed and torque at second measurement temperature

[1.49, 1.74, 2.49, 3.74; .42, .67, 1.42, 2.67; .06, .31, 1.06, 2.31; .42, .67, 1.42, 2.67; 1.49, 1.74, 2.49, 3.74] W (default)

Iron losses at the second measurement temperature that correspond to the speed and torque tabulated values on the Electrical Losses tab.

Dependencies

To enable this parameter, set the Parameterize losses by parameter in the Electrical Losses settings to Tabulated loss data as a function of speed and torque.

Corresponding efficiency (percent), E(w,T), at second measurement temperature — Efficiency corresponding to speed and torque at second measurement temperature

[95, 95, 95, 95; 95, 95, 95, 95; 95, 95, 95, 95; 95, 95, 95, 95; 95, 95, 95, 95] (default)

Tabulated efficiency values, in percentages, at the second measurement temperature, corresponding to the speed and torque tabulated values on the Electrical Losses tab.

This parameter models the conversion efficiency between the electrical energy and the mechanical energy when the temperature at the thermal port H is equal to the value of the Second measurement temperature parameter. If the temperature at the thermal port H is equal to a value between the Measurement temperature and Second measurement temperature, this block linearly interpolates the efficiency between the values ​​of each table.

Dependencies

To enable this parameter set the Parameterize losses by parameter in the Electrical Losses settings to Tabulated efficiency data as a function of speed and torque.

Corresponding losses, P(w,T,v), at second measurement temperature — Electrical losses corresponding to speed, torque and supply voltage at second measurement temperature

ones(5, 4, 3) W (default)

Iron losses at the second measurement temperature, corresponding to the speed, torque, and DC supply voltage tabulated values on the Electrical Losses tab.

Dependencies

To enable this parameter, set the Parameterize losses by parameter in the Electrical Losses settings to Tabulated loss data as a function of speed, torque, and DC supply voltage.

Corresponding efficiency (percent), E(w,T,v), at second measurement temperature — Efficiency corresponding to speed, torque and supply voltage at second measurement temperature

95 * ones(5, 4, 3) (default)

Tabulated efficiency values, in percentages, at the second measurement temperature, corresponding to the speed, torque, and DC supply voltage tabulated values on the Electrical Losses tab.

Dependencies

To enable this parameter, set the Parameterize losses by parameter in the Electrical Losses settings to Tabulated efficiency data as a function of speed, torque, and DC supply voltage.

Thermal Port

To enable these parameters, set the Modeling option parameter to Show thermal port.

Thermal mass — Thermal mass

100 J/K (default)

Thermal mass of the electrical winding, defined as the energy required to raise the temperature by one degree.

Initial Temperature — Initial temperature

25 degC (default)

Temperature of the thermal port at the start of simulation.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

Version History

Introduced in R2008a

R2024b: Capture power dissipated by rotor damping

If you set the Rotor damping parameter to a value greater than zero, the power_dissipated variable in the logged simulation data now includes the power dissipated by rotor damping. If you also set the Modeling option parameter to Show thermal port, the rotor damping generates heat.

R2023a: Specify vector parameters as either row or column vectors

You can now specify these parameters as either row or column vectors:

• Continuous operation maximum torque envelope, T_c(w)

• Intermittent operation maximum torque envelope, T_i(w)

• Corresponding rotational speeds, w

• Corresponding DC supply voltage, Vdc

• Vector of speeds (w) for tabulated losses

• Vector of torques (T) for tabulated losses

• Vector of DC supply voltages (v) for tabulated losses

In R2022b or earlier, you can only specify these parameters as row vectors. You can transpose input data stored as column vectors in the MATLAB^® workspace or in the Block Parameter fields in Simulink.

R2020b: Library path and name change

The Simplified PMSM Drive block has been renamed the Motor & Drive (System Level) block and moved from the Simscape > Electrical > Electromechanical > Permanent Magnet library to the Simscape > Electrical > Electromechanical > System-Level Modeling library.

If you have a script that depends on the library path or the Simscape component path of this block, update it to reflect these changes.