JMAG
Permanent Magnetic Synchronous Motor — permanent magnet synchronous motor model using a JMAG-RT model
The Permanent Magnet Synchronous Motor JMAG-RT component uses external code, provided through an attached .rtt file, to model a permanent-magnet, three-phase, synchronous electric motor.
Use the following steps to attach and connect to an external rtt file:
Select the Attached Files tab.
Right-click on Documents, and then select Attach File....
In the Attach Document dialog, browse to the location of the .rtt motor file, select it, and then click Attach....
Select the JMAG-RT component in the Model Workspace.
Select the Properties tab, open the Parameters > General section, and then select the attached .rtt file from the rtt_filename list.
This component should be used with a fixed-step solver. To select a fixed-step solver, click the Settings tab, expand the Simulation section, and then select Fixed from the Solver Type list.
Variables
Connections
Parameters
Name
Units
Description
Modelica ID
v
V
3-phases of voltage
i
A
3-phases of current
φ
radian
Angular position of shaft
phi
τ
N·m
Torque on shaft
tau
plugp
Positive 3-phase plug
plug_p
plugn
Negative 3-phase plug
plug_n
flange
Rotational flange of shaft
support
(optional) Support/housing of component
tempCoilInput
(optional) Signal input to control coil temperature [K]
tempMagnetInput
(optional) Signal input to control magnet temperature [K]
copperloss
(optional) Signal output of copper loss [W]
eddyloss
(optional) Signal output of eddy current loss [W]
hystloss
(optional) Signal output of hysteresis loss [W]
General
Default
rtt filename
Name of rtt file
rtt_filename
τsense
0
s
Time-constant of current/voltage sense filter
tau_sense
set accuracy type
false
True means enable a drop-down that selects the accuracy type calculation
setAccuracy
accuracy
dLdq
Can be either dLdq or Spatial Harmonic
use support
True means add a 1-D rotational port to support the torque on the shell of the motor
useSupport
set initial angle
True means set the initial angular displacement of the shaft
setDisplacement0
initial angle
rad
Initial angular position of the shaft
displacement0
set resistance
True means set the winding resistance
setRes
Rwinding
Ω
Winding resistance; used only if set resistance is true
use copper loss
True means enable a signal output for copper loss
use_copper_loss
use iron loss
True means enable signal outputs for eddy current loss and hysteresis loss
use_iron_loss
Coil Temperature
set coil temperature
True means assign the coil temperature; activates the following four parameters
setCoilTemp
use coil temp. input
True enables the real input TempCoilInput
useTempCoilInput
fixed coil temp.
20
C
Fixed temperature of coil
TempCoilFixed
base coil temp.
Base temperature of coil
TempCoilBase
coil tc
3810
ppmC
Temperature coefficient of coil
TempCoeffCoil
Magnet Temperature
set magnet temperature
True means assign the magnet temperature; activates the following four parameters
setMagnetTemp
use magnet temp. input
True enables the real input TempMagnetInput
useTempMagnetInput
fixed magnet temp.
Fixed temperature of magnet
TempMagnetFixed
base magnet temp.
Base temperature of magnet
TempMagnetBase
magnet tc
−0.11
Temperature coefficient of magnet
TempCoeffMagnet
Corrections
The corrections section consists of boolean parameters that enable corresponding real constants. When enabled, the correction factor is used, otherwise the value defined in the rtt file is used, or if none is defined there, then 1 is used.
correct turn1
Enable correction to turn 1 windings
corr_turn1
correct turn2
Enable correction to turn 2 windings
corr_turn2
correct flux
Enable correction to the flux
corr_flux
correct inductance
Enable correction to the inductance
corr_induct
correct magnet
Enable correction to the magnet
corr_magnet
correct steel
Enable correction to the steel
corr_steel
correct torque
Enable correction to the torque
corr_torque
turn1 correction
1
Correction factor for turn 1 windings
turn1_corr
turn2 correction
Correction factor for turn 2 windings
turn2_corr
flux correction
Correction factor for flux
flux_corr
inductance correction
Correction factor for inductance
inductance_corr
magnet correction
Correction factor for magnet
magnet_corr
steel correction
Correction factor for steel
steel_corr
torque correction
Correction factor for torque
torque_corr
See Also
Getting Started with the MapleSim Connector for JMAG-RT
MapleSim Help System
MapleSim Library Overview
Download Help Document