Please note as of Wednesday, August 15th, 2018 this wiki has been set to read only. If you are a TI Employee and require Edit ability please contact x0211426 from the company directory.

Troubleshooting CCSv5

From Texas Instruments Wiki
Jump to: navigation, search

Overview

This guide provides some suggestions for CCSv5 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 to provide to support). It also describes how to find/generate additional diagnostic logs that will be useful to provide to TI when reporting an issue.

Installation

1. Errors in startup script: For errors in startup script like the following, make sure to extract the offline installer zip file into a temporary folder and then run the setup.exe rather than installing it directly "on-the-fly".

Error in action ExecuteScript
 can't read "fileList": no such variable
    while executing
"::InstallJammer::actions::$component $this"
    while executing
"$obj_execute"
   (procedure "::InstallJammer::ExecuteActions" line 62)
    invoked from within
"::InstallJammer::ExecuteActions "SetupActions""
    (procedure "::InstallJammer::ParseCommandLineArguments" line 142)
    invoked from within
"::InstallJammer::ParseCommandLineArguments $::argv"
    (procedure "::InstallJammer::InitInstall" line 62)
    invoked from within
"::InstallJammer::InitInstall"
    (file "/installkitvfs/main.tcl" line 64456)

2. Clearing out existing installation: For failure during installation (CCS installer fails to complete), try removing all files under the InstallJammer registry folder for CCSv5 before retrying the installation. The path to the folder is typically:

Windows 32 Windows 64 Linux
C:\Program Files\InstallJammer Registry\ccsv5 C:\Program Files (x86)\InstallJammer Registry\ccsv5 ~/.installjammerinfo

Try deleting the entire 'ccsv5' folder. Keep in mind this will erase the install information of other CCSv5 versions you may have installed in parallel. If in doubt, check the date and time of each directory and delete the one that matches your attempt of install.

If you need to completely wipe all information from all versions of ccsv5 ever installed in your system, delete all workspace directories created and all directories in the locations below:

Windows Linux
C:\Users\<your_username>\.TI ~/.TI
C:\Users\<your_username>\.TI-trace ~/.TI-trace
C:\Users\<your_username>\user ~/.texas_instruments
C:\Users\<your_username>\ti ~/ti
C:\Users\<your_username>\AppData\.TI ~/.spectrumdigital
C:\Users\<your_username>\AppData\Local\.TI ~/.sd560v2config

C:\Users\<your_username>\AppData\Local\Texas Instruments


3. Installer hangs or crashes during installation: For issues where the web installer hangs or crashes during installation and generates following error, try one of the following suggestions:

  • check your proxy settings - as the settings may be blocking the installer from downloading packages
  • disable anti-virus software running on your machine as that may conflict with the installer. For a detailed explanation of the reasons, check this forum thread.
  • download and install from the offline installer
  • If running on Windows, make sure Windows Junction are not used - Junctions are not supported by InstallJammer
  • Unset _JAVA_OPTIONS temporarily, it interferes with eclipse installation.
Error in action ExecuteAction

Error in action ExecuteScript

couldn't open socket: invalid argument
 while executing
"::InstallJammer::actions::$component $this"
 while executing
"$obj execute"
 (procedure "::InstallJammer::ExecuteActions" line 69)
 invoked from within
 "::InstallJammer::ExecuteActions $action -parent $id -conditions $eval"
 (procedure "::InstallJammer::actions::ExecuteAction" line 35)
 invoked from within
 "::InstallJammer::actions::$component $this"

Error in action ExecuteAction

Error in action ExecuteScript

couldn't open socket: invalid argument
 while executing
 "::InstallJammer::actions::$component $this"
 while executing
 "$obj execute"
 (procedure "::InstallJammer::ExecuteActions" line 69)
 invoked from within
 "::InstallJammer::ExecuteActions $action -parent $id -conditions $eval"
 (procedure "::InstallJammer::actions::ExecuteAction" line 35)
 invoked from within
 "::InstallJammer::actions::$component $this"
 while executing
 "$obj execute" (procedure "::InstallJammer::ExecuteActions" line 69)
 invoked from within
 "::InstallJammer::ExecuteActions $id -when $when"
 (procedure "::InstallJammer::RaiseEventHandler" line 93)
 invoked from within
 "::InstallJammer::RaiseEventHandler .wizard"
 (command bound to event)

4. CCS crashes during startup: There is a known issue where running the installer from a directory with accented characters can cause it to crash during startup and generate error log like the following. Make sure to run the installer from a directory without any accented or double-byte characters. It is also advisable to install CCS to a directory without any special characters. The default c:\ti is recommended.

eclipse.buildId=I20110613-1736
java.version=1.6.0_13
java.vendor=Sun Microsystems Inc.
BootLoader constants: OS=win32, ARCH=x86, WS=win32, NL=hu_HU
Framework arguments:  -product com.ti.ccstudio.branding.product
Command-line arguments:  -os win32 -ws win32 -arch x86 -product com.ti.ccstudio.branding.product

!ENTRY org.eclipse.equinox.app 0 0 2012-02-02 20:55:38.818
!MESSAGE Product com.ti.ccstudio.branding.product could not be found.

!ENTRY org.eclipse.osgi 4 0 2012-02-02 20:55:38.911
!MESSAGE Application error
!STACK 1
java.lang.RuntimeException: No application id has been found.
    at org.eclipse.equinox.internal.app.EclipseAppContainer.startDefaultApp(EclipseAppContainer.java:242)
    at org.eclipse.equinox.internal.app.MainApplicationLauncher.run(MainApplicationLauncher.java:29)
    at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.runApplication(EclipseAppLauncher.java:110)
    at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.start(EclipseAppLauncher.java:79)
    at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:344)
    at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:179)
    at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source)
    at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)
    at java.lang.reflect.Method.invoke(Unknown Source)
    at org.eclipse.equinox.launcher.Main.invokeFramework(Main.java:622)
    at org.eclipse.equinox.launcher.Main.basicRun(Main.java:577)
    at org.eclipse.equinox.launcher.Main.run(Main.java:1410)

5. CCS does not start up after installation: If CCS does not start up properly and generates an error log that looks something like below, it may be that another software package uninstalled the Microsoft Visual Studio redistributable packages that CCS relies on. If so, reinstalling the VC redistributable package(s) that comes with the CCS installer should resolve the error. They are located in the CCS installer at \baserepo\vcredist*.exe.

!ENTRY org.eclipse.osgi 4 0 2011-12-21 10:31:07.133
!MESSAGE An error occurred while automatically activating bundle com.ti.ccstudio.debug.server (342).
!STACK 0
org.osgi.framework.BundleException: Exception in com.ti.ccstudio.debug.server.DebugServerPlugin.start() of bundle com.ti.ccstudio.debug.server.
	at org.eclipse.osgi.framework.internal.core.BundleContextImpl.startActivator(BundleContextImpl.java:734)
	at org.eclipse.osgi.framework.internal.core.BundleContextImpl.start(BundleContextImpl.java:683)
	at org.eclipse.osgi.framework.internal.core.BundleHost.startWorker(BundleHost.java:381)
	at org.eclipse.osgi.framework.internal.core.AbstractBundle.start(AbstractBundle.java:299)
	at org.eclipse.osgi.framework.util.SecureAction.start(SecureAction.java:440)
	at org.eclipse.osgi.internal.loader.BundleLoader.setLazyTrigger(BundleLoader.java:268)
	at org.eclipse.core.runtime.internal.adaptor.EclipseLazyStarter.postFindLocalClass(EclipseLazyStarter.java:107)
	at org.eclipse.osgi.baseadaptor.loader.ClasspathManager.findLocalClass(ClasspathManager.java:462)
	at org.eclipse.osgi.internal.baseadaptor.DefaultClassLoader.findLocalClass(DefaultClassLoader.java:216)
	at org.eclipse.osgi.internal.loader.BundleLoader.findLocalClass(BundleLoader.java:400)
	at org.eclipse.osgi.internal.loader.BundleLoader.findClassInternal(BundleLoader.java:476)
	at org.eclipse.osgi.internal.loader.BundleLoader.findClass(BundleLoader.java:429)
	at org.eclipse.osgi.internal.loader.BundleLoader.findClass(BundleLoader.java:417)
	at org.eclipse.osgi.internal.baseadaptor.DefaultClassLoader.loadClass(DefaultClassLoader.java:107)
	at java.lang.ClassLoader.loadClass(Unknown Source)
	at org.eclipse.osgi.internal.loader.BundleLoader.loadClass(BundleLoader.java:345)
	at org.eclipse.osgi.framework.internal.core.BundleHost.loadClass(BundleHost.java:229)
	at org.eclipse.osgi.framework.internal.core.AbstractBundle.loadClass(AbstractBundle.java:1207)
	at org.eclipse.core.internal.registry.osgi.RegistryStrategyOSGI.createExecutableExtension(RegistryStrategyOSGI.java:174)
	at org.eclipse.core.internal.registry.ExtensionRegistry.createExecutableExtension(ExtensionRegistry.java:905)
	at org.eclipse.core.internal.registry.ConfigurationElement.createExecutableExtension(ConfigurationElement.java:243)
	at org.eclipse.core.internal.registry.ConfigurationElementHandle.createExecutableExtension(ConfigurationElementHandle.java:55)
	at com.ti.ccstudio.core.CCStudioPlugin.getXPCOMRuntimeAdapter(CCStudioPlugin.java:85)

6. No update sites found: In some cases, when looking for updates, the list of CCS update sites may come up empty (under Help->Install New Software), thereby not listing any available updates. To restore the list, download the attached file, and unzip to extract the .xml file. Then go to CCS menu Window->Preferences->Install/Update->Available Software Sites, click on Import, browse to the attached file and click Ok.

7. CCS does not install completely/missing TI components : After installing CCSv5, if only Eclipse components are installed and TI components are missing, it is possible that some repos were not extracted properly. In such cases, check if there is a unzip utility in your system PATH. If so, remove or rename the utility temporarily from the PATH so CCS installer can use its own unpacking utility.

8. Installation error on Microsoft redistributable libraries. If, during the installation of CCS, you see an error dialog from the Microsoft Redistributable Library installer, this could be caused by a pending reboot on the PC. In this situation, allow the install to complete, reboot the PC, and then re-run the VC2005 and VC2008 installers (mentioned in (5) above).

General IDE

CCS 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 CCS. Some of these tips are:

1. 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'

2. Use the -clean argument when calling ccstudio.exe: CCS is launched by running the '.\ccsv5\eclipse\ccstudio.exe' executable. This is what is called when using the CCS desktop shortcut. However, ccstudio.exe can be called with some command line arguments. One of them is '-clean'. When calling 'ccstudio.exe' with '-clean', it will clean out cached data by the IDE and plug-ins upon launching CCS. Sometimes this cached data can get corrupted over time and cleaning it out can fix many problems. Note that launching CCS with '-clean' will cause the launch time to be slower so it is not recommend to use it every time but only when needed. To add the '-clean' option simply right-click on the CCS desktop shortcut and at the end of the "Target" field, enter '-clean'.

3. Clean the workspace (or try using a new one): CCS 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. Using a new workspace or cleaning the old workspace often helps resolve these issues. To use a new workpspace, simply select a new workspace location ('File->Switch Workspace'). If you wish to clean the old workspace, 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 CCS, 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 CCS by selecting 'File->Import...->General->Preferences->From preference file'

Debugger

For issues encountered during a debug session (launching a debug session, target connectivity issues, crashes experienced during debugging). Note that cleaning the workspace can also help resolve debugger issues.

  • Delete the debug launch configuration: A launch configuration is a configuration file that Eclipse creates when a debug session is started; it caches the information on which target configuration to use, target options and several other settings.
Go to menu "Run-->Debug Configurations..."
Under "Code Composer Studio - Device Debugging", select the name of your launch configuration and delete it.
  • Delete target cache files:
Cache files are saved in a user and CCS installation specific location.
On Windows XP the location is: C:\Documents and Settings\<Your Login ID>\Local Settings\Application Data\.TI
On Windows 7 the location is: C:\Users\<username>\AppData\Local\.TI\
On Linux, there is a hidden directory named .TI and located in the user area. The location is ~/.TI
Trace cache files are usually saved in similar locations:
On Windows XP the location is: C:\Documents and Settings\<Your Login ID>\Local Settings\Application Data\.TI-trace
On Windows 7 the location is: C:\Users\<username>\AppData\Local\.TI-trace
On Linux, there is a hidden directory named .TI-trace and located in the user area. The location is ~/.TI-trace


  • If you also have a installation of CCSv3.3 and have CCSv3.3 directories in the system PATH, try removing those directories from the PATH. There is a known issue where CCSv5 will pick up the wrong DLLs from the CCSv3.3 installation if the CCSv3.3 directories are found in the PATH.

Information for Support

  • Before posting a support question, please include the information requested in [this post this post. Be sure to include relevant CCS diagnostic logs as described below:

CCS Diagnostic Logs

When contacting TI for support, in addition to the usual information, providing the following additional diagnostics logs can help support personnel in their investigations:

  • Install Logs
  • Eclipse/JVM Error Logs
  • Crash Dump Files
  • Debug Server Logs
  • cTools/Trace Logs

For CCSv5, there is a utility that will automatically grab the above logs except the cTools/Trace Logs. This utility is accessible via 'Help->CCS Support Activities' menu. This will launch the CCS Support dialog:

CCS Support Dialog

From the above dialog are options to view various logs ('View' button), e-mail to support ('Email...'), clear the log ('Clear') and to enable logging ('Properties...'). Only the Debug Server Log is not enabled by default. To enable it, highlight it and click on Properties, check the box to 'Enable Debug Server Logging' and specify a location to save the log file. There is also a button to 'Archive Logs...'. This will zip up all the enabled logs to a location on your PC. This zip file can then be e-mailed or attached to the CCS support forums.

Install Logs

For installation errors, provide the install logs:

  • CCSv5: 'ccs_setup_5.x.x.xxxxx_install.log' located in C:\Program Files\InstallJammer Registry\ccsv5\<install_random_number>\
    • Note: the directory InstallJammer Registry has the hidden attribute turned on. You must enable the display of hidden files and folders in Windows Explorer to access it (XP or Vista and 7).


Debug Server Logging

  • This is NOT enabled by default. Enabling Debug Server Logging will slow overall CCS performance, so it is not recommended to leave logging enabled. If you are unable to provide a reproducible test case to TI support, you can enable debug server logging to generate additional diagnostics logs. These logs will only be useful for issues related to the debug server (ex: can't connect to the target, debugger hangs, etc) and useless for other issues like project management or the editor. Logging data from the debugger can get very large, so it may be desirable to only enable debug server logging just before the event of interest is being exercised.

You can enable logging via the CCS Support Dialog mentioned above or from within CCS by entering eval("DEBUG_LogEnable(1)") in the Scripting Console

If you wish to enable logging outside CCS (useful if you are using DSS), you can use the below environment variables (example for Windows):

set TI_DS_ENABLE_LOGGING=1
set TI_DS_LOGGING_OUTPUT=c:/path/file.log

The former enables logging, the latter will let you choose where the log is generated. Make sure you clear the first variable after the logging is done.

cTools/Trace Logging

To generate cTools/Trace logs:

  1. Quit CCS.
  2. Right click on the “MyComputer” icon on your desktop.
  3. Select “Properties”.
  4. On XP select System Properties, in Win7 click on "Advanced System Settings"
  5. In the System Properties dialog, click on the “Advanced” tab. (should already be selected in Win7)
  6. Click on the “Environment Variables” button. In the “Environment Variables” dialog
  7. Under the “User variables” group, verify that the “TI_TRACE_LOGGING” environment variable exists and has a value of 6. Create it if it is not there.
  8. Click “OK” in all dialogs. Restart CCS.
  9. Reproduce the problem, noting what steps were performed in what order.
  10. Zip up the log file and send it to TI via the forums. The log file will be in /ccsv5/ccs_base/emulation/analysis/bin/Logs/ (WinXP) or /users/<userid>/.TI-trace (Win7). The file name will be something like: ti_trace_log_MMDDYY_PID.txt file.