/*******************************************************************************
* Function Name: UART_1_UartGetByte
********************************************************************************
*
* Summary:
* Retrieves the next data element from the receive buffer, returns the
* received byte and error condition.
* - The RX software buffer is disabled: returns the data element retrieved
* from the RX FIFO. Undefined data will be returned if the RX FIFO is
* empty.
* - The RX software buffer is enabled: returns data element from the
* software receive buffer.
*
* Parameters:
* None
*
* Return:
* Bits 7-0 contain the next data element from the receive buffer and
* other bits contain the error condition.
*
* Side Effects:
* The errors bits may not correspond with reading characters due to RX FIFO
* and software buffer usage.
* RX software buffer is disabled: The internal software buffer overflow
* is not returned as status by this function.
* Check SCB_rxBufferOverflow to capture that error condition.
*
*******************************************************************************/
uint32 UART_1_UartGetByte(void)
{
uint32 rxData;
uint32 tmpStatus;
#if (UART_1_CHECK_RX_SW_BUFFER)
{
UART_1_DisableInt();
}
#endif
if (0u != UART_1_SpiUartGetRxBufferSize())
{
/* Enables interrupt to receive more bytes: at least one byte is in
* buffer.
*/
#if (UART_1_CHECK_RX_SW_BUFFER)
{
UART_1_EnableInt();
}
#endif
/* Get received byte */
rxData = UART_1_SpiUartReadRxData();
}
else
{
/* Reads a byte directly from RX FIFO: underflow is raised in the case
* of empty. Otherwise the first received byte will be read.
*/
rxData = UART_1_RX_FIFO_RD_REG;
/* Enables interrupt to receive more bytes.
* The RX_NOT_EMPTY interrupt is cleared by the interrupt routine
* in case the byte was received and read by code above.
*/
#if (UART_1_CHECK_RX_SW_BUFFER)
{
UART_1_EnableInt();
}
#endif
}
/* Get and clear RX error mask */
tmpStatus = (UART_1_GetRxInterruptSource() & UART_1_INTR_RX_ERR);
UART_1_ClearRxInterruptSource(UART_1_INTR_RX_ERR);
/* Puts together data and error status:
* MP mode and accept address: 9th bit is set to notify mark.
*/
rxData |= ((uint32) (tmpStatus << 8u));
return (rxData);
}
/*******************************************************************************
* Function Name: UART_1_UartGetByte
********************************************************************************
*
* Summary:
* Retrieves the next data element from the receive buffer, returns the received byte
* and error condition.
* - The RX software buffer is disabled: returns the data element retrieved from the RX FIFO.
* Undefined data will be returned if the RX FIFO is empty.
* - The RX software buffer is enabled: returns data element from the software receive
* buffer.
*
* Parameters:
* None
*
* Return:
* Bits 15-8 contains status and bits 7-0 contains the next data element from
* receive buffer. If the bits 15-8 are non-zero, an error has occurred.
*
*******************************************************************************/
uint32 UART_1_UartGetByte(void)
{
uint32 rxData;
uint32 tmpStatus;
uint32 intSourceMask;
intSourceMask = UART_1_SpiUartDisableIntRx();
if(0u != UART_1_SpiUartGetRxBufferSize())
{
/*
* Enable interrupt to receive more bytes: at least one byte is in
* buffer.
*/
UART_1_SpiUartEnableIntRx(intSourceMask);
/* Get received byte */
rxData = UART_1_SpiUartReadRxData();
}
else
{
/*
* Read byte directly from RX FIFO: the underflow is raised in case
* of empty. In other case the first received byte will be read.
*/
rxData = UART_1_RX_FIFO_RD_REG;
/*
* Enable interrupt to receive more bytes.
* The RX_NOT_EMPTY interrupt is cleared by the interrupt routine in case
* the byte was received and read above.
*/
UART_1_SpiUartEnableIntRx(intSourceMask);
}
/* Get and clear RX error mask */
tmpStatus = (UART_1_GetRxInterruptSource() & UART_1_INTR_RX_ERR);
UART_1_ClearRxInterruptSource(UART_1_INTR_RX_ERR);
/*
* Put together data and error status:
* MP mode and accept address: the 9th bit is set to notify mark.
*/
rxData |= ((uint32) (tmpStatus << 8u));
return(rxData);
}
