TIDUF23 may   2023

 

  1.   Description
  2.   Resources
  3.   Features
  4.   Applications
  5.   5
  6. 1System Description
    1. 1.1 Key System Specifications
  7. 2System Overview
    1. 2.1 Block Diagram
    2. 2.2 Design Considerations
    3. 2.3 Highlighted Products
      1. 2.3.1  UCC5880-Q1
      2. 2.3.2  AM2634-Q1
      3. 2.3.3  TMS320F280039C-Q1
      4. 2.3.4  UCC14240-Q1
      5. 2.3.5  UCC12051-Q1
      6. 2.3.6  AMC3330-Q1
      7. 2.3.7  TCAN1462-Q1
      8. 2.3.8  ISO1042-Q1
      9. 2.3.9  ALM2403-Q1
      10. 2.3.10 LM5158-Q1
      11. 2.3.11 LM74202-Q1
    4. 2.4 System Design Theory
      1. 2.4.1 Microcontrollers
        1. 2.4.1.1 Microcontroller – C2000™
        2. 2.4.1.2 Microcontroller – Sitara™
      2. 2.4.2 Isolated Bias Supply
      3. 2.4.3 Power Tree
        1. 2.4.3.1 Introduction
        2. 2.4.3.2 Power Tree Block Diagram
        3. 2.4.3.3 12 V Distribution and Control
        4. 2.4.3.4 Gate Drive Supply
        5. 2.4.3.5 5-Volt Supply Domain
        6. 2.4.3.6 Current and Position Sensing Power
  8. 3Hardware, Software, Testing Requirements, and Test Results
    1. 3.1 Hardware Requirements
      1. 3.1.1 Hardware Board Overview
        1. 3.1.1.1 Control Board
        2. 3.1.1.2 MCU Control Card – Sitara™
        3. 3.1.1.3 MCU Control Card – C2000™
        4. 3.1.1.4 Gate Driver and Bias Supply Board
        5. 3.1.1.5 DC Bus Voltage Sense
        6. 3.1.1.6 SiC Power Module
          1. 3.1.1.6.1 XM3 SiC Power Module
          2. 3.1.1.6.2 Module Power Terminals
          3. 3.1.1.6.3 Module Signal Terminals
          4. 3.1.1.6.4 Integrated NTC Temperature Sensor
        7. 3.1.1.7 Laminated Busing and DC Bus Capacitors
          1. 3.1.1.7.1 Discharge PCB
    2. 3.2 Test Setup
      1. 3.2.1 Software Setup
        1. 3.2.1.1 Code Composer Studio Project
        2. 3.2.1.2 Software Structure
    3. 3.3 Test Procedure
      1. 3.3.1 Project Setup
      2. 3.3.2 Running the Application
    4. 3.4 Test Results
      1. 3.4.1 Isolated Bias Supply
      2. 3.4.2 Isolated Gate Driver
      3. 3.4.3 Inverter System
  9. 4General Texas Instruments High Voltage Evaluation (TI HV EVM) User Safety Guidelines
  10. 5Design and Documentation Support
    1. 5.1 Design Files
      1. 5.1.1 Schematics
      2. 5.1.2 BOM
      3. 5.1.3 PCB Layout Recommendations
        1. 5.1.3.1 Layout Prints
      4. 5.1.4 Altium Project
      5. 5.1.5 Gerber Files
      6. 5.1.6 Assembly Drawings
    2. 5.2 Tools and Software
    3. 5.3 Documentation Support
    4. 5.4 Support Resources
    5. 5.5 Trademarks
  11. 6Terminology

3.2.1.1 Code Composer Studio Project

To import the software project for TIDM-02014 into CCS, click Project → Import CCS Projects, and browse to <SDK install location>\designs\tidm_02014\<device>\ccs and click Select Folder. Select the project named tidm_02014_<device> and click Finish. The project is now be visible in the Project Explorer pane in CCS. The user's guide provides further details on Importing Projects into CCS.

The folder src_foc includes the typical FOC modules, including park and clarke transforms, PID functions, and estimators. These modules are independent of the specific device and board and are used across several other designs in the SDK.

The folder src_control includes motor drive control files that call motor control core algorithm functions within the interrupt service routines and background tasks. The folder src_sys includes some files reserved for other system features such as drivers for CAN communication. The user can their own code for system control, communication, and so forth. These modules are specific to this reference design project but are independent of the device and board.

Board-specific, motor-specific and device-specific files are in the folder src_board. These files consist of device-specific drivers to run the design. If you want to migrate the project to your own board or other devices, you only need to make changes to the files hal.c, hal.syscfg (or hal_dclinkss.syscfg if used), hal.h, and user_mtr1.h based on the pin assignments and features of your device or board.

GUID-20230410-SS0I-SZXX-7HRH-4VXB9P0DSJJ4-low.svg Figure 3-12 Project Explorer View of the Reference Project

The default build configuration for the tidm_02014 project is named F28003x_RELEASE and uses hal.syscfg file to configure the ePWM, CMPSS, and ADC peripherals and the GPIOs. The project's predefined symbols and include the single-shunt current reconstruction library files and function calls as part of the build.

The default build configuration can be modified by right-clicking the project and going to Build Configurations → Manage. Users can add or modify build configurations for different test cases.

GUID-20230410-SS0I-9KDB-HSMR-WRP3FGQF9VBN-low.png Figure 3-13 Selecting Active Build Configuration

Different operational modes of the system can be enabled or disabled using predefined symbols in the project properties. The options are as follows:

  • CLOSED_CURRENT_LOOP to enable closed-loop

    control of the d and q axis motor currents.

  • CLOSED_SPEED_LOOP to enable

    closed-loop speed control.

Adding these symbols to the predefined symbols list enables the respective functionality. To view and edit the predefined symbols, right-click on your project and select Properties. Then go to the Predefined Symbols section of the C2000 Compiler options as shown in Figure 3-14. By default the above symbols are defined in the pre-defined symbols list and the corresponding features are enabled.

GUID-20230425-SS0I-RHPN-S8RM-XNV3MDWZLQXK-low.svg Figure 3-14 Selecting Predefined Symbols in the Project Properties