Engee documentation

Motor & Drive

Page in progress.

Universal motor and closed-loop torque control drive.

blockType: Engee1DMechanical.Electromechanical.MotorAndDrive

Path in the library:

/Physical Modeling/1D Mechanical/Engines & Motors/Motor & Drive

Description

Block Motor & Drive It is a universal brushless motor and a closed-loop torque control drive. Block Motor & Drive It is useful if you need a universal or approximate engine implementation in your system. It is also suitable for cases when you do not know all the technical characteristics of your engine or want to use the unit to find the right engine for your system.

To speed up the simulation, the block uses an abstraction of the motor, drive electronics, and control system. The unit generates an envelope of the dependence of the torque on the rotational speed, which saturates the input torque, and allows only a range of torques and speeds defined by this envelope.

Modeling of electrical losses

Block Motor & Drive simulates first-order losses based on the total efficiency for rotational speed and torque, which are set as parameters Motor and driver overall efficiency (percent), Speed at which efficiency is measured and Torque at which efficiency is measured accordingly. The block uses data on the rotational speed and torque to construct an envelope of the dependence of the torque on the rotational speed. The envelope saturates the input torque, which gives the torque that the motor responds to., . This torque is also used by the unit to calculate electrical losses.

The unit only takes into account torque-dependent resistive losses, so that

where

Resistive losses, also known as ohmic losses, occur due to the resistance of the armature windings to the flow of electrons. Electrical power includes these losses, so that

The rate of conversion of electrical energy into thermal energy is determined by the Joule—Lenz law:

where

  • — the electrical power that the unit calculates and uses in the main equation.

  • — electrical power lost during operation. When modeling the effect of heat flow and temperature changes, this value represents the rate of heat flow that is distributed in the heat mass or through the output port H.

  • — the angular velocity of rotation of the rotor. It is equivalent to the value of the output port W.

  • — required torque at saturation.

  • — the coefficient of proportionality for resistance losses, measured in units .

  • — The efficiency of the motor and drive at a given speed and torque. This value is equivalent to the parameter Motor and driver overall efficiency (percent).

  • — the angular velocity corresponding to the overall efficiency. This value is equivalent to the parameter Speed at which efficiency is measured.

  • — the torque corresponding to the overall efficiency. This value is equivalent to the parameter Torque at which efficiency is measured.

  • — terminal voltage.

  • — the current passing through the terminals.

When thermal modeling is enabled, the value displays the block’s contribution to the heat flow.

To account for sequential resistance, permanent losses, and core losses, you can add blocks to your model.

You can add damping and inertia using the block Rotational Damper and the block Inertia accordingly.

Thermal modeling

You can simulate the effects of heat flow and temperature changes by turning on an additional heat port H. To enable this port, check the box next to the option Enable thermal port.

When modeling the effects of heat flow and temperature changes, the electrical losses of the motor contribute to these effects.

Assumptions and limitations

  • The motor drive tracks the required torque with a time constant .

  • Fluctuations in engine speed caused by mechanical stress do not affect engine torque tracking.

Ports

Conserving

# + — positive DC power supply
electricity

Details

A power saving port connected to a positive DC source.

Program usage name

p

# R — engine rotor
rotational mechanics

Details

A mechanical rotation preservation port connected to the motor rotor.

Program usage name

rod_flange

# — negative DC power supply
electricity

Details

A power saving port connected to a negative DC source.

Program usage name

n

# C — engine housing
rotational mechanics

Details

Mechanical rotation preservation port connected to the motor housing.

Program usage name

case_flange

# H — heat flow
warmth

Details

The heat preservation port associated with the heat flow. The electrical losses of the engine contribute to the heat flow through this port.

Dependencies

To use this port, check the box next to the option Enable thermal port.

Program usage name

thermal_port

Input

# Tr — required reference torque
scalar

Details

Directional input port of the physical signal associated with the required reference torque.

Data types

Float64

Complex numbers support

No

Output

# W — mechanical rotation speed, rad/s
scalar

Details

A directional output port of a physical signal related to the mechanical rotation speed.

Data types

Float64

Complex numbers support

No

Parameters

Parameters

# Maximum torque — torque to determine the boundary of the envelope of the dependence of the torque on the rotational speed
N*m | mN*m | lbf*ft

Details

The maximum allowable torque value. The block uses this value and parameter Maximum power to determine the envelope dependence of the torque on the rotational speed.

Units

N*m | mN*m | lbf*ft

Default value

400.0 N*m

Program usage name

T_max

Evaluatable

Yes

# Maximum power — power for determining the boundary of the envelope of the dependence of the torque on the speed of rotation
W | GW | MW | kW | mW | uW | HP_DIN

Details

The maximum allowable power value. The block uses this value and parameter Maximum torque to determine the dependence of the torque on the rotational speed.

Units

W | GW | MW | kW | mW | uW | HP_DIN

Default value

200.0 kW

Program usage name

max_power

Evaluatable

Yes

# Torque control time constant, Tc — time step of the output torque
d | s | hr | ms | ns | us | min

Details

The time interval of the output signal of the torque regulator. Use this parameter to specify the waiting time for the unit between displaying information about the torque value.

Units

d | s | hr | ms | ns | us | min

Default value

0.02 s

Program usage name

tau

Evaluatable

Yes

# Motor and driver overall efficiency (percent) — energy efficiency at set values of rotation speed and torque

Details

The efficiency of converting electrical energy of rotation into mechanical energy.

Default value

100.0

Program usage name

efficiency

Evaluatable

Yes

# Speed at which efficiency is measured — preset speed for measuring efficiency
rpm | deg/s | rad/s

Details

The speed that the unit uses to calculate electrical losses that depend on the torque.

Units

rpm | deg/s | rad/s

Default value

3750.0 rpm

Program usage name

w_efficiency

Evaluatable

Yes

# Torque at which efficiency is measured — preset torque for measuring efficiency
N*m | mN*m | lbf*ft

Details

The torque that the unit uses to calculate electrical losses that depend on the torque.

Units

N*m | mN*m | lbf*ft

Default value

100.0 N*m

Program usage name

T_efficiency

Evaluatable

Yes

# Enable thermal port — modeling of thermal losses in the mass of electrical wiring

Details

The ability to turn on the heat port and take into account heat losses during modeling.

Default value

false (switched off)

Program usage name

has_thermal_port

Evaluatable

Yes

# Thermal mass — the ability of the wiring to retain heat
J/K | kJ/K

Details

The thermal mass of an electrical winding, defined as the energy required to raise the temperature per unit of temperature measurement.

Dependencies

To use this port, check the box next to the option Enable thermal port.

Units

J/K | kJ/K

Default value

100.0 J/K

Program usage name

thermal_mass

Evaluatable

Yes