SYS/BIOS CCS6 Migration Guide

Overview

Concurrent with the CCS6 release, the latest release of SYS/BIOS (6.40.0) is being made available as part of the TI-RTOS product. TI-RTOS includes SYS/BIOS, peripheral drivers, and communication stacks often used in modern embedded applications. If you are a new user, we recommended that you simply install TI-RTOS from the new CCS6 App Center and use the SYS/BIOS kernel it provides.

If, on the other hand, you need to develop using legacy (pre-6.40.0) releases of SYS/BIOS within CCS6, additional one-time setup/installation steps are necessary. In outline, these steps are:

1. Install the desired version of SYS/BIOS and the version of XDCtools that's recommended for use with this version of SYS/BIOS. (details)
2. Configure your workspace to use this version of XDCtools by default when creating new projects. (details)

The remainder of the document describes, in detail, how to install legacy versions of SYS/BIOS into CCS6.

Installing Legacy SYS/BIOS and XDCtools

Get SYS/BIOS and XDCtools

If the versions of SYS/BIOS and XDCtools that you need are already on your hard disk, you can skip this section; otherwise,

• Get the desired SYS/BIOS version from here and note the recommended version of XDCtools to use that's listed on this page.
• Get the version of XDCtools recommended for use with your version of SYS/BIOS from here.

Install SYS/BIOS and XDCtools

Before installing SYS/BIOS, make sure CCS is not running, closing CCS if necessary. Install SYS/BIOS and XDCtools as follows:

• If SYS/BIOS and XDCtools are not already on your hard disk, run the installers for SYS/BIOS and XDCtools to unzip their content into the one of the CCS6 "Product Discovery" directories (e.g., C:/ti.)
• Start CCS and wait for the Import dialog to appear.
• Check the newly discovered SYS/BIOS and XDCtools that you want to install and click Finish.
• When prompted to restart CCS, click Yes.

Configuring Your Workspace To Use a Legacy XDCtools

By default, when CCS creates new projects, the latest version of XDCtools is automatically selected. When working with legacy SYS/BIOS releases, however, it is often desirable to change this default to be the recommended version of XDCtools to use with your version of SYS/BIOS.

You can change the default version of XDCtools used in new projects as follows:

• Open your workspace preferences by selecting Workspace > Preferences.
• Navigate to Code Composer Studio > RTSC.
• Select the legacy version of XDCtools from the "XDCtools version:" pull-down list.
• Click OK.

Note: If you plan to create SYS/BIOS 6.40.0 (or TI-RTOS 2.0) projects, you should create a separate workspace for these projects in which the default XDCtools version is not specified. This ensures that new projects are always created referencing the latest installed version of XDCtools.

Other Topics

Importing existing SYS/BIOS projects

Once you've installed the legacy SYS/BIOS and XDCtools used in your existing project, you can import your SYS/BIOS projects as you would any other existing Code Composer Studio project:

• Select File->Import... .
• Select Code Composer Studio->Existing CCS Eclipse Projects and click Next.
• Browse to the directory containing the existing project and click Finish.

Note: If you haven't installed exactly the same version of XDCtools used in the legacy project, the latest version will be automatically selected and your build will likely fail. However, you can use any compatible version of XDCtools in your project; i.e., any version in which the first two components are the same. For example, 3.25.00 and 3.25.05 are compatible.

• Open the project properties by right-clicking on the project and selecting Properties
• Select the General category in the left-side of the dialog and click the RTSC tab in the right-hand side.
• Select any compatible version of XDCtools to use via the "XDCtools version:" pull-down list, and click OK

Viewing and changing the product discovery directories

The directories searched for new products are shown by the Windows > Preferences > Code Composer Studio > RTSC > Products dialog. This dialog also allows you to add other directories that will be searched.

Known issue with CCSv6.0.0 only

If you installed CCSv6.0.0 and are trying to use the RTSC platform editor to edit a custom platform, keep in mind this is not possible due to a bug found after CCS was released (check this bugzilla entry). In order to make this work again, please update your RTSC tools to version 3.30.02.xx, which can be done via CCS App Center.