QDK PIC24/dsPIC-C30 - Quantum Leaps

QDK
PIC24/dsPIC-C30
www.state-machine.com/pic
3 Non-Preemptive “Vanilla” Port
The “vanilla” port shows how to use QP on a bare metal PIC24-dsPIC-based system with the
cooperative “vanilla” kernel. In this version you’re using the non-preemptive kernel built-into the QF
framework and your’e not using the QK component.
3.1 The qep_port.h Header File
The QEP header file for the PIC24/dsPIC port is located in \ports\pic24-dspic\vanilla\mplabc30\qep_port.h.
Listing 2 shows the qep_port.h header file for PIC24/dsPIC.
NOTE: The QP port to the cooperative “Vanilla” kernel qep_port.h is generic and should not need
to change for other PIC24/dsPIC applications.
Listing 2: qep_port.h header file for the cooperative QP configuration and MPLAB-C30 compiler
#ifndef qep_port_h
#define qep_port_h
(1) #define Q_SIGNAL_SIZE 2
/* 2-byte signal space (64K signals) */
/* Exact-width types. WG14/N843 C99 Standard, Section 7.18.1.1 */
(2) typedef signed char int8_t;
typedef signed int int16_t;
typedef signed long int32_t;
typedef unsigned char uint8_t;
typedef unsigned int uint16_t;
typedef unsigned long uint32_t;
#include "qep.h" /* QEP platform-independent public interface */
#endif /* qep_port_h */
(1) The macro Q_SIGNAL_SIZE defines the size (in bytes) of event signals. The allowed values are 1, 2,
or 4 bytes. Here the value of Q_SIGNAL_SIZE is set to 2, which means that the QP application can
use up to 64K different signals.
(2) The C99-standard exact-width integer types are defined explicitly, because the MPLAB-C30
compiler does not provide the standard header file.
3.2 The qf_port.h Header File
The QF header file for the PIC24/dsPIC port is located in \ports\pic24-dspic\ vanilla\mplabc30\qf_port.h.
This file specifies the interrupt locking/unlocking policy (QF critical section) as well as
the configuration constants for QF (see Chapter 8 in [PSiCC2]).
The most important porting decision you need to make in the qf_port.h header file is the policy for
locking and unlocking interrupts. The PIC24/dsPIC CPU allows using the simplest “unconditional interrupt
unlocking” policy (see Section 7.3.2 of the book “Practical UML Statecharts in C/C++, Second Edition”
Copyright © Quantum Leaps, LLC. All Rights Reserved.
12 of 35