ARM Assembly Language Tools V18.1.0.LTS User's Guide (Rev. U) Compiler Manual

User Manual:

Open the PDF directly: View PDF .
Page Count: 356 [warning: Documents this large are best viewed by clicking the View PDF Link!]

Scroll down to view the document on your mobile browser.

Table of Contents
Preface
1 Introduction to the Software Development Tools
- 1.1 Software Development Tools Overview
- 1.2 Tools Descriptions
2 Introduction to Object Modules
- 2.1 Object File Format Specifications
- 2.2 Executable Object Files
- 2.3 Introduction to Sections
  - 2.3.1 Special Section Names
- 2.4 How the Assembler Handles Sections
- 2.5 How the Linker Handles Sections
  - 2.5.1 Combining Input Sections
  - 2.5.2 Placing Sections
- 2.6 Symbols
- 2.7 Symbolic Relocations
- 2.8 Loading a Program
3 Program Loading and Running
- 3.1 Loading
  - 3.1.1 Load and Run Addresses
  - 3.1.2 Bootstrap Loading
- 3.2 Entry Point
- 3.3 Run-Time Initialization
- 3.4 Arguments to main
- 3.5 Run-Time Relocation
- 3.6 Additional Information
4 Assembler Description
- 4.1 Assembler Overview
- 4.2 The Assembler's Role in the Software Development Flow
- 4.3 Invoking the Assembler
- 4.4 Controlling Application Binary Interface
- 4.5 Naming Alternate Directories for Assembler Input
  - 4.5.1 Using the --include_path Assembler Option
  - 4.5.2 Using the TI_ARM_A_DIR Environment Variable
- 4.6 Source Statement Format
- 4.7 Literal Constants
- 4.8 Assembler Symbols
- 4.9 Expressions
- 4.10 Built-in Functions and Operators
  - 4.10.1 Built-In Math and Trigonometric Functions
- 4.11 Unified Assembly Language Syntax Support
- 4.12 Source Listings
- 4.13 Debugging Assembly Source
- 4.14 Cross-Reference Listings
5 Assembler Directives
- 5.1 Directives Summary
- 5.2 Directives that Define Sections
- 5.3 Directives that Change the Instruction Type
- 5.4 Directives that Initialize Values
- 5.5 Directives that Perform Alignment and Reserve Space
- 5.6 Directives that Format the Output Listings
- 5.7 Directives that Reference Other Files
- 5.8 Directives that Enable Conditional Assembly
- 5.9 Directives that Define Union or Structure Types
- 5.10 Directives that Define Enumerated Types
- 5.11 Directives that Define Symbols at Assembly Time
- 5.12 Miscellaneous Directives
- 5.13 Directives Reference
6 Macro Language Description
- 6.1 Using Macros
- 6.2 Defining Macros
- 6.3 Macro Parameters/Substitution Symbols
- 6.4 Macro Libraries
- 6.5 Using Conditional Assembly in Macros
- 6.6 Using Labels in Macros
- 6.7 Producing Messages in Macros
- 6.8 Using Directives to Format the Output Listing
- 6.9 Using Recursive and Nested Macros
- 6.10 Macro Directives Summary
7 Archiver Description
- 7.1 Archiver Overview
- 7.2 The Archiver's Role in the Software Development Flow
- 7.3 Invoking the Archiver
- 7.4 Archiver Examples
- 7.5 Library Information Archiver Description
8 Linker Description
- 8.1 Linker Overview
- 8.2 The Linker's Role in the Software Development Flow
- 8.3 Invoking the Linker
- 8.4 Linker Options
- 8.5 Linker Command Files
- 8.6 Linker Symbols
- 8.7 Default Placement Algorithm
  - 8.7.1 How the Allocation Algorithm Creates Output Sections
  - 8.7.2 Reducing Memory Fragmentation
- 8.8 Linker-Generated Copy Tables
- 8.9 Linker-Generated CRC Tables
- 8.10 Partial (Incremental) Linking
- 8.11 Linking C/C++ Code
- 8.12 Linker Example
9 Absolute Lister Description
- 9.1 Producing an Absolute Listing
- 9.2 Invoking the Absolute Lister
- 9.3 Absolute Lister Example
10 Cross-Reference Lister Description
- 10.1 Producing a Cross-Reference Listing
- 10.2 Invoking the Cross-Reference Lister
- 10.3 Cross-Reference Listing Example
11 Object File Utilities
- 11.1 Invoking the Object File Display Utility
- 11.2 Invoking the Disassembler
- 11.3 Invoking the Name Utility
- 11.4 Invoking the Strip Utility
12 Hex Conversion Utility Description
- 12.1 The Hex Conversion Utility's Role in the Software Development Flow
- 12.2 Invoking the Hex Conversion Utility
  - 12.2.1 Invoking the Hex Conversion Utility From the Command Line
  - 12.2.2 Invoking the Hex Conversion Utility With a Command File
- 12.3 Understanding Memory Widths
- 12.4 The ROMS Directive
  - 12.4.1 When to Use the ROMS Directive
  - 12.4.2 An Example of the ROMS Directive
- 12.5 The SECTIONS Directive
- 12.6 The Load Image Format (--load_image Option)
  - 12.6.1 Load Image Section Formation
  - 12.6.2 Load Image Characteristics
- 12.7 Excluding a Specified Section
- 12.8 Assigning Output Filenames
- 12.9 Image Mode and the --fill Option
- 12.10 Array Output Format
- 12.11 Building a Table for an On-Chip Boot Loader
- 12.12 Controlling the ROM Device Address
- 12.13 Control Hex Conversion Utility Diagnostics
- 12.14 Description of the Object Formats
13 Sharing C/C++ Header Files With Assembly Source
- 13.1 Overview of the .cdecls Directive
- 13.2 Notes on C/C++ Conversions
- 13.3 Notes on C++ Specific Conversions
- 13.4 Special Assembler Support
A Symbolic Debugging Directives
- A.1 DWARF Debugging Format
- A.2 Debug Directive Syntax
B XML Link Information File Description
- B.1 XML Information File Element Types
- B.2 Document Elements
C Hex Conversion Utility Examples
- C.1 Scenario 1 -- Building a Hex Conversion Command File for a Single 8-Bit EPROM
- C.2 Scenario 2 -- Building a Hex Conversion Command File for 16-BIS Code
- C.3 Scenario 3 -- Building a Hex Conversion Command File for Two 8-Bit EPROMs
D Glossary
- D.1 Terminology
E Revision History
- E.1 Recent Revisions
Important Notice

Navigation menu