QDK PIC24/dsPIC-C30 - Quantum Leaps

Table of Contents
1 Introduction ..................................................................................................................................................... 1
1.1 About QP .................................................................................................................................................... 2
1.2 About the QP Port to PIC24/dsPIC ............................................................................................................. 3
1.3 What’s Included in the QDK-PIC24-dsPIC ................................................................................................... 4
1.4 Licensing QP .............................................................................................................................................. 4
2 Getting Started ................................................................................................................................................ 5
2.1 Software Installation ....................................................................................................................................... 5
2.2 Building the QP Libraries ............................................................................................................................... 7
2.3 Building and Running the Examples .............................................................................................................. 8
3 Non-Preemptive “Vanilla” Port ...................................................................................................................... 12
3.1 The qep_port.h Header File ........................................................................................................................... 12
3.2 The qf_port.h Header File .............................................................................................................................. 12
3.3 ISRs in the Non-Preemptive “Vanilla” Configuration ...................................................................................... 14
3.4 QP Idle Loop Customization in QF_onIdle() ................................................................................................... 16
4 Preemptive Configuration with QK ................................................................................................................ 17
4.1 QK-specific ISR Entry and Exit Macros (file qk_port.h) .................................................................................. 17
4.2 ISRs with the Preemptive QK Kernel ............................................................................................................. 19
4.3 Idle Loop Customization in the QK Port ......................................................................................................... 22
4.4 Testing QK Preemption Scenarios ................................................................................................................. 23
5 Implementing “Zero Interrupt Latency” with the NMI .................................................................................. 26
5.1 Communication between NMIs and QP ......................................................................................................... 26
5.2 Implementation Considerations for the NMIs ................................................................................................. 26
6 BSP for the Explorer 16 Board ....................................................................................................................... 27
6.1 Setting the Sizes of Stack and Heap .............................................................................................................. 27
6.2 The BSP header file bsp.h ............................................................................................................................. 28
6.3 BSP initialization ............................................................................................................................................ 28
6.4 Starting Interrupts in QF_onStartup() ............................................................................................................. 28
6.5 Assertion Handling Policy in Q_onAssert() .................................................................................................... 28
7 The QS Software Tracing Instrumentation ................................................................................................... 30
7.1 QS Time Stamp Callback QS_onGetTime() ................................................................................................... 31
7.2 QS Trace Output in QF_onIdle()/QK_onIdle() ................................................................................................ 33
7.3 Invoking the QSpy Host Application ............................................................................................................... 33
8 Related Documents and References ............................................................................................................. 34
9 Contact Information ........................................................................................................................................ 35
Copyright © Quantum Leaps, LLC. All Rights Reserved.
i