 |
 |
|---|---|
USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x GigE |
Syntax
INT is_ReadI2C (HIDS hCam, INT nDeviceAddr, INT nRegisterAddr, BYTE* pbData, INT nLen)
Beschreibung
Mit is_ReadI2C() können bei einigen uEye Platinenkameras Daten über das TWI (Two Wire Interface) gelesen werden.
Die Funktion erwartet die Geräteadresse als 8-bit-Wert, der durch einen Bitshift nach links aus der 7-bit-Adresse des Bausteins laut Datenblatt erzeugt wird. Die Funktion füllt das Bit 0 automatisch, um zu kennzeichnen ob auf die Geräteadresse geschrieben (0) oder von dort gelesen (1) werden soll.
Für Informationen zur Beschaltung des TWI siehe im Kapitel D: Spezifikationen.
|
I2C-Funktionen werden derzeit von folgenden Platinenversionen unterstützt: •uEye LE USB 3.1 Gen 1 •USB 3 uEye LE •USB uEye LE •GigE uEye LE. |
|
Folgende Adressen für nDeviceAddr sind von der uEye Kamera belegt und dürfen nicht verwendet werden: 7-bit-Format: 0x10, 0x20, 0x21, 0x48, 0x49, 0x4C, 0x50, 0x51, 0x52, 0x55, 0x5C, 0x5D, 0x69, 0x77 8-bit-Format: 0x20, 0x40, 0x42, 0x90, 0x92, 0x98, 0xA0, 0xA2, 0xA4, 0xAA, 0xB8, 0xBA, 0xD2, 0xEE Zusätzlich bei UI-336x/UI-536x und UI-337x/UI-537x: 0x82 |
Übergabeparameter
hCam |
Handle auf Kamera |
nDeviceAdr |
Slave-Geräteadresse (8-Bit-Format) |
nRegisterAddr |
Adresse eines 8-Bit-Registers (nur 8-bit-Adressen gültig) |
nRegisterAddr | |
Adresse eines 16-Bit-Registers |
nRegisterAddr | |
Wenn nur eine Geräteadresse aber keine Register-Adresse vorhanden ist. |
pbData |
Zeiger auf die zu lesende Daten |
nLen |
Datenlänge nLen = 1: 8 Bit Daten nLen = 2: 16 Bit Daten |
Rückgabewert
IS_CANT_COMMUNICATE_WITH_DRIVER |
Kommunikation mit dem Kameratreiber schlug fehl, weil kein Treiber geladen ist. |
IS_CANT_OPEN_DEVICE |
Ein Versuch die Kamera zu öffnen schlug fehl (Kamera nicht vorhanden oder Fehler beim Initialisieren). |
IS_INVALID_CAMERA_HANDLE |
Ungültiges Kamera-Handle |
IS_INVALID_I2C_DEVICE_ADDRESS |
Ungültige I2C-Geräteadresse |
IS_INVALID_PARAMETER |
Einer der übergebenen Parameter ist außerhalb des gültigen Bereichs, oder für diesen Sensor nicht unterstützt, bzw. in diesem Modus nicht zugänglich. |
IS_IO_REQUEST_FAILED |
Eine IO Anforderung des uEye Treibers schlug fehl. Eventuell passen die Versionen der Dateien ueye_api.dll (API) und ueye_usb.sys bzw. ueye_eth.sys (Treiber) nicht zusammen. Dieser Fehlercode wird auch zurückgegeben, wenn sich der Mikrocontroller nicht korrekt mit ACK zurückmeldet. |
IS_NO_SUCCESS |
Allgemeine Fehlermeldung |
IS_SUCCESS |
Funktion erfolgreich |
Verwandte Funktionen
•is_DeviceFeature(): I2C-Stop-Bit setzen
Beispiel
Siehe is_WriteI2C()
