QDK PIC24/dsPIC-C30 - Quantum Leaps

QDK
PIC24/dsPIC-C30
www.state-machine.com/pic
return (uint8_t)1; /* indicate successfull QS initialization */
}
/*..........................................................................*/
(9) void QS_onCleanup(void) {
}
/*..........................................................................*/
(10) void QS_onFlush(void) {
uint16_t b;
while ((b = QS_getByte()) != QS_EOD) { /* next QS trace byte available */
while (U2STAbits.UTXBF != 0U) { /* TX Buffer full */
}
U2TXREG = (uint8_t)b; /* stick the byte to TXREG for transmission */
}
}
/*..........................................................................*/
/* NOTE: invoked within a critical section (inetrrupts disabled) */
(11) QSTimeCtr QS_onGetTime(void) {
(12) if (_T2IF == 0) {
(13) return l_tickTime + (uint32_t)TMR2;
}
else {
(14) return l_tickTime + BSP_TMR2_PERIOD + (uint32_t)TMR2;
}
}
#endif /* Q_SPY */
(1) The QS instrumentation is enabled only when the macro Q_SPY is defined
(2) The l_tickTime variable is used to hold the 32-bit-wide the timestamp at tick and is updated in the
system clock tick ISR.
(3) This enumeration defines application-specific QS trace record(s), to demonstrate how to use them.
(4) You need to define the QS_init() callback to initialize the QS software tracing.
(5) You should adjust the QS buffer size (in bytes) to your particular application
(6) You always need to call QS_initBuf() from QS_init() to initialize the trace buffer.
(7) This block of code sets up UART2 to output data at the desired baud rate and standard format
(8N1).
(8) The QS filters are set-up statically.
(9) The QS_onCleanup() callback performs the cleanup of QS. Here nothing needs to be done.
(10) The QS_onFlush() callback flushes the QS trace buffer to the host. Typically, the function busywaits
for the transfer to complete. It is only used in the initialization phase for sending the QS
dictionary records to the host (see please refer to “QSP Reference Manual” section in the “QP/C
Reference Manual” an also to Chapter 11 in [PSiCC2])
7.1 QS Time Stamp Callback QS_onGetTime()
The platform-specific QS port must provide function QS_onGetTime() (Listing 12(11)) that returns the
current time stamp in 32-bit resolution. To provide such a fine-granularity time stamp, the PIC24/dsPIC
port uses the Timer2, which is the same timer already used for generation of the system clock-tick
interrupt.
Copyright © Quantum Leaps, LLC. All Rights Reserved.
31 of 35