Compiler Installation and Selection

From Texas Instruments Embedded Processors Wiki

Jump to: navigation, search


  • Image:Google-16x16.png Search for an article here:


Contents

Overview

Code Composer Studio (CCStudio) comes bundled with a version of the TI Code Generation Tools (CGT) for each supported Instruction Set Architecture (ISA). The CCStudio IDE default configuration is to use the CGT installation that it comes with when building a project. However there are many instances when the developer would need to use a different installation of the CGT to pick up the latest fixes and enhancements provided in later versions, or because they wish to use an older "tried and true" version to avoid potential migration pains of using a new CGT. In these cases, the developer can configure CCStudio to use a different installations of the CGT that exists on their machine.

CCStudio 3.x

  1. Download the code generation tools.
    • The best place is to go to is the Update Advisor (only works while CCS maintenance license is up-to-date).
      • Go to Help -> Update Advisor -> Check for updates.
      • Click on Code Generation Tools Updates.
    • Another option that does not require an up-to-date CCS license is to download the tools from here. Note that ARM code generation tools are not available on this page but they are available through the Update Advisor.
  2. Install the updated tools.
  3. Open the Component Manager:
    • If CCS is not open, the best/easiest way is to go to Start -> Program Files -> Texas Instruments -> Code Composer Studio 3.3 -> Component Manager.
    • If CCS is already open, it's easiest to go to Help -> About and then click the Component Manager button.
  4. Under Build Tools expand the ISA corresponding to the processor you are using.
  5. The newly installed code generation tools should now show up and can be selected.
  6. File -> Save.
  7. File -> Exit.
  8. Restart CCS if CCS was open.
  9. Double-check your project options to be sure there are no hard-coded paths to a previous codegen version. Note that it is not necessary to explicitly add the compiler's include directory to your project as CCS will handle that for you based on your selected code generation tools in the Component Manager. The same applies for the compiler's lib directory, i.e. the path will be automatically added for you. So by not adding these paths to your project CCS will always pick up the header files and libraries from the currently selected code generation tools.

CCStudio 4.0

CCStudio v4 determines the list of CGT installations available to it by searching the CGT 'Discovery Paths' for supported CGT installations. The paths to the CGT installations that come with CCStudio are part of the discovery paths by default. One benefit of CCStudio v4 over previous version of CCStudio is that the CGT installation does not have to be a "CCStudio Friendly CGT Package" to be detected by CCStudio v4. Any standard drop of the CGT can be used. To add to the list of available CGT installations to CCStudio, simply add the root location of the custom CGT installation to the list of discovery paths:

  • Select 'Windows->Preferences...'
  • Expand the 'CCS' node in the left pane
  • Select the 'Code Generation Tools' node underneath.

This will provide a list of all the CGT discovery paths used by CCStudio for each ISA under the 'Discovered Tools' section:

Fig. 1: CGT Discovery Paths Dialog

Note the 'Extended tool discovery path' section. It is here where additional custom discovery paths can be added so CCStudio can discover additional CGT installations to use.

  • Click the 'Add...' button to browse to the location of the custom CGT installation you wish to add to the list of 'Discovered Tools'.

The location can be the either the root folder of the installation or one parent higher. The root folder of a CGT installation would have a 'readme.1st' file and subfolders of 'bin', 'include', and 'lib'.

Fig. 2: Adding a New CGT Discovery Path

Once the new path has been added, CCStudio will then rescan all the discovery paths (including the newly added path) and refresh the 'Discovery Path' dialog. If a newly added path contains a supported CGT installation, it will appear in the list of 'Discovered Tools' under the applicable ISA:

Fig. 3: New CGT Installation Discovered

In the screenshot above, the newly added discovery path appears in the 'Extended tool discovery path' list and under 'Discovered Tools', a "new" C6000 CGT installation is discovered (v6.0.8). The newly discovered installation is now available for use.

  • Right-click on the desired project and select 'Build Properties...'
  • Click on 'CCS Build' in the left pane.
  • Choose the desired compiler version for this project and configuration (e.g. Debug/Release) using the "Code Generation Tools" selection box.
  • Click the 'Apply' button.
  • Click 'OK' to select 'Apply changes to existing build configuration'
  • Do the same for the Release configuration or any other build configurations for which you want to use this compiler version (typically all of them).

Notice how the version for the custom CGT installation (v6.0.8 for this example) will now appear in the drop down menu for 'Code Generation tools version' when previously there was only one option in the menu:

Fig. 4: Specifying the Custom CGT Version

In the example above, the 6.0.8 version of the C6000 CGT has been specified to be used when building the 'Debug' configuration for the specified project.

Also note the 'More...' button next to 'Code Generation tools version' drop down menu. This button will bring up another dialog box which to allows you to add a CGT discovery path with the 'Select tool from file-system' option. Selecting a CGT discovery path from this option has the same effect as selecting from the CGT 'Discovery Paths' dialog previously shown (and will appear in the 'Extended tool discovery path' list if the CGT 'Discovery Paths' dialog is opened).

Supported CGT Versions

The following version of the CGT are supported by CCStudio v4:

Supported TI CGT Versions
C2000 C5400 C5500 C6000 ARM MSP430
4.1.x 4.1.x 4.0.x 5.3.x 2.54 2.0.x
5.0.x - 4.1.x 6.0.x 2.71 3.0.x
5.1.x - 4.2.x 6.1.x 4.1.x 3.1.x
5.2.x - 4.3.x 7.0.x 4.4.x 3.2.x
- - - - 4.5.x -
4.6.x

If the CGT version is not supported, CCStudio may still discover the CGT installation and add it to the list of discovered tools. However there will be a warning or error associated with the entry. A warning is often given if there is at least a major version number match but its minor version is not supported (ex. C6000 v5.1.2). For a warning, the CGT installation may work but the information in the build settings dialog describing the options may appear incorrect. If there is no major version match then an error is specified and attempting to use that CGT version with CCStudio v4 will likely cause problems.


For technical support please post your questions at http://e2e.ti.com. Please post only comments about the article Compiler Installation and Selection here.
Leave a Comment

Comments

Comments on Compiler Installation and Selection


A0322160 said ...

The table of supported CGT versions needs to be updated. For example, the table lists the highest supported version of MSP430 CGT as 3.2.x, while CCSv4.1.3 is now available and downloads with MSP430 cgtoolsv3.3.0.

--A0322160 15:55, 18 August 2010 (CDT)

Personal tools