核心用法
RDK X5 Camera 技能专为地平线 RDK X5 开发板设计，提供完整的摄像头配置与图像采集解决方案。该技能覆盖四大类摄像头：MIPI CSI 单目/双目摄像头（如 IMX219、IMX415、SC230ai）、通用 USB UVC 摄像头、以及专业深度相机（Intel RealSense、ZED、Orbbec Gemini）。
用户通过 ROS2 launch 文件即可快速启动对应摄像头节点，系统会自动处理设备发现、参数配置和话题发布。MIPI 摄像头需特别注意断电插拔原则，避免硬件损坏。USB 摄像头支持 MJPEG 和 YUYV 两种模式，前者 CPU 占用更低，后者兼容性更广。深度相机则需要额外安装厂商 SDK 包。
图像预览通过 WebSocket 服务实现，编码后的视频流可在浏览器端实时查看，无需额外客户端软件。ISP 调参工具提供源码级别的图像参数调整能力，适合需要精细画质控制的场景。
显著优点
1. 硬件适配全面：覆盖消费级到工业级主流摄像头型号，单文档解决多源接入问题
2. ROS2 原生集成：基于 TROS（地平线 ROS2）构建，话题标准统一，便于与其他 ROS2 节点联动
3. 实时 Web 预览：零配置浏览器访问，大幅降低调试门槛
4. 故障排查体系完善：内置 5 类常见问题的诊断对照表，缩短问题定位时间
5. 开源友好：MIT-0 许可证，可自由商用和二次开发
潜在缺点与局限性
1. 平台绑定性强：仅支持 RDK X5 硬件平台，无法迁移至其他嵌入式设备
2. 深度相机依赖外部 SDK：RealSense、ZED 等需单独安装厂商驱动，版本兼容性问题需自行处理
3. MIPI 操作门槛高：硬件接线要求严格，带电插拔风险未做软件层面的防护
4. ISP 调参需编译：tuning_tool 为 C 源码，需 make 编译后运行，对非嵌入式开发者不够友好
5. 无 AI 推理能力：明确限制仅用于图像采集，目标检测等需调用 rdk-x5-ai-detect 技能
适合的目标群体
- 嵌入式视觉开发者：从事机器人、自动驾驶、智能相机等方向的 ROS2 开发者
- RDK X5 硬件用户：已购买该开发板、需要快速验证摄像头方案的工程师
- 教育科研场景：高校机器人实验室、自动驾驶课程的学生和教师
- 原型验证团队：需要快速搭建视觉采集系统的硬件产品经理
使用风险
1. 硬件损坏风险：MIPI 摄像头带电插拔可能导致模组烧毁，需严格执行断电操作流程
2. 设备节点冲突：多摄像头同时接入时，/dev/videoX 编号可能漂移，需动态确认
3. CPU 资源占用：YUYV 模式在高分辩率下会显著增加 CPU 负载，建议生产环境使用 MJPEG
4. 端口占用冲突：WebSocket 默认 8000 端口可能被其他服务占用，需检查冲突
5. 依赖版本锁定：ros-humble-librealsense2 等包需与 TROS 版本匹配，升级时可能引入兼容性问题