XIMEA Linux Software Package¶

• XIMEA Linux Software Package
  • Supported CPU
  • Contents
  • Installation
    • Download for Intel x86 CPU architecture
    • Download for ARM CPU architecture
    • Installation for all architectures
    • Uninstallation
  • Troubleshooting
  • Supported Vision Libraries
  • Knowledge Base

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 CPU¶

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:
  • NVIDIA Jetson TX1
  • NVIDIA Jetson TX2
  • NVIDIA Jetson TX2i
  • NVIDIA Jetson TX2 NX
  • NVIDIA Jetson Nano
  • NVIDIA Jetson Xavier AGX support
  • NVIDIA Jetson Xavier NX
  • Raspberry Pi 4

Under development:

• NVIDIA Jetson Orin Nano
• NVIDIA Jetson Orin AGX
• NVIDIA Jetson Orin NX

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 (newest beta version) 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 (newest beta version) for XIMEA Firewire cameras
  • Read more about Linux Firewire Support

• Kernel Driver for CURRERA-R cameras

• 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
  

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¶

• Download XIMEA Linux ARM Software Package
  

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, 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.

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¶

• OpenCV

Knowledge Base¶

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