armcl to tiarmclang Migration Guide¶

The sections included in this migration guide address many of the issues you will run into when porting source code and build process for your existing armcl application to tiarmclang. Among these are:

Converting build options used in an existing armcl project to appropriate tiarmclang build options,
Making your C/C++ source code more portable by converting legacy TI instances of pre-defined macro symbols, pragmas, and intrinsics into functionally equivalent ACLE (Arm C Language Extensions) forms, and
Converting assembly source code written in legacy TI-syntax Arm assembly language to GNU-syntax Arm assembly language.

Available Migration Aids

There are a variety of migration aids available in the tiarmclang compiler tools and in Code Composer Studio (CCS) version 10.1 or later to help you address these issues when converting an existing armcl project to use the tiarmclang compiler:

CCS Project Migration - for help converting the build options for an existing armcl CCS project to use the tiarmclang compiler, please see Migrating armcl CCS Projects to tiarmclang.
C/C++ Source Code Migration Aid Diagnostics - the tiarmclang compiler can help you find instances of legacy TI pre-defined macro symbols, pragmas, and intrinsics that need to be converted into ACLE form via the use of migration aid diagnostics. For more information, please see C/C++ Source Migration Aid Diagnostics.
Invoking the Legacy TI-Syntax Arm Assembler from tiarmclang - if you have assembly source code written in legacy TI-syntax Arm assembly language that you are unlikely to need to change or maintain in your project, then you may want to use the legacy TI-syntax Arm assembler to process that code. The tiarmclang compiler allows you to invoke the legacy TI-syntax Arm assembler from the tiarmclang command-line. For more information about how to do this, please see Invoking the TI-Syntax ARM Assembler from tiarmclang.

Contents: