TI Code Composer Studio

From SEGGER Wiki
Jump to: navigation, search

This article describes the usage of TI Code Composer Studio (CCS) in combination with J-Link.

Minimum CSS Version Requirements

In order to use J-Link with TI CCS, min. V6.1.3 of TI CCS is required. Earlier versions might work but are not guaranteed to do so. Please understand that SEGGER does not provide any support for CCS versions earlier than V6.1.3.

Adding J-Link support at installation time

Since TI CCS v7, J-Link is supported out-of-the-box if J-Link support is selected to be added at installation time of CCS. For more information regarding older versions of CCS: Adding J-Link support to older CCS versions. CCS InstJLinkSupport.png

Updating J-Link inside CCS

The J-Link plugin can be automatically updated as any other Eclipse plugin. A manual update can be triggered via Help -> Check for Updates.
CCS CheckForUpdates.png

Updating the plugin manually

J-Link CCS plugin can be updated manually.

  1. Download and extract the J-Link CCS plugin
    Download link
  2. In CCS go to Help -> Install New Software...
  3. Click Add...
  4. Click Local... and select the extracted folder
  5. Click Add
  6. Select the desired plugins (Windows/Linux/Mac) and click Next >, Next >, Finish
  7. Restart CCS to complete the installation
  8. To check if the correct plugin version is installed go to Help -> About Code Composer Studio -> Installation Details and check the entry for SEGGER J-Link Support

Using TI CCS with J-Link

In the following, a short step-by-step tutorial how to configure a Code Composer Studio project to be used with J-Link, is given.

  1. Open the project to configure
  2. Open project properties by clicking Project | Properties from the main menu and go to the General tab
  3. Make sure that the proper device is selected
  4. Make sure that Segger J-Link Emulator is selected as connection type

CCS Project Config.png

Ready for debugging

Now the project is ready to be debugged with J-Link / J-Trace.
CCS DebugSession.png

Adding J-Link support to older CCS versions

In order to get started with J-Link and CCS, please make sure that latest SEGGER software and documentation pack is installed, which can be downloaded here.

Adding J-Link to Available Software Sites

  1. Open CCS
  2. Open Window | Preferences
  3. In Install/Update select Available Software Sites
  4. Press Add...
    CCS AddJLinkUpdate.png
  5. Enter "J-Link Support" as Name
  6. Add the following URL as Location:
    https://download.segger.com/J-Link/JLink_TI_CCS_plugin_unified
    Note:
    The link is not browsable. Please do not try to download the plugin via your browser from the link above. The plugin is downloadable and installable via the TI CCS update interface only.
  7. Press OK

CCS Software.png

Installing J-Link

  1. Open Help | Install New Software
  2. In Work With: field: Choose "J-Link Support" from the drop down list
  3. Check J-Link support
  4. Click Next
  5. Click Next
  6. Click Next
  7. Accept the license
  8. Click Finish
  9. Restart TI CCS

CCS J Link Support.png

Using J-Link in a project

  1. Open the target configuration (.ccxml file in the project)
    • View | Target Configuration can be used to find the target configuration file if necessary
  2. In the Connection field choose "SEGGER J-Link Emulator" from the drop down list
  3. Check the correct target in the list below
  4. In the Advanced tab, additional settings are configurable , e.g. the JTAG speed
  5. The project is now ready to be debugged with J-Link

CCS Target Connection v2.png

Connecting to a J-Link via Ethernet

Problem

In current versions of the TI Code Composer Studio (CCS), the host interface to the J-Link (USB / Ethernet) can not be specified in the project settings.

Work-around

The J-Link DLL allows to override the used host interface using the J-Link Commander String SetHostIF. This command string can be passed to the J-Link DLL using the J-Link Script File function InitEMU(). Please find below an example J-Link Script File, which forces the J-Link DLL to open a connection to the J-Link via IP (192.168.104.174). How to use J-Link script files in CCS is described in the article below.

File:JLinkOverrideHostIF.jlinkscript

Note:
  • The work-around can be used with any J-Link with Ethernet interface.
  • Native host interface selection, using the GUI in CCS, is planned for future versions.

Using J-Link Script Files

  1. Make sure that J-Link CCS uses at least J-Link software version V6.20g
  2. Open the project
  3. Switch to the Project Explorer, browse to %PROJECT_NAME% --> targetConfigs and open the active target config with *.ccxml extension (e.g. CC2650F128.ccxml)
    CCS ProjectExplorer.png
  4. Select the Cpu properties (see screenshot below)
  5. Switch to the Advanced tab (see screenshot below)
  6. Select the desired J-Link script file in the Cpu Properties tab --> J-Link Scriptfile Path (see screenshot below)

CCS TargetConfiguration.png

Setting a breakpoint while the target is running

Per default a TI CCS project is in a so-called "non-intrusive" debug mode. In this mode CCS will not set any breakpoints while the target is running, because this could effect realtime behavior as the target needs to be halted before setting a breakpoint.

Error dialog: Cannot enable breakpoints while running


It is possible to change this behavior. To do so, the following steps are necessary:

  1. Open your project in TI CCS
  2. Navigate to the Project Explorer
  3. Open the properties of your project (right click on the project -> Properties)
  4. Activate the intrusive mode: Debug -> Auto Run and Launch Options -> Realtime Options -> set Halt the target before any debugger access
Project properties: Allow to set breakpoints while running