- Note
- The steps on this page need to be done once on a given host machine
Download CCS
Install CCS
- Install CCS 12.8.0 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 AM263X 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
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.0 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.0.LTS listed here
- Sometimes, you need to click "Restore Defaults" and then "Refresh"
CCS Compilers
Create Target Configuration
AM263X-CC / AM263X-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 "AM263X" and select "AM263x"
\htmlonly <style>div.image img[src="ccs_target_config_00.png"]{width:50%}</style>\endhtmlonly
\image html ccs_target_config_00.png "Select AM263X 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