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.
6-Phase PMSM BLDC Section
- Sylvain Ménard
- Pierre-Luc Renault (Unlicensed)
- Myriam Desranleau
The 6-Phase PMSM BLDC model implements two electromagnetically independent 3-Phase PMSM BLDC models that are mechanically coupled to maintain synchronization of the speed and position. This simplified model is sufficient for most applications. The 6-phase PMSM BLDC has two groups of three-phase stator windings, referred to in the product as ABC (group 1) and XYZ (group 2). The two sets of stator windings are offset from each other by 30°.
The 6-Phase PMSM BLDC model is configurable to represent one of three different 6-phase machine types: PMSM Constant Ld/Lq, PMSM Variable Ld/Lq, and BLDC Constant Ls. The PMSM Constant Ld/Lq and BLDC Constant Ls machine types simulate a machine with constant inductance and magnetic flux parameters. The PMSM Variable Ld/Lq machine type simulates a PMSM whose inductance and magnetic flux parameters are variable based on the operating state of the simulation (in this case, based on Id and Iq), which allows for greater model fidelity.
Page Content
Configuration Page
In the System Explorer window configuration tree, expand the Power Electronics Add-On custom device and select Circuit Model >> 6-Ph PMSM BLDC to display this page. Use this page to configure the 6-Phase PMSM BLDC machine model. Parameters are configurable at edit-time only.
General Parameters
The following parameters are available for any selected Machine Type.
Machine Model Settings | |
Name | Specifies the name of the machine model. |
Description | Specifies a description for the machine model. |
Machine Configuration | |
Machine Type | Choose from one of the following types. The motor configuration parameters automatically populate depending on the selected Machine Type.
|
Input Mapping Configuration | |
Use the Input Mapping Configuration to route signals to the Voltage Phase A, Voltage Phase B, Voltage Phase C, Voltage Phase X, Voltage Phase Y, and Voltage Phase Z 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. |
Machine-Specific Parameters
Certain parameters of the 6-Phase PMSM BLDC page are populated based on the selected Machine Type.
Machine Configuration | ||||
| Symbol | Units | Default Value | Description |
---|---|---|---|---|
Direct Axis Inductance 1 | Ld,1 | H | 0.002984 | Direct-axis inductance of the ABC stator windings of the machine |
Direct Axis Inductance 2 | Ld,2 | H | 0.002984 | Direct-axis inductance of the XYZ stator windings of the machine |
Quadrature Axis Inductance 1 | Lq,1 | H | 0.004576 | Quadrature-axis inductance of the ABC stator windings of the machine |
Quadrature Axis Inductance 2 | Lq,2 | H | 0.004576 | Quadrature-axis inductance of the XYZ stator windings of the machine |
Back EMF Profile |
|
| Default | Sets the waveform shape of the back EMF:
|
Preview |
|
|
| Displays a preview of the back EMF waveform shape defined in the Back EMF File. This button is displayed when Back EMF Profile is set to User Defined and the Back EMF File Path is specified. |
Back EMF File Path |
|
|
| Specifies the path to the Back EMF File on disk. This control is displayed when Back EMF Profile is set to User Defined. |
Initial Angle | θ0 | deg | 0 | Initial angle of the 6-phase machine. Note that the XYZ stator windings are offset from the ABC windings by a constant value of 30°. |
Phase A Resistance | Ra | Ω | 0.12 | Phase A Resistance of the machine |
Phase B Resistance | Rb | Ω | 0.12 | Phase B Resistance of the machine |
Phase C Resistance | Rc | Ω | 0.12 | Phase C Resistance of the machine |
Permanent Magnet Flux Linkage 1 | ψM,1 | Wb | 0.25366 | Peak permanent magnet flux linkage of phases ABC of the machine |
Permanent Magnet Flux Linkage 2 | ψM,2 | Wb | 0.25366 | Peak permanent magnet flux linkage of phases XYZ of the machine |
Pole Pairs | pp |
| 3 | Number of pole pairs of the 6-phase machine |
Phase X Resistance | Rx | Ω | 0.12 | Phase X Resistance of the machine |
Phase Y Resistance | Ry | Ω | 0.12 | Phase Y Resistance of the machine |
Phase Z Resistance | Rz | Ω | 0.12 | Phase Z Resistance of the machine |
Direct Quadrature Transform Angle Offset |
|
| Aligned | The angle offset applied to the Reference Frame Transformation of both 3-phase machine models making up the 6-phase machine.
|
Applied Solver Timestep | Ts | s | 1.2E-7 | 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. |
Minimum Solver Timestep | Tsm | s | 1.0E-7 | The minimum achievable timestep at which the machine model can execute |
Machine Configuration | ||||
| Symbol | Units | Default Value | Description |
---|---|---|---|---|
Model File |
|
|
| Specifies the path to the JSON Motor Model file on disk. Refer to PMSM BLDC Motor Model File [JSON] for details regarding the file format. The parameters in this file are applied to both 3-phase machine models making up the 6-phase machine. |
Enable Advanced Channels |
|
| False | Allows certain machine parameters to be exposed as tunable VeriStand Channels. See the PMSM Variable Ld/Lq Channels section below for more details. This checkbox is only available after a Model File has been specified. |
Back EMF Profile |
|
| Default | Sets the waveform shape of the back EMF:
|
Preview |
|
|
| Displays a preview of the back EMF waveform shape defined in the Back EMF File. This button is displayed when Back EMF Profile is set to User Defined and the Back EMF File Path is specified. |
Back EMF File Path |
|
|
| Specifies the path to the Back EMF File on disk. This control is displayed when Back EMF Profile is set to User Defined. |
Initial Angle | θ0 | deg | 0 | Initial Angle of the 6-phase machine. Note that the XYZ stator windings are offset from the ABC windings by a constant value of 30° |
Applied Solver Timestep | Ts | s | 1.2E-7 | 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. |
Minimum Solver Timestep | Tsm | s | 1.0E-7 | The minimum achievable timestep at which the machine model can execute |
Machine Configuration | ||||
| Symbol | Units | Default Value | Description |
---|---|---|---|---|
Stator 1 Inductance | Ls,1 | Henry | 0.002984 H | Stator inductance of the ABC windings |
Stator 2 Inductance | Ls,2 | Henry | 0.002984 H | Stator inductance of the XYZ windings |
Back EMF Profile |
|
| Default | Sets the waveform shape of the back EMF:
|
Preview |
|
|
| Displays a preview of the back EMF waveform shape defined in the Back EMF File. This button is displayed when Back EMF Profile is set to User Defined and the Back EMF File Path is specified. |
Back EMF File Path |
|
|
| Specifies the path to the Back EMF File on disk. This control is displayed when Back EMF Profile is set to User Defined. |
Back EMF Flat Area | H | Degrees | 0 | Describes the length of the flat area of the trapezoidal back-EMF waveform, in degrees. This control is displayed when Back EMF Profile is set to Default. Please see Trapezoidal Back-EMF Characteristics for a description of the waveform. |
Initial Angle (Deg) | θ0 | Degrees | 0° | Initial angle of the 6-phase machine. Note that the XYZ stator windings are offset from the ABC windings by a constant value of 30° |
Phase A Resistance | Ra | Ohm | 0.12 Ω | Phase A Resistance of the machine |
Phase B Resistance | Rb | Ohm | 0.12 Ω | Phase B Resistance of the machine |
Phase C Resistance | Rc | Ohm | 0.12 Ω | Phase C Resistance of the machine |
Permanent Magnet Flux Linkage 1 | ψM | Weber | 0.25366 Wb | Peak permanent magnet flux linkage of phases ABC of the machine |
Permanent Magnet Flux Linkage 2 | ψM | Weber | 0.25366 Wb | Peak permanent magnet flux linkage of phases XYZ of the machine |
Pole Pairs | pp |
| 3 | Number of pole pairs of the 6-phase machine |
Phase X Resistance | Rx | Ohm | 0.12 Ω | Phase X Resistance of the machine |
Phase Y Resistance | Ry | Ohm | 0.12 Ω | Phase Y Resistance of the machine |
Phase Z Resistance | Rz | Ohm | 0.12 Ω | Phase Z Resistance of the machine |
Direct Quadrature Transform Angle Offset |
|
| Aligned | The angle offset applied to the Reference Frame Transformation of both 3-phase machine models making up the 6-phase machine.
|
Applied Solver Timestep | Ts | Second | 1.2E-7 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. |
Minimum Solver Timestep | Tsm | Second | 1.0E-7 | The minimum achievable timestep at which the machine model can execute. |
Section Channels
The list of available channels in the 6-Phase PMSM BLDC section depends on the selected Machine Type. Channels listed under the General Channels header below are available for all machine types, while certain advanced channels are available for the PMSM Variable Ld/Lq only. Channel values can be modified dynamically at execution time.
Channel Name | Symbol | Type | Units | Description |
---|
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 | ||
Current Phase X | Ix | Output | A | Phase X current measured at the stator | ||
Current Phase Y | Iy | Output | A | Phase Y current measured at the stator | ||
Current Phase Z | Iz | Output | A | Phase Z 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 159Hz. | ||
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 159Hz | ||
Average Voltage Phase X | Vx,avg | Output | V | Averaged Phase X voltage measured at the stator. The voltage is processed through a low-pass filter with a cutoff frequency of 159Hz | ||
Average Voltage Phase Y | Vy,avg | Output | V | Averaged Phase Y voltage measured at the stator. The voltage is processed through a low-pass filter with a cutoff frequency of 159Hz | ||
Average Voltage Phase Z | Vz,avg | Output | V | Averaged Phase Z voltage measured at the stator. The voltage is processed through a low-pass filter with a cutoff frequency of 159Hz | ||
Three-Phase Active Power 1 | P1 | Output | W | Three-phase instantaneous active electrical power of the stator windings ABC. See the Power section for more information on how this is calculated. | ||
Three-Phase Reactive Power 1 | Q1 | Output | VAR | Three-phase instantaneous reactive electrical power of the stator windings ABC. See the Power section for more information on how this is calculated. | ||
Three-Phase Active Power 2 | P2 | Output | W | Three-phase instantaneous active electrical power of the stator windings XYZ. See the Power section for more information on how this is calculated. | ||
Three-Phase Reactive Power 2 | Q2 | Output | VAR | Three-phase instantaneous reactive electrical power in of the stator windings XYZ See the Power section for more information on how this is calculated. | ||
Direct Axis Stator 1 Current | Id,1 | Output | A | Direct-axis stator current of the ABC stator windings in the dq reference frame. For a description of the abc to dq transform used to compute this value, see Reference Frame Transformation. | ||
Quadrature Axis Stator 1 Current | Iq,1 | Output | A | Quadrature-axis stator current of the ABC stator windings in the dq reference frame. For a description of the abc to dq transform used to compute this value, see Reference Frame Transformation. | ||
Direct Axis Stator 2 Current | Id,2 | Output | A | Direct-axis stator current of the XYZ stator windings in the dq reference frame. For a description of the abc to dq transform used to compute this value, see Reference Frame Transformation. | ||
Quadrature Axis Stator 2 Current | Iq,2 | Output | A | Quadrature-axis stator current of the XYZ stator windings in the dq reference frame. For a description of the abc to dq transform used to compute this value, see Reference Frame Transformation. | ||
Back-EMF Phase A | Vbemf,a | Output | V | The electromotive force induced by the machine rotation, measured from Phase A to neutral | ||
Back-EMF Phase B | Vbemf,b | Output | V | The electromotive force induced by the machine rotation, measured from Phase B to neutral | ||
Back-EMF Phase C | Vbemf,c | Output | V | The electromotive force induced by the machine rotation, measured from Phase C to neutral | ||
Back-EMF Phase X | Vbemf,x | Output | V | The electromotive force induced by the machine rotation, measured from Phase X to neutral | ||
Back-EMF Phase Y | Vbemf,y | Output | V | The electromotive force induced by the machine rotation, measured from Phase Y to neutral | ||
Back-EMF Phase Z | Vbemf,z | Output | V | The electromotive force induced by the machine rotation, measured from Phase Z to neutral | ||
Permanent Magnet Flux Linkage 1 | ψM,1 | Output | Wb | Latest-value measurement of the ABC Permanent Magnet Flux Linkage used at the input of the electrical model. For the PMSM Constant Ld/Lq and BLDC Constant Ls machine types, this channel returns the constant value defined by the user in the Machine Configuration section. For the PMSM Variable Ld/Lq machine type, this channel returns the value obtained from the Fm table in the Machine Model File. | ||
Permanent Magnet Flux Linkage 2 | ψM,2 | Output | Wb | Latest-value measurement of the XYZ Permanent Magnet Flux Linkage used at the input of the electrical model. For the PMSM Constant Ld/Lq and BLDC Constant Ls machine types, this channel returns the constant value defined by the user in the Machine Configuration section. For the PMSM Variable Ld/Lq machine type, this channel returns the value obtained from the Fm table in the Machine Model File. | ||
Direct Axis Inductance 1 | Ld,1 | Output | H | Latest-value measurement of the ABC stator winding Direct Axis Inductance used at the input of the electrical model. For the PMSM Constant Ld/Lq and BLDC Constant Ls machine types, this channel returns the constant value defined by the user in the Machine Configuration section. For the PMSM Variable Ld/Lq machine type, this channel returns the value obtained from the Ld table in the Machine Model File. | ||
Quadrature Axis Inductance 1 | Lq,2 | Output | H | Latest-value measurement of the ABC stator winding Quadrature Axis Inductance used at the input of the electrical model. For the PMSM Constant Ld/Lq and BLDC Constant Ls machine types, this channel returns the constant value defined by the user in the Machine Configuration section. For the PMSM Variable Ld/Lq machine type, this channel returns the value obtained from the Lq table in the Machine Model File. | ||
Direct Axis Inductance 2 | Ld,2 | Output | H | Latest-value measurement of the XYZ stator winding Direct Axis Inductance used at the input of the electrical model. For the PMSM Constant Ld/Lq and BLDC Constant Ls machine types, this channel returns the constant value defined by the user in the Machine Configuration section. For the PMSM Variable Ld/Lq machine type, this channel returns the value obtained from the Ld table in the Machine Model File. | ||
Quadrature Axis Inductance 2 | Lq,2 | Output | H | Latest-value measurement of the ABC stator winding Quadrature Axis Inductance used at the input of the electrical model. For the PMSM Constant Ld/Lq and BLDC Constant Ls machine types, this channel returns the constant value defined by the user in the Machine Configuration section. For the PMSM Variable Ld/Lq machine type, this channel returns the value obtained from the Lq table in the Machine Model File. | ||
Direct Axis Stator 1 Voltage | Vd,1 | Output | V | Direct-axis stator voltage of the ABC stator windings in the dq reference frame. For a description of the abc to dq transform used to compute this value, see Reference Frame Transformation. | ||
Quadrature Axis Stator 1 Voltage | Vq,1 | Output | V | Quadrature-axis stator voltage of the ABC stator windings in the dq reference frame. For a description of the abc to dq transform used to compute this value, see Reference Frame Transformation. | ||
Direct Axis Stator 2 Voltage | Vd,2 | Output | V | Direct-axis stator voltage of the XYZ stator windings in the dq reference frame. For a description of the abc to dq transform used to compute this value, see Reference Frame Transformation. | ||
Quadrature Axis Stator 2 Voltage | Vq,2 | Output | Volts | Quadrature-axis stator voltage of the XYZ stator windings in the dq reference frame. For a description of the abc to dq transform used to compute this value, see Reference Frame Transformation. | ||
Electromagnetic Torque | Te | Output | Nm | Torque generated through power at the stator. Refer to the Torque section for more information. | ||
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. |
The following VeriStand channels are displayed under the Advanced section when the Enable Advanced Channels option is enabled on the PMSM Variable Ld/Lq configuration page.
Channel Name | Symbol | Type | Units | Default Value | Description |
---|
Channel Name | Symbol | Type | Units | Default Value | Description |
---|---|---|---|---|---|
Resistance Phase A Override | Ra | Input | Ω | Read from JSON Model File when Advanced Channels are enabled | Phase A resistance of the machine When Enable Resistance Override is True, this value overrides the Phase A resistance value defined in the Machine Model File [JSON]. 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 | Ω | Read from JSON Model File when Advanced Channels are enabled | Phase B resistance of the machine When Enable Resistance Override is True, this value overrides the Phase B resistance value defined in the Machine Model File [JSON]. 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 | Ω | Read from JSON Model File when Advanced Channels are enabled | Phase C resistance of the machine When Enable Resistance Override is True, this value overrides the Phase C resistance value defined in the Machine Model File [JSON]. When Enable Resistance Override is False, this channel is not used. This channel value can be modified while the simulation is running. |
Resistance Phase X Override | Rx | Input | Ω | Read from JSON Model File when Advanced Channels are enabled | Phase X resistance of the machine When Enable Resistance Override is True, this value overrides the Phase X resistance value defined in the Machine Model File [JSON]. When Enable Resistance Override is False, this channel is not used. This channel value can be modified while the simulation is running. |
Resistance Phase Y Override | Ry | Input | Ω | Read from JSON Model File when Advanced Channels are enabled | Phase Y resistance of the machine When Enable Resistance Override is True, this value overrides the Phase Y resistance value defined in the Machine Model File [JSON]. When Enable Resistance Override is False, this channel is not used. This channel value can be modified while the simulation is running. |
Resistance Phase Z Override | Rz | Input | Ω | Read from JSON Model File when Advanced Channels are enabled | Phase Z resistance of the machine When Enable Resistance Override is True, this value overrides the Phase Z resistance value defined in the Machine Model File [JSON]. When Enable Resistance Override is False, this channel is not used. This channel value can be modified while the simulation is running. |
Enable Resistance Override |
| Input |
| False | Enables the Resistance Phase A Override, Resistance Phase B Override, Resistance Phase C Override, Resistance Phase X Override, Resistance Phase Y Override, and Resistance Phase Z 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, Resistance Phase C Override, Resistance Phase X Override, Resistance Phase Y Override, and Resistance Phase Z Override channels. When False, the phase resistances are read from the table in the Machine Model File [JSON]. |
Direct Axis Inductance 1 Override | Ld,1 | Input | H | 0.002984 | Direct-axis inductance of the ABC stator windings of the machine When Enable Inductance Override is True, this value overrides the direct axis inductance value defined in the Machine Model File [JSON] table. When Enable Inductance Override is False, this channel is not used. This value can be modified while the simulation is running. |
Quadrature Axis Inductance 1 Override | Lq,1 | Input | H | 0.004576 | Quadrature-axis inductance of the ABC stator windings of the machine When Enable Inductance Override is True, this value overrides the direct axis inductance value defined in the Machine Model File [JSON] table. When Enable Inductance Override is False, this channel is not used. This value can be modified while the simulation is running. |
Direct Axis Inductance 2 Override | Ld,2 | Input | H | 0.002984 | Direct-axis inductance of the XYZ stator windings of the machine When Enable Inductance Override is True, this value overrides the direct axis inductance value defined in the Machine Model File [JSON] table. When Enable Inductance Override is False, this channel is not used. This value can be modified while the simulation is running. |
Quadrature Axis Inductance 2 Override | Lq,2 | Input | H | 0.004576 | Quadrature-axis inductance of the XYZ stator windings of the machine When Enable Inductance Override is True, this value overrides the direct axis inductance value defined in the Machine Model File [JSON] table. When Enable Inductance Override is False, this channel is not used. This value can be modified while the simulation is running. |
Enable Inductance Override |
| Input |
| False | Enables the Direct Axis Inductance Override 1, Quadrature Axis Inductance Override 1, Direct Axis Inductance Override 2 and Quadrature Axis Inductance 2 Override channels, allowing the user to modify the inductances of the machine while the simulation is running. When True, the inductances of the machine are read from the Direct Axis Inductance Override 1, Quadrature Axis Inductance Override 1, Direct Axis Inductance Override 2 and Quadrature Axis Inductance 2 Override channels. When False, the direct axis and quadrature axis inductances are read from the table in the Machine Model File [JSON]. |
Permanent Magnet Flux Linkage 1 Override | ψM,1 | Input | Wb | 0.25366 | Permanent magnet flux linkage of the stator windings ABC of the machine When the Enable Permanent Magnet Flux Linkage Override channel is set to True, instead of reading the Flux Linkage from the 2D ψM lookup table defined in the Model File, the motor model will use the following scalar channel value as an input. When Enable Permanent Magnet Flux Linkage Override is True, this value overrides the flux linkage value defined in the Machine Model File [JSON] table. When Enable Permanent Magnet Flux Linkage Override is False, this channel is not used. This channel value can be modified while the simulation is running. |
Permanent Magnet Flux Linkage 2 Override | ψM,2 | Input | Wb | 0.25366 | Permanent magnet flux linkage of the stator windings XYZ of the machine When the Enable Permanent Magnet Flux Linkage Override channel is set to True, instead of reading the Flux Linkage from the 2D ψM lookup table defined in the Model File, the motor model will use the following scalar channel value as an input. When Enable Permanent Magnet Flux Linkage Override is True, this value overrides the flux linkage value defined in the Machine Model File [JSON] table. When Enable Permanent Magnet Flux Linkage Override is False, this channel is not used. This channel value can be modified while the simulation is running. |
Enable Permanent Magnet Flux Linkage Override |
| Input |
| False | Enables the Permanent Magnet Flux Linkage 1 Override and Permanent Magnet Flux Linkage 2 Override channel, allowing the user to modify the permanent magnet flux linkage of the machine while the simulation is running. When True, the flux linkages of the machine are read from the Permanent Magnet Flux Linkage 1 Override and Permanent Magnet Flux Linkage 2 Override channels. When False, the flux linkages are read from the table in the Machine Model File [JSON]. |
Model Description
Back-EMF Characteristics
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