4.7.1.3 XC8 Linker Category
The following describe the options available in the MPLAB X IDE XC8 Linker categories as well as the VS Code category.
Runtime
- Initialize data
- This checkbox controls whether initialized C objects are assigned their starting value. See Mapped Linker Options.
- Keep generated startup.as
- This checkbox controls whether the runtime startup module is retained after compilation. See Keep Startup Option.
- Do not link startup module in
- This checkbox controls whether the runtime startup module linked into the program. See Nostartfiles Option.
- Calibrate oscillator
- This checkbox controls whether the oscillator calibration constant is applied by runtime startup module linked into the program. Not all devices uses this calibration method. See Osccal Option.
- Alternate oscillator calibration value
- This field allows you to specify an alternate oscillator calibration constant to that preprogrammed into the device. Not all devices uses this calibration method. See Oscval Option.
- Backup reset condition flags
- This checkbox controls whether the runtime startup code will preserve the state of the status register, so that it can later be examined to determine the cause of Reset. This option is not implemented for PIC18 device. See Resetbits Option.
- Format hex file for download
- This checkbox controls the special formatting of the final HEX file. See Download Option.
- Managed stack
- This checkbox controls whether a table look-up method of calling functions will be employed. See Stackcall Option.
- Program the device with default config words
- This checkbox controls whether unspecified configuration bits will be programmed with default values. See Config Option.
- Link in C library
- This selector indicates the language standard of libraries linked into the program. Currently, only a C99 compliance library is available.
Memory Model
- Size of double
- This selector indicates the size of the
doubletype. Currently, only 32-bit floating-point types are permitted. - Size of floats
- This selector indicates the size of the
floattype. Currently, only 32-bit floating-point types are permitted. - External memory
- This selector controls how external memory is accessed. See Emi Option.
- RAM ranges
- This field adjusts the data memory used by the program. See Ram Option.
- ROM ranges
- This field adjusts the program memory used by the program. See Rom Option.
Fill Flash Memory
- Fill options
- All the fields in this dialog correspond to filling unused memory with values. See Fill Option.
Additional Options
- Extra linker options
- This field allows you to specify additional linker-related options that cannot be otherwise controlled from the IDE. See Wl: Pass Option To The Linker, Option.
- Serial
- This field allows you to have codes placed into the HEX file. See Serial Option.
- Codeoffset
- This field allows you to move the entire program image up in memory. See Codeoffset Option.
- Checksum
- This field allows you to have a hash value calculated and inserted into the HEX file. See Checksum Option.
- Errata
- This field allows you to adjust the errata workarounds employed by the compiler. See Errata Option.
- Trace type
- This selector is not yet implemented. Native trace is supported.
- Extend address in HEX file
- This checkbox generates HEX files with extended liner addresses. See G: Produce Debugging Information Option.
- Use response file to link
- This field allows a command-line options file to be used by the compiler during the link step, in preference to the other link-step settings in the project properties. See Long Command Lines. This option is only relevant when running MPLAB X IDE under Windows.
Reporting
- Display psect usage
- This checkbox allows you to have psect (section) information included in the post-build summary. See Summary Option.
- Display class usage
- This checkbox allows you to have linker class (memory area) information included in the post-build summary. See Summary Option.
- Display overall memory summary
- This checkbox allows you to have general memory usage included in the post-build summary. See Summary Option.
- Display HEX usage map
- This checkbox allows you to see a graphical representation of the usage of the device memory included in the post-build summary. See Summary Option.
- Create summary file
- This checkbox allows you to have the post-build summary redirect to a file. See Summary Option.
