is_DeviceInfo

USB 3.0

GigE

USB 3.0

GigE

Syntax

INT is_DeviceInfo (HIDS hCam, UINT nCommand, void* pParam, UINT cbSizeOfParam)

Beschreibung

Mit is_DeviceInfo() können Informationen über angeschlossene USB 3 und GigE uEye Kameras abgefragt werden. Die Informationen werden in die Struktur IS_DEVICE_INFO geschrieben. Die Kameras müssen dazu nicht geöffnet sein (siehe Beispiel 1).

Wird die Funktion in Kombination mit einer GigE uEye Kamera verwendet, dann kann auch ein Zeiger auf eine Struktur von UEYE_ETH_DEVICE_INFO übergeben werden (siehe Beispiel 2).

Über den Übergabeparameter nCommand wird dabei der Funktionsmodus gewählt. Der Übergabeparameter pParam ist abhängig vom Funktionsmodus unterschiedlich belegt; bei Funktionen zum Setzen oder Rücklesen eines Wertes enthält pParam einen Zeiger auf eine Variable vom Typ UINT. Die Größe des Speicherbereichs, auf den pParam verweist, wird im Übergabeparameter cbSizeOfParam angegeben.

Übergabeparameter

hCam

nDeviceId | IS_USE_DEVICE_ID
nDeviceId = Geräte-ID der Kamera

pParam

Zeiger auf Funktionsparameter, der abhängig von nCommand unterschiedlich belegt ist.

cbSizeOfParam

Größe des Speicherbereichs in Byte, auf den pParam verweist.

Inhalt der Struktur IS_DEVICE_INFO

IS_DEVICE_INFO_HEARTBEAT

infoDevHeartbeat

Kamerabezogene Daten der Kamera (aus dem Heartbeat-Telegramm)

Siehe IS_DEVICE_INFO_HEARTBEAT

IS_DEVICE_INFO_CONTROL

infoDevControl

Kamerabezogene Daten des Treibers

Siehe IS_DEVICE_INFO_CONTROL

BYTE

reserved[240]

reserviert

Inhalt der Struktur IS_DEVICE_INFO::IS_DEVICE_INFO_HEARTBEAT

BYTE	reserved_1[24]	reserviert
DWORD	dwRuntimeFirmwareVersion	Firmware Version
BYTE	reserved_2[8]	reserviert
WORD	wTemperature	Kameratemperatur in Grad Celsius Bit 15: Vorzeichen Bit 14...11: vorzeichenrichtig erweiterte Bits Bit 10...4: Temperatur (Stellen vor dem Komma) Bit 3...0: Temperatur (Stellen nach dem Komma) Sie finden die Angaben für die Umgebungsbedingungen der einzelnen Kamerafamilien unter D: Spezifikationen. Wird der Wert "-127,9 °C" zurückgegeben, besitzt die Kamera keinen Temperatursensor.
WORD	wLinkSpeed_Mb	Übertragungsgeschwindigkeit: •IS_USB_HIGH_SPEED = 480 •IS_USB_SUPER_SPEED = 4000
BYTE	reserved_3[6]	reserviert
WORD	wComportOffset	Offset des Comport
BYTE	reserved[200]	reserviert

Inhalt der Struktur IS_DEVICE_INFO::IS_DEVICE_INFO_CONTROL

DWORD	dwDeviceId	Systeminterne Geräte-ID der Kamera
BYTE	reserved[148]	reserviert

Inhalt der Struktur UEYE_ETH_DEVICE_INFO

UEYE_ETH_DEVICE_INFO_HEARTBEAT	infoDevHeartbeat	Kamerabezogene Daten der Kamera (aus dem Heartbeat-Telegramm) Siehe unten: UEYE_ETH_DEVICE_INFO_HEARTBEAT
UEYE_ETH_DEVICE_INFO_CONTROL	infoDevControl	Kamerabezogene Daten des Treibers Siehe unten: UEYE_ETH_DEVICE_INFO_CONTROL
UEYE_ETH_ADAPTER_INFO	infoAdapter	Netzwerkkarten-bezogene Daten des Treibers Siehe unten: UEYE_ETH_ADAPTER_INFO
UEYE_ETH_DRIVER_INFO	infoDriver	Allgemeine Daten des Treibers Siehe unten: UEYE_ETH_DRIVER_INFO

Inhalt der Struktur UEYE_ETH_DEVICE_INFO::UEYE_ETH_DEVICE_INFO_HEARTBEAT

BYTE	abySerialNumber[12]	Seriennummer (String)
BYTE	byDeviceType	Typ der Kamerafamilie (0x80 für GigE uEye)
BYTE	byCameraID	Benutzerdefinierte ID der Kamera
WORD	wSensorID	ID des Sensors
WORD	wSizeImgMem_MB	Größe des Bildspeichers in MByte
BYTE	reserved_1[2]	reserviert
DWORD	dwVerStarterFirmware	Version Starter-Firmware
DWORD	dwVerRuntimeFirmware	Version Runtime-Firmware
DWORD	dwStatus	Statuswort zum aktuellen Zustand der Kamera: •IS_ETH_DEVSTATUS_READY_TO_OPERATE: Kamera ist funktionsbereit •IS_ETH_DEVSTATUS_TESTING_IP_CURRENT: Kamera testet aktuelle IP-Adresse •IS_ETH_DEVSTATUS_TESTING_IP_PERSISTENT: Kamera testet persistente IP-Adresse •IS_ETH_DEVSTATUS_TESTING_IP_RANGE: Kamera testet Autokonfig-IP-Bereich •IS_ETH_DEVSTATUS_INAPPLICABLE_IP_CURRENT: Aktuelle IP-Adresse im Netzwerk bereits belegt •IS_ETH_DEVSTATUS_INAPPLICABLE_IP_PERSISTENT: Persistente IP-Adresse im Netzwerk bereits belegt •IS_ETH_DEVSTATUS_INAPPLICABLE_IP_RANGE: IP-Adressen des Autokonfig-IP-Bereich im Netzwerk bereits belegt •IS_ETH_DEVSTATUS_UNPAIRED: Kamera ist nicht geöffnet (Paired) •IS_ETH_DEVSTATUS_PAIRING_IN_PROGRESS: Kamera wird geöffnet (Pairing) •IS_ETH_DEVSTATUS_PAIRED: Kamera ist geöffnet (Paired) •IS_ETH_DEVSTATUS_FORCE_100MBPS: Kamera ist auf 100 MBit/s konfiguriert •IS_ETH_DEVSTATUS_NO_COMPORT: Kamera unterstützt keinen uEye COM-Port •IS_ETH_DEVSTATUS_RECEIVING_FW_STARTER: Kamera empfängt Starter-Firmware •IS_ETH_DEVSTATUS_RECEIVING_FW_RUNTIME: Kamera empfängt Runtime-Firmware •IS_ETH_DEVSTATUS_INAPPLICABLE_FW_RUNTIME: Runtime-Firmware kann nicht verwendet werden •IS_ETH_DEVSTATUS_INAPPLICABLE_FW_STARTER: Starter-Firmware kann nicht verwendet werden •IS_ETH_DEVSTATUS_REBOOTING_FW_RUNTIME: Kamera startet Runtime-Firmware neu •IS_ETH_DEVSTATUS_REBOOTING_FW_STARTER: Kamera startet Starter-Firmware neu •IS_ETH_DEVSTATUS_REBOOTING_FW_FAILSAFE: Kamera startet Failsafe-Firmware neu •IS_ETH_DEVSTATUS_RUNTIME_FW_ERR0: Prüfsummen-Fehler (Error 0) in der Runtime-Firmware
BYTE	reserved_2[4]	reserviert
WORD	wTemperature	Kameratemperatur in Grad Celsius Bit 15: Vorzeichen Bit 14...11: vorzeichenrichtig erweiterte Bits Bit 10...4: Temperatur (Stellen vor dem Komma) Bit 3...0: Temperatur (Stellen nach dem Komma) Sie finden die Angaben für die Umgebungsbedingungen der einzelnen Kamerafamilien unter D: Spezifikationen. Wird der Wert "-127,9 °C" zurückgegeben, besitzt die Kamera keinen Temperatursensor.
WORD	wLinkSpeed_Mb	Link-Bandbreite in Mbit/s
UEYE_ETH_ADDR_MAC	macDevice	MAC-Adresse der Kamera
BYTE	reserved_3[2]	reserviert
UEYE_ETH_IP_CONFIGURATION	ipcfgPersistentIpCfg	Persistente IP Konfiguration
UEYE_ETH_IP_CONFIGURATION	ipcfgCurrentIpCfg	Aktuelle IP Konfiguration
UEYE_ETH_ADDR_MAC	macPairedHost	ggf. MAC-Adresse des verbundenen PCs
BYTE	reserved_4[2]	reserviert
UEYE_ETH_ADDR_IPV4	ipPairedHostIp	ggf. IP-Adresse des verbundenen PCs
UEYE_ETH_ADDR_IPV4	ipAutoCfgIpRangeBegin	Erste IP-Adresse des Autokonfigurationsbereiches
UEYE_ETH_ADDR_IPV4	ipAutoCfgIpRangeEnd	Letzte IP-Adresse des Autokonfigurationsbereiches
BYTE	abyUserSpace[8]	Die ersten acht Bytes des Benutzerspeichers
BYTE	reserved_5[84]	reserviert
BYTE	reserved_6[64]	reserviert

Inhalt der Struktur UEYE_ETH_DEVICE_INFO::UEYE_ETH_DEVICE_INFO_CONTROL

DWORD	dwDeviceID	Systeminterne Geräte-ID der Kamera
DWORD	dwControlStatus	Statuswort zur Verwaltung der Kamera durch den Treiber: •IS_ETH_CTRLSTATUS_AVAILABLE: Kamera ist verfügbar •IS_ETH_CTRLSTATUS_ACCESSIBLE1: Kamera hat gültige IP-Adresse und ist über das Netzwerk ansprechbar •IS_ETH_CTRLSTATUS_ACCESSIBLE2: Kamera hat keine persistente IP-Adresse und der Auto-IP-Bereich ist gültig •IS_ETH_CTRLSTATUS_PERSISTENT_IP_USED: Kamera ist im Netzwerk mit der persistenten IP-Adresse ansprechbar •IS_ETH_CTRLSTATUS_COMPATIBLE: Kamera ist mit dem installierten Treiber kompatibel •IS_ETH_CTRLSTATUS_ADAPTER_ON_DHCP: Auf der Netzwerkkarte des PCs ist DHCP aktiviert •IS_ETH_CTRLSTATUS_UNPAIRING_IN_PROGRESS: Kamera wird gerade an diesem PC geschlossen •IS_ETH_CTRLSTATUS_PAIRING_IN_PROGRESS: Kamera wird gerade an diesem PC geöffnet •IS_ETH_CTRLSTATUS_PAIRED: Kamera ist an diesem PC geöffnet •IS_ETH_CTRLSTATUS_FW_UPLOAD_STARTER: Es wird gerade eine Starter-Firmware auf die Kamera geladen •IS_ETH_CTRLSTATUS_FW_UPLOAD_RUNTIME: Es wird gerade die Runtime-Firmware auf die Kamera geladen •IS_ETH_CTRLSTATUS_REBOOTING: Kamera startet gerade neu •IS_ETH_CTRLSTATUS_INITIALIZED: Kamera ist am Treiber initialisiert •IS_ETH_CTRLSTATUS_TO_BE_DELETED: Kamera wird gerade aus der Treiberverwaltung entfernt •IS_ETH_CTRLSTATUS_TO_BE_REMOVED: Kamera wird gerade aus der Treiberverwaltung entfernt
BYTE	reserved_1[80]	reserviert
BYTE	reserved_2[64]	reserviert

Inhalt der Struktur UEYE_ETH_DEVICE_INFO::UEYE_ETH_ADAPTER_INFO

DWORD	dwAdapterID	Treiberinterne ID des Netzwerk-Adapters
DWORD	dwDeviceLinkspeed	Mögliche Werte: •IS_ETH_LINKSPEED_100MB = 100 Mbit/s •IS_ETH_LINKSPEED_1000MB = 1000 Mbit/s
UEYE_ETH_ETHERNET_CONFIGURATION	ethcfg	Die Ethernet-Konfiguration des Netzwerk-Adapters
BYTE	reserved_2[2]	reserviert
BOOL	bIsEnabledDHCP	Der Adapter ist für DHCP konfiguriert
UEYE_ETH_AUTOCFG_IP_SETUP	autoCfgIp	Einstellung IP-Adressen-Autokonfiguration
BOOL	bIsValidAutoCfgIpRange	Die Einstellung für die IP-Autokonfiguration ist gültig
DWORD	dwCntDevicesKnown	Anzahl der an diesem Netzwerk-Adapter erkannten Kameras
DWORD	dwCntDevicesPaired	Anzahl der über diesen Netzwerk-Adapter geöffneten Kameras
WORD	wPacketFilter	Einstellung der Filterung für eingehende Pakete: •IS_ETH_PCKTFLT_PASSALL: Alle Pakete an das Betriebssystem weiterleiten. •IS_ETH_PCKTFLT_BLOCKUEGET: GigE uEye Datenpakete für das Betriebssystem blocken (empfohlen). •IS_ETH_PCKTFLT_BLOCKALL: Alle Pakete für das Betriebssystem blocken.
BYTE	reserved_3[38]	reserviert
BYTE	reserved_4[64]	reserviert

Inhalt der Struktur UEYE_ETH_DEVICE_INFO::UEYE_ETH_DRIVER_INFO

DWORD	dwMinVerStarterFirmware	Minimale kompatible Starter-Firmware Version
DWORD	dwMaxVerStarterFirmware	Maximale kompatible Starter-Firmware Version
BYTE	reserved_1[8]	reserviert
BYTE	reserved_2[64]	reserviert

Rückgabewert

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.
IS_SUCCESS	Funktion erfolgreich

Verwandte Funktionen

•is_GetCameraList()

Beispiel 1

// The camera has the device ID 1

UINT nDeviceId = 1;

IS_DEVICE_INFO deviceInfo;

memset(&deviceInfo, 0, sizeof(IS_DEVICE_INFO));

INT nRet = is_DeviceInfo((HIDS)(nDeviceId | IS_USE_DEVICE_ID), IS_DEVICE_INFO_CMD_GET_DEVICE_INFO, (void*)&deviceInfo, sizeof(deviceInfo));

if (nRet == IS_SUCCESS)

{

WORD wTemperature = deviceInfo.infoDevHeartbeat.wTemperature;

}

Beispiel 2

// The camera has the device ID 1001

UINT nDeviceId = 1001;

UEYE_ETH_DEVICE_INFO deviceInfo;

memset(&deviceInfo, 0, sizeof(UEYE_ETH_DEVICE_INFO));

INT nRet = is_DeviceInfo((HIDS)(nDeviceId | IS_USE_DEVICE_ID), IS_DEVICE_INFO_CMD_GET_DEVICE_INFO, (void*)&deviceInfo, sizeof(deviceInfo));

if (nRet == IS_SUCCESS)

{

WORD wTemperature = deviceInfo.infoDevHeartbeat.wTemperature;

}

Haben Sie Verbesserungshinweise? Senden Sie ein kurzes Feedback zu diesem Kapitel. Vielen Dank!
Bei technischen Fragen wenden Sie sich bitte an Ihren lokalen Händler oder nutzen Sie das Support-Formular auf unserer Internetseite.