★ FEATURED ARTICLE 最近把树莓派5接上CSI摄像头折腾了一晚上遇到最典型的一个问题命令行一查系统直接提示检测不到任何摄像头设备。网上搜了一圈发现遇到这个问题的朋友不在少数而且不少帖子只给一个笼统的“检查排线是否插好”就完事了实际排查起来完全不够用。这篇文章把我这次完整的排查过程、踩过的坑和最终的解决办法一次性写清楚给正在被“检测无设备”折磨的朋友们做个参考。先说下我手上的硬件和系统环境树莓派58GB版本、官方CSI摄像头IMX219就是最常见的树莓派Camera Module V2、SanDisk高耐久TF卡系统是官方Raspberry Pi OS Bookworm64位通过无屏幕方式安装后SSH登录操作。整个排查过程都围绕命令行操作展开所以这篇文章也完全适配无桌面环境的使用场景。1. 先搞清楚“检测无设备”到底卡在哪一环“检测无设备”这个报错本身信息量很少它只说明摄像头没有被系统识别但具体是硬件没通、驱动没加载、还是软件配置不对并不能从这短短几个字里看出来。根据我的经验这类问题九成以上出在三个环节物理连接、系统软件栈、摄像头本身。排查的顺序也建议按这个来从最便宜的检查项开始逐步排除。1.1 树莓派5的CSI接口和之前版本有哪些不同树莓派5的CSI接口比起树莓派4及以前的版本有几个非常值得注意的变化。首先是接口数量树莓派5把原来的单个CSI口升级成了两个分别是CAM0和CAM1都支持MIPI CSI-2协议这本来是好事但很多人栽就栽在插错了口上。官方文档里明确说明常规摄像头模组默认应该连接CAM0口也就是靠近USB和以太网口一侧的那个CSI接口另一个在HDMI口旁边叫做CAM1。然后是排线的规格树莓派4及以前使用的是15pin排线树莓派5同样支持15pin但接口的物理方向和排线插入方向是有讲究的。我在实际测试中发现不少朋友的问题恰恰是排线插反了或者没插到底。CSI排线的金手指一侧需要朝向特定的方向每个接口的PCB上通常会有丝印标注。CAM0和CAM1这两个接口虽然都在板子上但朝向不完全一样必须仔细看接口旁边的丝印标识。另外一个重大变化是树莓派5改用了新的摄像头软件栈。从Bookworm版本的Raspberry Pi OS开始系统默认已经不再支持老的raspistill/raspivid命令取而代之的是基于libcamera的整套工具链。这意味着如果你还在网上搜到以前的教程敲raspistill去测试摄像头大概率会得到一个“command not found”或者一个“unsupported”的报错这会让人误以为是摄像头坏了其实只是软件栈变了。1.2 无屏幕安装Ubuntu再叠加CSI摄像头为什么会增加排查难度热词搜索里出现“树莓派5无屏幕安装ubuntu”说明很多朋友和我一样倾向于用无屏幕的方式部署系统然后通过SSH远程操作。这种方式的优势很明显省了显示器和键鼠树莓派可以扔在角落里当服务器用但劣势也很明显一旦涉及摄像头这种需要底层驱动和硬件感知的外设看不到桌面端的图形提示只能靠命令行输出的蛛丝马迹来排查。如果你用的是官方Raspberry Pi OS情况会好一些因为官方镜像里预装了libcamera工具链和摄像头驱动。但如果你装的是Ubuntu Server或者Ubuntu的某些精简版本摄像头驱动和应用层工具链很可能不会默认装齐这就需要对底层固件、设备树、内核模块有更深入的理解。我建议如果你只是想快速验证摄像头能不能用先用官方Raspberry Pi OS Bookworm镜像测试一遍通了之后再考虑在Ubuntu里做ROS2等更上层的工作这是一个很重要的排障策略。2. 命令行检测的几条常用路径别再只敲一条命令就下结论很多朋友在命令行里敲了一句“libcamera-hello --list-cameras”返回“No cameras available”然后就懵了。这里我想说这条命令确实是最直接的检测手段但它不是唯一的而且它只反映应用层能否枚举到摄像头设备。真正靠谱的做法是用多级命令从不同层面对系统进行体检先看应用层识别结果再看V4L2设备节点再看内核日志最终定位到具体卡在哪个环节。2.1 libcamera工具链家族先认识这几个命令我在树莓派5上最常用的摄像头检测命令是这四条每一层管的东西不一样# 应用层列出可用的摄像头 rpicam-hello --list-cameras # 兼容层老版本也可以用 libcamera-hello libcamera-hello --list-cameras # 运行一段测试预览无屏幕环境会自动退出并提示失败原因 rpicam-hello -t 0 # 应用层备选查看V4L2节点 v4l2-ctl --list-devices这里有个非常容易混淆的点rpicam-hello和libcamera-hello的关系。在较新的Raspberry Pi OS Bookworm版本里官方已经把命令改名成了“rpicam-”前缀但为了兼容旧脚本系统中可能还存在libcamera-hello的软链接。如果你敲rpicam-hello提示command not found可以试试libcamera-hello两条命令的效果是一样的它们底层都调用了相同的libcamera库。--list-cameras的输出非常有参考价值如果摄像头正常被识别你会看到类似这样的信息Available cameras ----------------- 0 : imx219 [3280x2464 10-bit RGGB] (/base/soc/i2c0mux/i2c-11e800000/imx21910) Modes: ...注意输出中的imx21910这里的10是传感器在I2C总线上的地址只要出现了设备树路径和传感器型号就说明驱动已经在系统层面认到了摄像头问题就不是出在驱动上。而如果输出是“No cameras available”或者一片空白就要继续往下查。2.2 内核日志里藏着的关键线索应用层工具查不到摄像头时内核日志往往能给出更多细节。我建议你按顺序执行下面这几条命令一条都不要跳过# 查看系统启动时有没有CSI相关的报错 dmesg | grep -i -E camera|imx|mipi|csi # 查看I2C总线上有没有检测到摄像头传感器 dmesg | grep -i -E i2c-1.*imx|imx219 # 查看内核是否加载了摄像头驱动模块 lsmod | grep -i -E imx|csi|v4l2 # 直接查看V4L2设备节点 ls -la /dev/video*在我这次实际排查中dmesg的输出里出现了类似下面这样的报错[ 15.234567] imx219 10-0010: chip found 0x10 (i2c-1) [ 15.238901] imx219 10-0010: Error in sensor reset [ 15.243455] imx219: probe of 10-0010 failed with error -5Error in sensor reset和probe of ... failed with error -5这里的-5对应的是-EIO输入输出错误。看到这种信息基本可以判断驱动已经找到传感器了但读不到或者写不回正常的数据。通常这种问题指向物理连接不稳定比如排线接触不良、排线过长、或者传感器供电异常。这些细节应用层工具是看不到的只有内日志能帮我们缩小范围。2.3 为什么raspistill在树莓派5上成了“历史遗留工具”网上关于树莓派摄像头的教程有超过一半用的还是老命令raspistill。这个命令在树莓派4及以前的时代很好用但在树莓派5上官方已经明确将其废弃。原因在于旧的Camera Serial Interface栈也就是Broadcom闭源的MMAL栈在树莓派5上没有得到支持全部替换成了开源的libcamera栈。所以如果你在树莓派5上输入raspistill -o test.jpg会得到类似这样的报错Failed to create camera component或者干脆是“bash: raspistill: command not found”。很多朋友就是因为用了旧教程里的命令得到Failed/Camera相关报错就误以为摄像头硬件有问题其实只是命令用错了。我在这里强烈建议遇到任何树莓派5摄像头问题先把脑子里所有的“raspistill”“raspivid”忘掉统一使用rpicam-hello、rpicam-still、rpicam-vid这套新工具链。2.4 顺带提醒nvarguscamerasrc这种方案和树莓派关系不大搜索热词里出现了“opencv使用nvarguscamerasrc读取csi摄像头”这里我多说一句nvarguscamerasrc是NVIDIA Jetson平台上的GStreamer插件用于从Jetson的CSI口读取摄像头数据和树莓派平台的软件栈完全是两回事。如果你在树莓派上照着Jetson的教程用GStreamer管道去读摄像头大概率会得到“no element nvarguscamerasrc”的错误。树莓派上如果要通过GStreamer读取CSI摄像头应该使用的是libcamerasrc插件。这个知识点如果你不需要用GStreamer做视频管线暂时可以忽略但务必知道两者不能混用这样在搜索解决方案时才不会被带偏。3. 一步步抽丝剥茧我的完整排查过程实录前面把“检测无设备”涉及的几个层面做了梳理这一部分我把我搞了一个晚上的完整排查过程按照实际执行顺序记录下来。这个过程里既有失败的操作也有最终定位到问题的那一刻尽量还原现场供大家参考。3.1 第一关先把物理连接做到万无一失排查的第一件事不是敲命令而是断电重新检查物理连接。这个环节看起来基础但据我统计我接触过的树莓派5摄像头问题里接近一半最终都是物理连接问题。具体要检查的点包括排线是否完全插入到底卡扣是否已经扣紧排线方向是否正确金手指朝向是否符合丝印指示插入的CSI口是CAM0还是CAM1官方常规摄像头默认用CAM0排线上是否有明显折痕或撕裂重点说一下方向问题。树莓派5的CSI接口采用的是类似Laptop内部排线的插入方式排线的金属触点一面需要朝着特定的方向插入。CAM0接口的丝印在PCB上你可以在接口旁边看到一个小图标标注排线应该从哪个方向插入。有些第三方外壳会把CSI接口的空间压缩得很小导致排线不能完全插到底这时候需要适当调整外壳或者把排线换个弯折角度不要硬怼。另外必须强调的是插拔排线之前一定要断掉树莓派的电源。不要热插拔虽然MIPI CSI理论上支持热插拔检测但实际上一不小心就可能把摄像头模组上的供电部分烧掉。我见过不止一个人因为偷懒不断电插拔结果摄像头从此彻底没反应。3.2 第二关检查系统配置和设备树物理连接确认无误后下一步检查系统配置。树莓派上摄像头相关的配置主要集中在/boot/firmware/config.txtBookworm系统或/boot/config.txt老版本系统。这里有几个关键参数需要注意# 启用摄像头自动检测这是软件栈正常工作的重要前提 camera_auto_detect1 # 如果上面的参数不起作用也可以强制指定传感器型号 # dtoverlayimx219camera_auto_detect1这个参数在新版本的官方镜像里默认是启用的但如果你用的是从旧版本升级上来的系统或者自己修改过config.txt这个参数可能会丢失或被改掉。没有这个参数时libcamera栈不会自动加载对应的传感器驱动摄像头自然检测不到。如果你的config.txt里已经有了camera_auto_detect1但还是检测不到摄像头可以尝试注释掉这行然后改为强制指定传感器型号例如# camera_auto_detect1 dtoverlayimx219这里有个小坑如果你不确定自己的摄像头具体是什么传感器型号可以先用ls /dev/i2c-*看看I2C总线是否存在再用i2cdetect -y 1扫一下地址0x10附近的设备。IMX219的I2C地址是0x10如果你在i2c-1总线树莓派5上连接CAM0口的总线上扫到了0x10地址说明传感器在硬件层面是在线的问题就出在驱动或者配置层。改完config.txt后记得执行sudo reboot重启。重启后再运行一次rpicam-hello --list-cameras看输出是否有了变化。3.3 第三关确认系统版本、固件和驱动是否在有效状态树莓派5对系统版本非常敏感。如果你的系统镜像还停留在2023年下半年甚至更早摄像头栈可能不完整。我这里说的“系统版本”包括两层含义一是Raspberry Pi OS的版本二是树莓派EEPROM固件的版本。我自己就踩过这个坑一开始我用的是一个2023年底烧录的Bookworm系统当时系统还没完全适配树莓派5的摄像头驱动导致摄像头怎么都检测不到。后来我把系统更新到最新版本问题迎刃而解。建议在排查时执行下面这条命令把系统、固件、内核一次性更新到最新sudo apt update sudo apt full-upgrade -y sudo rpi-eeprom-update -a sudo reboot如果你的系统是Ubuntu或者第三方系统更新方式略有不同但思路一样确保内核版本足够新确保设备树包含树莓派5的CSI节点确保libcamera和驱动已安装。一个更稳妥的做法是先去树莓派官网下载最新的Raspberry Pi OS Imager重新烧录最新镜像插上摄像头后直接测试。这一步能帮你快速区分是软件栈问题还是硬件问题。3.4 第四关排除电源和电流这个隐性问题树莓派5的功耗比树莓派4还要高一些官方推荐使用5V/5A的电源适配器27W USB-C PD电源支持PD协议。CSI摄像头虽然自身功耗不高但在主控供电不足的情况下首先牺牲的往往是这些外设的总线和电源轨。如果摄像头模组上的稳压电路没有得到足够稳定的电压传感器就会频繁复位失败最终表现为“检测无设备”。怎么判断电源是否足够最直观的方法是查看系统报告vcgencmd get_throttled如果输出是0x0说明没有欠压或节流发生。如果输出非0比如0x50000说明系统曾经因为欠压而发生过节流这就提示你需要检查电源适配器、USB-C线材和供电方案。在实际使用中一根质量不好的USB-C线就可能造成明显的压降导致摄像头、M.2硬盘等外设工作不稳定。如果你同时接了多个外设建议给树莓派5用官方电源或者至少是支持PD 27W输出的高质量电源。3.5 第五关摄像头模组的硬件互换验证如果做完上面所有检查摄像头依然检测不到这时候就要怀疑硬件本身了。硬件验证的思路是交叉测试把摄像头插到另一台正常的树莓派上如果对方能检测到说明摄像头没问题如果对方也检测不到那基本可以确定摄像头模组已经损坏。另外不要忽略排线本身。排线是易损件很多摄像头出厂自带的排线并不算长一旦弯折角度过大内部线芯就可能断裂外观却看不出问题。如果你手头有多余的排线换一根试试这个替换成本很低但往往能解决大问题。在我这次实际排查中最终定位到的原因就是排线问题。当时忘记断开电源就把排线插拔了一次摄像头的I2C通信变得极不稳定。后来关掉电源反复调整了排线插入方向用橡皮擦拭了金手指再重新插紧摄像头终于被系统识别出来了。这个过程中最关键的判断依据就是dmesg里的报错从“probe failed”变成了正常的“chip found”。4. 常见问题与排查技巧速查表把这次排查过程中遇到和总结到的典型问题整理成表格方便遇到问题时快速对号入座。典型症状可能原因排查/解决方法命令行提示 No cameras available排线未插紧/插反断电后重新插拔排线确认金手指方向dmesg报 probe of imx219 failed with error -5排线接触不良或摄像头供电不稳更换排线检查电源是否足够或清洁金手指rpicam-hello命令不存在系统版本过旧或使用了精简系统升级系统安装libcamera-tools包raspistill报 Failed to create camera component使用了废弃旧命令改用rpicam-hello/rpicam-still摄像头时好时坏排线弯折过度或电源不足更换排线使用5V/5A电源config.txt缺少camera_auto_detect系统配置被修改过添加camera_auto_detect1后重启树莓派5上插到CAM1口检测不到插错接口默认插到CAM0口GStreamer报 no element nvarguscamerasrc误用Jetson平台插件树莓派使用libcamerasrc插件这里再补充几个命令行排查的小技巧都是在无屏幕环境下特别实用的使用vcgencmd get_camera可以查看老版本固件层面是否识别到摄像头但注意在Bookworm上这个命令可能返回的只是软件栈的状态不能完全代表硬件状态。使用sudo i2cdetect -y 1扫描I2C总线如果有0x10地址说明硬件在线问题在软件如果没有0x10地址问题多半在硬件连接。使用sudo v4l2-ctl --list-devices可以查看V4L2视频节点如果这里能看到摄像头设备说明驱动层面已经OK剩下的就是应用层的调用问题。5. 从“检测无设备”到正常出图完整实操步骤总结排查完成后我把最终的解决方案整理成一套标准操作流程方便以后遇到类似问题直接按这个顺序走也适合大家照做。这个流程特别适合无屏幕SSH远程操作的情况因为全程只用命令行操作。第一步断电。拔掉树莓派5的USB-C电源线把CSI摄像头排线完全拔出检查金手指是否有氧化或者污渍如果有用干净的橡皮擦拭金手指再重新插回CAM0口。注意排线插到位后再扣下卡扣不要留缝。第二步上电启动SSH登录后执行sudo apt update sudo apt full-upgrade -y sudo rpi-eeprom-update -a sudo reboot第三步重启后确认系统已经烧录最新摄像头固件并启用驱动dmesg | grep -i -E camera|imx|mipi|csi ls -la /dev/video*第四步运行检测命令rpicam-hello --list-cameras如果这一步能看到imx219的相机信息说明摄像头已经被系统识别可以在无屏幕环境下用以下命令抓拍一张测试照片rpicam-still -o test.jpg --width 3280 --height 2464然后用scp或者sftp把test.jpg拉到本地查看确认画面是否正常。注意无屏幕环境下不能直接预览但抓拍照片是可以的。如果你的系统里没有rpicam-still可以通过sudo apt install rpicam-apps安装。第五步如果第四步还是查不到摄像头再回头检查config.txt的配置。确认camera_auto_detect1存在或者直接用dtoverlayimx219强制指定。修改后重启再测。第六步如果以上步骤都没解决进入硬件交叉验证阶段换排线、换摄像头模组、换树莓派主板逐一排除。这套流程下来绝大多数“检测无设备”的问题都能定位到具体环节。从我个人的经验来看这是一套“先软件后硬件”的排查思路每一步都有明确的目的和判断标准不会让人盲目操作。后续如果你还想把摄像头用在OpenCV或者ROS2里那么需要在这一步成功出图的基础上再做扩展。树莓派5上的CSI摄像头在OpenCV里可以用GStreamer管道读取核心是libcamerasrc插件而不是Jetson的nvarguscamerasrc。我举个例子一个能跑通的GStreamer管道是这样的gst-launch-1.0 libcamerasrc camera-name/base/soc/i2c0mux/i2c-11e800000/imx21910 ! video/x-raw,width640,height480 ! videoconvert ! autovideosink在OpenCV的Python接口里可以用cv2.VideoCapture(libcamerasrc ! video/x-raw,width640,height480 ! videoconvert ! appsink, cv2.CAP_GSTREAMER)来读取画面。但前提是你系统里已经安装了GStreamer相关插件和OpenCV的GStreamer支持。至于ROS2里使用CSI摄像头树莓派5上通常的做法是先把图像源通过v4l2或者GStreamer桥接成ROS2的图像话题常用的包有v4l2_camera或者libcamera_ros。这个方向可以等摄像头基础功能完全正常后再深入研究底层的“检测无设备”排查经验在任何上层应用里都是通用的。最后再说一个我在实际操作中的小技巧每次改完配置、重启系统之后不要急着去敲各种复杂的检测命令先给系统十秒钟左右的启动缓冲时间让摄像头驱动的probe流程完全跑完。有时候你重启后立刻敲rpicam-hello --list-cameras刚好遇到底层I2C设备还没枚举完毕也会出现“No cameras available”的假阴性结果。等系统完全就绪后再测能少走很多弯路。
阅读完成 · 觉得有帮助？
)
