AN: Capstone Dive Computer Example - Quantum Leaps

Application Note:
Capstone Dive Computer Example
www.state-machine.com
UART_InitStruct.UART_HardwareFlowControl = UART_HardwareFlowControl_None;
UART_InitStruct.UART_Mode = UART_Mode_Tx;
UART_InitStruct.UART_FIFO = UART_FIFO_Enable;
UART_InitStruct.UART_TxFIFOLevel = UART_FIFOLevel_1_8;
UART_InitStruct.UART_RxFIFOLevel = UART_FIFOLevel_1_8;
UART_Init(UART0, &UART_InitStruct); /* initialize UART0 */
UART_Cmd(UART0, ENABLE); /* enable UART0 */
(14) QS_FILTER_ON(QS_ALL_RECORDS);
QS_FILTER_OFF(...);
...
/* setup the QS filters... */
(15)
}
return (uint8_t)1; /* indicate successfull QS initialization */
/*..........................................................................*/
(16) void QS_onCleanup(void) {
}
/*..........................................................................*/
/* NOTE: getTime is invoked within a critical section (inetrrupts disabled) */
(17) uint32_t QS_onGetTime(void) {
(18) uint16_t currTime16 = (uint16_t)TIM3->CNTR;
(19)
(20)
l_currTime32 += (currTime16 - l_prevTime16) & 0xFFFF;
l_prevTime16 = currTime16;
(21) return l_currTime32;
}
/*..........................................................................*/
(22) void QS_onFlush(void) {
uint16_t nBytes = BSP_UART_TX_FIFO; /* the capacity of the UART TX FIFO */
uint8_t const *block;
(23) while ((block = QS_getBlock(&nBytes)) != (uint8_t *)0) {
(24) while ((UART0->FR & 0x80) == 0) {
}
/* TX FIFO not empty? */
/* keep waiting... */
(25) while (nBytes-- != 0) {
}
UART0->DR = *block++; /* stick the byte to the TX FIFO */
nBytes = BSP_UART_TX_FIFO; /* for the next time around */
}
}
#endif /* Q_SPY */
/*--------------------------------------------------------------------------*/
Listing 5 QS implementation to send data out of the UART0 of the STR912 device.
(1) The QS instrumentation is enabled only when the macro Q_SPY is defined
(2) The static l_currTime32 variable is used to hold the 32-bit-wide timestamp.
(3) The static l_prevTime16 variable is used to hold the last 16-bit-wide reading of the free-running
16-bit Timer 3 (the same used to generate the system clock tick interrupt).
(4) This enumeration defines application-specific QS trace record(s), to demonstrate how to use
them.
(5) You need to define the QS_onStartup() callback to initialize the QS software tracing.
(6) You should adjust the QS buffer size (in bytes) to your particular application
(7) You always need to call QS_initBuf() from QS_onStartup() to initialize the trace buffer.
(8-9) The clock to the UART0 peripheral is enabled. Also, the clock to the GPIO3 peripheral is enabled.
GPIO3 controls the UART0 transmit and receive pins.
(10-11) The UART0 and GPIO3 peripherals are removed from reset.
Copyright © Quantum Leaps, LLC. All Rights Reserved.
24 of 29