KJX ENGINEERING GUIDE · 06
Raspberry Pi 相机服务部署与运维
从相机识别、服务自启、健康检查到日志轮转，形成可交付的边缘相机服务。
参考流程 · 系统镜像需复核
中级
预计 2–4 小时
核查 2026-08-09
原创方案效果图 · Raspberry Pi 生态边缘视觉网关
使用边界：本页是可简芯原创工程检查流程，不是第三方教程改名，也不代表所有同名板卡已实测通过。当前适用于：Raspberry Pi OS、Picamera2/rpicam-apps 与受支持 CSI 相机。正式交付前须把目标板卡、固件、外设批次和验收结果写入订单或技术协议。
准备与目标
适用范围Raspberry Pi OS、Picamera2/rpicam-apps 与受支持 CSI 相机
当前状态参考流程 · 系统镜像需复核；不得直接当作量产验证结论
开始前准备
- 官方或授权板卡
- 匹配 CSI 相机与排线
- 稳定电源
- 可更新的系统镜像
完成后应得到
- 相机能力可查询
- 服务异常可恢复
- 日志和版本可审计
01 · 相机冒烟
先用官方工具确认相机和格式，不从业务应用开始排错。
- 记录系统、内核和相机信息。
- 完成预览、抓拍和短视频测试。
- 确认分辨率、帧率和旋转。
✓ 相机被系统识别✓ 三种基础操作通过✓ 接口和排线已记录
02 · 服务化
业务进程必须有独立账号、健康检查和明确依赖。
- 建立最小服务与配置文件。
- 设置网络和相机设备依赖。
- 验证开机自启、进程退出和自动恢复。
✓ 重启后自动可用✓ 失败状态可见✓ 配置与代码分离
03 · 运维与更新
限制日志和缓存，更新前保留可回滚版本。
- 配置日志轮转和磁盘阈值。
- 保存服务版本、系统镜像和配置摘要。
- 执行网络中断、相机断连和磁盘占满演练。
✓ 磁盘不会被日志占满✓ 更新可回滚✓ 三类故障有处置记录
故障定位
| 现象 | 常见原因 | 建议动作 |
|---|---|---|
| 服务启动但无画面 | 相机被占用、权限、接口或格式不匹配 | 停止业务服务并回到官方相机工具确认基础链路。 |
验收与归档
- 相机基础测试通过
- 开机自启和恢复通过
- 日志轮转已验证
- 系统/服务版本已归档
建议随订单保存：板卡/PCB 版本、固件与依赖版本、BOM 修订号、操作人、测试日期、原始日志、异常样本和最终结论。图片演示不能替代这些记录。
