USERI2CRESPONSE

Status of USERI2CREAD or USERI2CWRITE Command

Platform:

OEM7600, OEM7700, OEM7720

This log reports the status of a previously executed USERI2CREAD or USERI2CWRITE command. There is one log emitted for each command that is executed.

For the USERI2CREAD command, this log outputs the data read from the device on the I2C bus and the status of the read operation.

For the USERI2CWRITE command, the status of the write operation is reported and the data field will always be 0.

Message ID: 2234

Recommended Input:

log USERI2CRESPONSE onnew

Abbreviated ASCII Example 1:

USERI2CREAD 70 4 aabbccdd 12 6789

<USERI2CRESPONSE COM1 0 84.0 FINESTEERING 1994 257885.895 02000000 e3f6 32768
<     70 aabbccdd OK READ 6789 12 000102030405060708090a0b

Abbreviated ASCII Example 2:

USERI2CWRITE 70 3 aabbcc 8 0001020304050607 12345

<USERI2CRESPONSE COM1 0 84.0 FINESTEERING 1994 257885.895 02000000 e3f6 32768
<     70 aabbcc OK WRITE 12345 0

Field

Field Type

Description

Format

Binary Bytes

Binary Offset

1

Log header

USERI2CRESPONSE header

For information about log headers, see ASCII, Abbreviated ASCII or Binary.

-

H

0

2

DeviceAddress

The 7 bit address of the I2C device. Valid values are 0 through 127.

For ASCII and Abbreviated commands, this field is a hexadecimal string of two digits. There is no 0x prefix and spaces are not allowed in the string.

Uchar

11

H

3

RegisterAddress

The actual register address used for the operation. This is a ULONG value in hexadecimal format (without 0x prefix).

Ulong

4

H+4

4

ErrorCode

Error code for the operation. See Table: Error Code.

Enum

4

H+8

5

OperationMode

Operation mode code. See Table: Operation Mode Code.

Enum

4

H+12

6

TransactionID

This is the copy of Transaction ID provided to the command.

Ulong

4

H+16

7

ReadDataLength

For a Read operation, this is the actual number of bytes read from the I2C device.

For a Write operation, this value is always zero.

Ulong

4

H+20

8

ReadData

For a Read operation, this is the data read from the device. For ASCII logs this field is displayed as a string of hexadecimal digits, with two digits per byte. The first byte retrieved from the I2C device is the first byte displayed and so on.

The maximum size of this field is 256 bytes.

When ReadDataLength is zero, this field will be empty.

HEXBYTE
ARRAY

Y

H+24

Error Code

Binary

ASCII

Description

0

OK

I2C transaction is successful

1

IN_PROGRESS

I2C transaction is currently in progress

2

DATA_TRUNCATION

I2C transaction read data was truncated

3

BUS_BUSY

I2C bus is busy

4

NO_DEVICE_REPLY

No device replied to the I2C transaction request

5

BUS_ERROR

I2C bus error or bus arbitration lost

6

TIMEOUT

I2C transaction has timed out

7

UNKNOWN_FAILURE

I2C transaction has an unexplained failure

Operation Mode Code

Binary

ASCII

Description

0

NONE

No Operation

1

READ

Read Operation

2

WRITE

Write Operation

3

SHUTDOWN

Shut down Operation