Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

For a PMSM BLDCmachine configured to use the PMSM Variable Ld/Lq motor type, a JSON file is required to define the motor characteristics. The file must contain the following information:

Parameter (JSON key)

Value type

Unit

Description

Example

PolePairs

int


Number of pole pairs of the machine.

Code Block
languagejson
"PolePairs": 2

DqTransformAngleOffset

double

degree

Angle offset applied to the DQ Transform, before Id and Iq are referenced to look up Ld, Lq, and Fm. A value of 0 indicates that the D axis is aligned with Phase A when the rotor angle θ=0. In other words, the active power reaches a maximum when Id is at a maximum.  This is the default behavior.

For more information, see the DQ Transform description.

Code Block
languagejson
"DqTransformAngleOffset": 0

Ra

double

Ohm

Phase A Resistance of the machine

Code Block
"Ra": 0.04

Rb

double

Ohm

Phase B Resistance of the machine

Code Block
"Rb": 0.04

Rc

double

Ohm

Phase C Resistance of the machine

Code Block
"Rc": 0.04

Id_axis

double[]

A

One dimensional array of the current values along the Direct axis of the stator.

This array must be the same size as Iq_axis, it can contain up to 128 values, and its values they must be arranged in ascending order.

Code Block
"Id_axis": [
  -50.0,
  0.0,
  50.0
],

Iq_axis

double[]

A

One dimensional array of the current values along the Quadratic axis of the stator.

This array must be the same size as Id_axis, and its values it can contain up to 128 values, and they must be arranged in ascending order.

Code Block
"Iq_axis": [
  -50.0,
  0.0,
  50.0
],

Ld

double[][]

H

Two dimensional array of the Direct inductance values. 

The size of this array must be n x n, where n is equal to the number of current values in Id_axis and Iq_axis.

Figure 1 below describes how the inductance values are mapped from the JSON file array to the Ld table.

Code Block
languagejson
"Ld": [
  [
    0.0004,
    0.00042,
    0.00041
  ],
  [
    0.00041,
    0.00044,
    0.00043
  ],
  [
    0.0004,
    0.00042,
    0.000425
  ]
],

Lq

double[][]

H

Two dimensional array of the Quadratic inductance values. 

The size of this array must be n x n, where n is equal to the number of current values in Id_axis and Iq_axis.

Figure 1 below describes how the inductance values are mapped from the JSON file array to the Lq table.

Code Block
languagejson
"Lq": [
  [
    0.0004,
    0.00042,
    0.00041
  ],
  [
    0.00041,
    0.00044,
    0.00043
  ],
  [
    0.0004,
    0.00042,
    0.000425
  ]
],

Fm

double[][]

Wb

Two dimensional array of the Permanent Magnet Flux Linkage values. 

The size of this array must be n x n, where n is equal to the number of current values in Id_axis and Iq_axis.

Figure 1 below describes how the inductance values are mapped from the JSON file array to the Permanent Magnet Flux Linkage table.

Code Block
languagejson
"Fm": [
  [
    0.1,
    0.1,
    0.1
  ],
  [
    0.1,
    0.1,
    0.1
  ],
  [
    0.1,
    0.1,
    0.1
  ]
]

...