03.11.2014 Views

QDK-nano PIC24/dsPIC-C30 - Quantum Leaps

QDK-nano PIC24/dsPIC-C30 - Quantum Leaps

QDK-nano PIC24/dsPIC-C30 - Quantum Leaps

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

<strong>QDK</strong>-<strong>nano</strong><br />

<strong>PIC24</strong>/<strong>dsPIC</strong>-<strong>C30</strong><br />

www.state-machine.com/pic<br />

2 Getting Started<br />

This section describes how to install, build, and use <strong>QDK</strong>-<strong>PIC24</strong>-<strong>dsPIC</strong>-<strong>C30</strong>.<br />

2.1 Software Installation<br />

The <strong>QDK</strong>-<strong>nano</strong> code is distributed in a ZIP archive (qdkn_pic24_dspic-c30_.zip, where <br />

stands for a specific <strong>QDK</strong>-<strong>nano</strong> version, such as 4.0.04). You can uncompress the archive into any<br />

directory. The installation directory you choose will be referred henceforth as . The following<br />

shows the directory structure and selected files included in the QP-<strong>nano</strong> distribution. (Please note that the<br />

QP-<strong>nano</strong> directory structure is described in detail in a separate <strong>Quantum</strong> <strong>Leaps</strong> Application Note: “QP<br />

Directory Structure”).<br />

NOTE: Every <strong>QDK</strong>-<strong>nano</strong> contains only example(s) pertaining to the specific MCU and compiler, but<br />

does not include the platform-independent baseline code of QP-<strong>nano</strong>, which is available for a<br />

separate download. It is strongly recommended that you read Chapter 12 in [PSiCC2] before you<br />

start with this <strong>QDK</strong>-<strong>nano</strong>.<br />

Listing 1: Selected QP directories and files after installing <strong>QDK</strong>-<strong>nano</strong>-<strong>PIC24</strong>/<strong>dsPIC</strong>-<strong>C30</strong><br />

/<br />

- QP-<strong>nano</strong> Root Directory<br />

|<br />

+-doc\<br />

| +-AN_PELICAN.pdf - Application Note “PELICAN crossing example”<br />

| +-<strong>QDK</strong>n_<strong>PIC24</strong>-<strong>dsPIC</strong>.pdf – This <strong>QDK</strong>-<strong>nano</strong> Manual “<strong>QDK</strong>-<strong>nano</strong> <strong>PIC24</strong>-<strong>dsPIC</strong>-<strong>C30</strong>”<br />

|<br />

+-examples\<br />

- subdirectory containing the QP example files<br />

| +-pic24_dspic\ - <strong>PIC24</strong>/<strong>dsPIC</strong> examples<br />

| | +-mplab-c30\ - Microchip MPLAB <strong>C30</strong> compiler<br />

| | | +-pelican-explorer16_pic24\ - PELICAN example for Explorer 16 with <strong>PIC24</strong><br />

| | | | +-dbg\ - directory containing the Debug build<br />

| | | | | +-pelican-dbg.cof - image of the application<br />

| | | | | +-pelican-dbg.map - map file of the application<br />

| | | | +-rel\ - directory containing the Release build<br />

| | | | |<br />

| | | | +-bsp.c - BSP for Explorer 16 with <strong>PIC24</strong>FJ128GA010<br />

| | | | +-bsp.h - BSP header file<br />

| | | | +-main.c - the main function<br />

| | | | +-pelican.c - the PELICAN active objects<br />

| | | | +-pelican.h - the PELICAN application header file<br />

| | | | +-ped.c - the Pedestrian active object<br />

| | | | +-pelican-dbg.mcp – MPLAB project for Debug configuration<br />

| | | | +-pelican-rel.mcp – MPLAB project for Release configuration<br />

| | | | +-pelican-explorer16_pic24.mcw – MPLAB workspace for the application<br />

| | | | +-p24FJ128GA010.gld - Linker script for <strong>PIC24</strong>FJ128GA010<br />

| | | | +-qpn_port.h - QP-<strong>nano</strong> port to <strong>PIC24</strong>FJ128GA010 with Vanilla kernel<br />

| | | | |<br />

| | | +-pelican-explorer16_dspic\ - PELICAN example for Explorer 16 with <strong>dsPIC</strong><br />

| | | | +-dbg\ - directory containing the Debug build<br />

| | | | | +-pelican-dbg.cof - image of the application<br />

| | | | | +-pelican-dbg.map - map file of the application<br />

| | | | +-rel\ - directory containing the Release build<br />

Copyright © <strong>Quantum</strong> <strong>Leaps</strong>, LLC. All Rights Reserved.<br />

6 of 29

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!