Migrating armcl CCS Projects to tiarmclang

One of the challenges you may face when transitioning an existing armcl application in order to build the application with the tiarmclang compiler is in mapping armcl compiler options into their corresponding tiarmclang compiler options. If your armcl application exists as a CCS project, then CCS can help with the mapping of armcl compiler options to tiarmclang options.

The process of migrating an armcl CCS project to use the tiarmclang compiler is relatively straightforward:

  1. Import the armcl CCS project into a CCS workspace
  2. In the “Project Explorer” window, left-click on the armcl project name that you want to migrate to make it the active project
  3. Right-click on the armcl project name and select “Show Build Settings”
  4. You will then see a “Properties” pop-up dialog box for the armcl project
  5. Left-click on the “General” category along the left-hand side of the dialog box
  6. Find the “Compiler version” drop-down menu near the middle of the dialog box
  7. Change the compiler selected from the current armcl compiler to the tiarmclang compiler (may be denoted as “TI Clang <version string>”)
  8. Click on “Apply and Close” at the bottom of the dialog box

You will see a “Confirmation Needed” pop-up dialog asking if you’d like to proceed with the creation of a new build configuration. When you click “OK” in the “Confirmation Needed” dialog box, the migration process is started.

Unless all armcl compiler options were migrated flawlessly to their tiarmclang compiler counterparts, you will see a “Warning” pop-up dialog box explaining that some issues were encountered when creating the new build configuration. You can then click “OK” and proceed to view a project.log file in the CCS source file window.

The project.log file will provide details about each of the armcl to tiarmclang option mappings that were enacted during the migration step. The armcl compiler options that CCS was not able to migrate into a functionally equivalent tiarmclang compiler option will be listed with a “!WARNING” message in the project.log file. Please review the mappings listed in the project.log file to ensure that each armcl compiler was mapped to a tiarmclang option as you expected.

You can then right-click on the project name and select “Show Build Settings” again to verify the tiarmclang options are set as you anticipate, making adjustments if necessary.