QDK-nano PIC24/dsPIC-C30 - Quantum Leaps

Table of Contents
1 Introduction ..................................................................................................................................................... 1
1.1 About QP-nano ........................................................................................................................................... 2
1.2 About the QP-nano Port to PIC24/dsPIC .................................................................................................... 3
1.3 What’s Included in the QDK-nano-PIC24-dsPIC? .......................................................................................... 4
1.4 Licensing QP-nano ..................................................................................................................................... 5
2 Getting Started ................................................................................................................................................ 6
2.1 Software Installation ....................................................................................................................................... 6
2.2 Building and Running the Examples .............................................................................................................. 8
3 Non-Preemptive “Vanilla” Port ...................................................................................................................... 10
3.1 The qpn_port.h Header File ........................................................................................................................... 10
3.2 ISRs in the Non-Preemptive “Vanilla” Configuration ...................................................................................... 11
3.3 QP Idle Loop Customization in QF_onIdle() ................................................................................................... 13
4 Preemptive Configuration with QK-nano ................................................................................................... 15
4.1 QK-nano-specific ISR Entry and Exit Macros (file qpn_port.h) ....................................................................... 15
4.2 ISRs with the Preemptive QK-nano Kernel .................................................................................................... 17
4.3 Idle Loop Customization in the QK-nano Port ................................................................................................ 20
4.4 Testing QK Preemption Scenarios ................................................................................................................. 21
5 Implementing “Zero Interrupt Latency” with the NMI .................................................................................. 24
5.1 Communication between NMIs and QP-nano ................................................................................................ 24
5.2 Implementation Considerations for the NMIs ................................................................................................. 24
6 BSP for the Explorer 16 Board ....................................................................................................................... 25
6.1 Setting the Sizes of Stack and Heap .............................................................................................................. 25
6.2 The BSP header file bsp.h ............................................................................................................................. 26
6.3 BSP initialization ............................................................................................................................................ 26
6.4 Starting Interrupts in QF_onStartup() ............................................................................................................. 26
6.5 Assertion Handling Policy in Q_onAssert() .................................................................................................... 27
7 Related Documents and References ............................................................................................................. 28
8 Contact Information ........................................................................................................................................ 29
Copyright © Quantum Leaps, LLC. All Rights Reserved.
i