From Texas Instruments Embedded Processors Wiki

Contents 1 Overview 2 Linux Distributions 2.1 Dependencies 2.2 Testing 3 Emulator Support 3.1 Supported 3.2 Not-Supported 4 Supported ISAs / Device families 4.1 Emulation (h/w debug) 4.2 Simulation 5 Features not available on Linux 6 Downloads 7 Installation Instructions 7.1 Support for Older Kernels 7.2 Installing on 64bit Ubuntu 8 Getting Started 9 Support

Overview

CCSv5 is the first CCS release to add Linux host support to the CCS product line. This wiki page describes important information regarding supported Linux distributions (and other dependencies), emulators, simulators and devices. It also lists CCS features that are not yet supported on Linux.

Linux Distributions

As there are many versions and distributions of Linux, we are not able to test and support every flavor. To operate CCS is dependent on a number of libraries, those libraries are listed below along with the Linux distributions that CCS is tested on.

Dependencies

CCS depends on the following libraries on linux:

• ld-linux.so.2
• libasound.so.2
• libatk-1.0.so.0
• libcairo.so.2
• libc.so.6 (version 2.3.2 or higher)
• libdbus-1.so.3
• libdbus-glib-1.so.2
• libdl.so.2
• libfontconfig.so.1
• libfreetype.so.6
• libgcc_s.so.1
• libgdk_pixbuf-2.0.so.0
• libgdk-x11-2.0.so.0
• libglib-2.0.so.0
• libgmodule-2.0.so.0
• libgobject-2.0.so.0
• libgthread-2.0.so.0
• libgtk-x11-2.0.so.0
• libm.so.6
• libpango-1.0.so.0
• libpangocairo-1.0.so.0
• libpangoft2-1.0.so.0
• libpthread.so.0
• librt.so.1
• libstdc++.so.6 (version 3.4.9 or higher)
• libX11.so.6
• libXext.so.6
• libXrender.so.1
• libXt.so.6
• libz.so.1

The distro’s package management system should allow you to search for these libraries and install the necessary packages (and dependent packages of those packages) to get them. Or they can be downloaded and built from source.

An additional dependency issue is that the installed version of gdk on some distros may expose different function signatures than expected. This manifests as CCS exiting early with the error message: “symbol lookup error: /opt/ti/ccsv5/ccs_base/DebugServer/linux/libxul.so: undefined symbol: gdk_screen_get_resolution”. SUSE 10.2 exhibits this issue.

The easiest way to resolve this is to install xulrunner-191 (on SUSE: sudo zypper install mozilla-xulrunner191), and then add the new gdk libraries to LD_LIBRARY_PATH (on SUSE: export LD_LIBRARY_PATH=/usr/lib/firefox/lib/:$LD_LIBRARY_PATH) before starting CCS. This issue is only needed when using the internal web browser (help and the TI Resource Explorer are web based). If those features are not needed, CCS can be used with the existing gdk as long as the workspace does not auto-load them.

Testing

These are the distributions that are in the CCS test lab. Note that there are libraries that CCS is dependent on (see the above section). The installation section of this topic describes how to install CCS on some distributions.

• Ubuntu 10.04 32 bit
• Ubuntu 10.10 32 bit
• Ubuntu 10.10 64 bit
• SUSE 11 32 bit (being added, additional libraries needed that are not part of the distribution)

Emulator Support

Supported

• XDS100v1 class emulators
• XDS100v2 class emulators
• XDS100v3 class emulators
• Spectrum Digital 510USB more info
• Spectrum Digital 510USB Plus more info
• Spectrum Digital 510USB C2000 more info
• Spectrum Digital XDS560v2 (LAN/USB) more info
• Spectrum Digital DSK/EVM onboard 510USB (OMAP-L137, DA850, DA830, AM1707) more info
• Blackhawk XDS560v2 (LAN/USB)
• Blackhawk XDS560 USB (USB560, USB560m, and USB560bp models) CCSv5.0.3+ or CCSv5.1.0 required
• Blackhawk XDS560 LAN (LAN560 models) CCSv5.0.3+ or CCSv5.1.0 required
• Blackhawk XDS560-BP
• SEED XDS560v2 more info, login needed

Not-Supported

• Blackhawk USB510L (planned)
• Blackhawk USB2000 (planned)
• Blackhawk USB2.0 (will not be supported)
• Spectrum Digital onboard emulators on DSKs/EVMs/eZdsp kits not listed above (tbd)
• Spectrum Digital XDS560R (will not be supported)
• Spectrum Digital Parallel Port emulators (will not be supported)
• Texas Instruments XDS560 PCI emulator
• Blackhawk XDS560 PCI emulator
• Texas Instruments XDS510 ISA emulator
• In general vendors are not supporting PCI, ISA or parallel port emulators on Linux

For information on a specific JTAG emulator please contact your emulator vendor.

Supported ISAs / Device families

Emulation (h/w debug)

Supported

• C6-Integra
• Sitara
• DaVinci
• OMAP
• C64x+
• c674
• C66x
• C28x
• C55x

Not Supported

• TMS570 (Scheduled for 5.2.0)
• MSP430 (Scheduled for 5.2.0)
• Older C6000 devices (C62xx/C64xx/C671x/C672x)
• Stellaris (ICDI support is TBD, possible to use with XDS emulator if xml files are copied from Windows, xml files will be added to Linux installation in 5.2.0 release)

Simulation

• generic ARM9e
• generic C64x
• generic C64x+
• generic C674x
• C6416
• C6455
• C6474
• C6670
• C6678
• C6745
• C6747
• DA830
• DM6437
• DM6443
• Cortex M3
• Cortex R4
• other C64+ based devices

Features not available on Linux

Most features are available on Linux but there are some key features that are not present

• Trace (planned for CCSv5.2.0)
  • PC Trace (XDS560T)
  • ETB (Embedded Trace Buffer)
  • STM (System Trace Module)
• MSP430 support (planned for 5.2.0)
• Stellaris onboard emulation support (emulation present on IDKs)

Downloads

See the main CCSv5 topic.

Installation Instructions

• Check that your Linux distribution has all the dependent libraries listed in the 'Dependencies' section.
• Download the install file and untar it into a temporary folder.
  • For example, tar xvfz /tmp/ccsv5_install setup_CCS_5.x.x.0xxxx.tar.gz
• Install as root. This avoids many issues with emulation device drivers.
  • From a terminal, run the installer as sudo ./ccs_setup_5.1.0.0xxxxx.bin &
• A license file is required for Linux versions of the CCSv5.1 release. A free upgrade to CCSv5.1 will be received by the users with an active subscription (details here)

Support for Older Kernels

• USB permissions are handled successfully in older kernel versions. The installer does not attempt to add the fstab entries required by older kernel versions.

Installing on 64bit Ubuntu

• CCS is a 32bit application that can run on 64bit Ubuntu distributions when the 32bit library support package (ia32-libs) is installed. See the Ubuntu 32bit vs 64bit Wiki topic for more detailed information as well as other alternative ways of running 32bit applications.

Getting Started

• Refer to the CCSv5 Windows Getting Started guide for help with the differences between the v5 and v5 workflows.
• Refer to the Linux Debug guide for help in getting started with run-mode and stop-mode Linux debugging

Support

• Refer to the Spectrum Digital troubleshooting guide above for help with the XDS510USB and XDS560v2 emulation connection.
• Refer to the the Linux Debug in CCSv5 page for help with run-mode and stop-mode Linux debug.

Additional resources:

• Troubleshooting CCS
• TI E2E Community
  • Code Composer Studio Forum. The CCS forums are actively monitored for CCSv5 questions.
  • Compiler Forum

Remember to Tag your questions with CCSv5.

Leave a Comment

Comments

Questions on roadmap

It seems that you've made a lot of progress so far during 2010. Is support for the MSP430 architectures on the roadmap somewhere? (How far out?) Porting CCS for GNU/Linux is a good thing -- it'll allow you to tap into a well of clever hackers that now will begin to consider developing for TI chips, both at home and at work. Keep it up! :-) --Aevin 20:55, 21 September 2010 (UTC)

Aevin, thanks for your comments. MSP430 support on Linux is not something we have on the roadmap yet. You are not the only one asking for this though, so it is being looked at but there is no specific plan as to when it might be available.--AndyW

I am also looking for TI MSP430 support on linux, I have a Windows XP laptop but have been having problems connecting to the FET, I have a linux desktop that I would perfer to use once the support is available.

Gary.stephany said ...