Corelis BusPro-I, Руководство пользователя

Страница: 225 / 250

Third Party Application Interface 211
I2C_Random_Read
Writes internal memory address of the slave device to read from, and then reads data from it.
Prototype:
extern “C” __declspec(dllexport) int _cdecl
I2C_Random_Read ( int nAddress,
int b10BitAddress,
unsigned char * pMemAddrBytes,
int nMemAddrLength,
unsigned char * pReceiveData,
int nDataCount,
int bUseStopBits);
Return Value:
-1 if
I2C_InitHardware
was never called.
-2 if a timeout occurred.
otherwise the number of bytes received (may be 0 if transfer was aborted due to address NAK)
Parameters:
nAddress
This is the 7-bit or 10-bit address of the source slave (depending on following parameter).
b10BitAddress
If 1, the above address is a 10-bit value. If 0, it is a 7-bit address.
pMemAddrBytes
A pointer to a block of memory where the internal memory address bytes of the slave device are
provided.
nMemAddrLength
The number of bytes contained in the above block of memory.
pReceiveData
A pointer to a block of memory where the receive data bytes are to be stored.
nDataCount
The number of storage bytes of the above block of memory.
bUseStopBits
If 1, a stop cycle terminates the message after the last data byte read, otherwise, no stop cycle is
issued (the analyzer continues to control the bus with SCL low, ready to perform a coming
Repeat Start on the next access).