5.1. Getting Started View

First time users of Code Composer Studio (CCS) should start with the aptly named Getting Started view. The Getting Started view is the first screen that is visible once you have launched CCS and selected a workspace. The view can also be explicitly opened via the View -> Getting Started menu item.

The purpose of the Getting Started view is to provide fast access to common actions and tasks, especially those that are relevant when first starting to use CCS. This includes browsing examples, creating new projects, and so forth:

image0

For more details, please refer to the Getting Started view feature overview.

5.2. Resource Explorer

The Resource Explorer helps you find all the latest examples, libraries, demo applications, data sheets, and more for your chosen platform.

The Resource Explorer can be opened from the Resource Explorer button in the Getting Started view or from the View -> Resource Explorer menu item.

image1 image2

Filtering by device, or by TI LaunchPad Kit, the interface enables you to filter the content to only what is relevant to your chosen platform.

Use the Select Board or Device filter field to search and select the device or TI LaunchPad Kit that you are using. For example, if you are using the CC2640R2 LaunchPad, you can starting typing “cc2640” in the search field to filter the list to easily find your LaunchPad:

image4

If you have a valid TI kit (such as a LaunchPad Development Kit) connected to your computer, Resource Explorer may be able to autodetect it. If autodetect is successful, you can select the USE MY BOARD option to specify your kit:

image3

Once your device or TI LaunchPad Kit is selected, the filter will be applied and only content relevant to your selection will be displayed. You can now browse through the displayed content to learn more about your device, board, relevant tools, and available software packages.

image5

The best way to get going with software development on your target is to start with some existing examples for your target. Many examples are included with the software package with supports your device, and many of these software packages are accessible right from Resource Explorer.

Note

Not all devices are supported via Resource Explorer. Please see the device family specific information in the next few sections for more details.

5.3. Device Family Specific Information

Please refer to the section below that is applicable for your device.

5.3.2. C2000

The best place to start is with the C2000 Fundamentals Workshop for CCS: English | Chinese (中文).

It can be found in Resource Explorer by browsing to the following location: Development Tools -> Code Composer Studio -> General and IDE -> Training -> Workshops -> C2000 Fundamentals Workshop for CCS.

Once the above workshop is completed, more examples, resources, and documentation can be found in the C2000Ware package in Resource Explorer.

5.3.3. mmWave

The best place to start is with the setup guide for the mmWave SDK Demo:

xWR14xx

It can be found in Resource Explorer by browsing to the following location: Software -> mmWave Sensors -> Industrial Toolbox -> Labs -> mmWave SDK Demo - 14xx -> Setup Guide.

xWR16xx

It can be found in Resource Explorer by browsing to the following location: Software -> mmWave Sensors -> Industrial Toolbox -> Labs -> mmWave SDK Demo - 16xx -> Setup Guide.

xWR68xx

It can be found in Resource Explorer by browsing to the following location: Software -> mmWave Sensors -> Industrial Toolbox -> Labs -> mmWave SDK Demo - 68xx -> Setup Guide.

Once the above guide is completed, more examples, resources, and documentation can be found in the mmWave Sensors package in Resource Explorer.

5.3.4. MSP430

The best place to start is with the MSP430 Fundamentals Workshop for CCS.

It can be found in Resource Explorer by browsing to the following location: Development Tools -> Code Composer Studio -> General and IDE -> Training -> Workshops -> MSP430 Fundamentals Workshop for CCS.

Once the above workshop is completed, more examples, resources, and documentation can be found in the MSP430Ware package in Resource Explorer.

5.3.5. TM4C

The best place to start is with the TM4 Fundamentals Workshop for CCS.

It can be found in Resource Explorer by browsing to the following location: Development Tools -> Code Composer Studio -> General and IDE -> Training -> Workshops -> TM4 Fundamentals Workshop for CCS.

Once the above workshop is completed, more examples, resources, and documentation can be found in the TM4C ARM Cortex-M4F MCU package in Resource Explorer.

5.3.6. Automotive Processors (TDAx/DRAx)

It is recommended to follow the Processor SDK RTOS Automotive Getting Started Guide.

5.3.7. Sitara/C66x/66AK2x/OMAP-L1x

It is recommended to follow the Quick Start Guides for the Processor SDK:

5.3.8. Hercules

It is recommended to follow the tutorials for the various Hercules LaunchPads available from the Hercules LaunchPad wiki site.

5.3.9. C55x

It is recommended to start working with the examples found in the C55x Ship Support Library (CSL) and C55x DSP Library (DSPLIB). Please see the C55x Digital Signal Processors Software Overview video module for more information.

Since the examples mentioned in the above libraries are not available from Resource Explorer, manual steps will need to be taken to import/build/debug/run the project into CCS. Please refer to the next few sections below for more information.

Warning

CCS does not come bundled with the C55x compiler. It can be obtained from the CCS App Center.

5.4. Importing a CCS Project

CCS projects must be imported into the current CCS workspace before they can be used. The most convenient way to import example CCS projects is from Resource Explorer, as mentioned in some of the sections above.

If the example project is not available from Resource Explorer, then the project can be manually imported using the Import CCS Eclipse Projects wizard:

  1. Go to menu Project -> Import CCS Projects.

  2. Next to Select search-directory, click Browse and browse to the location of a project OR if the project is available as an archive, then choose Select archive file and click on Browse to browse to archive.

  3. Select the desired project(s) from the list of Discovered projects.

  4. Leave the Copy projects into workspace option checked if you want to copy the projects into the workspace, otherwise uncheck the box. If unchecked, the project will continue to reside in its original location and all modifications/actions taken on the project will modify it in its original location.

    image7

If the Copy projects into workspace option is checked, everything in the project folder will be copied to the workspace. That includes the project files and any source files that are present within the project folder. If the original project has linked resources those will NOT be copied to the workspace. Before editing resources make sure to check if the project references linked resources from another location. Refer to this section on linked files for more information.

  • Depending on how the original project was created (whether it was made portable or not) it may not be advisable to check the box to copy project into workspace as it could break paths to some of the resources.
  • Example projects in most TI software packages (such as TivaWare, ControlSuite, C2000Ware, SimpleLink SDK) are designed such that they CAN be safely copied to the workspace.

Once the project has been imported into the workspace, it will be visible in the Project Explorer view.

image8

When a project created with an older version of CCS is imported into the workspace of a newer CCS version, the project will be migrated to support the newer version of CCS. This may prevent the project from being imported or opened again with the older CCS version. This is especially true for major CCS revision number differences (CCSv9 -> CCSv8) while minor revision number differences (CCS8.3 -> CCS8.2) may not be impacted as much.

One way to work around this is to check the option Copy projects into workspace when importing the project into newer CCS. That way each version of CCS can open its own version of the project as they are in different workspaces.

The same rule also applies when a project created in a newer version of CCS is imported into an older version of CCS. CCS projects are not backward compatible. If you want to use a CCS v9 project with CCSv8, for example, it is best to create a new project in CCSv8 and copy over the source files and settings.

For more information on importing CCS projects, please refer to the relevant section in the Projects and Build chapter.

5.5. Creating a New CCS Project

Creating a new CCS Project from scratch requires a bit of prior knowledge about the device. Hence, it is recommended to always start with an existing CCS example project first - assuming one exists. Once some experience is gained working with the existing example, one can look to creating a new CCS project from scratch. There are also rare cases where a CCS example does not exist for a particular device. This is also another scenario where one would want to start with creating a new CCS project.

To create a new CCS project, follow the steps below:

  1. Go to menu Project -> New CCS Project… or File -> New -> CCS Project.

  2. In the New CCS Project wizard:
    • Type or select the Target device.
    • Optionally select a Connection type if it is not auto-populated (or the auto-populated value is incorrect).
    • Type in a Project name.
    • Optionally de-select the Use default location check box and set the project storage location. By default, the project will be created inside the workspace directory.
    • The Compiler version will default to the latest version of compiler tools that CCS has discovered for that device family. You can change the Compiler version if there is more than one version in the drop-down list.
    • Tool-chain contains a few default settings for the project based on the Target selected. This includes Output type which defaults to Executable but you can select between creating an Executable project or a Static Library project. An Executable project generates an executable file (.out) that can be loaded and executed on a target device. A Static Library project generates a library of object modules.
    • Lastly, select a Project template/example as a starting point, and click Finish. Alternately, if the option is presented, you may open Resource Explorer to browse and import example CCS projects.

    image9

  3. The new project will appear in the Project Explorer view and will be set as the currently active project.

  4. Depending on the template selected, some source files are added to the project by default to ease the process of building and loading the program to the target device. You may add your own source files to the project and customize it further using the Project Properties dialog.

    image10

For more information on creating non-CCS projects, please refer to the relevant section in the Project Management and Build chapter.

Warning

Depending on the device, compiler, and template used, additional manual changes may be needed to the project. This could include adding additional initialization code or linker command files. This requires additional expertise on the device, hence why it is strongly recommended to start with an existing example if possible.

Once a new project has been created, additional source files can be added or linked to the project. Please refer to the relevant section in the Project Management and Build chapter.

5.6. Building and Running Your Project

Once your project has been created/imported and any necessary manual changes completed, the project can then be compiled and loaded to the target for execution/debug. There is one easy option to do all this - using the Run -> Debug menu. This menu item will automatically do the following:

  • Prompt to save source files (if necessary).
  • Build the project (incrementally).
  • Start the debugger (CCS will switch to the CCS Debug perspective).
  • Connect CCS to the target.
  • Load (flash) the program on the target.
  • Run to main.

Note

The above sequence of steps can be customized by modifying the debugger options. It is also possible to just only build the project (Project -> Build Project) without starting the debugger. Please refer to the relevant section in the Project Management and Build chapter and the Debugging chapter for more information.

image11