/badge.svg?branch=master&event=push){kind=link}
UEye Cam Driver
This software comes with a BSD License and provides convenience APIs (c++ and ROS) that facilitate access to UEye Cameras via the IDS Software Suite.
Requirements
Buildtime
If you are just building the software, no IDS Software Suite installation is required. This package will fetch headers and libraries on-the-fly to result in a successful build. Note however, that these are not made available for a runtime environment. These headers and libraries are not installed to the install space and you'll also need to install the IDS discovery daemon.
Runtime
- IDS uEye Software Suite >= 4.94
The IDS Software Suite installs headers, libraries, documentation and a daemon used for discovery of UEye cameras.
Start the discovery daemon for ethernet connected cameras:
$ sudo systemctl start ueyeethdrc
$ sudo /etc/init.d/ueyeethdrc start
To configure the cameras, do it via the idscameramanager graphical tool (should be reasonably
self-explanatory) or via the command line tools:
- Enumerate the network interfaces to be used for discovery (
/etc/ids/ueye/ueyeethd.conf) - Configure the camera ip addresses (
ueyesetip) - Configure the camera ids (
ueyesetid)
Usage
Resources
Default resource paths include:
~/.ros/camera_info/: camera calibration files (.yaml)~/.ros/camera_conf/: IDS configuration files (.ini)
The camera calibration files are used to feed the ros2 camera_calibration framework.
The IDS configuration files are the native format for configuring an IDS camera. In general, you do not need an IDS configuration file as the ROS wrapper exposes most of the configuration via dynamic ROS parameters, but an IDS configuration file can be useful for parameters that it does not yet cover.
Quick Start
To get started, launch the standalone or component launcher. It is configured with a parameterisation that should enable connection to most IDS cameras.
# Install launcher / debugging / viz tools if you don't already have them
$ sudo apt install ros-foxy-ros2launch ros-foxy-ros2param ros-foxy-ros2run ros-foxy-ros2topic ros-foxy-rqt-image-view
# Uses ueye_cam/config/standalone.yaml
$ ros2 launch ueye_cam standalone.launch.py
# In a seperate shell, visualise the stream
$ ros2 run rqt_image_view rqt_image_view /ueye_cam/froody/image_raw
# Play around with parameters
$ ros2 param list
$ ros2 param set ueye_cam auto_gain false
$ ros2 param describe ueye_cam red_gain
$ ros2 param set ueye_cam red_gain 100