SLAU948 October   2024 MSPM0G3507

 

  1.   1
  2.   Abstract
  3.   Trademarks
  4. 1Introduction
  5. 2Hardware Setup
    1. 2.1  EVM Hardware Setup
      1. 2.1.1 EVM Hardware Support
    2. 2.2  Pin Configurations for PWM Outputs
    3. 2.3  Pin Configurations for ADC Currents
    4. 2.4  Pin Configurations for ADC Voltages
    5. 2.5  Pin Configurations for Hall Sensor Inputs Through GPIO
    6. 2.6  Pin Configurations for Faults
    7. 2.7  Pin Configurations for GPIO Output Functions
    8. 2.8  Pin Configurations for SPI Communication
    9. 2.9  Pin Configurations for UART Communication
    10. 2.10 External Connections for Evaluation Boards
  6. 3Software Setup
  7. 4GUI Setup
    1. 4.1 Serial Port Configuration
    2. 4.2 GUI Home Page
      1. 4.2.1 System Configurations
      2. 4.2.2 Register Map
      3. 4.2.3 Motor Tuning Page
      4. 4.2.4 Collateral Page
  8. 5Register Map
    1. 5.1 Register Map Page in GUI
    2. 5.2 User Control Registers (Base Address = 0x20200400h)
      1. 5.2.1 Speed Control Register (Offset = 0h) [Reset = 00000000h]
      2. 5.2.2 Algo Debug Control 1 Register (Offset = 4h) [Reset = 00000000h]
      3. 5.2.3 Algo Debug Control 2 Register (Offset = 8h) [Reset = 00000000h]
      4. 5.2.4 Algo Debug Control 3 Register (Offset = Ch) [Reset = 00000000h]
      5. 5.2.5 DAC Configuration Register (Offset = 10h) [Reset = 00000000h]
    3. 5.3 User Input Registers (Base Address = 0x20200000h)
      1. 5.3.1  SYSTEM_PARAMETERS (Offset = 0h)
      2. 5.3.2  MOTOR_STARTUP1 Register (Offset = 3Ch) [Reset = 00000000h]
      3. 5.3.3  MOTOR_STARTUP2 Register (Offset = 40h) [Reset = 00000000h]
      4. 5.3.4  CLOSED_LOOP1 Register (Offset = 44h) [Reset = 00000000h]
      5. 5.3.5  CLOSED_LOOP2 Register (Offset = 48h) [Reset = 00000000h]
      6. 5.3.6  FIELD_CTRL Register (Offset = 4Ch) [Reset = 00000000h]
      7. 5.3.7  FAULT_CONFIG1 Register (Offset = 50h) [Reset = 00000000h]
      8. 5.3.8  FAULT_CONFIG2 Register (Offset = 54h) [Reset = 00000000h]
      9. 5.3.9  MISC_ALGO Register (Offset = 58h) [Reset = 00000000h]
      10. 5.3.10 PIN_CONFIG Register (Offset = 5Ch) [Reset = 00000000h]
      11. 5.3.11 PERI_CONFIG Register (Offset = 60h) [Reset = 00000000h]
    4. 5.4 User Status Registers (Base Address = 0x20200430h)
  9. 6Basic Tuning
    1. 6.1 System Configuration Parameters
      1. 6.1.1 Configuring System Parameters From GUI
      2. 6.1.2 Updating System Parameters Through CCS Debug Window
        1. 6.1.2.1 Motor Resistance in Milliohms (mΩ)
        2. 6.1.2.2 Motor Inductance in Microhenries (μH)
        3. 6.1.2.3 Saliency of IPMSM Motor
        4. 6.1.2.4 Motor BEMF Constant
        5. 6.1.2.5 Base Voltage (V)
        6. 6.1.2.6 Base Current (A)
        7. 6.1.2.7 Maximum Motor Electrical Speed (Hz)
        8. 6.1.2.8 Maximum Motor Power(W)
    2. 6.2 Control Configurations for Basic Motor Spinning
      1. 6.2.1 Hall Sensor Auto Calibration
        1. 6.2.1.1 Hall Sensor Calibration Through GUI
      2. 6.2.2 Motor Open Loop Ramp
      3. 6.2.3 PI Controller Tuning for Closed Loop Speed Control
        1. 6.2.3.1 Current Controller Tuning
        2. 6.2.3.2 Speed/Power Controller Tuning
      4. 6.2.4 Testing for Successful Startup Into Closed Loop
    3. 6.3 Fault Handling
      1. 6.3.1 Monitoring Power Supply Voltage Fluctuations for Voltage Out of Bound Faults
      2. 6.3.2 No Motor Fault [NO_MTR]
      3. 6.3.3 Hall Invalid Fault
  10. 7Advanced Tuning
    1. 7.1 Control Configurations Tuning
      1. 7.1.1  Control Mode of Operation
      2. 7.1.2  Closed Loop Torque Control Mode
      3. 7.1.3  Closed Loop Power Control Mode
      4. 7.1.4  Closed Loop Speed Control Mode
      5. 7.1.5  Voltage Control Mode
      6. 7.1.6  Stopping Motor Quickly
      7. 7.1.7  Flux Weakening: Operating Motor at Speeds Higher Than Rated Speed
      8. 7.1.8  Maximum Torque Per Ampere : Improve Efficiency of IPMSM Motors
      9. 7.1.9  Preventing Supply Voltage Overshoot During Motor Stop.
      10. 7.1.10 Protecting the Power Supply
      11. 7.1.11 FOC Bandwidth Selection
  11. 8Hardware Configurations
    1. 8.1 Direction Configuration
    2. 8.2 Brake Configuration
    3. 8.3 Main.h Definitions
      1. 8.3.1 Sense Amplifier Configuration
      2. 8.3.2 Driver Propagation Delay
      3. 8.3.3 Driver Min On Time
      4. 8.3.4 Current Shunt Configuration Selection
        1. 8.3.4.1 Three Shunt Configurations
        2. 8.3.4.2 Dual Shunt Configuration
      5. 8.3.5 CSA Offset Scaling Factor Selection
    4. 8.4 Real Time Variable Tracking

5.3.1 SYSTEM_PARAMETERS (Offset = 0h)

These tables show a set of basic system configuration parameters essential for motor control system functionality.

Table 5-10 Motor Resistance Configuration Registers (Offset = 0h)
Bit Field Type Reset Description
31-0 MTR_RESISTANCE R/W 0000h Motor Resistance in milliohms
Table 5-11 Motor Inductance Configuration (Offset = 4h)
Bit Field Type Reset Description
31-0 MTR_INDUCTANCE R/W 0000h Motor Inductance in microhenry. For Salient pole motors (Lq + Ld)/2
Table 5-12 Motor Saliency Configuration (Offset = 8h)
Bit Field Type Reset Description
31-0 MTR_SALIENCY R/W 0.0(Float) Saliency of Motor (Lq-Ld)/(Lq+Ld) in float.
Table 5-13 Motor BEMF Constant Configuration (Offset = Ch)
Bit Field Type Reset Description
31-0 MTR_BEMF_CONSTANT R/W 0000h Motor BEMF constant in mV/Hz × 10.
Table 5-14 Base Voltage Configuration (Offset = 10h)
Bit Field Type Reset Description
31-0 VOLTAGE_BASE R/W 0.0(Float) Base voltage of the board calculated based on the voltage divider as (3.3V × voltage divider ratio / √3) in volts. 3.3V is the full-scale value of the ADC.
Table 5-15 Base Current Configuration (Offset = 14h)
Bit Field Type Reset Description
31-0 CURRENT_BASE R/W 0.0(Float) Base current of the board calculated based on the CSA gain in as (1.65V / CSA Gain in volts/amp) in amps.
1.65V is the reference mid point voltage of the ADC for bidirectional current sensing.
If the CSA gain is in V/V , multiply with current sense resistor value in ohms to compute CSA gain in volts/amp
Table 5-16 Motor Max Speed Configuration (Offset = 18h)
Bit Field Type Reset Description
31-0 MOTOR_MAX_SPEED R/W 0.0(Float) Rated motor speed in Hz from the data sheet
Table 5-17 Motor Max Power Configuration (Offset = 1Ch)
Bit Field Type Reset Description
31-0 MOTOR_MAX_POWER R/W 0.0(Float) Maximum Power rating of the Motor.

Note: FOC Algorithm computes the PU power for controlling the Input Power in closed loop.
Note: The PU Power is defined as MOTOR_MAX_POWER/ √3 * VOLTAGE_BASE * CURRENT_BASE

Table 5-18 Speed Loop Proportional Gain (Offset = 20h)
Bit Field Type Reset Description
31-0 SPEED_POWER_LOOP_KP R/W 0.0(Float) Proportional gain for the closed loop speed control / Closed Loop Power Control in float
Table 5-19 Speed Loop Integral Gain (Offset = 24h)
Bit Field Type Reset Description
31-0 SPEED_POWER_LOOP_KI R/W 0.0(Float) Integral gain for the closed loop speed control/ Closed Loop Power Control in float
Table 5-20 Torque Loop Proportional Gain (Offset = 28h)
Bit Field Type Reset Description
31-0 CURR_LOOP_KP R/W 0.0(Float) Proportional gain for the closed loop torque control in float
Table 5-21 Torque Loop Integral Gain (Offset = 2Ch)
Bit Field Type Reset Description
31-0 CURR_LOOP_KI R/W 0.0(Float) Integral gain for the closed loop torque control in float
Table 5-22 Flux weakening Controller Proportional Gain (Offset = 30h)
Bit Field Type Reset Description
31-0 FLUX_WEAK_KP R/W 0.0(Float) Proportional gain for the Flux weakening control in float
Table 5-23 Flux Weakening Controller Integral Gain (Offset = 34h)
Bit Field Type Reset Description
31-0 FLUX_WEAK_KI R/W 0.0(Float) Integral gain for the Flux weakening control in float
Table 5-24 Motor Pole Pairs (Offset = 38h)
Bit Field Type Reset Description
31-0 POLE_PAIRS R/W 0(Int) Total Pole pairs of Motor or Number of Poles / 2 .