This example uses field-oriented control (FOC) to control two three-phase permanent magnet synchronous motors (PMSM) coupled in a dyno setup. Motor 1 runs in the closed-loop speed control mode. Motor 2 runs in the torque control mode and loads Motor 1 because they are mechanically coupled. You can use this example to test a motor in different load conditions.
The example simulates two motors that are connected back-to-back. You can use a different speed reference for Motor 1 and a different torque reference for Motor 2 (derived from the magnitude and electrical position of the Motor 2 reference stator current). Motor 1 runs at the reference speed for the load conditions provided by Motor 2 (with a different torque reference).
The example runs in the controller hardware board. You can input the speed reference for Motor 1 and current reference for Motor 2 using a host model. The host model uses serial communication to communicate with the controller hardware board.
Current control loops in Motor 1 and Motor 2 control algorithms are offset by Ts/2, where Ts is the control-loop execution rate.
The example includes the following models:
For QEP based dyno mcb_pmsm_foc_f28379d_dyno example, refer Control PMSM Loaded with Dual Motor (Dyno) (Motor Control Blockset) .
You can use mcb_pmsm_foc_sensorless_dyno_f28379d and mcb_pmsm_foc_qep_dyno_f28069m models for both simulation and code generation. You can also use the open_system command to open the Simulink® model. These models use timer0 as a base rate trigger. For example, use this command for a F28379D based controller:
The example includes the following models:
You can use mcb_pmsm_foc_dual_cpu1_f28379d and mcb_pmsm_foc_dual_cpu2_f28379d models for both simulation and code generation. You can also use the open_system command to open the Simulink® model.
Note: Dual core CPU models does not support simulation.
For example, use this command for a F28379D based controller:
IPC Communication for Dual Core Processors
The CPU1 transmits the following data to CPU2 through IPC channels:
The CPU2 transmits the debug signal according to the signal select of CPU1.
Core1 transmits data to its allocated memory (Core1-to-Core2 Message RAM) and receives data from the allocated memory of Core2 (Core2-to-Core1 Message RAM). Similarly, Core2 transmits data to its allocated memory (Core2-to-Core1 Message RAM) and receives data from allocated memory of Core1 (Core1-to-Core2 Message RAM). For more information, refer Inter-Processor Communication Using IPC Blocks.
Set the peripheral block configurations for this model. Double-click on the blocks to open block parameter configurations. You can use the same parameter values if you want to run this example for other hardware boards.
ePWM Block Configuration The ePWM1/2/3 is offset by ePWM time period from ePWM4/5/6. This is achieved by sending a synchronization signal from ePWM3 to ePWM4 and setting the phase offset value of ePWM4 as
ADC Block Configuration
The algorithm in this example uses an asynchronous scheduling. The pulse width modulation (PWM) block triggers the ADC conversion. At the end of conversion, the ADC posts an interrupt that triggers the main FOC algorithm. For more information, refer ADC Interrupt Based Scheduling.
For Single CPU model:
ADC channel for Inverter 1
ADC channel for inverter 2
For Dual CPU model, the ADC channels for inverter 2 is defined in the initialize function of the CPU1 model. In CPU2 model, we use Memory Copy blocks, to access the value of the ADC registers.
1. Open the 'mcb_pmsm_foc_dual_cpu1_f28379d' and 'mcb_pmsm_foc_dual_cpu2_f28379d' model. This model is configured for TI Delfino F28379D Launchpad.
2. To run the model on other TI C2000 processors, first press Ctrl+E to open the Configuration Parameters dialog box. Then, select the required hardware board by navigating to Hardware Implementation > Hardware board.
3. The following screenshots show the scheduler configurations performed in the Dual CPU model.
For Single CPU model, ensure that the base rate trigger is Timer0.
Ensure that the Default parameter behavior is set to Inlined (Configuration Parameters > Code Generation > Optimization).
4. Ensure that the baud rate is set to 12e6 bits/sec.
To simulate model:
Motor Control Blockset™
To generate code and deploy model:
Motor Control Blockset™
Embedded Coder® Support Package for Texas Instruments™ C2000™ Processors
Fixed-Point Designer™ (only needed for optimized code generation)
1. Obtain the motor parameters for both Motor 1 and Motor 2. We provide default motor parameters with the Simulink® model that you can replace with the values from either the motor datasheet or other sources.
However, if you have the motor control hardware, you can estimate the parameters for the motor that you want to use, by using the Motor Control Blockset™ parameter estimation tool. For instructions, see Estimate Motor Parameters Using Motor Control Blockset Parameter Estimation Tool (Motor Control Blockset).
2. Update the motor parameters (that you obtained from the datasheet, other sources, or parameter estimation tool) and inverter parameters in the model initialization script associated with the Simulink® model. For instructions, see Estimate Control Gains from Motor Parameters (Motor Control Blockset).
For this example, update the motor parameters for both the motors in the model initialization script.
This example supports simulation. Follow these steps to simulate the model.
1. Open a model included with this example.
2. Click Run on the Simulation tab to simulate the model.
3. Click Data Inspector on the Simulation tab to view and analyze the simulation results.
4. Input a different speed reference for Motor 1 and a different current reference (load) for Motor 2. Observe the measured speed and other logged signals in the Data Inspector.
This section instructs you to generate code and run the FOC algorithm on the target hardware.
The 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. The prerequisite to use the host model is to 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 a closed-loop control.
The example supports this hardware configuration. You can also use the target model name to open the model for the corresponding hardware configuration, from the MATLAB® command prompt.
LAUNCHXL-F28069M controller + 2 BOOSTXL-DRV8305 inverters: mcb_pmsm_foc_qep_dyno_f28069m
LAUNCHXL-F28379D controller + 2 BOOSTXL-DRV8305 inverters: mcb_pmsm_foc_dual_cpu1_f28379d
LAUNCHXL-F28379D controller + 2 BOOSTXL-DRV8305 inverters: mcb_pmsm_foc_dual_cpu2_f28379d
LAUNCHXL-F28379D controller + 2 BOOSTXL-DRV8305 inverters: mcb_pmsm_foc_f28379d_dyno
For connections related to the preceding hardware configuration, see Hardware Connections.
Generate Code and Run Model on Target Hardware
1. Simulate the target model and observe the simulation results.
2. Complete the hardware connections.
3. The model automatically computes the ADC (or current) offset values. To disable this functionality (enabled by default), update the value 0 to the variable inverter.ADCOffsetCalibEnable in the model initialization script.
Alternatively, you can compute the ADC offset values and update it manually in the model initialization scripts. For instructions, see Open-Loop Control of 3-Phase AC Motors using C2000 Processors.
4. Compute the quadrature encoder index offset value and update it in the model initialization scripts associated with the target model. For instructions, see Quadrature Encoder Offset Calibration for PMSM Motor.
For this example, update the QEP offset values in the pmsm_motor1.PositionOffset and pmsm_motor2.PositionOffset variables in initialization script.
5. Open the target model. If you want to change the default hardware configuration settings for the model, see Model Configuration Parameters (Motor Control Blockset).
6. To ensure that CPU2 is not mistakenly configured to use the board peripherals intended for CPU1, load a sample program to CPU2 of LAUNCHXL-F28379D, for example, a program that operates the CPU2 blue LED by using GPIO31 (c28379D_cpu2_blink.slx).
For dual CPU model, you must build and download CPU1 and CPU2 models to respective cores of the processor. Each core controls one motor on the dual motor control kit. Two cores communicate each other using IPC. CPU1 model sends Load Torque request to CPU2. CPU2 sends data to be logged to CPU1.
After deploying the code, full power reset should be done on the launchpad to ensure proper execution of the code.
7. Click Build, Deploy & Start on the Hardware tab to deploy the model to the hardware.
8. Click the host model hyperlink in the target model to open the associated host model. These are the following host models.
You can also use the open_system command to open the host model:
9. In the Host Serial Setup block mask of the host model, select a Port name.
10. Click Run on the Simulation tab to run the host model.
11. Change the position of the Motor 1 switch to Start, to run the motor.
12. Update the Motor 1 - Reference Speed (RPM) and Motor 2 - Iq Ref (A) in the host model.
13. Select the debug signals that you want to monitor, to observe them in the Time Scope block of host model.
You can also use SoC Blockset™ to develop a real-time motor control application for a dual motor setup that utilizes multiple processor cores to obtain design modularity, improved controller performance, and other design goals. For details, see Integrate MCU Scheduling and Peripherals in Motor Control Application.