Linux Host Support CCSv10

<img src="./images/tux.jpg" alt="Tux" width="100" length="100" align="right"> # Overview # This page contains information regarding Code Composer Studio v10 running on Linux. It includes installation instructions, device support and debug probe support. Due to the wide variety of Linux distributions and versions available, it is impossible to support all of them. CCS is tested in a small subset ordered by popularity, but over the years the developers helped populate this list by providing information on how to install in various additional distributions. This information is added to this page, therefore always check back for updates. Please note that Code Composer Studio is a 64-bit application and will not run on 32-bit distributions. # Devices # ## Supported ## - Microcontrollers: MSP430, MSP432, C2000, TM4, Hercules - Wireless Connectivity: CC13xx, CC2538, CC26xx, CC32xx - Processors: Sitara (AMxxxx), Keystone / Keystone II, OMAPL - DSP: C64x+, C674x, C66x, C55x, C641x ## Not Supported ## - Microcontrollers: C/F24x - DSP: C3x/C4x/C5x/C8x, C54x, C62x, C670x/C671x/C672x # Debug Probes # ## Supported ## - MSP430: MSP-FET, MSP-FET430UIF, Launchpads with built-in MSP-FET and eZ-FET technology such as the [MSP-EXP430G2ET](https://www.ti.com/tool/MSP-EXP430G2ET) - For a complete list, check the document [SLAU647](https://www.ti.com/lit/slau647) - XDS110: Standalone XDS110 [TMDSEMU110-U](https://www.ti.com/tool/TMDSEMU110-U), LaunchPads with built-in XDS110 technology - The XDS110 EnergyTrace HDR Add-on [TMDSEMU110-ETH](https://www.ti.com/tool/TMDSEMU110-ETH) is also supported - XDS100: v1, v2 and v3 - XDS200: USB [TMDSEMU200-U](https://www.ti.com/tool/TMDSEMU200-U), LAN [XDS220](http://www.spectrumdigital.com/xds220-usb-ethernet-jtag-emulator/) - TM4C/Tiva/Stellaris ICDI as well as CC3200 LaunchPad - Spectrum Digital: XDS560v2 [TMDSEMU560V2STM-UE](https://www.ti.com/tool/TMDSEMU560V2STM-UE), XDS ProTrace [TMDSEMUPROTRACE](https://www.ti.com/tool/TMDSEMUPROTRACE) - Blackhawk: XDS560v2 USB [TMDSEMU560V2STM-U](https://www.ti.com/tool/TMDSEMU560V2STM-U), XDS560v2 Ethernet - SEGGER J-Link - Not all TI devices are supported. Check [Segger's device list](https://www.segger.com/products/debug-probes/j-link/technology/cpus-and-devices/overview-of-supported-cpus-and-devices/) ## Not Supported ## - MSP430: MSP-FET430PIF (Parallel port), Launchpads and Experimenters kits that use eZ430 technology such as Chronos, [MSP-EXP430G2](https://www.ti.com/tool/MSP-EXP430G2) and [MSP-EXP430FR4133](https://www.ti.com/tool/MSP-EXP430FR4133) LaunchPads. - **Note:** the [MSP-EXP430G2ET](https://www.ti.com/tool/MSP-EXP430G2ET) is supported. - For a complete list, check the document [SLAU647](https://www.ti.com/lit/slau647) - Stellaris ICDI based on FTDI - Blackhawk: USB2.0, XDS560 PCI, XDS560T, XDS510, USB560, USB560m, USB560bp - Spectrum Digital: XDS510, XDS560R, Parallel Port emulators - Texas Instruments: XDS560 PCI, XDS510 ISA - In general vendors are not supporting PCI, ISA or parallel port emulators on Linux For information on a specific debug probe please contact the manufacturer. # Distribution Validation # CCS is validated on a defined set of Linux distributions. Typically these are active Ubuntu LTS versions. # Installation Instructions # CCS requires a 64-bit distribution of Linux. 32-bit distributions are not supported with current versions of CCS. There is one 32-bit library required to support the compilers. From a terminal prompt, issue the following command to install it: <tt>sudo apt install libc6:i386</tt>. Please note that certain versions of Ubuntu require to use <tt>libc6-i386</tt> instead. IMPORTANT! TI performs testing on actively supported Ubuntu LTS distributions only and provides instructions for other distributions as a reference - sometimes these instructions are kindly provided by other developers with the intention to help others. In this case, consider these releases as unsupported and untested. NOTE: Certain older SDKs and Compiler installers could hang when installing on a system with glibc2.26 and greater. While the component is installed correctly, the installer doesn't exit. In order to complete your installation of the component, kill off the hanging installer and remove the downloads folder from the <installdir>/eclipse directory, if it exists. NOTE: it is possible to install CCS as a superuser using sudo (gksu is not recommended), which automatically adds all the required driver udev rules at the end of the process. However this requires extra steps for regular operation of CCS as a regular user. Check the application note [Configuring CCS for multiuser](./application_notes/appnote-configuring_ccs_for_multiuser.html) for details. - When installed as superuser using sudo, CCS must be run at the same privilege level to install updates. - When installed and run as superuser using sudo, there may be some IBus warning messages that appear in the terminal. These messages can be ignored, as they will not impact the execution of CCS. This can be avoided by specifying <tt>sudo -H</tt> when running the CCS installer. ## Ubuntu 21.04 ## - Tested on 21.04 - Please note that CCS is not officially tested on this version. - update system: <tt>sudo apt update</tt> - install dependent libraries: <tt>sudo apt install libc6:i386 libusb-0.1-4 libgconf-2-4 libncurses5 libpython2.7 libtinfo5</tt> - install CCS - if CCS was installed as user then run the driver install script - go to <CCS_INSTALL_DIR>/ccs/install_scripts - <tt>sudo ./install_drivers.sh</tt> ## Ubuntu 20.04 LTS ## - Tested on 20.04 initial release - Please note that CCS is not officially tested on alpha versions. - update system: <tt>sudo apt update</tt> - install dependent libraries: <tt>sudo apt install libc6:i386 libusb-0.1-4 libgconf-2-4 libncurses5 libpython2.7 libtinfo5</tt> - install CCS - if CCS was installed as user then run the driver install script - go to <CCS_INSTALL_DIR>/ccs/install_scripts - <tt>sudo ./install_drivers.sh</tt> ## Ubuntu 19.10 STS ## - Tested on 19.10 - Please note that CCS is not officially tested on this version. - update system: <tt>sudo apt update</tt> - install dependent libraries: <tt>sudo apt install libc6:i386 libusb-0.1-4 libgconf-2-4 libgtk2.0-0 libncurses5 libpython2.7 libtinfo5 build-essential</tt> - install CCS - if CCS was installed as user then run the driver install script - go to <CCS_INSTALL_DIR>/ccs/install_scripts - <tt>sudo ./install_drivers.sh</tt> ## Ubuntu 18.04 LTS ## - Tested on 18.04.4 bionic (with canonical partners repository enabled) - update system: <tt>sudo apt update</tt> - install dependent libraries: <tt>sudo apt install libc6:i386 libusb-0.1-4 libgconf-2-4 build-essential</tt> - install CCS - if CCS was installed as user then run the driver install script - go to <CCS_INSTALL_DIR>/ccs/install_scripts - <tt>sudo ./install_drivers.sh</tt> # Proxy server considerations # Certain functions of Code Composer Studio require access to the Internet. In general, this works well for connections that do not require a proxy server, but in certain cases its use is mandatory by the corporate IT department. Linux poses a challenge to configure proxy servers due to the nature of its various components and where they inherit its settings. For example, it is not uncommon to have a web browser fully connected to the internet while the aptitude or yum utilities (used to install system features or dependencies) is unable to do so. In this case, it is important to observe a few aspects during CCS setup and runtime. - The proxy server configuration can be set during the installation options. This is critical for a successful install if using the On-demand installer (web installer), as each component must be downloaded individually. - The system update utility (apt, yum, etc.) has its own configuration files to set up a proxy, typically text files under the subdirectory /etc. To properly configure these utilities, please refer to your distro instructions. - The system wide proxy setting is usually accessible via the GUI of choice (Gnome, KDE, etc.) and is normally present under the Network settings. This setting is inherited by the Eclipse features of Code Composer Studio, namely the ability to access its update sites to update the various components of an install (compilers, emupack, etc.) - The shell environment variable <tt>http_proxy</tt> (and its counterparts <tt>https_proxy</tt> and <tt>ftp_proxy</tt> not used by CCS) are inherited by the browser built into Code Composer Studio to access its online content and download the various SDK packages. In general this environment variable is set at the system wide shell init script (<tt>/etc/bash.bashrc</tt>, for example) but this can also be set by each user on its local shell <tt>~/.bashrc</tt>. - The scope where this configuration will reach is highly dependent on the install and definitely some experimentation is necessary. - In this case, experimentation can be done by setting the environment variable exclusively during the invocation of Code Composer Studio from a command line. For example, from a bash shell the proxy environment variable can be set prior to running CCS as: **user@host:~/ti/ccs1000/ccs/eclipse$**<tt>http_proxy=myproxy.mycompany.com:80 ./ccstudio &</tt>    <div id="footer"></div>