GSG:CCSv5.0 Creating projects

IMPORTANT! This Getting Started Guide was designed to be used only with Code Composer Studio 5.0.x and pre-releases of 5.1.x.
Creating Projects

---

Introduction

This section describes the general steps required to create a project in CCSv5.
In addition, a short video clip at the section Tutorial video below shows an example of creating a project in CCSv5.

Creating a project

Once the welcome screen is closed, then the workspace is shown and a new project can be created.

For version 5.0.x

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

2. In the Project Name field, type the new project name. The Use default location option, enabled by default, will create the project in your workspace folder. Uncheck the option to select a new location (by using the Browse… button). Click Next.

3. Select the architecture to be used in the Project Type: drop-down menu. Click Next.

Note: The exact device will be selected in step 5.

• If the project is for Cortex devices (Stellaris or Hercules), select ARM.
• If the project is for SoC devices (DaVinci, OMAP), select either ARM or C6000 depending on the core used.

Optional. This screen also allows selecting or adding build configurations for the project. Debug and Release are enabled by default.

4. Usually can be left blank, but if the project depends on other projects to be built first (like static library projects) select them here. Click Next.

Optional. The C/C++ Indexer tab configures the level of the indexer, a CCS feature that creates a list of source-code information that enables auto-complete and go to definition features in the editor. The default option is to use the workspace global settings, but the options can be set for each project as well.

5. Most of the options in this next screen can be left as default. Depending on the selections, additional screens will be shown.

• Device Variant: Choose the device to be used, based on the device family specified in step 3. Some families like C6000 have generic devices, while others like MSP430 are very specific. The first drop-down box is a general filter, while the second drop-down box is the device selector itself.

Optional. The other options can be left with the default values.

• Output type: Leave the setting as Executable to build a complete program. The other option is Static Library, which is a collection of functions to be used by other projects.
• Code Generation tools: Leave the default setting, unless additional versions of the code generation tools are installed and a specific one should be used.
• Output Format: Typically this option is greyed out to legacy COFF. Currently, only the ARM family allows selecting also eabi (ELF).
• Linker Command File: Can be left blank - a linker command file can be added later. If a valid file is available this field is pre-populated. If the project uses BIOS, a linker command file will be added automatically.
• Runtime Support Library: Usually leave it in <automatic>, since the Code Generation Tools automatically selects the correct runtime library. If needed, a different runtime support library can be selected here.

6. Click Next. This next screen contains several templates to create empty projects, pre-configured projects for standard C/C++, SYSBIOS, IPC, DSP/BIOS, etc.

7. Click Finish to create the project. It will be displayed in the C/C++ Projects tab and ready to create or add source files.

8. To create files for your project, right-click on the project name in the C/C++ Projects view and select New --> Source File. In the opened box type the name of the file with a valid extension for the type of the source code (.c, .C, .cpp, .c++, .asm, .s64, .s55, etc). Click Finish.

9. To add existing source files to the project, right-click on the project name in the C/C++ Projects tab and select Add Files to Project to copy the source files to the project directory.

Another option is to select Link Files to Project to create a reference to the file, but leaving it in its original directory. This is necessary if the source code includes files in a very specific directory structure.

For version 5.1.x

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

2. In the Project Name field, type the new project name. The Use default location option, enabled by default, will create the project in your workspace folder. Uncheck the option to select a new location (by using the Browse… button).

3. Output type: Leave the setting as Executable to build a complete program. The other option is Static Library, which is a collection of functions to be used by other projects.

4. In the Device Section:

a) Select the architecture to be used in Family: drop-down menu.

• If the project is for Cortex devices (Stellaris or Hercules), select ARM.
• If the project is for SoC devices (DaVinci, OMAP), select either ARM or C6000 depending on the core used.

b)Variant: Choose the device to be used, based on the device family. Some families like C6000 have generic devices, while others like MSP430 are very specific. The first drop-down box is a general filter, while the second drop-down box is the device selector itself.

Optional. The other options can be left with the default values.

• Output type: Leave the setting as Executable to build a complete program. The other option is Static Library, which is a collection of functions to be used by other projects.
• Code Generation tools: Leave the default setting, unless additional versions of the code generation tools are installed and a specific one should be used.
• Output Format: Typically this option is greyed out to legacy COFF. Currently, only the ARM family allows selecting also eabi (ELF).
• Linker Command File: Can be left blank - a linker command file can be added later. If a valid file is available this field is pre-populated. If the project uses BIOS, a linker command file will be added automatically.
• Runtime Support Library: Usually leave it in <automatic>, since the Code Generation Tools automatically selects the correct runtime library. If needed, a different runtime support library can be selected here.

5. Click Next. This next screen contains several templates to create empty projects, pre-configured projects for standard C/C++, SYSBIOS, IPC, DSP/BIOS, etc.

6. Click Finish to create the project. It will be displayed in the Project Explorer tab and ready to create or add source files.

7. To create files for your project, right-click on the project name in the C/C++ Projects view and select New --> Source File. In the opened box type the name of the file with a valid extension for the type of the source code (.c, .C, .cpp, .c++, .asm, .s64, .s55, etc). The Template window allows you to select between "Default C++ source Template", "Default C source Template". Click Finish.

8. To add existing source files to the project, go to Project --> Add File ... --> to copy the source files to the project directory.

Another option is to select Link Files to Project to create a reference to the file, but leaving it in its original directory. This is necessary if the source code includes files in a very specific directory structure.

Building the project

Once the project is created and all the files are included or created, it is necessary to build it.

1. Go to menu Project --> Build Project.

Note: If any build errors are encountered and no executable file is created, a error or warning message will appear in the console window at the bottom of the screen and a debug session will not be started.

Configuring Build Settings

For version 5.0.x:
To configure the build settings, right-click on the project in the C/C++ Projects view and select Build Properties…. There are several options for the compiler, assembler and linker.

Note: If you want to set the properties for a single source file in the project, simply right-click on it and select Properties.

For version 5.1.x:
To configure the build settings, right-click on the project in the Project Explorer view and select Build Settings…. There are several options for the compiler, assembler and linker

Note: If you want to set the properties for a single source file in the project, simply right-click on it and select Properties.

Tutorial video

Here is a short video clip that shows the entire process described above:

http://software-dl.ti.com/sdo/sdo_apps_public_sw/CCSv5/Demos/GSG_Creating_projects_v5/GSG_Creating_projects_v5.html

• Format: SWF
• Resolution: 1024x768
• Color depth: 24 bit
• Size: 3.302.906 bytes

What's next?

Now that you have finished creating your new project in Code Composer Studio v5, please continue on to the Project Debugging section of the CCSv5 Getting Started Guide.

---