树莓派+RealSense深度相机：从0到1的环境搭建与避坑指南

【免费下载链接】librealsense Intel® RealSense™ SDK 项目地址: https://gitcode.com/GitHub_Trending/li/librealsense

树莓派（Raspberry Pi）作为低成本嵌入式开发平台，与Intel RealSense深度相机结合可实现三维感知应用。本文基于官方文档doc/installation_raspbian.md，详细说明在树莓派上部署librealsense SDK的完整流程，解决编译超时、驱动兼容等核心痛点。

环境准备与系统检查

硬件与系统要求

• 推荐配置：Raspberry Pi 3/3+（4B性能更佳）+ Intel RealSense D435/D435i
• 系统版本：Raspbian 9（Stretch）及以上，内核版本≥4.14.34-v7+

系统版本验证

$ uname -a  # 检查内核版本
Linux raspberrypi 4.14.34-v7+ 
$ gcc -v    # 确认GCC版本≥6.3.0
$ cmake --version  # 初始版本可能为3.7.2，需升级

执行系统更新确保依赖库最新：

$ sudo apt update && sudo apt upgrade -y
$ sudo reboot

关键依赖安装

1. 扩展交换空间

树莓派默认100MB交换空间不足以支撑SDK编译，需临时扩容至2GB：

$ sudo vim /etc/dphys-swapfile
# 修改CONF_SWAPSIZE=2048
$ sudo /etc/init.d/dphys-swapfile restart
$ swapon -s  # 验证交换空间大小

2. 安装核心依赖库

$ sudo apt-get install -y libdrm-dev libglu1-mesa-dev xorg-dev libgtk-3-dev libusb-1.0-0-dev

上述命令安装：

• 图形渲染：common/opengl3.h 依赖的OpenGL开发库
• USB设备通信：libusb/ 目录下驱动所需的libusb开发包
• 图形界面：RealSense Viewer tools/realsense-viewer/ 依赖的GTK+3库

3. 升级CMake至3.11+

官方编译要求CMake≥3.11.4，手动安装流程：

$ wget https://cmake.org/files/v3.11/cmake-3.11.4.tar.gz
$ tar -zxvf cmake-3.11.4.tar.gz && cd cmake-3.11.4
$ ./configure --prefix=/home/pi/cmake-3.11.4
$ make -j1  # 单线程编译避免内存溢出
$ sudo make install
$ export PATH=/home/pi/cmake-3.11.4/bin:$PATH

驱动配置与权限设置

1. 配置udev规则

从源码目录复制设备规则文件，确保相机被系统正确识别：

$ git clone https://gitcode.com/GitHub_Trending/li/librealsense.git
$ cd librealsense
$ sudo cp config/99-realsense-libusb.rules /etc/udev/rules.d/
$ sudo udevadm control --reload-rules && sudo udevadm trigger

规则文件config/99-realsense-libusb.rules定义了RealSense设备的USB通信权限。

2. 安装TBB并行计算库

librealsense的图像处理模块依赖Intel TBB库，ARM架构预编译包安装：

$ wget https://github.com/PINTO0309/TBBonARMv7/raw/master/libtbb-dev_2018U2_armhf.deb
$ sudo dpkg -i libtbb-dev_2018U2_armhf.deb
$ sudo ldconfig

SDK编译与安装

1. 编译librealsense核心库

$ mkdir build && cd build
$ cmake .. -DBUILD_EXAMPLES=true -DCMAKE_BUILD_TYPE=Release -DFORCE_LIBUVC=true
$ make -j1  # 树莓派3建议单线程编译，4B可尝试-j2
$ sudo make install

• 关键参数：FORCE_LIBUVC=true 强制使用libuvc驱动框架，解决树莓派USB视频类设备兼容性问题
• 示例程序：编译完成后可在examples/目录找到深度流显示、点云生成等示例

2. 安装Python绑定（可选）

如需使用Python开发，需单独编译pyrealsense2：

# 针对Python3
$ cmake .. -DBUILD_PYTHON_BINDINGS=bool:true -DPYTHON_EXECUTABLE=$(which python3)
$ make -j1 && sudo make install
# 配置Python路径
$ echo "export PYTHONPATH=\$PYTHONPATH:/usr/local/lib" >> ~/.bashrc
$ source ~/.bashrc

系统配置与功能验证

1. 启用OpenGL加速

RealSense Viewer需要OpenGL支持，通过raspi-config配置：

$ sudo apt-get install python-opengl
$ sudo -H pip3 install pyopengl pyopengl_accelerate
$ sudo raspi-config
# 依次选择: 7.Advanced Options → A7 GL Driver → G2 GL (Fake KMS)
$ sudo reboot

2. 运行RealSense Viewer

连接D435相机后启动可视化工具验证安装：

$ realsense-viewer

成功启动后可查看深度流、RGB流实时画面，并调整相机参数。若提示缺少库文件，检查src/librealsense2/目录下的动态链接库是否正确安装。

常见问题解决

编译超时/内存溢出

• 确保已扩展交换空间至2GB
• 使用make -j1代替多线程编译
• 清理临时文件：make clean && rm -rf CMakeCache.txt

相机无法识别

• 验证udev规则：ls /etc/udev/rules.d/99-realsense-libusb.rules
• 检查USB端口供电：使用带外接电源的USB hub
• 重新加载驱动：sudo udevadm control --reload-rules && sudo udevadm trigger

Python导入失败

• 确认pyrealsense2.so路径：ls /usr/local/lib/python3.7/dist-packages/
• 检查Python路径配置：echo $PYTHONPATH

扩展学习资源

• 官方文档：doc/目录包含更多高级配置与API说明
• 示例代码：examples/capture/演示基础流捕获，examples/pointcloud/展示三维点云生成
• ROS支持：可参考doc/rs400_support.md配置ROS环境

通过以上步骤，树莓派可稳定运行RealSense深度相机，为机器人导航、物体识别等应用提供三维感知能力。建议定期同步CMakeLists.txt中的依赖配置，确保与最新SDK版本兼容。

【免费下载链接】librealsense Intel® RealSense™ SDK 项目地址: https://gitcode.com/GitHub_Trending/li/librealsense