1.8.7.5 1.25.6.5 1.26.5.5 1.27.5.5 1.28.6.5 1.36.7.5 1.41.5.5 1.42.3.5 FLEXCOMx_USART_WriteCountGet Function

C

/* x = FLEXCOM instance number */

/* Non-blocking and ring buffer mode */

size_t FLEXCOMx_USART_WriteCountGet( void )

Summary

Non-blocking mode

Gets the byte count of processed bytes for a given USART write operation

Ring buffer mode

Returns the number of bytes pending to be transmitted out in the transmit buffer.

Description

Non-blocking mode

This function gets the count of processed bytes for an on-going or last completed USART Transmit operation. This function can be used to track the progress of the non-blocking transmit operation.

Ring buffer mode

This function returns the number of bytes of data pending for transmission.

Precondition

FLEXCOMx_USART_Initialize must have been called for the associated USART instance.

Parameters

None.

Returns

Non-blocking mode

Returns count of bytes currently completed/processed from the current Transmit buffer for interrupt non-blocking mode. In 9-bit mode, it returns the number of 9-bit data processed.

Ring buffer mode

The API returns the number of bytes that are pending for transmission in the internal transmit buffer. If 9-bit mode is enabled, then the return value indicates the number of 9-bit data pending transmission.

Example

Non-blocking mode

size_t count;

count = FLEXCOM0_USART_WriteCountGet();

if(count < COUNT_EXPECTED)
{
    //More bytes are expected to transmit, wait
}

Ring buffer mode

if (FLEXCOM0_USART_WriteCountGet() == 0)
{
    // All the data has been transmitted out.
}

Remarks

None