SDAA194 November   2025 AM2431 , AM2432 , AM2434 , AM62P , AM6412 , AM6421 , AM6422 , AM6441 , AM6442

 

  1.   1
  2.   Abstract
  3.   Trademarks
  4. 1Introduction
    1. 1.1 SysConfig CodeGen Tool
  5. 2Getting Started Guide
    1. 2.1 How to Launch SysConfig (GUI and Command-Line)
    2. 2.2 Integration with CCS and Makefile builds
    3. 2.3 Location of SysConfig file in MCU SDK
      1. 2.3.1 Using Existing SysConfig File
      2. 2.3.2 Creating New SysConfig File
  6. 3Example Sysconfig in CCS
    1. 3.1 Example I2C Read
  7. 4Common Application Configuration
    1. 4.1 RAT Configuration
    2. 4.2 MPU Configuration
    3. 4.3 MMU Configuration
    4. 4.4 System Initialization
      1. 4.4.1 DPL Initialization
      2. 4.4.2 Clock Initialization
      3. 4.4.3 PinMux Configuration
      4. 4.4.4 Driver Initialization
      5. 4.4.5 Board Peripheral Initialization
  8. 5Output File
    1. 5.1 Files Generated by CodeGen Tool
      1. 5.1.1 Debugging and Troubleshooting
    2. 5.2 Version Mismatch
    3. 5.3 Resource Conflict
      1. 5.3.1 Pin Conflict
      2. 5.3.2 Module Instance Conflict
      3. 5.3.3 Multicore Resource Conflict
    4. 5.4 Unsupported Drivers
    5. 5.5 Use of Reserve Peripheral
  9. 6Disclaimers and Intended Use
  10. 7Summary
  11. 8References

3.1 Example I2C Read

To get started with SysConfig CodeGen Tool, import an existing example provided in the MCU SDK with SysConfig support.

  1. Launch CCS and import the example: i2c_read_r5fss0-0_nortos
    1. Select Project → Import CCS Project
    2. Browse to ${MCU+SDK}\examples\drivers\i2c\i2c_read\am64x-evm\r5fss0-0_nortos
    3. Select the project and import the project.
  2. Inside the CCS project, the user can see the syscfg file along with the rest of the application files.
    Example Project Figure 3-1 Example Project
  3. Double click on example.syscfg file and the SysConfig GUI launches.
    Note:

    Right-click on the syscfg file, then select Open With → SysConfig Editor.

    Sysconfig CCS GUI Editor Figure 3-2 Sysconfig CCS GUI Editor
  4. The SysConfig GUI must be launched inside CCS and looks similar to the one shown in Figure 3-3.
    Sysconfig CCS GUI View Figure 3-3 Sysconfig CCS GUI View
  5. Click the Device View button at the top right corner of the SysConfig GUI to see the device and package used for the project.
Sysconfig Device ViewFigure 3-4 Sysconfig Device View

SysConfig support is added to the Project Properties. By default, this project was configured for AM64x family of devices, and the selected device package is set to FCBGA (ALV) package. If the Project Properties for AM64x SysConfig support is not set up by default in the CCS project, the syscfg file does not launch the GUI successfully.

When using the standalone version of CodeGen tool (opened through CLI), the same steps are applicable for module configuration.