(XC32) How do I link in my own custom startup code with the XC32 Compiler?

These are the steps to link the customized startup code in XC32:

1

Copy the default startup code crt0.S, available under the folder <Compiler-DIR>\pic32-libs\libpic32\startup, to your project directory.

2

Customize this startup code by making the changes as required.

3

Add this modified startup code (crt0.S) to the MPLAB® X IDE project under Source Files.

You may also change the name of your custom startup code to something like my_startup.S.

4

Set the options to exclude linking of default startup code.

In MPLAB X IDE, go to File > Project Properties > xc32-ld. Select Libraries for Option categories. Check the Do not link startup code option. Click Ok.

5

The code will now link with the customized startup code.

Note that the default startup code source, crt0.S, uses many device-specific macros that should be defined as appropriate for your target device.

© 2025 Microchip Technology, Inc.
Notice: ARM and Cortex are the registered trademarks of ARM Limited in the EU and other countries.
Information contained on this site regarding device applications and the like is provided only for your convenience and may be superseded by updates. It is your responsibility to ensure that your application meets with your specifications. MICROCHIP MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED, WRITTEN OR ORAL, STATUTORY OR OTHERWISE, RELATED TO THE INFORMATION, INCLUDING BUT NOT LIMITED TO ITS CONDITION, QUALITY, PERFORMANCE, MERCHANTABILITY OR FITNESS FOR PURPOSE. Microchip disclaims all liability arising from this information and its use. Use of Microchip devices in life support and/or safety applications is entirely at the buyer's risk, and the buyer agrees to defend, indemnify and hold harmless Microchip from any and all damages, claims, suits, or expenses resulting from such use. No licenses are conveyed, implicitly or otherwise, under any Microchip intellectual property rights.