This example determines the initial rotor position (in electrical radians) of a stationary interior PMSM. The example uses the pulsating high-frequency (PHF) method, which works when the motor has a high saliency ratio . The estimated rotor position ranges from
0 to 2π electrical radians. Due to a limitation in the PHF method, the estimated position may show ambiguity of π (pi). The dual-pulse (DP) method uses polarity detection to resolve the ambiguity of π and applies π compensation if there is an error.
Part A: Pulsating High-Frequency Method
Motor control techniques like Field-Oriented Control (FOC) need real-time position feedback from the running motor to track the rotor angle accurately. An FOC algorithm uses the real-time rotor position along with the current feedback to compute the reference voltages and duty cycles that drive the motor. Therefore, it is essential to accurately track the rotor position to compute the right reference voltages to run the motor at a specific speed using an efficient torque value. Sensors like quadrature encoders and Hall effect sensors can provide real-time rotor position data to implement position tracking in FOC applications. However, these sensors might have mechanical constraints (for example, a complex sensor installation process) and can be expensive. In addition, when using some of these sensors, it is difficult to determine the initial position of the rotor.
Whereas, sensorless techniques are cost effective and can provide more accurate position tracking without any mechanical constraint. This example uses the PHF method to determine the initial rotor position. The example algorithm injects a sinusoidal high-frequency voltage along the
d-axis (resulting in unbalanced three-phase voltage in the motor) and reads the current response from the motor. The algorithm performs numerical analysis of the resulting stator current response to compute the initial position of the stationary rotor (in electrical radians).
The example algorithm performs iterative tests on the motor. Therefore, when you start simulation, the estimated position shows as zero but rises steadily to saturate at the estimated rotor-angle (with respect to
The PHF method has a limitation due to which it might compute rotor position with an ambiguity of π. If the rotor lies in the range electrical radians (region 1), the estimated position is accurate (π compensation is not required).
If the rotor lies in the range electrical radians (region 2), the estimated position shows an ambiguity of π (π compensation is required).
Therefore, the example uses the dual-pulse method to determine if the estimated position needs π compensation.
Note: You can use these variables in the model initialization script
mcb_ipmsm_pos_est_f28379d_data.m to customize the PHF signal:
PHF.Frequency — Frequency of PHF signal
PHF.Amplitude — Amplitude (in per-unit) of PHF signal
PHF.PHF_Duration — Execution time of the PHF algorithm
Part B: Dual-Pulse Method
The example algorithm injects two very short duration voltage pulses (with the same width and magnitude) into the
d-axis of the rotor with respect to the magnetic north of the rotor:
Pulse-1 that uses the rotor position estimated in Part A
Pulse-2 that uses the rotor position estimated in Part A + π
Because pulse width is very short, the motor does not run and the rotor remains stationary after pulse injection. The interaction between the resulting stator magnetic flux and the rotor permanent magnets result in two current impulses along the
d-axis of the rotor that rise and fall quickly.
Because the stator core is saturated, it shows a nonlinear behavior. A small results in higher current , and a high results in smaller current . Therefore the current impulses generated by Pulse-1 and Pulse-2 show different peak values.
The example algorithm computes the difference between the peak values of the two current impulses to determine if the position estimated in Part A needs π compensation.
This example does not support position estimation when is approximately equal to or (the boundary points between region 1 and region 2).
You can use these variables in the model initialization script
mcb_ipmsm_pos_est_f28379d_data.m to customize the DP signals:
DP.PulseAmp — Amplitude (in per-unit) of the pulses
DP.Duration_width — Width of the pulses
DP.Duration_delay — Delay between the two pulses
The example includes the target model mcb_ipmsm_pos_est_f28379d.
You can simulate this model or run it on the hardware. Use the open_system command to open the model.
Required MathWorks® Products
Motor Control Blockset™
Embedded Coder Support Package for Texas Instruments C2000™ Processors
Simscape™ Electrical™ (only for simulation)
1. Determine the motor parameters. The target model uses default parameters that you can replace with values from either the motor datasheet or other sources.
However, if you have motor control hardware, you can estimate the parameters for your motor by using the Motor Control Blockset parameter estimation tool. For instructions, see Estimate PMSM Parameters Using Recommended Hardware. The parameter estimation tool updates the
motorParam variable (in the MATLAB® workspace) with the estimated motor parameters.
2. Update the motor and inverter parameters in the model initialization script associated with the target model. For instructions, see Estimate Control Gains from Motor Parameters.
Follow the instructions in the Simulate Nonlinear Stator Core Behavior section to introduce high saliency in the motor block. Then follow these steps to simulate the target model.
1. Open the target model included in this example.
2. Enter the initial rotor position value (that the Interior PMSM block should use for simulation) in the Input electrical rotor position (radians) field available in the Simulation Input & Output area of the target model.
3. Click Run on the Simulation tab to simulate the target model. The model estimates the rotor position using the PHF method. Then it uses the DP method to determine if the estimated rotor position needs π compensation. The target model applies π compensation if needed.
It then displays the estimated rotor position in the Estimated electrical rotor position (radians) field.
4. Observe the logged signals in the Simulation Data Inspector.
This plot shows the current along the
d-axis during simulation.
This plot shows the estimated rotor position when the target model does not apply π compensation and when the target model applies π compensation .
5. The Estimated Rotor Position (Electrical Radians) display block in the Output area of the target model shows the initial rotor position estimated by the target model.
Follow the instructions in this section to generate code and run the example on the target hardware.
This example uses a host and a target model. The host model is a user interface to the controller hardware board. You can run the host model on the host computer. Before you can run the host model on the host computer, deploy the target model to the controller hardware board. The host model uses serial communication to command the target Simulink® model and run the motor in closed-loop control.
The example supports this hardware configuration. You can also use the target model name to open the model from the MATLAB® command prompt.
For connections related to this hardware configuration, see LAUNCHXL-F28069M and LAUNCHXL-F28379D Configurations.
Generate Code and Run Model on Target Hardware
1. Simulate the target model and observe the simulation results.
2. Complete the hardware connections.
3. By default, the model computes the ADC offset values for phase current measurement. To disable this functionality, update the value of the
inverter.ADCOffsetCalibEnable variable in the model initialization script to
Alternatively, you can compute the ADC offset values and update them manually in the model initialization script. For instructions, see Run 3-Phase AC Motors in Open-Loop Control and Calibrate ADC Offset.
4. Open the target model. If you want to change the default hardware configuration settings for the model, see Model Configuration Parameters.
5. Load a sample program to CPU2 of the LAUNCHXL-F28379D board. For example, load the program that operates the CPU2 blue LED by using GPIO31 (
c28379D_cpu2_blink.slx). This ensures that CPU2 is not mistakenly configured to use the board peripherals intended for CPU1.
6. Click Build, Deploy & Start on the Hardware tab to deploy the target model to the hardware. Verify the variables that the target model adds to the workspace.
7. Click the host model hyperlink in the target model to open the associated host model. You can also use the
open_system command to open the host model.
For details on serial communication between the host and target models, see Host-Target Communication.
8. In the dialog box of the Host Serial Setup block in the host model, select a port name in the Port name parameter.
9. Click Run on the Simulation tab to run the host model.
10 Change the position of the Estimate Position switch to Start to start running the example algorithm. The target model estimates the rotor position using PHF method. Then it uses the DP method to determine if the estimated rotor position needs π compensation. The target model applies π compensation if needed.
The host model obtains the estimated rotor position from the target hardware and displays it in the Estimated rotor electrical position (radians) field.
11 To estimate a different rotor position, change the position of the Estimate Position switch to Stop. The Estimated rotor electrical position (radians) field displays the value
Turn the motor shaft to a new position. Then change the position of the Estimate Position switch to Start to run the example algorithm again and estimate the new position.
12 Observe the estimated position,
Iq signals in the time scope available in the host model.
This plot shows the estimated rotor electrical position () and the stator currents (
Id) and (
The DP method algorithm works only when the stator core saturates and shows a nonlinear behavior. To generate this behavior in simulation, the target model uses the PMSM (Simscape Electrical) block from Simscape™ Electrical™. Follow this procedure to experimentally determine the tabulated , , and data for the actual motor and use this data to make the motor block nonlinear for simulation purposes.
1. Create a target model to run a PMSM using open-loop control. Modify the algorithm so that it injects the voltages and into the actual motor. This generates the current in the motor where:
is the voltage that the algorithm computes and injects along the rotor's
is the AC component of (such that and ω are constants that the algorithm should assume)
is the DC component of that you provide as an input
is the current along the
d-axis of the rotor that the algorithm computes from the measured and phase currents
is the AC component of (ϕ is the phase difference between and that the algorithm should measure)
is the DC component of , which is fixed for a input (the algorithm should compute this value by using and the motor resistance)
Note: Because , the rotor remains stationary.
a. Add an algorithm to read the and phase currents that the motor draws.
b. Add an algorithm to convert the and phase current values into the equivalent value by using Clarke and Park transforms.
c. Add an algorithm to compute ϕ and .
d. Add an algorithm to compute .
e. Add an algorithm to compute .
(for a fixed )
2. Create a model initialization script (
.m file) to initializate the paramters and perform other calculations. Use the Model Properties > Callbacks to integrate this script with the target model. For details about how Motor Control Blockset™ uses this script, see Estimate Control Gains from Motor Parameters.
3. Configure the target model to run on the target hardware. For instructions, see Model Configuration Parameters.
4. Create a separate host model to control and communicate with the target model running on the motor-control hardware in real-time. You can add an Edit box on the host model and use it to send input to the target hardware. Use Display boxes to obtain the computed and values from the target hardware.
For details about the host-target communication interface, see Host-Target Communication.
5. Click Build, Deploy & Start on the Hardware tab to deploy the target model to the hardware.
6. Simulate the host model. Send a input to the target hardware and record the and values that you obtain.
7. Change manually across a range between a negative and positive voltage and record the resulting and values for each operating point.
Perform these steps to determine a value that is higher than the sequence of values obtained from the Determine Ld section. This is necessary to maintain a high saliency ratio () for the simulated motor block.
1. Modify the target model that you used in the Determine Ld section so that it injects the voltages and into the actual motor. This generates a current in the motor where:
is the DC voltage (corresponding to ) that the algorithm injects along the
d axis of the rotor
is the AC voltage that the algorithm computes and injects along the
q-axis of the rotor. (such that and ω are constants that the algorithm assumed in the Determine Ld section)
is the AC current along the
q-axis of the rotor that the algorithm computes from the measured and phase currents (ϕ is the phase difference between and that the algorithm should measure)
Note: Because , the rotor remains stationary.
a. Update the existing algorithm to convert the and phase current values into the equivalent value by using Clarke and Park transforms.
b. Update the existing algorithm to compute ϕ.
c. Update the existing algorithm to compute .
d. Add an algorithm to compute .
2. Update the model initialization script to perform the preceding modified calculations.
3. Update the host model to obtain and display the value computed by the target hardware.
4. Click Build, Deploy & Start on the Hardware tab to deploy the target model to the hardware.
5. Simulate the host model. Send a input (corresponding to ) to the target hardware and record the value that you obtain.
Design High Saliency Motor Block
Sections Determine Ld Data and Determine Lq Value provide the following data:
Sequence of values
Sequence of ( for a DC current) values
In addition, we can assume a set of values that we can use to add high saliency to the motor block.
Use the variables
pmsm.nonlin.Lq_data to store this data in the model initialization script
mcb_ipmsm_pos_est_f28379d_data.m associated with the example target model
Note: This script is different from the model initialization script used in sections Determine Ld Data and Determine Lq Value.
In addition, define the variables
In the PMSM (Simscape Electrical) block parameter dialog box, set the Modeling fidelity parameter to Tabulated Ld, Lq and PM and add these variables as shown in the following figure.
pmsm.nonlin.Lq_data help saturate the stator core and introduce a nonlinear behavior during simulation. This enables the algorithm of the DP method to generate the current impulses (corresponding to Pulse-1 and Pulse-2) with different peaks.
 W. Zine, L. Idkhajine, E. Monmasson, Z. Makni, P. Chauvenet, B. Condamin, and A. Bruyere, "Optimisation of HF signal injection parameters for EV applications based on sensorless IPMSM drives", IET Electric Power Applications, Volume 12, Issue 3, March 2018, p. 347 - 356 (doi:10.1049/iet-epa.2017.0228).
 Gaolin Wang, Guoqiang Zhang, and Dianguo Xu, "Position Sensorless Control Techniques for Permanent Magnet Synchronous Machine Drives", Springer, Singapore, 2020 p. 41 - 43 (doi: https://doi.org/10.1007/978-981-15-0050-3).