Jump to main content

##

# 2.27.7 DBGU_WriteCountGet Function

## C

    /* Non-blocking and ring buffer mode */

    size_t DBGU_WriteCountGet( void )

## Summary

Non-blocking mode

Gets the byte count of processed bytes for a given DBGU 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 DBGU 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

DBGU_Initialize must have been called for the associated DBGU 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 = DBGU_WriteCountGet();

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

Ring buffer mode

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

## Remarks

None