XIMEA Linux Software Package¶

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:

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

Python

OpenCV

DNG Store

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¶

Download XIMEA Linux x86 Software Package - Beta or LTS in Browser

Or download Beta using command line:

wget  https://updates.ximea.com/public/ximea_linux_sp_beta.tgz

Untar

tar xzf ximea_linux_sp_beta.tgz
cd package

Download for ARM CPU architecture¶

Download XIMEA Linux ARM Software Package - Beta or LTS

Or download Beta using command line:

wget  https://updates.ximea.com/public/ximea_linux_arm_sp_beta.tgz

Untar

tar xzf ximea_linux_arm_sp_beta.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
```
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:

Supported Vision Libraries¶

OpenCV

Knowledge Base¶

You can find a solution for known issues in our Linux SP Knowledge Base.