You’re reading an older version of the Slamcore SDK documenation. The latest one is 23.01.

Setting up a Camera

Warning

To use the D435i or D455 depth camera, most x64 systems will require building and activating kernel modules to complete the setup of the Intel RealSense SDK 2.0 features required by SLAMcore software.

To start using our software with live camera data you will need to do the following:

  1. Install Intel® RealSense™ Kernel Modules

  2. Verify RealSense Setup

  3. Install the Camera Firmware

  4. Register Your Camera

Install Intel® RealSense™ Kernel Modules

Check your machine’s kernel version by running uname -r in a terminal window, and follow the steps below to set up the camera depending on your system:

Check whether Intel RealSense’s DKMS kernel drivers package supports your system’s Ubuntu kernel version on their package installation site (see screenshot in Fig. 1 for the current list of supported kernels).

For kernel versions supported by Intel RealSense’s DKMS package:

Install the pre-built packages following instructions on the same package installation site.

For the newer kernels - Ubuntu 20.04 (amd64) running the 5.13 or 5.15 HWE kernel:

We’ve open sourced a DKMS Debian package to provide support for Intel RealSense cameras on the newer kernels for x86 platforms: Ubuntu 20.04 (amd64) running the 5.13 or 5.15 HWE kernel.

Install the pre-built packages following the details on SLAMcore’s DKMS package installation site.

For older kernels not supported by either Intel RealSense or SLAMcore’s DKMS package:

Build and install the librealsense2 module package from source.

To download the sources without cloning the repository, use the command:

$ wget https://github.com/IntelRealSense/librealsense/archive/master.zip && unzip master.zip

Warning

Ensure that your Intel RealSense camera is unplugged when running the scripts. Reboot your system when the patch is completed.

We open source our DKMS package to provide full support for Intel RealSense cameras on the all NVIDIA Jetson platforms running L4T between r32.4.4 and r32.6.1.

Note

Installation of this DKMS package is not required to use an Intel RealSense D435i camera with NVIDIA Jetson platforms.

Install the pre-built packages following the details on SLAMcore’s DKMS package installation site.

Verify RealSense Setup

After following the setup instructions it is important to make sure that everything has been set up correctly. Firstly, you should confirm the camera firmware version matches the one required.

  1. Install RealSense’s SDK if you have not done so.

  2. Start up the realsense-viewer program.

  3. Connect your RealSense camera.

  4. Find the firmware version of the camera:

    • Go to Info (in the connected cameras side panel) > Firmware Version

    • Make sure it corresponds to one of the required versions: 5.12.3.0 - 5.12.15.50. This may be displayed in the form 05.12.12.100

Now confirm that all of the data streams are being received correctly from the camera.

  1. Start all three of the streams: Stereo Module, RGB Camera and Motion Module and ensure the 2D view is selected.

  2. On each panel, click the “Show frame metadata” icon.

  3. Check that none of the panel display the message “Per-frame metadata is not enabled at the OS level! Please follow the installation guide for details.”.

    This message on any of the panels indicates that the kernel module patches are not correctly installed or activated. If this happens, check that the patches were installed correctly according to the instructions for your kernel version.

Note

If the message still appears, contact SLAMcore support at support@slamcore.com providing the following details:

  • The machine you are using,

  • Your system’s Ubuntu kernel version,

  • The camera firmware version,

  • The link to the kernel patching instructions used,

  • The patch version used from Intel RealSense’s repository (if applicable).

Install the Camera Firmware

Follow the instructions provided by Intel RealSense to install one of the camera firmware versions 5.12.3.0 - 5.12.15.50.

Register Your Camera

Finally, register your camera to start using it with the SLAMcore software. You will need the serial number which can be found printed on the camera or the box. Alternatively you can connect your camera and run:

$ rs-enumerate-devices | grep Serial

Two serial numbers will be displayed, take the Serial Number.

Login to your SLAMcore account at the SLAMcore Portal.

  1. Click on the Manage Cameras option.

  2. Click on the Activate New Camera link.

  3. Select your camera type (RealSense D435i, RealSense D455, OAK-D S2 Fixed-Focus).

  4. Enter your camera serial number.

  5. Click Add Camera.