Documentation Home Page ◇ Power Electronics Add-On for NI VeriStand Home Page
Pour la documentation en FRANÇAIS, utilisez l'outil de traduction de votre navigateur Chrome, Edge ou Safari. Voir un exemple.
PMSM SH Section
The PMSM SH model defines the Inductance Matrices Ld and Lq within a three-dimensional table stored in an RTT motor model file. Because the tables are three-dimensional rather than two-dimensional, the PMSM SH model can provide higher fidelity than the PMSM BLDC model. Please see Permanent Magnet Synchronous Machine Models Comparison for a comparison of the PMSM SH and PMSM BLDC models.
Page Content
Configuration Page
In the System Explorer window configuration tree, expand the Power Electronics Add-On custom device and select Circuit Model >> PMSM SH to display this page and configure the PMSM SH machine model.
This page includes the following components, configurable at edit-time only:
Machine Model Settings | ||||
Name | Specifies the name of the machine model. | |||
Description | Specifies a description for the machine model. | |||
Machine Configuration | ||||
| Symbol | Units | Default Value |
|
Model File |
|
|
| Specifies the path to the 3D Machine Model file on disk. Refer to JMAG-RT RTT File Generation Recommendations for details regarding the file format. The following standards are supported:
|
Enable |
|
| True | Indicates whether the selected machine model is enabled. When a machine is enabled, it computes and generates output data at the specified Applied Solver Timestep. It is recommended to disable unused machines, as the number of enabled machines impacts the minimum achievable timestep of the solver. |
Initial Angle | θ0 | deg | 0° | Initial Angle of the machine This may be useful when simulating two separate 3-phase machines that require a phase shift between them. |
Enable Advanced Channels |
|
|
| Allows certain parameters to be exposed as tunable VeriStand Channels. See the Advanced Channels section below for more details. This checkbox is only available when the machine is enabled. Otherwise, the option is greyed out. |
Applied Solver Timestep | Ts | s |
| The timestep at which the machine model executes. New outputs are computed by the FPGA machine model at each timestep. If Optimize Solver Timesteps is enabled in the Circuit Model page, the Applied Solver Timestep is automatically set to an optimal value and cannot be edited. If Optimize Solver Timesteps is disabled, this value must be set to a multiple of 50ns equal to or greater than the Minimum Solver Timestep (s) (400ns), and less than 2.5us. |
Minimum Solver Timestep | Tsm | s |
| The minimum achievable timestep at which the machine model can execute |
Table Max Current |
| A |
| Maximum current value that will be used to interpolate the model file. Use this feature to increase the resolution of the machine at lower Current operating points. This will reduce the machine operating range. Use -1 to use the full range available in model file. |
DQ Angle Offset | θoffset | deg | 0° | The electrical angle offset applied to the Reference Frame Transformation. Setting this parameter to 0° indicates that the d-axis is aligned with Phase A when the electrical angle θe = 0°. This is illustrated in Figure 2. Setting this parameter to -90° indicates that the q-axis is aligned with Phase A when the electrical angle θe = 0°. |
Input Mapping Configuration | ||||
Use the Input Mapping Configuration to route signals to the Voltage Phase A, Voltage Phase B, and Voltage Phase C inputs of the machine model. Available routing options may vary depending on the selected Hardware Configuration. | ||||
Group |
|
|
| Specifies the group that will be routed to the input voltages of the machine. The available routing options are defined by the selected Hardware Configuration, however it is typical to see the following options by default:
|
Element |
|
|
| Specifies the index of the measurement in the group that has been selected as the input voltage of the machine. |
Section Channels
This section includes the following custom device channels:
Channel Name | Symbol | Type | Units | Description | ||
---|---|---|---|---|---|---|
Current Phase A | Ia | Output | A | Phase A current measured at the stator | ||
Current Phase B | Ib | Output | A | Phase B current measured at the stator | ||
Current Phase C | Ic | Output | A | Phase C current measured at the stator | ||
Average Voltage Phase A | Va,avg | Output | V | Averaged Phase A voltage measured at the stator. The voltage is processed through a low-pass filter with a cutoff frequency of 159 Hz
| ||
Average Voltage Phase B | Vb,avg | Output | V | Averaged Phase B voltage measured at the stator. The voltage is processed through a low-pass filter with a cutoff frequency of 159 Hz | ||
Average Voltage Phase C | Vc,avg | Output | V | Averaged Phase C voltage measured at the stator. The voltage is processed through a low-pass filter with a cutoff frequency of 159 Hz | ||
Three-Phase Active Power | P | Output | W | Three-phase instantaneous active electrical power. See the Power section for more information on how this value is calculated. | ||
Three-Phase Reactive Power | Q | Output | VAR | Three-phase instantaneous reactive electrical power. See the Power section for more information on how this value is calculated. | ||
Direct Axis Stator Current | Id | Output | A | Direct-axis stator current in the dq reference frame aligned with the rotor For a description of the abc to dq transform used to compute this value, see Reference Frame Transformation. | ||
Quadrature Axis Stator Current | Iq | Output | A | Quadrature-axis stator current in the dq reference frame aligned with the rotor For a description of the abc to dq transform used to compute this value, see Reference Frame Transformation. | ||
Electrical Angle | θe | Output | deg | Position of the rotating magnetic field, as defined by the Electrical Angle Equation. If this signal is routed to a Waveform Channel or an Analog Output Channel, its value is expressed in Turns. The signal ranges in value from 0 to 1, with 1 representing a full rotation. | ||
Electromagnetic Torque | Te | Output | Nm | Torque generated through power at the stator. Refer to the Torque section for more information. |
Advanced Channels
The following VeriStand channels are displayed under the Advanced section when the Enable Advanced Channels option is enabled on the PMSM SH configuration page. The value of an input channel can be modified dynamically at execution time.
Channel Name | Symbol | Type | Units | Default Value | Description |
---|---|---|---|---|---|
Enable Resistance Override |
| Input |
| False | Enables the Resistance Phase A Override, Resistance Phase B Override, and Resistance Phase C Override channels, allowing the user to modify the phase resistances of the machine while the simulation is running. When True, the phase resistances of the machine are read from the Resistance Phase A Override, Resistance Phase B Override, and Resistance Phase C Override channels. When False, the phase resistances are read from the table in the 3D Motor Model File Enabling these channels allows the user to reduce the machine signal error in high impedance conditions. Refer to How to Reduce PMSM SH Signal Error In High Impedance Conditions for more information. |
Resistance Phase A Override | Ra | Input | Ω | 0.12 | Phase A resistance of the machine When Enable Resistance Override is True, this value overrides the Phase A resistance value defined in the 3D Motor Model File. When Enable Resistance Override is False, this channel is not used. This channel value can be modified while the simulation is running. |
Resistance Phase B Override | Rb | Input | Ω | 0.12 | Phase B resistance of the machine When Enable Resistance Override is True, this value overrides the Phase B resistance value defined in the 3D Motor Model File. When Enable Resistance Override is False, this channel is not used. This channel value can be modified while the simulation is running. |
Resistance Phase C Override | Rc | Input | Ω | 0.12 | Phase C resistance of the machine When Enable Resistance Override is True, this value overrides the Phase C resistance value defined in the 3D Motor Model File. When Enable Resistance Override is False, this channel is not used. This channel value can be modified while the simulation is running. |
Model Description
OPAL-RT TECHNOLOGIES, Inc. | 1751, rue Richardson, bureau 1060 | Montréal, Québec Canada H3K 1G6 | opal-rt.com | +1 514-935-2323
Follow OPAL-RT: LinkedIn | Facebook | YouTube | X/Twitter