C2000 SysConfig Linker Command Tool

Abstract

Linker command files play an important role in embedded programs as they specify where code and data sections get allocated into target memory. Without this file, the linker does not know the target memory configuration and how to properly allocate the sections. For C2000™ real-time controllers, you have to understand the device memory by reviewing the device-specific data sheet and technical reference manual. Example C2000 linker command files are available in C2000Ware SDK but for any given application, you might have to modify the template linker command files available in the C2000Ware SDK to fit your application needs. This requires that you to learn the syntax and options available when writing a linker command file. The C2000 Linker CMD Tool simplifies the task of creating application-specific linker command files by providing an intuitive GUI and automatic code generation.

Trademarks

C2000™ and Code Composer Studio™ are trademarks of Texas Instruments.

All trademarks are the property of their respective owners.

1 Introduction

The linker command file is used during the link stage of the application build where the linker combines object files and allocates sections into the target system's configured memory. The linker command file is an ASCII file that uses two linker directives, MEMORY and SECTIONS, to allocate sections into specific areas of memory. The MEMORY directive defines target memory configuration. The SECTIONS directive controls how sections are built and allocated. In addition, the linker command file can also include input filenames and linker options.

The Linker Command File Primer page covers the basics of linker command files, focusing on the MEMORY and SECTIONS directives.

Creating a new linker command file from scratch or even editing an existing linker command file template can be difficult for new users. Users must understand the structure of linker command files along with their specific device’s memory structure.

The C2000 Linker CMD Tool significantly simplifies the task of creating new or editing existing linker command files by providing the following features:

Intuitive GUI-based that showcases all available customization options
Error checking to help you to avoid making mistakes
Auto-generate CMD files
Automatic Code Composer Studio™ project property modification
Auto-generate additional C source and header files for initializing memory sections
Showcasing the available memories for the selected device family

Utilizing the C2000 Linker CMD tool can speed up the software development for new and advanced users.