1.8.7.62 1.25.6.62 1.26.5.62 1.27.5.62 1.28.6.62 1.36.7.60 1.41.5.62 1.42.3.62 FLEXCOMx_TWI_Read Function
C
/* x = FLEXCOM instance number */
/* TWI master mode */
bool FLEXCOMx_TWI_Read(uint16_t address, uint8_t* data, size_t length)
Summary
Reads data from the slave.
Description
This function reads the data from a slave on the bus. The function will attempt to read length number of bytes into pdata buffer from a slave whose address is specified as address. The TWI Master generates a Start condition, reads the data and then generates a Stop Condition. If the slave NAKs the request or a bus error is encountered on the bus, the transfer is terminated. The application can call the FLEXCOMx_TWI_ErrorGet() function to know the cause of the error. The function is non-blocking. It initiates bus activity and returns immediately. The transfer is completed in the peripheral interrupt. A transfer request cannot be placed when another transfer is in progress. Calling the read function when another function is already in progress will cause the function to return false. The library will call the registered callback function when the transfer has completed if callback is registered.
Precondition
FLEXCOMx_TWI_Initialize must have been called for the associated FLEXCOM TWI instance.
Parameters
Param | Description |
---|---|
address | 7-bit / 10-bit slave address. |
data | pointer to destination data buffer where the received data should be stored. |
length | Number of bytes to be read |
Returns
true - The request was placed successfully and the bus activity was initiated
false - The request fails, if there was already a transfer in progress when this function was called
Example
uint8_t myData [NUM_BYTES];
if(!FLEXCOM0_TWI_Read( SLAVE_ADDR, &myData[0], NUM_BYTES ))
{
// error handling
}
Remarks
None