QDK PIC24/dsPIC-XC16 - Quantum Leaps

QDK
PIC24/dsPIC-XC16
www.state-machine.com/pic
2.1 Building the QP Libraries
All QP components are deployed as libraries that you statically link to your application. The pre-built
libraries for QEP, QF, QK, and QS are provided inside the \ports\pic24-dspic directory. This
section describes steps you need to take to rebuild the libraries yourself.
NOTE: To achieve commonality among different development tools, Quantum Leaps software does
not use the vendor-specific IDEs, such as the MPLABX IDE, for building the QP libraries. Instead, QP
supports command-line build process based on simple batch scripts.
The code distribution contains the batch file make_.bat for building all the libraries located in
the \ports\pic24-dspic\... directory. For example, to build the debug version of all the QP
libraries for PIC24-dsPIC, with the MPLABX XC16 compiler, QK kernel, you open a console window on a
Windows PC, change directory to \ports\pic24-dspic\qk\xc16\, and invoke the batch by typing
at the command prompt the following command:
make_24FJ64GB002.bat
For the PIC24FJ64GB002 MCU and
make_33FJ128MC802.bat
for the dsPIC33FJ128MC802 MCU.
NOTE: You also need to adjust the symbol MPLABX_XC16 at the top of the batch scripts if you’ve
installed the XC16 compiler into a different directory. You adjust the MCU type by changing the
symbol PIC_DEVICE at the top of the make_.bat file.
The build process should produce the QP libraries in the location: \ports\pic24-dspic\qk\-
xc16\dbg\. The make_24FJ64GB002.bat files assume that the Microchip MPLABX XC16 toolset has
been installed in the directory C:\tools\Microchip\xc16\v1.10.
NOTE: It is highly recommended that you re-build the QP libraries yourself, because the libraries that
ship in the QDK have been built with optimizations disabled due to the expiration of the license key.
In order to take advantage of the QS (“spy”) instrumentation, you need to build the QS version of the QP
library. You achieve this by invoking the make_24FJ64GB002.bat utility with the “spy” target, like this:
make_24FJ64GB002.bat spy
The script should produce the QP library in the directory: \ports\pic24-dspic\qk\xc16\spy\.
You choose the build configuration by providing a target to the make_24FJ64GB002.bat utility. The
default target is “dbg”. Other targets are “rel”, and “spy”, respectively.
Table 1 Make targets for the Debug, Release, and Spy library versions
Software Version
Build command
Debug (default)
make_
Release
make_ rel
Spy
make_ spy
Copyright © Quantum Leaps, LLC. All Rights Reserved.
8 of 35