Processor SDK RTOS Setup CCS
|RTOS Software Developer Guide||→||CCS Setup for EVM and SDK|
- 1 Overview
- 2 Discovering SDK products
- 3 Create Target Configuration File for EVM
- 3.1 Open new target configuration file
- 3.2 Select target configuration options
- 3.3 Save target configuration
- 3.4 Test target configuration
- 3.5 View target configurations
- 3.6 Launch target configuration
- 3.7 Connect target
- 3.8 Success!
- 3.9 Additional Notes for AM57x
- 4 Troubleshooting
This page provides information on configuring CCS to work with both the EVM and the Processor-SDK for RTOS.
Discovering SDK products
CCS and SDK installed in same directory
After installing the Processor-SDK RTOS, start CCS and it will automatically detect the newly installed components (products):
CCS and SDK installed in different directories
If you chose to install the SDK package in a different folder from where CCS is installed (e.g. C:\TEMP\RTOS-SDK\am57x), then you will need to add the path to the search path for CCS to locate the new packages. The screenshots below demonstrate the process to setup the CCS environment; the sequence for a Linux host is the same.
Go to product preference
From CCS, select "Window -> Preferences":
Enter path to SDK
In the Preferences window, select "Code Composer Studio -> RTSC -> Products" in the panel on the left. Then, press the "Add" button on the panel on the right:
Next, verify the newly discovered products. If everything is correct, press the "Finish" button on the bottom:
When prompted, restart CCS for changes to take effect. You will see newly discovered products from the custom path.
Create Target Configuration File for EVM
In CCS, you need to create a Target Configuration for your EVM to be able to connect to the target. This configuration defines your:
- Connection to the target (XDS, FET, etc.)
- Target device (AM437x GP EVM, AM57x GP EVM, etc.)
- GEL file for hardware initialization. A GEL file is basically a “batch file” that sets up the CCS debug environment including memory map, PLL, clock, etc.
CCS comes with basic configuration that can be used to configure your particular setup. In the example below, we provide details for a GP AM437x EVM; configuration information for other supported EVMs are also provided as needed.
For EVM specific instructions, refer to the Hardware User's Guide for your EVM.
Note for K2G devices: If using CCS v6.1.2 and Keystone2 device support v1.1.7, 66AK2G02 would not show up in the list of devices when creating the target configuration. This is due to an incompatibility in the XML parser in CCS v6.1.2 with the K2G device xml. In order to work-around this issue, make the change in 66AK2G02.xml as illustrated below in order to have 66AK2G02 display in the device list. This problem does not exist in CCS v6.1.3 onwards as the XML parser has been updated.
<?xml version="1.1" encoding="UTF-8" standalone="no"?>
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
Open new target configuration file
From CCS, select "File -> New -> Target Configuration File":
Select target configuration options
The AM437x GP EVM supports embedded XDS100V2 USB Emulation through the MicroUSB AB connector. Select
- Connection: Texas Instruments XDS100v2 USB Debug Probe
- Board or Device: EVMAM437X
If you enter the starting numbers of your device in the Board or Device field, the list will show the relevant subset.
Here is a table showing configuration information for all supported EVMs in the Processor-SDK RTOS:
|GP335x||External Emulator Supplied by User. EVM includes a TI 20 pin JTAG connector.||EVMAM3358|
|ICE335x||Texas Instruments XDS100v2 USB Debug Probe||ICE_AM3359|
|SK335x||Texas Instruments XDS100v2 USB Debug Probe||SK_AM3358|
|BBB||External Emulator Supplied by User. EVM includes a TI 20 pin JTAG connector.||BeagleBone_Black|
|GP437x||Texas Instruments XDS100v2 USB Debug Probe||EVMAM437X|
|IDK437x||Texas Instruments XDS100v2 USB Debug Probe||IDK_AM437X|
|GP572x||External Emulator Supplied by User. EVM includes a TI 20 pin JTAG connector.||GPEVM_AM572X|
|X15||External Emulator Supplied by User. EVM includes a TI 20 pin JTAG connector.||GPEVM_AM572X|
|IDK572x/IDK574x|| Texas Instruments XDS100V2 USB Debug Probe
External Emulator Supplied by User. EVM includes a 60-pin MIPI JTAG connector
|C665x EVM||Texas Instruments XDS2xx USB Onboard Debug Probe||TMS320C6657|
|C667x EVM|| L w/ XDC100: Texas Instruments XDS100v1 USB Emulator
LE/LXE with XDS560: Blackhawk XDS560v2-USB Mezzanine Emulator
|K2E EVM||Texas Instruments XDS2xx USB Onboard Debug Probe||66AK2E05|
|K2H EVM||Texas Instruments XDS2xx USB Onboard Debug Probe||66AK2H12|
|K2L EVM||Texas Instruments XDS2xx USB Onboard Debug Probe||TCI6630K2L|
|K2G GP EVM||Texas Instruments XDS2xx USB Onboard Debug Probe||66AK2G02|
|OMAPL137 EVM||Spectrum Digital XDS510USB Emulator||OMAPL137SK|
|OMAPL138 LCDK||External Emulator Supplied by User. EVM includes a TI 14 pin JTAG connector.||OMAPL138LCDK|
Save target configuration
Next, save the target configuration by pressing the Save button:
Test target configuration
Next, test the target configuration by pressing the Test Connection button. This will confirm that you have successfully created an emulator connection with your board.
View target configurations
From CCS, select "View -> Target Configurations":
Launch target configuration
Open "User Defined" list and right click on the target configuration file that was just saved and select "Launch Selected Configuration":
After launch, you can connect to a core. For GP AM437x EVM, select Cortex A9 and select "Connect Target":
After connecting to target, check the console for status. Typically, the end of the configuration will indicate success or failure. For GP AM437x EVM, you will see the message "AM437x GP EVM Initialization is Done":
Additional Notes for AM57x
Connect to Slave Cores
After connecting to the boot master core -- typically the ARM core -- you may need to connect to a slave core in order to run code. Depending on your SOC, the slave core can be
- DSP C66x
- ARM M4
Typically the slave cores will wait in reset state until the master core wakes up the slave core to run code. To connect to the slave core on AM57x, go to Scripts menu in CCS Debug View and under AM572x MULTICORE Initialization enable the corresponding sub system clock. For example, enable
DSP11SSClkEnable_API for the first DSP core. After running the clock enable option, you can connect to the core.
Timer Suspend Control Options for DSP
On AM57xx devices, all the timers on the chip have their suspend control signal routed to the A15 core. Which means that if any of the slave cores are using these timers, the timers will continue to run even when the slave core has been paused. The timer will only pause when the A15 core is halted.
This is confusing while debugging code on slave cores if you are relying on timer for logging, inserting delays or if the timer keeps firing interrupts even when the core is halted. One such scenario occurs with GPtimer5 when DSP developers are using SYS/BIOS. The OS uses GPtimer5 on the DSP and forces a frequency check to confirm the timer configuration, however the OS can't gain access to the timer due to the hook up of the suspend control signals.
Due to this issue the SYS/BIOS developers will need to configure an additional CCS configuration check to connect the GPTimer suspend control signal to the DSP as shown in the image below:
If you face any problems, first check these basic items:
- Power cycle your target.
- Check the USB cable. One simple way to do this is to connect another device to the USB and ensure the cable works.
- Check host driver. Even with CCS turned off, your host should list the TI XDS as a USB device. If this does not work, try a different USB port.
- Latest emulation package. Ensure that you have the latest emulation files as specified in the Getting Started Guide.
If this does not resolve your problem, see these additional resources: