For operating the uEye cameras, the following system requirements must be met:
|USB 3.1/USB 3.0 camera||USB 2.0 camera||GigE camera|
|Interface||USB 3.0 port (Super Speed)||USB 2.0 port (High Speed 480 Mbps, "Full Powered" 500 mA)||Gigabit Ethernet port (1000 Mbps)|
|CPU||Intel i5 or better||Intel i3 or better||Intel i3 or better|
|Memory||min. 2 GB||min. 2 GB||min. 2 GB|
|Disk space||min. 500 MB||min. 500 MB||min. 500 MB|
|Operating system||Linux > Kernel 3.4 (32/64-bit)
For UI-3013XC: Linux >= Kernel 3.13 (32/64-bit)
|Linux > Kernel 2.6 (32/64-bit)||Linux > Kernel 2.6 (32/64-bit)|
Depending on the sensor model, the camera performance may be limited with the minimum system requirements.
The Linux operation system is one of the most widely ported, running on a huge amount of architectures and provided over many distributions. Although we are trying to be compatible among the whole range of kernel versions and distributions, there is no guarantee that the IDS Software Suite is working on a specific untested combination.
Below is a list of successfully tested distributions for the current IDS Software Suite:
libpng16.so.16) for support of saving images in PNG format
libjpeg.so.62) for support of saving images in JPEG format and JPEG mode of XS
Former versions of the IDS Software Suite can be downloaded in the software archive under https://en.ids-imaging.com/ueye-software-archive.html.
The UI-3013XC camera model is supported by driver version 4.92 for the last time.
The models UI-112xSE, UI-512xSE, and XS are supported by driver version 4.91 for the last time.
The UI-1008XS camera model is supported by driver version 4.81 for the last time.
The GigE uEye RE camera family is supported by driver version 4.80 for the last time. The GigE uEye RE PoE camera family is not affected by this.
The USBE uEye RE camera family is supported by driver version 4.80 for the last time.
The USB uEye ME camera family is supported by driver version 4.40 for the last time.
The GigE uEye HE camera family is supported by driver version 3.82 for the last time.
The models UI-121xSE, UI-141xSE, UI-144xSE, UI-145xSE, and UI-154xSE-C have been discontinued and will not be tested from driver version 3.80 on. IDS Imaging Development Systems GmbH therefore cannot guarantee that these models will provide full functionality with new driver versions and operate without problems.
The optional memory board of the USB uEye SE and USB uEye RE camera series has been discontinued. The functions required to operate the memory board are supported up to and including driver version 3.25.
All USB CMOS cameras with USB board revision < 2.1 are not supported by driver versions > 3.10. How can you check whether your camera is affected?
Check the serial number of your camera. If it is less than 400 26 27000, your camera will not be compatible with driver versions > 3.10.
If your camera is not compatible with driver versions > 3.10, you can of course continue to use your present driver (up to version 2.40).
You must be root to install.
$> sudo sh ./ueyesdk-setup*.run
(/tmp/ids_ueye_YYYYMMDDhhmmss_PID.log)may include a hint to solve them (see installer output). If not, contact your local distributors support and submit the report file.
Note: If older configuration files are present from a previous installation, they are backed up before the new configuration files are created.
The created files will be installed in following directories (if you have not uninstalled the USB or GigE package):
|/usr/lib/libueye_api.so.[version]||32-bit uEye shared library||After
|/usr/lib/libueye_api64.so.[version]||64-bit uEye shared library|
|/usr/include/ueye.h||Development header file||For compatibility with older versions, a symbolic link
|/usr/bin/ueyeethd||GigE uEye daemon binaries|| Configuration files are located under
|/usr/bin/ueyeusbd||USB uEye daemon binaries||Configuration files are located under
|/usr/share/ids/ueye/licenses||Third party licenses and copyrights|
|/usr/lib/firmware/ids/ueye||USB3 firmware binaries|
|/etc/init.d/ueyeethdrc||GigE uEye daemon runlevel control script||Is only installed if
|/etc/init.d/ueyeusbdrc||USB uEye daemon runlevel control script||Is only installed if
|/lib/systemd/system/ueyeethdrc.service||GigE uEye daemon service file|
|/lib/systemd/system/ueyeusbdrc.service||USB uEye daemon service file|
|/usr/src/ids/ueyedemo||IDS demo sources|
|/usr/share/ids/ueye/readme.txt||IDS SDK readme|
|/usr/share/ids/ueye/manual||IDS SDK user manual|
Additionally, the installer provides the following tools - unless not indicated otherwise, the tools will be installed to
|ueyesetid||Camera ID configuration tool|
|ueyesetip||Camera IP address configuration tool|
|idscameramanager||IDS Camera Manager|
|ueyereport||Report generator tool|
|ueyesetup||IDS SDK setup tool
For installing/uninstalling the self-extracting tar archive
The installer will create a system group
'ueye' and a system user
'ueyed' to run the daemon with. Currently there are no access control restrictions, but be aware that this might change in the future.
Note: It is recommended to use
systemd for controlling the daemons. Do not mix calls of
$> sudo systemctl start ueyeethdrc
$> sudo systemctl start ueyeusbdrc
systemdyet, you can use the following commands:
$> sudo /etc/init.d/ueyeethdrc start
$> sudo /etc/init.d/ueyeusbdrc start
$> sudo systemctl stop ueyeethdrc
$> sudo systemctl stop ueyeusbdrc
$> sudo /etc/init.d/ueyeethdrc stop
$> sudo /etc/init.d/ueyeusbdrc stop
After you installed the software, connect the camera to the PC, using the corresponding USB cable. The camera will be recognized automatically. When you connect a camera with a PC or a new USB port for the first time, it is detected as a new device and the firmware is uploaded to the camera. When the camera has been correctly installed, the LED on the back of the camera lights up green and the camera is displayed in the list of the IDS Camera Manager.
USB 3/USB 3.1 uEye cameras are limited usable under USB 2.0. Depending on the camera model, not all camera functions are available in USB 2.0 mode. USB 3/USB 3.1 uEye cameras are optimized for USB 3.0 ports and are not tested by IDS Imaging Development Systems GmbH under USB 2.0.
Please note that due to the high performance of modern sensors, some USB 3/USB 3.1 uEye models are not supported in USB 2.0 mode anymore, as the USB 2.0 interface does not provide enough power.
After you installed the software, connect the camera with the network. Check the power supply to the camera. Use either an external power supply or - depending on the model - via PoE (Power over Ethernet).
Attention: The camera should not be supplied through both voltage sources at once as this can irreparably damage the camera.
Before you can use the camera on the network, you need to assign a valid IP address to the camera in the IDS Camera Manager.
By default, the installer configures the default ethernet network interfaces. If you use another network interface to connect your cameras, insert the interface name at the interface configuration parameter in
/etc/ids/ueye/ueyeethd.conf. You must be root to edit the configuration file.
The GigE uEye daemon network interfaces may be configured with the IDS Camera Manager if a graphical environment is available.
ueyeethd must be stopped before manually editing the configuration file!
This section lists known issues that might occur in this release.
ueyeusbdrc.servicefile, you will need to run
$> sudo systemctl daemon-reload
PASSIVE, waiting threads should not consume CPU power while waiting; while the value is
ACTIVEspecifies that they should. If undefined, threads wait actively for a short time before waiting passively.
sucommand in buster is provided by the util-linux source package, instead of the shadow source package, and no longer alters the
PATHvariable by default. This means that after doing
PATHmay not contain directories like
/sbin, and many system administration commands will fail. There are several workarounds:
su -instead; this launches a login shell, which forces
PATHto be changed, but also changes everything else including the working directory.
sudostill runs commands with an altered
PATH, you may use
su -), you may use
/etc/login.defsto get an approximation of the old behavior. This is documented in su but not in login.defs. It may also cause a harmless error message to appear in some situations.
/sbin, /usr/sbin, /usr/local/sbin) in your regular account's
See list on https://en.ids-imaging.com/open-source.html
$> sudo /usr/bin/ueyesetup -r eth
$> sudo /usr/bin/ueyesetup -r usb
You should always use the setup script that came with the previous installation to ensure proper system cleanup. Do not attempt to remove the IDS Software Suite manually.
Note: The configuration files are not uninstalled and remain on the system.
© 2019, IDS Imaging Development Systems GmbH
IDS Imaging Development Systems and uEye are registered trademarks of IDS Imaging Development Systems GmbH.
IDS Imaging Development Systems GmbH
Dimbacher Str. 6-8
74182 Obersulm, Germany