【产出】 > 给树莓派接上官方摄像头模块,用 rpicam-apps 完成预览、拍照、录像和延时摄影,并能在摄像头识别不到时手动指定驱动。
【版本】 > 按树莓派官方 Camera software 文档编写,适用于 Raspberry Pi OS Bookworm 及以后版本。从 Bookworm 开始,拍照录像命令统一叫
rpicam-*。
【注意】 > 网上很多旧教程用的
raspistill、raspivid和老版Picamera库,官方已经声明弃用且不再支持,在新系统上用不了。看到这些命令的教程可以直接跳过。
一、接线
| 板子 | 摄像头接口 | 需要的排线 |
|---|---|---|
| 树莓派 4B / 3B+ | 标准 15 针 | 摄像头自带的排线 |
| 树莓派 5、所有 Zero 系列 | 迷你 22 针 | 需要另买 Standard-Mini 转接排线 |
摄像头模块本身都是标准 15 针接口。树莓派 5 有两个接口,标着 CAM/DISP0 和 CAM/DISP1,用哪个都可以。
步骤:
- 先关机并拔掉电源,再插排线。
- 树莓派 5 装了官方主动散热器时,官方建议先接排线再装散热器,装好后接口很难够到。
- 接好后开机,先更新系统:
sudo apt update && sudo apt full-upgrade -y。
二、确认摄像头可用
rpicam-hello # 预览 5 秒
rpicam-hello --timeout 0 # 一直预览,Ctrl+C 退出
rpicam-hello --list-cameras # 列出识别到的摄像头
通过 SSH 远程登录、没有接显示器时,加 -n 关闭预览窗口:rpicam-hello -n。
三、拍照
最简单的 JPEG:
rpicam-jpeg --output test.jpg
指定分辨率和预览时间(预览 2 秒后保存 640×480):
rpicam-jpeg --output test.jpg --timeout 2000 --width 640 --height 480
功能更多的 rpicam-still:
rpicam-still --output test.jpg # JPEG
rpicam-still --encoding png --output test.png # PNG
rpicam-still --raw --output test.jpg # 同时保存一份 DNG 原始文件
【提示】 > 输出格式由
--encoding决定,不是由文件扩展名决定。只把文件名写成.png、不加--encoding png,得到的仍然是 JPEG 数据。
四、录像
rpicam-vid -t 10s -o test.h264 # 录 10 秒,裸 H.264 流(没有封装格式)
rpicam-vid -t 10s -o test.mp4 # 树莓派 5:直接输出 MP4
rpicam-vid -t 10s --codec libav -o test.mp4 # 树莓派 4 及更早:用 libav 输出 MP4
裸 .h264 文件很多播放器打不开或者播放速度不对,需要分享时直接录成 MP4 更省事。
五、延时摄影
拍 30 秒、每 2 秒一张:
mkdir timelapse
rpicam-still --timeout 30000 --timelapse 2000 -o timelapse/image%04d.jpg
%04d 会被替换成 0001、0002……这样的编号。
长时间、间隔较大的延时(例如每分钟一张拍一整天),官方给出的做法是用 cron 定时调用拍照脚本:
crontab -e
# 加入一行:
* * * * * /home/<用户名>/timelapse.sh 2>&1
timelapse.sh 里写一条带时间戳文件名的 rpicam-still 命令即可,记得 chmod +x 给它执行权限。
六、识别不到摄像头
官方摄像头在普通树莓派上一般会自动识别。识别不到时,先检查:
- 排线方向:金属触点要朝向接口里的触点,两端都要插到底、卡扣压紧。
- 树莓派 5 / Zero 用的是不是 Standard-Mini 转接排线。
确认接线无误后,可以手动指定驱动。编辑 /boot/firmware/config.txt:
camera_auto_detect=0
dtoverlay=imx708
然后 sudo reboot。不同摄像头对应的 overlay:
| 摄像头 | overlay |
|---|---|
| Camera Module 3 | dtoverlay=imx708 |
| Camera Module V2 | dtoverlay=imx219 |
| HQ Camera(高质量摄像头) | dtoverlay=imx477 |
| Camera Module V1 | dtoverlay=ov5647 |
| Global Shutter Camera | dtoverlay=imx296 |
有两个摄像头接口的板子,overlay 默认对应 1 号接口,接在 0 号接口时在后面加 ,cam0,例如 dtoverlay=imx708,cam0。
参考资料
- 树莓派官方 Camera software 文档:https://www.raspberrypi.com/documentation/computers/camera_software.html
评价 (0)