文章目录1. 范围2. USB 和 CSI3. 工具、权限、板况4. USB枚举、格式、抓帧5. USB 采集脚本6. USB 常见坑6.1 设备号漂移6.2 带宽和格式6.3 曝光和自动档6.4 多个 video 节点6.5 供电和口7. CSI和 USB 不是同一套排障8. 接到检测和容器9. 掉线重连10. 采集和推理分开验收11. 术语对照12. 延伸阅读13. 小结摘要检测通了之后经常卡在相机OpenCV 打不开、能开却黑屏、CSI 换载板就没图。本文写 Jetson Orin 上 USB / CSI 的确认步骤、采集脚本、格式与带宽、设备号漂移、掉线重连、容器透传以及 CSI 和 USB 不同的排障路径。适合已经能用文件跑检测、要把实时画面接进链路的人。命令和插件名随 JetPack / 载板会变以你板上实际为准。1. 范围目标板上能稳定拿到相机帧。先不扯 RTSP 调度、DeepStream 拓扑、模型精度。相机挂了和 TensorRT 挂了混在一起查半天都在猜。顺序上文件链路通了再上 USBUSB 能连续存图了再碰 CSI。现场三种高频症状后文都会拆开写症状常见落点打不开权限、占用、节点选错、容器没映射设备能开但黑/花曝光、像素格式、开到 metadata 节点跑一会儿挂供电、线材、带宽、USB 控制器复位图1. 采集和推理分开验收排障才分得清层。2. USB 和 CSI类型常见接口优点麻烦点USB 相机USB-A / USB-C好买、好换、排障相对直观带宽、供电、UVC 兼容、节点编号会漂CSI 相机载板 MIPI CSI量产常见、延迟和集成更好绑载板、设备树、驱动、排线方向场景更合适原因预研、演示、临时验证USB换相机成本低问题多半在软件侧结构件固定、产线安装CSI机械固定、线束短、延迟更可控多路高分辨率同时采看载板和带宽预算USB 口抢带宽CSI 看 lane 和驱动Orin 模组有 CSI 能力不等于你那块载板开了哪一路、要不要改 device tree。宣传页上的“支持多路相机”落到手上永远是载板丝印 BSP 传感器型号三件套。USBUVC和走 ISP 的 CSI在 NVIDIA 文档里对应的用户态路径也不一样可对照 Camera Software Development Solution。3. 工具、权限、板况sudoapt-getupdatesudoapt-getinstall-yv4l-utilsv4l-utils提供v4l2-ctl。有桌面可用guvcview没桌面就用v4l2-ctl、GStreamer 或下文脚本把帧落到磁盘。groups|rg videoidls-l/dev/video0不在video组就加然后重新登录或重开 SSH 会话sudousermod-aGvideo$USERls -l /dev/video0一般能看到属组是video。当前会话还是旧 groups 的话表现就是“同一块板root 能开、普通用户不能开”。记板况后面换镜像、换同事接手都用得上cat/etc/nv_tegra_releaseuname-alsusbls-l/dev/video*sudonvpmodel-q信息干什么用L4T / JetPackCSI 驱动、Argus、插件是否对版lsusbUSB 相机有没有被枚举/dev/video*V4L2节点有几个、会不会漂功耗档采集推理一起跑时别拿默认档对标USB 先看lsusbCSI 主要看载板和dmesglsusb帮不了多少。4. USB枚举、格式、抓帧ls/dev/video* v4l2-ctl --list-devices一个物理摄像头常对应多个/dev/videoN。有的出图有的是 metadata。别默认video0。v4l2-ctl-d/dev/video0--allv4l2-ctl-d/dev/video0 --list-formats-ext--all能看到当前格式、分辨率、部分控件--list-formats-ext看支持的格式组合。重点看有没有MJPG/YUYV有的还有H264每个格式下的宽高和帧率档位你后面推理要用的尺寸相机能不能直接出还是必须软件缩放v4l2-ctl-d/dev/video0\--set-fmt-videowidth640,height480,pixelformatMJPG\--stream-mmap\--stream-count1\--stream-toframe.jpgfileframe.jpgfile看是不是真 JPEG。这一步失败先别写 OpenCVVideoCapture业务代码——问题还在驱动、权限、格式或供电。也可以用 GStreamer 做对照不经过 OpenCVgst-launch-1.0 v4l2srcdevice/dev/video0!\image/jpeg,width640,height480,framerate30/1!\jpegdec!videoconvert!jpegenc!filesinklocationgst_frame.jpgOpenCV 失败、GStreamer 成功时优先查 OpenCV 后端要不要强制CAP_V4L2、FOURCC 设置顺序而不是先重装系统。5. USB 采集脚本工作目录mkdir-p~/orin-cam/{cam_out,cam_live}cd~/orin-cam# 保存下文 usb_cam_probe.py / usb_cam_reconnect.py文件作用usb_cam_probe.py打开相机、设分辨率、连续存帧usb_cam_reconnect.py读帧失败后自动重开保存为usb_cam_probe.py#!/usr/bin/env python3Orin 上 USB 相机最小探针打开、设分辨率、保存若干帧。 用法: python3 usb_cam_probe.py --device 0 --width 640 --height 480 --frames 30 python3 usb_cam_probe.py --device /dev/video0 --save-dir ./cam_out --show from__future__importannotationsimportargparseimporttimefrompathlibimportPathimportcv2defopen_cam(device:str,width:int,height:int,fps:int):ifdevice.isdigit():capcv2.VideoCapture(int(device),cv2.CAP_V4L2)else:capcv2.VideoCapture(device,cv2.CAP_V4L2)ifnotcap.isOpened():raiseRuntimeError(f打不开:{device})# 先设后端和格式再设分辨率顺序反了有的相机会 silently ignorecap.set(cv2.CAP_PROP_FOURCC,cv2.VideoWriter_fourcc(*MJPG))cap.set(cv2.CAP_PROP_FRAME_WIDTH,width)cap.set(cv2.CAP_PROP_FRAME_HEIGHT,height)iffps0:cap.set(cv2.CAP_PROP_FPS,fps)actual_wint(cap.get(cv2.CAP_PROP_FRAME_WIDTH))actual_hint(cap.get(cv2.CAP_PROP_FRAME_HEIGHT))actual_fpscap.get(cv2.CAP_PROP_FPS)print(fopened{device}: ask{width}x{height}{fps}, got{actual_w}x{actual_h}{actual_fps:.1f})returncapdefmain():apargparse.ArgumentParser()ap.add_argument(--device,default0)ap.add_argument(--width,typeint,default640)ap.add_argument(--height,typeint,default480)ap.add_argument(--fps,typeint,default30)ap.add_argument(--frames,typeint,default30)ap.add_argument(--save-dir,defaultcam_out)ap.add_argument(--show,actionstore_true)argsap.parse_args()out_dirPath(args.save_dir)out_dir.mkdir(parentsTrue,exist_okTrue)capopen_cam(args.device,args.width,args.height,args.fps)ok_count0t0time.perf_counter()foriinrange(args.frames):ok,framecap.read()ifnotok:print(fframe{i}: read failed)continueok_count1cv2.imwrite(str(out_dir/fframe_{i:04d}.jpg),frame)ifargs.show:cv2.imshow(usb-cam,frame)ifcv2.waitKey(1)0xFFord(q):breakdttime.perf_counter()-t0 cap.release()ifargs.show:cv2.destroyAllWindows()print(fsaved{ok_count}/{args.frames}frames to{out_dir}, elapsed{dt:.2f}s)ifok_count0:raiseSystemExit(1)if__name____main__:main()python3 usb_cam_probe.py--device0--width640--height480--frames30lscam_out|head打印里的ask和got要对一下很多相机对不支持的分辨率会静默回落到别的档脚本以为设成功了其实一直在采 640×480 或更奇怪的尺寸。有桌面加--show纯 SSH 只存文件。cam_out/里应是正常画面不是全黑、绿屏、条纹。想粗测采集侧帧率可以把--frames提到 300看脚本打印的 elapsed再和相机标称帧率比。差很多时先查 USB 口是 2.0 还是 3.x、是不是 YUYV 把带宽打满。6. USB 常见坑现象多见原因先查什么ls /dev/video*没有没枚举、线/口、供电lsusb、换口换线、供电有节点但 OpenCV 打不开不在video组、被占用groups、fuser能开但全黑曝光、格式、开错节点换节点、MJPG/YUYV、曝光控件分辨率设了不生效不支持、设置顺序不对--list-formats-ext、看got跑一会儿掉线供电不稳、线差、口供电不足短线、带供电的 Hub、换口重启后设备号变了多个 UVCudev 或按名称选容器里打不开没映射设备--device、--group-add video画面卡、实际 FPS 很低YUYV高分辨率、USB2改 MJPG、降分辨率sudofuser/dev/video0被占用就停掉。远程桌面、浏览器、之前没杀掉的guvcview/ Python 进程都很常见。6.1 设备号漂移今天video0多插一个 UVC 就变成video2。业务脚本别写死0。v4l2-ctl --list-devices量产可以用 udev 固定名。先查相机的idVendor/idProductlsusb udevadm info-a-n/dev/video0|rg-iidVendor|idProduct|serial|ATTRS示例规则按你的 vid/pid 改保存为/etc/udev/rules.d/99-orin-usbcam.rules# 示例把指定 UVC 的捕获节点链成 /dev/orin_cam0SUBSYSTEMvideo4linux, ATTRS{idVendor}046d, ATTRS{idProduct}0825,\ATTR{index}0,SYMLINKorin_cam0,GROUPvideo,MODE0660sudoudevadm control --reload-rulessudoudevadm triggerls-l/dev/orin_cam0脚本和 Docker 都用/dev/orin_cam0少受插拔顺序影响。ATTR{index}0用来避开 metadata 节点具体以udevadm info为准。6.2 带宽和格式同一分辨率下YUYV 未压缩MJPG 压缩后更省 USB 带宽。1080p30 走 YUYV在 USB2 口上很容易卡或直接设失败。格式特点什么时候用MJPG省带宽解码吃一点 CPUUSB 口紧张、分辨率较高时优先试YUYV无压缩带宽大短距离 USB3、分辨率不高、要省解码时H264若支持相机端编码要传较远或录流时链路更复杂FPS 低时先把采集格式和口速查清别一上来怪 TensorRT。6.3 曝光和自动档有的模组默认曝光极低室内像黑屏自动曝光狂抖时后面检测框也会晃。v4l2-ctl-d/dev/video0 --list-ctrls# 控件名因相机而异v4l2-ctl-d/dev/video0 --set-ctrlauto_exposure1v4l2-ctl-d/dev/video0 --set-ctrlexposure_time_absolute300黑屏时先存一张原图直方图贴边、几乎全 0多半是曝光花屏、颜色通道错乱再怀疑格式和转换。6.4 多个 video 节点v4l2-ctl --list-devices里同一摄像头下挂video0、video1时开错节点会出现能open但一直read失败或帧内容异常。两个节点各跑一遍探针看谁出正常图。6.5 供电和口Orin DevKit / 载板上的 USB 口供电能力不一样。工业相机、长线、劣质 Hub 叠在一起时表现是刚插上能枚举采几分钟lsusb设备消失或dmesg里出现 reset。dmesg|rg-iusb|uvcvideo|disconnect|reset|tail-n40优先换短线、换口、去掉无供电 Hub。板子供电本身不稳时还会连带文件系统和随机重启那时先查电源适配器别只盯相机驱动。7. CSI和 USB 不是同一套排障CSI 依赖载板接口定义、设备树/BSP、传感器驱动是否在当前镜像、排线方向与供电/复位。顺序大致是载板文档是否写明支持该传感器当前 JetPack / 镜像有没有对应驱动物理连接和 CSI 路数丝印 CAM0/CAM1再用厂商推荐的 GStreamer / Argus 路径验证插件名和 pipeline 随 JetPack 会变以载板文档为准。CSI ISP 场景优先看 Libargus 与文档里的nvarguscamerasrc路径不要默认等同于 USB 那套 V4L2 打开方式。ls/dev/video*dmesg|rg-iimx|ov56|camera|vi|nvcsi|argus|i2c|tail-n80dmesg里 I2C NACK、probe fail先查排线、座子、供电和设备树别先改 Python。有 Argus 时可以这样试示意sensor-id / 分辨率按文档改gst-launch-1.0 nvarguscamerasrc sensor-id0!\video/x-raw(memory:NVMM),width1280,height720,framerate30/1!\nvvidconv!video/x-raw,formatBGRx!\videoconvert!jpegenc!filesinklocationcsi_test.jpg现象多见原因先查什么Argus 直接报错退出驱动/设备树不匹配、sensor-id 错载板文档、dmesg有/dev/video*但 OpenCV 打不开CSI 应用路径本就不走这个节点改用文档里的 GStreamer一路有图一路没有线序、座子、只开了一路电源换 CAM 口、查供电换 JetPack 后挂了BSP 未跟上回退或找载厂对应镜像别把 USB 经验硬套成“换个/dev/video0”。不少 CSI 方案稳定路径是nvarguscamerasrc一类插件不是任意 V4L 节点。换载板或传感器时记一页比收藏一条网上命令有用记录项例子载板型号某 Orin NX 载板传感器型号IMX 某型号CSI 路数 / 丝印CAM0JetPack / L4T某版本验证 pipelinenvarguscamerasrc ...稳定分辨率 / 帧率1280×72030已知限制某模式花屏、某线材不稳图2. CSI传感器 → 载板 → 设备树/驱动 → 用户态取流缺一层都会“没图”。8. 接到检测和容器USB 出图稳定后再改检测入口。例如沿用检测闭环里的脚本python3 detect_camera.py--engineyolov8n_fp16.engine--device0# 或python3 detect_camera.py--engineyolov8n_fp16.engine--device/dev/orin_cam0点说明分辨率相机 1080p、模型 640中间必有缩放letterbox 要和训练一致预览imshow吃 CPUSSH 无桌面会直接失败先存帧计时端到端 FPS 含采集和纯推理不要混着报缓冲区OpenCV 默认可能积压旧帧实时场景要考虑丢中间帧容器映射示例--devicedockerrun--rm\--runtimenvidia\--device/dev/orin_cam0:/dev/orin_cam0\--group-add video\-v$PWD/models:/models\-v$PWD/output:/output\your-image...--privileged能省事量产别当默认。映射后先在容器里确认节点存在dockerrun--rm\--device/dev/orin_cam0:/dev/orin_cam0\--group-add video\ubuntu:22.04ls-l/dev/orin_cam0宿主机能采、容器不能采按这个查--device是否映射对、容器内有没有节点、组权限、重启后设备号是否又漂了。用 udev 固定名再映射比写死video0稳。9. 掉线重连USB 常见拔插、供电抖、跑久了read失败。进程直接退出的话现场就得人上去重启。保存为usb_cam_reconnect.py#!/usr/bin/env python3USB 相机读帧失败时自动重开。 用法: python3 usb_cam_reconnect.py --device 0 --save-dir ./cam_live --max-fail 30 from__future__importannotationsimportargparseimporttimefrompathlibimportPathimportcv2defopen_cam(device:str,width:int,height:int):capcv2.VideoCapture(int(device)ifdevice.isdigit()elsedevice,cv2.CAP_V4L2)ifnotcap.isOpened():returnNonecap.set(cv2.CAP_PROP_FOURCC,cv2.VideoWriter_fourcc(*MJPG))cap.set(cv2.CAP_PROP_FRAME_WIDTH,width)cap.set(cv2.CAP_PROP_FRAME_HEIGHT,height)returncapdefmain():apargparse.ArgumentParser()ap.add_argument(--device,default0)ap.add_argument(--width,typeint,default640)ap.add_argument(--height,typeint,default480)ap.add_argument(--save-dir,defaultcam_live)ap.add_argument(--every,typeint,default30,help每 N 帧存一张)ap.add_argument(--max-fail,typeint,default30)argsap.parse_args()out_dirPath(args.save_dir)out_dir.mkdir(parentsTrue,exist_okTrue)fail0idx0capopen_cam(args.device,args.width,args.height)ifcapisNone:raiseRuntimeError(首次打开失败)print(running, CtrlC to stop)try:whileTrue:ifcapisNone:time.sleep(1.0)capopen_cam(args.device,args.width,args.height)ifcapisNone:print(reopen failed, retry...)continuefail0print(reopened camera)ok,framecap.read()ifnotok:fail1print(fread fail{fail}/{args.max_fail})iffailargs.max_fail:cap.release()capNonetime.sleep(0.05)continuefail0idx1ifidx%args.every0:pathout_dir/flive_{idx:06d}.jpgcv2.imwrite(str(path),frame)print(fsaved{path.name})exceptKeyboardInterrupt:print(stop)finally:ifcapisnotNone:cap.release()if__name____main__:main()python3 usb_cam_reconnect.py--device/dev/orin_cam0 --save-dir ./cam_live--every30量产再加最大重连次数、告警、systemd / 看门狗把进程拉起。重连成功后最好再读几帧丢弃避免拿到半截缓冲。10. 采集和推理分开验收阶段通过标准失败时先别动设备枚举lsusb/v4l2-ctl能看到模型、DeepStream单帧保存磁盘上有正常图片推理代码连续读帧约 3060 秒不掉线后处理、画框冷启动重启后再采一次仍正常临时热插拔状态接入检测框大致合理相机驱动容器映射和权限正确模型结构不少“昨天还好”其实是占用进程、加组后没重登、设备号变了、或昨天用的是 root。验收时按上表走比上来就改模型快。11. 术语对照说法含义UVCUSB Video Class多数 USB 摄像头走这套V4L2Linux 视频子系统/dev/video*、v4l2-ctlFOURCC像素/压缩格式四字符码如 MJPG、YUYVArgus / LibargusJetson 上常见的相机用户态栈之一nvarguscamerasrcGStreamer 取 CSI/Argus 流的常见插件metadata 节点不出预览图的附属/dev/video*设备树 / DT描述板上有哪些传感器、接在哪路 CSI12. 延伸阅读排障时官方文档比零散博客稳版本要以你板上的 L4T / JetPack 为准Jetson Orin 产品页JetPack 下载与版本说明Camera Software Development SolutionUSB/V4L2 与 CSI/Argus 路径怎么选Libargus Camera APIV4L2 用户态文档v4l-utilsGStreamer 文档OpenCV VideoCaptureudevDockerrun --device后续若上多路视频链可再看 DeepStream13. 小结USB 侧优先查权限、占用、格式、带宽、供电和设备号CSI 侧优先查载板文档、设备树、驱动和排线。采集能单独稳住再接检测和容器问题才不会全部堆到模型上。
)
)
