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

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.

  • PMSM Constant Ld/Lq

  • PMSM Variable Ld/Lq

  • BLDC Constant Ls

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:

  • Measurements - eHS circuit model measurements

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:

  • Default - The back EMF is sinusoidal.

  • User Defined - The shape of the back EMF waveform is defined by the Back EMF File [JSON].

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.

  • Aligned - Indicates that the d-axis is aligned with Phase A at t = 0. In this case, θoffset = 0°. This is illustrated in Figure 2.

  • 90 Degrees behind Phase A - Indicates that the q-axis is aligned with Phase A at t = 0. In this case, θoffset = -90°.

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:

  • Default - The back EMF is sinusoidal.

  • User Defined - The shape of the back EMF waveform is defined by the Back EMF File [JSON].

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.

  • Aligned - Indicates that the d-axis is aligned with Phase A at t = 0. In this case, θoffset = 0°. This is illustrated in Figure 2.

  • 90 Degrees behind Phase A - Indicates that the q-axis is aligned with Phase A at t = 0. In this case, θoffset = -90°.

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

(1)

 

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