NXC  Version 1.2.1 r5
 All Data Structures Files Functions Variables Groups Pages
long I2CRead ( const byte  port,
byte  buflen,
byte &  buffer[] 
)
inline

Read I2C data.

Read the specified number of bytes from the I2C device on the specified port and store the bytes read in the byte array buffer provided. The maximum number of bytes that can be written or read is 16.

Parameters
portThe port to which the I2C device is attached. See the Input port constants group. You may use a constant or a variable. Constants should be used where possible to avoid blocking access to I2C devices on other ports by code running on other threads.
buflenThe initial size of the output buffer.
bufferA byte array that contains the data read from the internal I2C buffer. If the return value is negative then the output buffer will be empty.
Returns
A status code indicating whether the write completed successfully or not. See CommLSReadType for possible result values. If the return value is NO_ERR then the last operation did not cause any errors.
See Also
I2CCheckStatus, I2CWrite, I2CStatus, I2CBytesReady, LowspeedRead, LowspeedWrite, LowspeedCheckStatus, LowspeedBytesReady, and LowspeedStatus
Examples:
ex_I2CRead.nxc.