Configuring Project Build Options

MPLAB X offers a simple way to configure the "Build Options" of your project. If this is your first time using our tools, the "Build Option" configuration allows you to change/configure the Programming Tools such as the ICD3, RealICE, ICD2 and any Compiler Tools such as C18, C30, HiTech, etc.


Displaying the Project Build Options Window

MPLAB X gives you two options to access the Build Option Configuration window of your project.

Option 1:
On the toolbar, click on "Run", select "Set Project Configuration" and then click on "Customize".


Option 2:
Right-click on the name of your project, select "Set Project Configuration" and then click on "Customize".


MPLAB X will bring up the following window:



Modifying the Project Build Options

To see what programming and compiler tools are currently selected, click on "Default". The tools highlighted in blue are the current tools used by your project. In this instance, the Real ICE programming tool and the C18 compiler are currently being used (see below). To select any other tool, simply click on its name and click "Apply".


Can MPLAB X see my programmer/debugger?

If the serial number of your tool is shown as in the previous window, this means that MPLAB X has detected your tool. In this example, the serial number of the Real ICE detected is shown and annotated as the "Active Programmer".


Modifying the Programmer Configurations


Clicking on the programmer name, in this case Real ICE, gives you access to further configuration "Option categories", such as:

1. Memories to Program
  • a. Auto Select Memories and Ranges
  • b. Program Memory
  • c. Program Memory Start
  • d. Program Memory End
2.Debug Options
  • a. Use Software Breakpoints
3.Program Options
  • a. Erase All Before Program
4.Freeze Peripherals
  • a. Freeze Peripherals


Modifying the Compiler Configurations


Clicking on the compiler name, i.e. C18, brings up the following configuration options:


1. General

  • Enable Case Sensitivity
  • Default radix
  • Preprocessor macro definitions

2. Output

  • Cross-reference file
  • Diagnostics level
  • Hex file format


1. General

  • Treat char as unsigned
  • Enable integer promotion
  • Enable verbose output
  • Default storage class
  • Diagnostic level
  • Preprocessor macro definitions
  • Include directories

2. Memory Model

  • Code model
  • Data model
  • Enable multi-bank stack model

3. Optimization


  • Generate map file
  • Generate COD file
  • HEX file format
  • Generate HEX file
  • Library directories
© 2024 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.