Skip to content

Latest commit

 

History

History
71 lines (54 loc) · 4.04 KB

distribution_linux.md

File metadata and controls

71 lines (54 loc) · 4.04 KB
Raw

Linux Distribution

Using pre-build packages

Intel® RealSense™ SDK 2.0 provides installation packages in dpkg format for Ubuntu 16/18 LTS.
The Realsense DKMS kernel drivers package (librealsense2-dkms) supports Ubuntu LTS kernels 4.4, 4.10, 4.13 and 4.15. Please refer to Ubuntu Kernel Release Schedule for further details.

Configuring and building from the source code

While we strongly recommend to use DKMS package whenever possible, there are certain cases where installing and patching the system manually is necessary:

  • Using SDK with linux kernel version 4.16+
  • Integration of user-specific patches/modules with librealsense SDK.
  • Adjusting the patches for alternative kernels/distributions.

The steps are described in Linux manual installation guide

Installing the packages:

  • Register the server's public key:
    sudo apt-key adv --keyserver keys.gnupg.net --recv-key C8B3A55A6F3EFCDE || sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-key C8B3A55A6F3EFCDE
    In case the public key still cannot be retrieved, check and specify proxy settings: export http_proxy="http://<proxy>:<port>"
    , and rerun the command. See additional methods in the following link.

  • Add the server to the list of repositories:
    Ubuntu 16 LTS:
    sudo add-apt-repository "deb http://realsense-hw-public.s3.amazonaws.com/Debian/apt-repo xenial main" -u
    Ubuntu 18 LTS:
    sudo add-apt-repository "deb http://realsense-hw-public.s3.amazonaws.com/Debian/apt-repo bionic main" -u

  • Install the libraries (see section below if upgrading packages):
    sudo apt-get install librealsense2-dkms
    sudo apt-get install librealsense2-utils
    The above two lines will deploy librealsense2 udev rules, build and activate kernel modules, runtime library and executable demos and tools.

  • Optionally install the developer and debug packages:
    sudo apt-get install librealsense2-dev
    sudo apt-get install librealsense2-dbg
    With dev package installed, you can compile an application with librealsense using g++ -std=c++11 filename.cpp -lrealsense2 or an IDE of your choice.

Reconnect the Intel RealSense depth camera and run: realsense-viewer to verify the installation.

Verify that the kernel is updated :
modinfo uvcvideo | grep "version:" should include realsense string

Upgrading the Packages:

When upgrading, be sure to:

  • Remove the old records and update your source list:
    sudo rm -f /etc/apt/sources.list.d/realsense-public.list
    sudo apt-get update

Uninstalling the Packages:

Important Removing Debian package is allowed only when no other installed packages directly refer to it. For example removing librealsense2-udev-rules requires librealsense2 to be removed first.

Remove a single package with:
sudo apt-get --purge <package-name>

Remove all RealSense™ SDK-related packages with:
dpkg -l | grep "realsense" | cut -d " " -f 3 | xargs sudo dpkg --purge

Package Details:

The packages and their respective content are listed below:

Name Content Depends on
librealsense2-udev-rules Configures RealSense device permissions on kernel level -
librealsense2-dkms DKMS package for Depth cameras-specific kernel extensions librealsense2-udev-rules
librealsense2 RealSense™ SDK runtime (.so) and configuration files librealsense2-udev-rules
librealsense2-utils Demos and tools available as a part of RealSense™ SDK librealsense2
librealsense2-dev Header files and symbolic link for developers librealsense2
librealsense2-dbg Debug symbols for developers librealsense2

Note The packages include binaries and configuration files only. Use the github repository to obtain the source code.