Intel® RealSense™ Cross Platform API
Intel Realsense Cross-platform API
Troubleshooting Tips and Tricks

The following commands can be used to isolate and analyze issues:

Kernel Version

Enable LibRealSense Log

On Linux:

$ export LRS_LOG_LEVEL="<Log Level>"

On Windows:

$ set LRS_LOG_LEVEL="<Log Level>"

Connected Intel Cameras

General Linux Kernel Log

UVC Video Module Traces

You can get more verbose logs from the uvcvideo kernel-module.
These logs can be seen in dmesg

For example, once enabled you will get the following line inside dmesg for each frame received from USB:

[619003.810541] uvcvideo: frame 1 stats: 0/0/1 packets, 0/0/1 pts (!early initial), 0/1 scr, last pts/stc/sof 25177741/25178007/81
[619003.810546] uvcvideo: Frame complete (FID bit toggled).
[619003.810556] uvcvideo: frame 2 stats: 0/0/1 packets, 0/0/1 pts (!early initial), 0/1 scr, last pts/stc/sof 25210903/25211168/346
[619003.810588] uvcvideo: uvc_v4l2_poll
[619003.811173] uvcvideo: uvc_v4l2_poll
[619003.843768] uvcvideo: frame 3 stats: 0/0/1 packets, 0/0/1 pts (!early initial), 0/1 scr, last pts/stc/sof 25210903/25211168/346
[619003.843774] uvcvideo: Frame complete (FID bit toggled).
[619003.843785] uvcvideo: frame 4 stats: 0/0/1 packets, 0/0/1 pts (!early initial), 0/1 scr, last pts/stc/sof 25244064/25244330/612

Kernel Events

System Calls and Signals

Core Dump File

In case of a crash (for example SEGFAULT), a snapshot of the crash can be created (Core Dump) and submitted for inspection.

  1. Enable the auto-creation of Core Dump files:
    $ ulimit -c unlimited
  2. Run the application that causes the crash
  3. Search for the core file in the current directory

Note: Auto-creation of the dump file will only work on the same Terminal that you ran the ulimit command.