GSG:CCSv5 Running for the first time

Running Code Composer Studio for the first time

---

Defining the workspace directory

The first thing CCSv5 asks is to define a workspace - a directory that holds all elements (projects, links to projects, possibly source code) used in the development.

• Differently than CCSv4, by default the workspace is created under the C:\Users\<user> or C:\Documents and Settings\<user> directory, but its location is arbitrary.
• Every time CCSv5 is executed it will ask for the workspace directory. If you plan to use just a single directory for all your projects, just check the option Use this as the default and do not ask again. The workspace can always be changed later from inside CCSv5.

Fig. 1: selecting the workspace location

Choosing the license

1. Update as of Dec 2016 CCSv5 full license can be downloaded from the link below. There are no restrictions in regards to time, code size, debug probe or target used.

CCS Full License

2. In the pop up license screen, select Activate and then click on Next button

Fig. 2: License options

3. Click on Browse under Specify a License File. Point to the place where you saved the license file downloaded above. Click Finish.

Fig. 3: activate license file

All of the below (collapsed) information is now legacy information.

---

Expand

Old licensing information (Obsolete)

Choosing the license

CCSv5 requires an active license, therefore depending on the installation and selected components the screens below are shown just after startup.

Fig. 2: license options with MSP430 and an expired 30-day evaluation license

Fig. 3: license options on a clean computer and without MSP430 support installed

There are a number of different license options in CCS, and their details are shown in the section License Types of the page Licensing CCS.

• If you already have a purchased a license and received the license file via e-mail, follow steps 9 through 11 of the EVALUATION or EXTENSION process below.
• If you are just doing Linux Application Debug then no license is needed. Click Cancel.
• If CCS was provided with a development board, the license is already activated and this section can be skipped.
• If a license file (that has an extension .lic) is installed or a license server is appropriately configured in your system, CCS will detect it and this section can be skipped.

90-day EVALUATION (Windows), FREE or CODE SIZE LIMITED (MSP430)

The 90-day evaluation license in Windows (renewable for more 90 days) enables the use of all the features of CCS for a limited period of time.
The free license allows the use of CCSv5 to debug using the low cost XDS100 emulators, emulation built onto standard EVM/DSP/eZdsp development boards, or simulators.
If MSP430 support was installed, the Code Size Limited (MSP430) allows the use of CCSv5 with MSP430 microcontrollers at no cost.

• There is no need to have an active Internet connection.
• CCSv5 can be used right from the start, since it is activated directly on the PC.
• To use a different license or extend the evaluation period you can go to Help --> Code Composer Studio License Information --> tab Upgrade.

1. Simply select the option EVALUATION, FREE LICENSE or CODE SIZE LIMITED and click Finish.

90-day EVALUATION (Linux) or 90-day EXTENSION (Windows)

The 90-day EVALUATION (Linux) or 90-day EXTENSION (Windows) is a three-month period that enables the use of all the features of CCS.

• In Linux, this option is the only evaluation license available.
• In Windows, this option is available when the 30-day period has expired.
• Requires an active my.ti.com account (one can be created instantly).
• Requires an active Internet connection.
• CCSv5 is fully featured during the evaluation period.
• To use a different license or extend the evaluation period you can go to Help --> Code Composer Studio License Information --> tab Upgrade.

1. Select EVALUATION or EXTENSION and then click on Finish.

2. A message will appear with a summary of the process. Click Ok.

Fig. 3: License activation message box

3. A browser window will open with the my.ti.com log in page. After that, the myRegistered Software page will open with the terms and conditions to sue the evaluation license. You must agree to the terms before activating the product.

Fig. 4: Review Terms and Conditions

4. Activation ID code. This page shows the automatically generated ID code, details about the product to be activated and the license chosen. Click Next.

Fig. 5: Activation ID and details

5. In this page enter the information about the PC where CCS is being installed: the HostID (the MAC address of your PC) and a name for it. Click Next.

Fig. 6: Activation ID and details

6. The next screen asks for the e-mail address where the license file will be sent. Check the address and click E-mail License.

Fig. 7: e-mail selection

7. A confirmation screen should appear. Look in your inbox for two e-mails: myTI_license and myregistered_software in the subject.

• The myTI_License e-mail contains the license file. Save this file and write down its location.

8. Go back to the CCS screen and go to menu Help --> Code Composer Studio License Information --> tab Upgrade --> Launch License Setup.

9. Select ACTIVATE and then click Next.

10. Click on Browse under Specify a License File. Point to the place where you saved the license file received above. Click Finish.

Fig. 8: activate license file

11. Restart CCS. The bottom bar should say Licensed instead of 30-day evaluation or Unlicensed.

Note: In some cases the evaluation option will not be available if:

• The evaluation period has expired for the current install.
• There was once a previous installation of CCS that was activated with the evaluation period, and it has expired. Note that the evaluation period is still active even if CCS is uninstalled.

ACTIVATE

The ACTIVATE option is also used for a paid license.

• Requires an active my.ti.com account (one can be created instantly).
• Requires an active Internet connection.
• If a license file was already provided, follow steps 9 through 11 of the EVALUATION or EXTENSION process.
• If an Activation ID code was provided with your software, then follow the steps below to register and properly generate the license file.

1. Select ACTIVATE and then click on Next.

Fig. 9: License selection

2. The screen below will be shown. Click on Register to open the registration

Fig. 10: register a new Activation ID

3. Follow steps 3 through 12 as in the EVALUATION or EXTENSION process, with the following difference in step 4:

Locate the Activation ID provided with your software and type it in the Activation ID field.

Floating License

The Floating License allows sharing a pool of licenses among several PCs in a networked environment. It requires a network connection, but not necessarily Internet (good for laboratories disconnected from the external world).
The process of activation is similar to steps 9 through 11 of the EVALUATION or EXTENSION procedure. The only difference is in step 10:

• Select the Specify a license server option and enter the Address and Port Number information for the floating license installed on a server.

Note: In order to perform the setup on the license server host PC please check the topic License Server Administration in Advanced topics for more details.

The welcome screen

After the license process is finished, CCS will show the Welcome Screen and is ready to use.

Fig. 11: Welcome to Code Composer Studio v5!

What's next?

Now that you have finished the license activation of Code Composer Studio v5, please continue on to the Working with CCS section of the CCSv5 Getting Started Guide.

---