Download, Install and Setup CCS

Table of Contents

• Download CCS
• Install CCS
• Enabling AM261x Device Support in Code Composer Studio (CCS)
• Check Packages as seen by CCS
• Create Target Configuration
  • AM261X-SOM / AM261X-LP
• Known Issues

Note

The steps on this page need to be done once on a given host machine

Download CCS

• Download CCS 12.8.1, https://www.ti.com/tool/CCSTUDIO
• Unzip the file for Windows or Linux at any location on your host PC

Install CCS

• Install CCS 12.8.1 by double clicking the installer file from the downloaded and un-zipped CCS package file.

CCS Installer File

• Follow the steps and at below screen, recommend to keep install directory as default.

CCS Install Path

• Follow the steps and at below screen, recommend to keep setup type as "custom"

CCS Setup Type

• Follow the steps and at below screen, select the component as "Sitara AM2x MCUs" to install AM261X related emulation and GELs

CCS Select Components

• Follow the steps, until CCS is installed.
• If using Linux, additionally go through the instructions given at CCS Linux Host Support
• Launch CCS and select the workspace.

CCS Select Workspace

Enabling AM261x Device Support in Code Composer Studio (CCS)

1. Add the CCS - CSP (Chip Support Package):
   • Download the CSP from the TI Drive. Contact your TI representative to get the CSP package.
   • Copy the CSP inside the CCS installation directory at C:\ti\<ccs_version>\ccs\ccs_base/ccs_base.
   • Follow the instructions in the documentation provided with the CSP data for more details.
2. Update the timestamp:
   • To update the device list in CCS, close CCS and navigate to C:\ti\<ccs_version>\ccs\ccs_base\common\targetdb.
   • Open a command line and run the following:
     • Windows: copy /b timestamp ,,+
     • Linux: touch timestamp
   • Open CCS, and check if the AM261x is present in the device list of the new project.
3. Import the project:
   • Go to File -> Import.
   • Select CCS projects.
   • Select the search-directory and browse to SDK_PATH/examples/hello_world/am261x-lp/r5fss0-0_nortos/ti-arm-clang/.
   • Click Import.
   • If the SDK product was not correctly recognized in CCS, preventing the SDK project from being imported, go to the CCS menu -> windows -> code composer studio -> products, and refresh the products to solve the issue.

Note

After importing the application, go to the project settings and select the correct SysConfig that includes the AM261 device data.

Check Packages as seen by CCS

• Launch CCS
• Goto "Window > Preferences"

CCS Preferences

• Goto "Code Composer Studio > Products", make sure you see SysConfig 1.21.2 listed here.
  • Sometimes, you need to click "Restore Defaults" and then "Refresh"

CCS Products

• Goto "Code Composer Studio > Build > Compilers", make sure you see TI CLANG 4.0.1.LTS listed here
  • Sometimes, you need to click "Restore Defaults" and then "Refresh"

CCS Compilers

Create Target Configuration

AM261X-SOM / AM261X-LP

• Goto "View > Target Configuration"

Target Configuration Menu

• Create a new target configuration

New Target Configuration

• Give a nice name to the new target configuration, typically {soc name}_{JTAG type}

Target Configuration Name

• Select connection as XDS110 USB Debug Probe

Select JTAG Connection

• In "Board or Device" type "AM261X" and select "AM261x"

Select AM261X EVM

• For CCs using ISO7221ADR (U53) for JTAG, lower the TCLK to 1MHz. Under Advanced tab, in the Connection Properties
  • Select 'The JTAG TCLK Frequency (MHz)' as "Fixed with user specified value"
  • Select '–Enter a value from 100.0kHz to 5.5MHz' as "1MHz"

Configuring JTAG TCLK frequency

• Under Advanced tab – Select Cortex_R5_0
  • Make sure the device csp gel file path is in the Initialization script field

Initialization script

• Click "Save" to save the newly created target configuration.
• Now you can move on to EVM Setup to prepare your EVM for running programs.

Known Issues

• To use the debugger correctly with CCS in Linux, some additional steps are required. There is a message which is shown during the CCS installation to do this, but more often than not this is missed. If you miss this, you might get an error similar to

CS_DAP_0: Error initializing emulator: (Error -260 @ 0x0) An attempt to connect to the XDS110 failed. The cause may be one or more of: no XDS110 is connected,
invalid firmware update, invalid XDS110 serial number, or faulty USB cable. The firmware and serial number may be updated using the xdsdfu utility found in the
.../ccs_base/common/uscif/xds110 directory of your installation. View the XDS110SupportReadMe.pdf file there for instructions. (Emulation package 9.4.0.00129)

• There might be EVM specific issues in which the debugger maybe needs to be connected after the power is turned ON, or other similar issues. For this refer the evm specific setup page at EVM Setup