Using SDK with CCS Projects

Table of Contents

• Introduction
• CCS Projectspec and CCS Projects
• Import a Project in CCS
• Browse a Project in CCS
• Build a Project in CCS
• Build System Projects in CCS
• Delete a Project in CCS

Note

The steps on this page show screen shots and description based on Windows. However the steps in Linux would remain the same, unless mentioned otherwise.

By default, CCS import of SDK example projects performs a copy of example files to CCS workspace. User are free to modify the example files without affecting the files in the SDK installed location.

Deleting the CCS project, deletes the project files from CCS workspace. User should be careful especially when the copied example files are modified by user.

The screen shots shown on this page are for AM64x MCU+ SDK v7.3.0. You would see your specific SOC and SDK version that is installed. However the instructions and steps mentioned remain the same, unless mentioned otherwise.

Introduction

All SDK examples can be built using CCS projects. Using CCS projects one can also open SysConfig from within CCS itself to configure the example. This section provides basic instructions and tips on using CCS projects.

Note

To re-build libraries you need to use makefiles, see Using SDK with Makefiles

CCS Projectspec and CCS Projects

• When a example project is imported into CCS, what is really getting imported is a projectspec file.
• This file is a definition or blueprint of a CCS project, like compiler options, files to compile, libraries to link.
• CCS takes the projectspec as input and then generates CCS project files in the user workspace.
• Default workspace is,

  C:/Users/{user name}/workspace_v{CCS major version}/{project name}/

• The projectspec is also human readable, i.e you can open it in a text editor to see all the different options for that project.

Import a Project in CCS

• First open the "project explorer" as shown below

Project Explorer

• "Right-click" in the project explorer window to import a project

Project Import

• All examples follow below naming convention to help you easily pick the example you need

  {example name}_{soc board}_{cpu}_{os}_{compiler toolchain}

• You can also navigate to the example folder to pick a specific example. All examples are organized as below in the examples folder.

  examples/{component or module}/{optional sub-module or sub-component}/
                 |
                 + -- {example name}/{board on which this example can run}/
                                       |
                                       + -- {cpu}_{os}/{compiler toolchain}
                                                              |
                                                              + -- example.projectspec  --> This is the file that CCS imports.

Browse a Project in CCS

• You can explore other project files by clicking on them.

Build a Project in CCS

• To build a project "right-click" on the project name and select "Build Project" to build it
• You can explore additional project options in the same menu.

Build System Projects in CCS

• Some examples, to run correctly, need multiple binaries on different CPUs to be built, loaded and run. Such examples have "system projects" associated with them. One such example is inter-processor communication example, which shows multiple CPUs communicating among each other.
• System project have a naming convention as below

  {example name}_{soc board}_system_{os or tag}_{compiler toolchain}

• And the project file is located at

  examples/{component or module}/{optional sub-module or sub-component}/
                 |
                 + -- {example name}/{board on which this example can run}/
                                       |
                                       + -- system_{os or tag}/
                                                     |
                                                     + -- system.projectspec  --> This is the file that CCS imports.

Delete a Project in CCS

• To delete a imported project "right-click" on the project name and select "Delete" to delete it.
• Note, that deleting a project, only deletes it from your CCS workspace, the .c, .h and other project files are located with the ${SDK_INSTALL_PATH}/examples and these are not deleted.
• You can reimport a project later as needed.