Raspberry Pi 新版相機指令 libcamera 快速上手 (含舊版指令對照表)
台灣物聯科技技術團隊
|
2025 技術專欄
如果您剛入手最新的 Raspberry Pi Camera Module 3，或者將樹莓派系統更新到了 Bullseye / Bookworm 版本，您會發現以前熟悉的
raspistill 指令失效了！別驚慌，這是因為樹莓派全面轉向了更強大的開源相機堆疊——libcamera。本文將帶您快速掌握新指令。
1. 快速對照表：舊指令 vs 新指令
對於老玩家來說，最快的學習方式就是直接看對照。新版指令在命名邏輯上非常直觀：
| 功能 | 舊版指令 (Legacy) | 新版指令 (libcamera) |
|---|---|---|
| 純預覽 (不存檔) | raspistill -f |
libcamera-hello |
| 拍照 (JPG) | raspistill |
libcamera-still |
| 錄影 (H264) | raspivid |
libcamera-vid |
| 原始數據 (Raw) | raspiyuv |
libcamera-raw |
*註：在最新的 Raspberry Pi OS (Bookworm) 中，指令別名可能為 rpicam-still 或 rpicam-vid，但功能完全相同。
2. 實戰演練：常用指令範例
拍照指令 (libcamera-still)
這是最常用的指令，基本用法與舊版非常相似。
libcamera-still -o test.jpg
# 延遲 5 秒後拍攝 (單位為毫秒)
libcamera-still -t 5000 -o test.jpg
# 指定解析度為 1920×1080
libcamera-still –width 1920 –height 1080 -o test.jpg
錄影指令 (libcamera-vid)
新版錄影功能支援更靈活的檔案格式。
libcamera-vid -t 10000 -o test.h264
# 直接錄製為 mjpeg (方便某些播放器觀看)
libcamera-vid -t 10000 –codec mjpeg -o test.mjpeg
即時預覽 (libcamera-hello)
用來測試鏡頭是否安裝成功，或是單純想當作電子鏡子使用。
libcamera-hello -t 0
3. 進階功能：解放 Camera Module 3 的潛力
如果您購買的是支援自動對焦 (Auto Focus) 的 Camera Module 3，舊指令是完全無法驅動這個功能的。唯有 libcamera 能讓它火力全開。
啟用連續自動對焦
libcamera-hello -t 0 --autofocus-mode continuous加上這個參數後，您會發現畫面中的物體移動時，鏡頭會自動重新對焦，就像手機一樣！
手動控制對焦
您也可以指定對焦距離（單位為 Dioptres 屈光度，數值 0 代表無限遠，數值越大代表對焦距離越近）： 例如：10.0 大約對焦在 10公分處
libcamera-still -o focus_test.jpg --lens-position 5.04. 常見問題 Troubleshooting
Q: 執行指令出現 command not found？
A: 請確認您的作業系統是否為 Raspberry Pi OS Bullseye 或更新版本。如果是舊版 Buster，請先升級系統。
Q: 出現 no cameras available 錯誤？
A:
1. 檢查排線是否接反（藍色膠帶應朝向網路孔/USB座，若是 Pi Zero 則相反）。
2. 如果您使用的是舊款 Pi Camera V1 (OmniVision)，新系統可能支援度有限，建議升級至 Camera V2 或 Camera V3。
Q: 我還能切換回舊版指令嗎？
A: 在舊版 Bullseye 中可以透過 sudo raspi-config -> Interface Options -> Legacy Camera 啟用舊版支援，但在最新的 Bookworm 系統中，舊版堆疊已被大幅移除，建議盡早適應 libcamera。
官方權威資源參考
- Raspberry Pi 官方相機文件 (Camera Software Documentation) – 查看最完整的參數列表
- Libcamera 開發者官方文檔 – 深入了解底層架構
專注於 Raspberry Pi 與 AIoT 技術教學，我們致力於讓開發者能更輕鬆地使用最新的硬體技術。
