Troubleshooting CCS

From Texas Instruments Embedded Processors Wiki

Overview

This guide provides some suggestions for CCSv4 users experiencing odd generic issues not covered in FAQs or other topics and having difficulty to reproducing in other environments (creating a reproducible test case for to provide to support).

General IDE

CCSv4 is based on the Eclipse open source framework and when experiencing various odd/corrupted behavior (missing menu options, "blank" views, plug-ins are missing or no longer behave properly, random crashes, etc), common tips on cleaning up your Eclipse environment also apply to CCSv4. Some of these tips are:

• Reset the perspective: If the issue is strange GUI appearance (missing menu options or strange/empty looking views), often just resetting the perspective can resolve this. This can be done by selecting 'Window->Reset Perspective'

• Use the -clean argument when calling eclipse.exe: CCSv4 is launched by running the '.\ccsv4\eclipse\eclipse.exe' executable. This is what is called when using the CCSv4 desktop shortcut. However, eclipse.exe can be called with some command line arguments. One of them is '-clean'. When calling 'eclipse.exe' with '-clean', it will clean out cached data by the IDE and plug-ins upon launching CCSv4. Sometimes this cached data can get corrupted over time and cleaning it out can fix many problems. Note that launching CCSv4 with '-clean' will cause the launch time to be slower so it is not recommend to use it every time but only when needed

• Clean the workspace: CCSv4 stores various information in a folder called '.metadata' located in the user's workspace. The contents of this folder can get corrupted over time, causing various instability and strange behavior. Cleaning the workspace often helps resolve these issues. The simplest way to do this is to delete the '.metadata' folder in the workspace. This will essentially reset the workspace and restore the environment to the default behavior. All projects that were in the workspace will need to be re-imported into CCSv4, even though they are still physically in the workspace folder. Also note that any modified preference settings will be lost (set back to the default setting). If you wish to avoid resetting those preferences, export the preferences to a file (outside the workspace) by selecting 'File->Export...->General->Preferences->To preference file' before deleting the workspace. Once the workspace has been cleaned, those preferences can be imported back into CCSv4 by selecting 'File->Import...->General->Preferences->From preference file'

General Emulation

For JTAG issues, you may want to see: Debugging JTAG Connectivity Problems

Leave a Comment