Setting up a Camera¶
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:
Install Intel® RealSense™ Kernel Modules¶
Follow the steps below to set up the camera depending on your system:
First, 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
You may check your machine’s kernel version by running
uname -r in a
For supported kernel versions: install the pre-built packages following instructions on the same package installation site.
For unsupported kernel versions: build and install the
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
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
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.
Install RealSense’s SDK if you have not done so.
Start up the
Connect your RealSense camera.
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: 22.214.171.124 - 126.96.36.199. 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.
Start all three of the streams: Stereo Module, RGB Camera and Motion Module and ensure the 2D view is selected.
On each panel, click the “Show frame metadata” icon.
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.
If the message still appears, contact SLAMcore support at firstname.lastname@example.org 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 188.8.131.52 - 184.108.40.206.
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
Login to your SLAMcore account at the SLAMcore Portal.
Click on the
Click on the
Activate New Cameralink.
Select your camera type (RealSense D435i, RealSense D455, Mynteye S).
Enter your camera serial number.