J-Link Emulator Support

From Texas Instruments Wiki
Jump to: navigation, search

Overview

SEGGER offers a line of high-performance, low cost JTAG Debug Probes for embedded ARM software development.

CCSv7

SEGGER J-Link Install Selection

The SEGGER integration feature is now shipped with the CCSv7 install package. The feature is not installed by default and would need to be checked during installation.

For more information on SEGGER support for CCSv7, Please visit SEGGER's website: https://www.segger.com/ti-code-composer-studio.html

For additional information about the devices and cores supported, please visit SEGGER's page: https://www.segger.com/jlink_supported_devices.html



CCSv6

Additional software from SEGGER can be installed to add support for J-Link with CCSv6.

For more information on SEGGER support for CCSv6, Please visit SEGGER's website: https://www.segger.com/ti-code-composer-studio.html

For additional information about the devices and cores supported, please visit SEGGER's page: https://www.segger.com/jlink_supported_devices.html

CCSv5

IMPORTANT! CCSv5 support for J-Link has been discontinued. It is strongly recommended to use CCSv6 for J-Link support.

Supported Host OSs

J-Link support is currently offered on Windows XP and 7, as well as Linux platform. Both 32 and 64-bit versions are supported (except XP).

Supported Target Hardware

Currently supported target hardware:

TMS470 ARM7 and Cortex-M devices are not supported
CC25x, CC26x and CC32x devices are not supported

Supported J-Link Debug Probes

CCS supports the standard J-Link USB pod, J-Link Pro, and J-Link Ultra. The current beta software suppports only the USB connection type.

Project Status

  • Linux support is now available
  • A beta of Stellaris and Tiva devices, Hercules CortexR4-based devices, MSP432P4xx devices and Sitara AM335x support is now available.

Patch Notes:

  • v0.1.0.5
  1. basic debug support added for generic Cortex Devices.
  • v0.1.0.4
  1. AM335x basic debug support added.
  • v0.1.0.3
  1. fixed a bug where CONTROL FAULTMASK BASEPRI PRIMASK register of Cortex-M3 is not properly mapped
  2. fixed a bug where banked registers are out of sync with the values used in debugger
  3. fixed a bug where setting JTAG speed through target configuration setup view is not working properly

Limitations

  • J-Link Flash Breakpoint and J-Flash
    • J-Link provided and related flash modules may conflict with the CCS flash modules as it does caching of flash memory and writing to flash memory behind the back of CCS, please be consistent and stick to the set of flash solutions you choose to use, ie:
      • if you are using J-Link Flash Breakpoints, erase the target and load programs to the target with J-Flash rather than using the flash features provided by CCS
      • if you are loading programs to flash and erasing flash through CCS, refrain from using J-Link Flash Breakpoint.
  • J-Link Support for Stellaris, Tiva, Hercules, and Sitara AM335x, v0.1.0.4
  1. For Sitara AM335x, The ARM advance features View is not supported
  2. WatchPoints and advanced hardware breakpoint features are disabled to enable support for J-Link flash breakpoints, you can still set WatchPoints through the Segger J-Link control panel found in the system tray.
  • J-Link Support for Stellaris, Tiva and Hercules, v0.1.0.2
  1. Requires a CCSv5.2.0 or later installation
  2. If you have v0.1.0.1 of the J-Link support package installed, please uninstall it first!
  3. WatchPoints and advanced hardware breakpoint features are disabled to enable support for J-Link flash breakpoints, you can still set WatchPoints through the Segger J-Link control panel found in the system tray.
  • J-Link Support for Stellaris and Tiva, v0.1.0.1:
  1. Requires a CCSv5.1.0 or higher installation.
  2. Only Stellaris Cortex-M3 and Tiva Cortex-M4 are supported.
  3. Only USB connection to the JTAG debug probe is supported.
  4. J-Link's implementation of Flash breakpoints is not supported.
  5. Please do not create break points in the J-Link Control Panel.
  6. Make sure the target board is connected to a powered J-Link through the 20 pin cable before connecting power for the tareget board. Not following this sequence will cause the DEBUG OUT feature to be enabled and J-Link will not be able to communicate with the target board (see below).
  7. If the red DEBUG OUT LED lights, please power cycle the board to reset it.
  8. On some boards, such as the LM3S811 Eval Board, the JTAG pins are just for DEBUG OUT, thus you will not be able to connect to it through the 20 pin cable.

Downloads

  • Windows:
  1. J-Link Support for Generic Cortex Devices, v0.1.0.5
  2. J-Link Support for Stellaris, Tiva, Hercules, and Sitara AM335x, v0.1.0.4
  3. J-Link Support for Stellaris, Tiva and Hercules, v0.1.0.3
  4. J-Link Support for Stellaris, Tiva and Hercules, v0.1.0.2
  5. J-Link Support for Stellaris, Tiva, v0.1.0.1
  • Linux
  1. J-Link Support for Stellaris, Tiva, Hercules, and Sitara AM335x, v0.1.0.4

Installation

  • To install J-Link support for CCS for Windows:
  1. Install the latest CCS v5.x from here. If you already have a CCS v5.2.x installation, J-Link support can be added to this instead. J-Link suppport is compatible with v5.2.0 and higher.
  2. Download and install the latest J-Link software package from Segger.
  3. Download and run the CCS J-Link installer. J-Link Support for Stellaris/Tiva v0.1.0.2 requires CCS v5.2.0 or higher.
  4. During install, select the ccsv5 folder of your CCS installation. For example: C:\ti\ccsv5. Click next.
  5. Select the "Typical" installation option.
  6. Allow the installation to complete.
  7. Browse to Segger's install directory below and copy the file <JLinkARM.dll> to the clipboard (Ctrl-C)
    C:\Program Files (x86)\SEGGER\JLink_V496
  8. Browse to the CCS install directory below and paste the file <JlinkARM.dll>.
    C:\ti\ccsv6\ccs_base\DebugServer\drivers
  • To install J-Link support for CCS for Linux:
  1. Download and install the latest J-Link software package from Segger.
  2. Download and run the CCS J-Link installer. J-Link Support for Stellaris/Tiva v0.1.0.2 requires CCS v5.2.0 or higher.
  3. During install, select the ccsv5 folder of your CCS installation. For example: C:\ti\ccsv5. Click next.
  4. Select the "Typical" installation option.
  5. Allow the installation to complete.
  6. Install libusb with the following command:
    user@host:~$ sudo apt-get install libusb
  7. Go to CCS install directory and copy the file <libjlinkarm.so.4.xx.xx> from the Segger's install directory: (the xx.xx is the version number of the installed Segger software)
    user@host:~$ cd /opt/ti/ccsv6/ccs_base/DebugServer/drivers
    user@host:/opt/ti/ccsv6/ccs_base/DebugServer/drivers$ sudo cp /opt/SEGGER/Jlink/libjlinkarm.so.4.96.12 .
  8. Create a soft link that points to this library.
    user@host:/opt/ti/ccsv6/ccs_base/DebugServer/drivers$ sudo ln -s libjlinkarm.so.4.96.12 libjlinkarm.so.4


Beta Guide

  • Steps to startup a debug session with J-Link and a Stellaris/Tiva Cortex-M, MSP432P4xx or Hercules Cortex-R4 device in CCS:
  1. Complete the installation instructions above.
  2. Connect the J-Link Debug Probe to the PC and to the target board. Ensure the target board is powered and the DEBUG OUT feature has not become enabled (see limitations section).
  3. Start CCS, select the "Target Configuration" view. Click the "New Target Configuration" button to create a new target configuration file (*.ccxml).
  4. Select the file name and location. In "General Setup" under the "Basic" tab, select "Segger J-Link Emulator" from.
  5. Type in the filter text field to find your device.
  6. Click on the "Save" button to save the target configuration file
  7. Right click on the newly created target configuration file and from the context menu, choose "Launch Selected Configuration" to start a debug session
  • After the J-Link target configuration file is created, it can be used like any other target configuration file to start a debug session. eg: Set as default, Link to a sepecific project
  • When the device is connected in the debug view, a J-Link icon will be displayed in the status bar on the low right of your screen. Double click on it will open up the J-Link Control Panel. On disconnect, its fields will be greyed out, you can refresh it by double click on the icon again.
  • In the "General" tab J-Link Control Panel, next to "Target interface: JTAG", you can select the connection speed. Note that the changes will occur instantly, and at high speed there could be potential errors in memory write operations.

Uninstallation

The uninstaller can be found under the installed ccsv5 folder: "uninstall_ccs_jlink_support.exe" or from "Control Panel\All Control Panel Items\Programs and Features" on Windows 7.
The uninstaller can be found under the installed ccsv5 folder: "uninstall_ccs_jlink_support" on Linux.