 |
 |
|---|---|
USB 3.x GigE |
USB 3.x 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 |
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 |
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 |
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
// 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;
}
// 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;
}
