AM273x MCU+ SDK  08.05.00
CCS Launch, Load and Run

Table of Contents

Note
The steps on this page should be done each time EVM is power cycled or when a new CCS session is started.

Prerequisites

A quick recap of the steps that need to have been done before you proceed

  • Make sure you have installed CCS as mentioned in Download, Install and Setup CCS
  • Make sure the UART port used for console is identified as mentioned in Setup UART Terminal
  • Make sure you have the EVM power cable, JTAG cable, UART cable connected as shown in Cable Connections
  • Make sure you have done the steps for a SOC initialization method using SOC Initialization
  • Make sure the UART or CCS console logs on doing EVM POWER-ON indicate that SOC initization is successful
  • Make sure you have built the example of interest as mentioned in Build a Hello World example

Launch CCS

Launch Target Configuration
  • You will see the AM273X target configuration in the "Debug" window as shown below

Target Configuration After Launch
  • When using the SOC Initialization using the Binary Flashed in QSPI memory you need to remove the gel files from CS_DAP_0 core. You can skip this step when using the SOC Initialization Using CCS
    • Right click on the launhched target config and click show all cores
      Show All Cores
    • Right click on the CS_DAP_0 core and open the gel file view
      Open gel files view
    • Remove the gel files
      Remove gel files

Load and run example binaries

  • POWER-ON the EVM
  • Connect the target CPU of interest if not already connected. For the "hello world" example this is MAIN_Cortex_R5_0_0

Connect CPU
  • when using the SOC Initialization Using CCS connecting to the R5 core will run the gel files and you should be able to see the gel logs as below

Gel Output
  • Reset the CPU

Reset CPU
  • Load program on the CPU

Load Program
  • When using makefiles to build,
    • In the "Load Program" dialog, select "Browse" and select the program from examples/{example folder}/{board}/{cpu}_{os}/{compiler} as shown below for the "hello world" program.

Select Program for Makefile Build
  • When using CCS projects,
    • In the "Load Program" dialog, select "Browse Project", select the project and then select the program as shown below,

Select Program for CCS Projects Build

Select the Program from CCS Project
  • After the program is loaded, you will see the program is halted at "main" as shown below

Program at main()
  • Depending on the example you are running, you may need to load more programs on other CPUs for the example to work as expected. Typically, this is needed for multi-core interprocessor communication (IPC) examples. For the "hello world" program shown above, no more programs need to be loaded.
  • Select "Resume" to run the program and debug using the various CCS debug options

Run the Program
  • The program output will be seen on CCS console, and/or UART terminal, if enabled. Below shows a sample output on both CCS console and UART console, after running the "hello world" program.

Run the Program
Note
When loading the examples on R5 core using the XDS560 or XDS200 CCS Hangs. Use below workaround
  • After connecting to the R5 Core
  • Open the Expression Window and enter as below 
     symbol_loader=1
  • Now load the example as shown above
  • This is a known issue in CCS. Refer the below link for details https://sir.ext.ti.com/jira/browse/EXT_EP-10638

Re-load and run example binaries

  • Here simply repeat the steps shows in Load and run example binaries
  • It is especially important to "reset the CPU" before reloading the program.
  • In most cases, you dont need to power-cycle the EVM to reload the program or load a new program.
  • In some cases, depending on whether the previous program execution was successful or not, the CPU or some SOC peripheral may be in a exception or hang state. In this case program reload may not work.
    • SOLUTION: Power cycle the EVM and repeat all steps shown on this page.