XIMEA Linux Software Package¶
XIMEA Linux Software Package is a tarred installer of xiAPI with examples.
It is designed to run on most common Linux distribution that includes the usual tools and libraries like:
Ubuntu, Red Hat, Arch, Gentoo etc.
Please note: Even though cameras and API can work with such systems, XIMEA does not guarantee reliable functionality on the ones which are NOT included in the list of tested versions mentioned below.
Supported platforms¶
xiAPI supports the following CPU families:
- Intel x86 - tested OK with:
- Ubuntu 20.04, 22.04
- RedHat 9.x
- SUSE 15.4
- ARM - tested OK with Linux for Tegra on NVIDIA:
See also additional helpful materials:
Jetson TX2 vs AGX Xavier comparison,
Jetson Nano, TX2 and AGX Xavier comparison,
Jetson Image Processing,
Jetson Zero Copy for Embedded applications,
Realtime image processing on NVIDIA GeForce RTX 2080ti,
Multimedia User Guide
Contents¶
The Package contains:
- Driver for XIMEA USB 2.0 and USB 3.0 cameras
- Read more about Linux USB2.0 Support
- Read more about Linux USB3.0 Support
- Driver for XIMEA PCIe Cameras
- Driver for XIMEA Firewire cameras
- Read more about Linux Firewire Support
- CamTool - interactive viewer
- xiAPI - SDK for camera control by your software
- Examples:
- xiSample - sample showing basic image acquisition in xiAPI
- streamViewer - camera live image viewer for picture check
- streamViewer is based on gstreamer. It must be installed before streamViewer is started. Please read more in README file.
Installation¶
Download for Intel x86 CPU architecture¶
wget https://www.ximea.com/downloads/recent/XIMEA_Linux_SP.tgz
- Untar
tar xzf XIMEA_Linux_SP.tgz cd package
Download for ARM CPU architecture¶
wget https://www.ximea.com/downloads/recent/XIMEA_Linux_ARM_SP.tgz
- Untar
tar xzf XIMEA_Linux_ARM_SP.tgz cd package
Installation for all architectures¶
- Start installation script
- For PCIe Cameras - please start script with option -pcie.
./install -pcie
If it fails, make sure that you have the necessary tools installed, e.g. run the following command on Ubuntu:sudo apt-get update sudo apt-get install build-essential linux-headers-"$(uname -r)" sudo apt-get install libtiff5
or this one on Red Hat:sudo yum install gcc make kernel-devel sudo yum install libtiff
In some cases, it helps to disable "secure boot" in the bios - For other cameras (i.e. USB3 cameras)
./install
- For PCIe Cameras - please start script with option -pcie.
- If logged-in user is not root, you will be asked for your password to get root access because the installation runs with the root account using
sudo
. - If xiCamTool fails to start on your system, please check that all required dependencies of Qt for X11 are installed:
https://doc.qt.io/qt-6/linux-requirements.html
E.g. on Ubuntu, you may need to run this command:sudo apt install libxcb-cursor0
Uninstallation¶
Run uninstall
script:
/opt/XIMEA/uninstall
If logged in user is not root, you will be asked for your password to get root access same as with install
script.
Troubleshooting¶
If you should run into any issues during installing XIMEA API, before submitting a Support request, please read our troubleshooting pages:
- USB 2.0 Support,
- USB 3.0 Support,
- Firewire Support,
- ARM Support,
- Nvidia Jetson TX1/TX2/Nano/AGX Xavier Support,
Supported Vision Libraries¶
Knowledge Base¶
You can find a solution for known issues in our Linux SP Knowledge Base.