SW500011 Microchip Technology, SW500011 Datasheet - Page 33

• Manufacturer Part Number: SW500011
• Description: HI-TECH X PRO FOR PIC32
• Manufacturer: Microchip Technology
• Type: Compilerr
• Series: PIC32r

Specifications of SW500011

• No. Of User Licenses: 1
• Supported Families: PIC32
• Core Architecture: PIC
• Supported Hosts: Windows XP, Vista, Linux, Mac OS X
• Software Edition: Professional
• Kit Contents: Software And Docs
• Tool Type: Compiler
• Lead Free Status / RoHS Status: Not applicable / Not applicable
• For Use With/related Products: PIC32 Series
• Lead Free Status / Rohs Status: Lead free / RoHS Compliant
• Other names: 032; 778-1007; 778-1007

PICC32 Command-line Driver
2.3.3 The Powerup Routine
Some hardware configurations require special initialization, often within the first few instruction
cycles after reset. To achieve this there is a hook to the reset vector provided via the powerup
routine.
ately after reset. An empty powerup routine is provided in the file powerup.as which is located
in the SOURCES directory of your compiler distribution. Refer to comments in this file for more
details.
a source file. No special linker options or other code is required; the compiler will detect if you
have defined a powerup routine and will automatically use it, provided the code in this routine is
contained in a psect called powerup.
tion which will place the return address in register 31 (ra). For correct operation (when using the
default compiler-generated runtime startup code), the code must contain at its end a jr ra instruc-
tion and ensure that it preserves the address in register 31. As with all user-defined assembly code,
it must take into consideration program memory paging and/or data memory banking, as well as any
applicable errata issues for the device you are using. The program’s entry point is already defined by
the runtime startup code, so this should not be specified in the powerup routine at the END directive
(if used). See Section
2.3.4 The printf Routine
The code associated with the printf function is not found in the library files. The printf function
is generated from a special C source file that is customized after analysis of the user’s C code. See
Section for more information on the printf library function.
It contains a minimal implementation of the printf function, but with the more advanced features
included as conditional code which can be utilized via preprocessor macros that are defined when it
is compiled.
tion. For all calls, the placeholders that were specified in the printf format strings are collated to
produce a list of the desired functionality of the final function. The doprnt.c file is then prepro-
cessed with the those macros specified by the preliminary analysis, thus creating a custom printf
This routine can be supplied in a user-defined assembler module that will be executed immedi-
The file should be copied to your working directory, modified and included into your project as
The runtime startup code will invoke the powerup routine using a absolute jump and link instruc-
This template file is found in the LIB directory of the compiler distribution and is called doprnt.c.
The parser and code generator analyze the C source code, searching for calls to the printf func-
enable instruction caching and
enable predictive prefetch cache on all regions.
4.3.10.2
for more information on this assembler directive.
Runtime Files
33