QDK PIC24/dsPIC-C30 - Quantum Leaps

More documents

Recommendations

Info

QDK PIC24/dsPIC-C30 www.state-machine.com/pic 7 The QS Software Tracing Instrumentation QS is a software tracing facility built into all QP components and also available to the Application code. QS allows you to gain unprecedented visibility into your application by selectively logging al-most all interesting events occurring within state machines, the framework, the kernel, and your application code. QS software tracing is minimally intrusive, offers precise time-stamping, sophisticated runtime filtering of events, and good data compression (see Chapter 11 in PSiCC2 [PSiCC2]). This QDK demonstrates how to use the QS software tracing instrumentation to generate real-time trace of a running QP application. QS can be configured to send the trace data out of the serial port of the target device. On the Explorer 16 board, QS uses the built-in UART2 to send the trace data to the host. The QS platform-dependent implementation is located in the file bsp.c and looks as follows: (1) #ifdef Q_SPY Listing 12: QS implementation to send data with UART2 of PIC24/dsPIC MCU (2) static uint32_t l_tickTime; /* timestamp at tick */ (3) enum AppRecords { /* application-specific trace records */ PHILO_STAT = QS_USER }; #define QS_BUF_SIZE #define BAUD_RATE 1024U 38400U (4) uint8_t QS_onStartup(void const *arg) { (5) static uint8_t qsBuf[QS_BUF_SIZE]; /* buffer for Quantum Spy */ (6) QS_initBuf(qsBuf, sizeof(qsBuf)); /* initialize the QS trace buffer */ /* initialize the UART2 for transmitting the QS trace data */ (7) TRISFbits.TRISF5 = 0; /* set UART2 TX pin as output */ U2MODE = 0x0008; /* enable high baud rate */ U2STA = 0x0000; /* use default settings of 8N1 */ U2BRG = ((BSP_FCY_HZ / 4 / BAUD_RATE) - 1); /* baud rate generator */ U2MODEbits.UARTEN = 1; U2STAbits.UTXEN = 1; (8) QS_FILTER_ON(QS_ALL_RECORDS); /* setup the QS filters... */ // QS_FILTER_OFF(QS_QEP_STATE_EMPTY); // QS_FILTER_OFF(QS_QEP_STATE_ENTRY); // QS_FILTER_OFF(QS_QEP_STATE_EXIT); // QS_FILTER_OFF(QS_QEP_STATE_INIT); // QS_FILTER_OFF(QS_QEP_INIT_TRAN); // QS_FILTER_OFF(QS_QEP_INTERN_TRAN); // QS_FILTER_OFF(QS_QEP_TRAN); // QS_FILTER_OFF(QS_QEP_dummyD); QS_FILTER_OFF(QS_QF_ACTIVE_ADD); . . . Copyright © Quantum Leaps, LLC. All Rights Reserved. 30 of 35
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
Page 1 and 2: QP state machine frameworks for PIC
Page 3 and 4: 1 Introduction This QP Development
Page 5 and 6: QDK PIC24/dsPIC-C30 www.state-machi
Page 31: QDK PIC24/dsPIC-C30 www.state-machi
Page 37: QDK PIC24/dsPIC-C30 www.state-machi

QDK PIC24/dsPIC-C30 - Quantum Leaps

Create successful ePaper yourself

Delete template?

Save as template?