# Page History

## Key

• This line was added.
• This line was removed.
• Formatting was changed.

### Mechanical Model Configuration Page

In the System Explorer window configuration tree, expand the Power Electronics Add-On custom device and select Circuit Model >> PMSM BLDC >> Mechanical Model to display this page.  Use this page to configure the PMSM BLDC Mechanical model.

Excerpt

This page includes the following components:

Configuration Symbol Units Default Mechanical Model Name Specifies the name of the model. Description Specifies a description for the model. Viscous Damping Fv Newton*meter*second per radian 0.00190986 Nm*s/rad Combined viscous damping of the rotor and load, proportional to the angular velocity of the machine. Static Friction Tf Newton-meter 0.3665 Nm Static friction resisting initial rotation when the machine is at rest. Inertia J Kilogram-meter^2 0.0167309 Kg*m^2 Moment of inertia of the rotor and load.

### Mechanical Model Section Channels

This section includes the following custom device channels:

Channel Name

Symbol

Type

Units

Default Value

Description

Mechanical Model Mode
Input

0

(Speed Controlled)

Set this channel to one of the following values:

• 0 - Sets the mechanical model to Speed Controlled mode.  The mechanical parameters are ignored in this case.
• 1 - Sets the mechanical model to Torque Controlled mode.

See the Mechanical Model Mode section for more information.

User-Defined SpeedωuserInputRPM0 RPMForces the speed of the machine to the defined value.  This parameter is used in Speed Controlled mode, and ignored in Torque Controlled mode.
Load TorqueTLInputNm0 NmTorque applied to the shaft of the machine. This parameter is used in Torque Controlled mode, and ignored in Speed Controlled mode.
Mechanical AngleθmOutputDegrees0°Mechanical rotor position.
Electrical AngleθeOutputDegrees-90°

Position of the rotating magnetic field, defined by the equation:

LaTeX Math Inline
body --uriencoded--θ_%7Be%7D = (pp \cdot θ_%7Bm%7D) - 90°

Mechanical SpeedωmOutputRPM0 RPMRotation speed of the machine rotor in RPM.
Electromagnetic TorqueTeOutputNm0 Nm

Torque generated through power at the stator. For equations describing the electromagnetic torque of each type of machine, refer to their specific description pages under the Machine Section.

Total TorqueTtotalOutputNm0 Nm

LaTeX Math Inline
body --uriencoded--T_%7Btotal%7D = T_%7Be%7D - T_%7BL%7D - T_%7Bf%7D

### Mechanical Model Description

Attached to the machine model's shaft is a basic mechanical model.  This model was chosen due to its common application, and the ability to extend its functionality. The behavior of the model varies depending upon whether the Mechanical Model Mode is set to Torque Controlled (1) or Speed Controlled (0).

#### Torque Controlled

When the Mechanical Model Mode is set to Torque Controlled (1), the equation of the mechanical model can be expressed as follows:

LaTeX Math Block
anchor mech_speed center
\frac{\partial ω_m}{\partial t} = \frac{1}{J} * (T_{total} - F_v ω_m)

where

LaTeX Math Block
anchor TTotal center
T_{total}=T_e-T_L-T_f

There is a dead-zone implementation with the static friction torque; if the Electromagnetic Torque (Te) does not exceed the Static Friction (Tf) torque, the speed remains at zero.

Note that in equation

LaTeX Math Block Reference
anchor mech_speed
, the value of the mechanical speed (ωm) is in radians per second, while the output of the Mechanical Speed channel will be in RPM.  The equation for the Electromagnetic Torque (Te) of each type of machine can be found on its specific description page under the Machine Section.

The following equation is used to calculate the machine power:

LaTeX Math Block
anchor Power center
P_{m} = T_{total} * ω_m

#### Speed Controlled

When the Mechanical Model Mode is set to Speed Controlled (0), the mechanical parameters (Viscous Damping, Static Friction, Inertia) are ignored.  Instead, the rotor speed is directly set using the User-Defined Speed parameter, ωuser.

### AnchorModeModeChoosing a Mechanical Model Mode

Select Speed Controlled mode if:

1. Your project requires you to manually set the speed of the machine
2. Your project has a mechanical model that requires you to input the speed of the machine in to the model

Select Torque Controlled mode if:

1. Your project requires you to manually set the load torque of the machine
2. Your project has a mechanical model that requires you to input the load toque of the machine in to the model