1.1.2.4.15 DRV_I2C_ReadTransfer Function

bool DRV_I2C_ReadTransfer(
    const DRV_HANDLE handle,
    uint16_t address,
    void* const buffer,
    const size_t size
)

This is a blocking function that performs a I2C read operation.

This function does a blocking read operation. The function blocks till the read is complete or error has occurred during read. Function will return false to report failure.

The failure will occur for the following reasons:

• Invalid input parameters

• Hardware error

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

true - read is successful

false - error has occurred

uint8_t myRxBuffer[MY_RX_BUFFER_SIZE];

// myI2CHandle is the handle returned
// by the DRV_I2C_Open function.

// slaveAddress is address of I2C slave device
// to which data is to be written

if (DRV_I2C_ReadTransfer(myI2CHandle, slaveAddress, myRxBuffer, MY_RX_BUFFER_SIZE) == false)
{
    // Error handling here
}

This function is thread safe in a RTOS application. This function should not be called from an interrupt context. This function is available only in the synchronous mode.