KJX ENGINEERING GUIDE · 06

Raspberry Pi 相机服务部署与运维

从相机识别、服务自启、健康检查到日志轮转，形成可交付的边缘相机服务。

参考流程 · 系统镜像需复核 中级 参考学习时长 2–4 小时 核查 2026-08-09
查看对应方案与 BOM 商城搜索 树莓派
Raspberry Pi 5 / Camera Module 2 / rpicam-apps

公开资料核对，不使用未经确认的整机照片。

适用说明：本手册用于 Raspberry Pi OS、Picamera2/rpicam-apps 与受支持 CSI 相机。实施时请以目标板卡、固件和外设的实际版本为准；正式交付的功能、资料与验收标准以订单或技术协议为准。

准备与目标

适用范围Raspberry Pi OS、Picamera2/rpicam-apps 与受支持 CSI 相机
实施方式参考流程 · 系统镜像需复核；按目标硬件执行并记录结果

开始前准备

  • 官方或授权板卡
  • 匹配 CSI 相机与排线
  • 稳定电源
  • 可更新的系统镜像

完成后应得到

  • 相机能力可查询
  • 服务异常可恢复
  • 日志和版本可审计

01 · 相机冒烟

先用官方工具确认相机和格式，不从业务应用开始排错。

3 个步骤
  1. 记录系统、内核和相机信息。
  2. 完成预览、抓拍和短视频测试。
  3. 确认分辨率、帧率和旋转。
✓ 相机被系统识别✓ 三种基础操作通过✓ 接口和排线已记录

02 · 服务化

业务进程必须有独立账号、健康检查和明确依赖。

3 个步骤
  1. 建立最小服务与配置文件。
  2. 设置网络和相机设备依赖。
  3. 验证开机自启、进程退出和自动恢复。
✓ 重启后自动可用✓ 失败状态可见✓ 配置与代码分离

03 · 运维与更新

限制日志和缓存，更新前保留可回滚版本。

3 个步骤
  1. 配置日志轮转和磁盘阈值。
  2. 保存服务版本、系统镜像和配置摘要。
  3. 在测试环境模拟网络/相机服务中断；磁盘满使用受限测试分区或配额模拟，不填满系统盘。CSI 排线需要变更时先关机断电。
✓ 磁盘不会被日志占满✓ 更新可回滚✓ 三类故障有处置记录
停止条件：先备份测试数据并确认恢复路径，不在客户生产设备上直接做破坏性故障演练。

故障定位

现象常见原因建议动作
服务启动但无画面相机被占用、权限、接口或格式不匹配停止业务服务并回到官方相机工具确认基础链路。

验收与归档

  • 相机基础测试通过
  • 开机自启和恢复通过
  • 日志轮转已验证
  • 系统/服务版本已归档

建议随订单保存：板卡/PCB 版本、固件与依赖版本、BOM 修订号、操作人、测试日期、原始日志、异常样本和最终结论，方便后续复现、维护与售后。