Home > C: Programming > Function Descriptions > History back  Previous chapter  Next chapter  Print  

is_ReadI2C

uEye Camera Manual Version 3.80

is_ReadI2C

Windows_Logo

Linux_Logo

USB 2.0

USB 2.0

Syntax

INT is_ReadI2C (HIDS hCam,
INT nDeviceAddr, INT nRegisterAddr,
BYTE* pbData, INT nLen)

Description

Using is_ReadI2C(), you can read data over the I2C bus of a board level camera.

The uEye processes I2C addresses in a 7-bit format that is created from the 8-bit format by a bit shift to the right. The eighth bit indicates whether an address is a read (1) or write (0) address. For example, the 7-bit address 0x48 is the write address 0x90 and the read address 0x91 in 8-bit format.

For information on the signals applied to the I2C bus, refer to the chapters with electrical specifications for the USB uEye LE and the USB uEye ME.

Hinweis

The is_ReadI2C() function is only supported by PCB versions of the USB uEye ME/LE camera series.

Achtung

The following addresses for nRegisterAddr are assigned to the uEye and must not be used:
7-bit format: 0x10, 0x48, 0x4C, 0x50, 0x51, 0x52, 0x55, 0x5C, 0x5D, 0x69

8-bit format: 0x20, 0x90, 0x98, 0xA0, 0xA2, 0xA4, 0xAA, 0xB8, 0xBA, 0xD2

Input Parameters

hCam

Camera handle

nDeviceAddr

Slave device address in 7-bit format

nRegisterAddr

Address of a 8 bit register (only 8-bit addresses are valid)

nRegisterAddr |
IS_I2C_16_BIT_REGISTER

Address of a 16 bit register

pbData

Pointer to the data to be read

nLen

Data length

nLen = 1: 8 bits data

nLen = 2: 16 bits data

Return Values

IS_SUCCESS

Function executed successfully

IS_NO_SUCCESS

General error message

IS_INVALID_I2C_DEVICE_ADDRESS

Invalid I2C device address

Related Functions

is_WriteI2C()

Example

see is_WriteI2C()

Suggestion for improvement? Send us your short Feedback on this chapter. Thank you very much!


© 2010 IDS Imaging Development Systems GmbH
http://www.ids-imaging.com