TIDUF67 April   2024

 

  1.   1
  2.   Description
  3.   Resources
  4.   Features
  5.   Applications
  6.   6
  7. 1System Description
    1. 1.1 Terminology
    2. 1.2 Key System Specifications
  8. 2System Overview
    1. 2.1 Block Diagram
    2. 2.2 Highlighted Products
      1. 2.2.1 AM263x Microcontrollers
        1. 2.2.1.1 TMDSCNCD263
        2. 2.2.1.2 LP-AM263
  9. 3System Design Theory
    1. 3.1 Three-Phase PMSM Drive
      1. 3.1.1 Mathematical Model and FOC Structure of PMSM
      2. 3.1.2 Field Oriented Control of PM Synchronous Motor
        1. 3.1.2.1 The ( a ,   b ) ⇒ ( α , β ) Clarke Transformation
        2. 3.1.2.2 The α , β ⇒ ( d ,   q ) Park Transformation
        3. 3.1.2.3 The Basic Scheme of FOC for AC Motor
        4. 3.1.2.4 Rotor Flux Position
      3. 3.1.3 Sensorless Control of PM Synchronous Motor
        1. 3.1.3.1 Enhanced Sliding Mode Observer With Phase Locked Loop
          1. 3.1.3.1.1 Design of ESMO for PMSM
          2. 3.1.3.1.2 Rotor Position and Speed Estimation with PLL
      4. 3.1.4 Hardware Prerequisites for Motor Drive
      5. 3.1.5 Additional Control Features
        1. 3.1.5.1 Field Weakening (FW) and Maximum Torque Per Ampere (MTPA) Control
        2. 3.1.5.2 Flying Start
  10. 4Hardware, Software, Testing Requirements, and Test Results
    1. 4.1 Hardware Requirements
    2. 4.2 Software Requirements
      1. 4.2.1 Importing and Configuring Project
      2. 4.2.2 Project Structure
      3. 4.2.3 Lab Software Overview
    3. 4.3 Test Setup
      1. 4.3.1 LP-AM263 Setup
      2. 4.3.2 BOOSTXL-3PHGANINV Setup
      3. 4.3.3 TMDSCNCD263 Setup
      4. 4.3.4 TMDSADAP180TO100 Setup
      5. 4.3.5 TMDSHVMTRINSPIN Setup
    4. 4.4 Test Results
      1. 4.4.1 Level 1 Incremental Build
        1. 4.4.1.1 Build and Load Project
        2. 4.4.1.2 Setup Debug Environment Windows
        3. 4.4.1.3 Run the Code
      2. 4.4.2 Level 2 Incremental Build
        1. 4.4.2.1 Build and Load Project
        2. 4.4.2.2 Setup Debug Environment Windows
        3. 4.4.2.3 Run the Code
      3. 4.4.3 Level 3 Incremental Build
        1. 4.4.3.1 Build and Load Project
        2. 4.4.3.2 Setup Debug Environment Windows
        3. 4.4.3.3 Run the Code
      4. 4.4.4 Level 4 Incremental Build
        1. 4.4.4.1 Build and Load Project
        2. 4.4.4.2 Setup Debug Environment Windows
        3. 4.4.4.3 Run the Code
    5. 4.5 Adding Additional Functionality to Motor Control Project
      1. 4.5.1 Using DATALOG Function
      2. 4.5.2 Using PWMDAC Function
      3. 4.5.3 Adding CAN Functionality
      4. 4.5.4 Adding SFRA Functionality
        1. 4.5.4.1 Principle of Operation
        2. 4.5.4.2 Object Definition
        3. 4.5.4.3 Module Interface Definition
        4. 4.5.4.4 Using SFRA
    6. 4.6 Building a Custom Board
      1. 4.6.1 Building a New Custom Board
        1. 4.6.1.1 Hardware Setup
        2. 4.6.1.2 Migrating Reference Code to a Custom Board
          1. 4.6.1.2.1 Setting Hardware Board Parameters
          2. 4.6.1.2.2 Modifying Motor Control Parameters
          3. 4.6.1.2.3 Changing Pin Assignment
          4. 4.6.1.2.4 Configuring the PWM Module
          5. 4.6.1.2.5 Configuring the ADC Module
          6. 4.6.1.2.6 Configuring the CMPSS Module
  11. 5General Texas Instruments High Voltage Evaluation (TI HV EVM) User Safety Guidelines
  12. 6Design and Documentation Support
    1. 6.1 Design Files
      1. 6.1.1 Schematics
      2. 6.1.2 BOM
      3. 6.1.3 PCB Layout Recommendations
        1. 6.1.3.1 Layout Prints
    2. 6.2 Tools and Software
    3. 6.3 Documentation Support
    4. 6.4 Support Resources
    5. 6.5 Trademarks
  13. 7About the Author

Importing and Configuring Project

This project is a universal motor control design that has support for TI EVM motor driver kits and can be used in conjunction with the AM263x MCU devices. The user can run different TI EVM kits by setting the build configurations and properties of the project. In the following sections, the LP-AM263 is used in combination with the BOOSTXL-3PHGANINV lab to show how to import and run the example lab on this kit.

  1. Import the project within CCS by clicking "Project" ➔"Import CCS Projects...", and then click "Browse..." button to select search directory at:
    1. <install_location>\examples\ to select the "universal_motorcontrol_lab" folder.
  2. The project can be configured to run on two motor driver kits. You can select one of these kits by right-clicking on the imported project name and selecting the right build configuration (such as 3phGaN_3SC) as shown in Figure 4-1.
  3. Configure the project to select the supporting functions in the project by right-clicking on the imported project name, and then click the "Properties" command to set the pre-define symbols for the project as shown in Figure 4-2.
    1. A pre-define symbol is active or disabled by removing or adding the "_N" in the name. For example, field weakening control is enabled by removing the "_N" in "MOTOR1_FWC_N" to change to "MOTOR1_FWC", and field weakening control functions are disabled by changing the "MOTOR1_FWC" symbol name to "MOTOR1_FWC_N".
    2. Select the right supporting motor control algorithm based on the motor and hardware board by enabling the related pre-define symbol as described above. The supporting algorithms and related motors matrix are shown in Table 4-3.
    3. Select the right supporting functions by enabling the pre-define symbol/s as shown in Figure 4-2.
  4. Select the right target configuration file (.ccxml) as shown in Figure 4-4 by right clicking on the file name to select "Set as Active Target Configuration" and "Set as Default Target Configuration" on the pop-up menu.
    1. AM263_LP.ccxml is for the LP-AM263 based hardware kit.
    2. AM263_CC.ccxml is for the TMDSCNCD263 based hardware kit.
  5. Select or define the right motor model in the user_mtr1.h and user_common.h files. These files are located under the src_board folder located in the project explorer window. Uncomment the #define that corresponds with the motor being tested, and verify that the rest of the #define motors remain commented out. Make sure that the motor parameters in the code match with the specifications of the connecting motor.
  6. Set up the hardware kit, connect the motor, encoder, and/or hall sensor to the kit as described in Section 4.3.
GUID-20240320-SS0I-H1X7-PGZQ-XGF0FG9PXPJP-low.svg Figure 4-1 Select the Right Build Configurations within CCS
GUID-20240320-SS0I-NSBS-NSKQ-1SD617S2GZVP-low.svg Figure 4-2 Select the Desired Pre-define Symbols in Project Properties
Table 4-3 The Supporting Algorithms, Functions and Motors Matrix in Universal Motor Control
Algorithms or Functions Pre-Define Symbols LaunchPad controlCARD
BOOSTXL-3PHGANINV TMDSHVMTRINSPIN
eSMO based Sensorless FOC MOTOR1_ESMO ✔, LVSERVOMTR ✔, HVPMSMMTR
QEP Encoder based Sensored FOC MOTOR1_ENC ✔, LVSERVOMTR ✔, HVPMSMMTR
Hall Sensors based Sensored FOC MOTOR1_HALLHALL_CAL ✔, LVSERVOMTR
Datalog with Graph Tool DATALOG_EN
PWMDAC EPWMDAC_MODE
SFRA Tool SFRA_ENABLE
Step Response with Graph Tool STEP_RP_EN