Jump to main content
MPLAB® XC32 Assembler, Linker and Utilities User's Guide
Notice to Development Tools Customers
1 Preface
1.1 Conventions Used in This Guide
1.2 Recommended Reading
2 Assembler Overview
2.1 Assembler and Other Development Tools
2.2 Feature Set
2.3 Input/Output Files
3 Assembler Command-Line Options
3.1 Assembler Interface Syntax
3.2 Compilation-Driver Interface Syntax
3.3 Options That Modify the Listing Output
3.4 Options That Control Informational Output
3.5 Options That Control Output File Creation
3.6 Assembler Symbol-Definition and Search-Path Options
3.7 Compilation-Driver and Preprocessor Options
4 MPLAB XC32 Assembly Language
4.1 Internal Preprocessor
4.2 Source Code Format
4.3 Constants
4.4 Symbols
4.5 Expressions
4.6 Operators
4.7 Special Operators
5 Assembler Directives
5.1 Directives that Define Sections
5.2 Directives that Initialize Constants
5.3 Directives that Declare Symbols
5.4 Directives that Define Symbols
5.5 Directives that Modify Section Alignment
5.6 Directives that Format the Output Listing
5.7 Directives that Control Conditional Assembly
5.8 Directives for Substitution/Expansion
5.9 Directives that Include Other Files
5.10 Directives that Control Diagnostic Output
5.11 Directives for Debug Information
5.12 PIC32M Symbols that Control Code Generation
6 Assembler Errors/Warnings/Messages
6.1 Fatal Errors
6.2 Errors
6.3 Fatal Errors
6.4 Messages
7 Linker Overview
7.1 Linker and Other Development Tools
7.2 Feature Set
7.3 Input/Output Files
8 Linker Command-Line Interface
8.1 Linker Interface Syntax
8.2 Compilation-Driver Linker Interface Syntax
8.3 Options That Control Output File Creation
8.4 Options That Control Run-Time Initialization
8.5 Options That Control Multilib Library Selection
8.6 Options that Control Informational Output
8.7 Options that Modify the Link Map Output
9 Linker Scripts
9.1 Overview of Linker Scripts
9.2 Command Line Information
9.3 Section Mapping
9.4 Using Custom Linker Scripts in MPLAB X IDE Projects
9.5 Linker Script Command Language
9.6 Expressions in Linker Scripts
10 Linker Processing
10.1 Overview of Linker Processing
10.2 Linker Allocation
10.3 Global and Weak Symbols
10.4 Initialized Data
10.5 Stack Allocation
10.6 Heap Allocation
10.7 PIC32MX Interrupt Vector Tables
10.8 Interrupt Vector Tables for PIC32 MCUS Featuring Dedicated Programmable Variable Offsets
11 Linker Examples
11.1 Memory Addresses and Relocatable Code
11.2 Locating Objects at a Specific Address
11.3 Locating Attributed Objects
11.4 Locating Functions at a Specific Address
11.5 Locating and Reserving Program Memory
12 Linker Errors/Warnings
12.1 Fatal Errors
12.2 Errors
12.3 Warnings
13 MPLAB XC32 Object Archiver/Librarian
13.1 Archiver/Librarian and Other Development Tools
13.2 Feature Set
13.3 Input/Output Files
13.4 Syntax
13.5 Options
13.6 Scripts
14 Other Utilities
14.1 xc32-bin2hex Utility
14.2 xc32-nm Utility
14.3 Objdump Utility
14.4 xc32-ranlib Utility
14.5 xc32-size Utility
14.6 xc32-strings Utility
14.7 xc32-strip Utility
15 Useful Tables
15.1 ASCII Character Set
15.2 Hexadecimal to Decimal Conversion
16 GNU Free Documentation License
17 Document Revision History
Microchip Information
Trademarks
Legal Notice
Microchip Devices Code Protection Feature

The online versions of the documents are provided as a courtesy. Verify all content and data in the device’s PDF documentation found on the device product page.