1.1.9.4.15 DRV_USART_WriteBuffer Function

C

bool DRV_USART_WriteBuffer
(
    const DRV_HANDLE handle,
    void* buffer,
    const size_t size
);

Summary

This is a blocking function that writes data over USART.

Description

This function does a blocking write operation. The function blocks till the data write is complete. Function will return false to report failure. The failure will occur for the following reasons:

  • if the handle is invalid

  • if the input buffer pointer is NULL

  • if the buffer size is 0

Precondition

DRV_USART_Open must have been called to obtain a valid opened device handle.

Parameters

ParamDescription
handleHandle of the communication channel as return by the DRV_USART_Open function.
bufferPointer to the data to be transmitted.
sizeBuffer size in bytes.

Returns

true - write is successful

false - error has occurred

Example

MY_APP_OBJ myAppObj;
uint8_t myBuffer[MY_BUFFER_SIZE];

// myUSARTHandle is the handle returned
// by the DRV_USART_Open function.

if (DRV_USART_WriteBuffer(myUSARTHandle, myBuffer, MY_BUFFER_SIZE) == false)
{
    // Error handling here
}

Remarks

This function is thread safe in a RTOS application. This function should not be called from an interrupt context.