單元 1 · 平台相機生態總覽

1.1 MIPI CSI-2 標準：分層模型

MIPI CSI-2（Camera Serial Interface 2）由 MIPI Alliance 制定，是嵌入式相機最普遍的介面。它分四層，每一層解決一類問題：

1.1.1 D-PHY 的兩種模式（很重要）

• HS（High-Speed）：傳資料。差動電平（約 200mV），高速。每 byte 以 DDR 雙沿取樣。
• LP（Low-Power）：傳控制（如 BTA、reset）。單端，低速，電平接近 1.2V。

1.2 RPi5 的 CSI-2 硬體資源

1.2.1 15-pin 連接器腳位（必須背）

1.3 libcamera 四層堆疊（每一層你操作什麼）

1.4 感測器選擇：三個決定性問題

1. 官方 vs 客製：官方 Camera Module v1 = OV5647，免寫 overlay。
2. 接口：15-pin、2-lane MIPI、I2C 0x36。
3. 驅動：drivers/media/i2c/ 有無對應（ov5647/ov5640/ov9281 皆有 mainline 驅動）。

1.5 本章最小驗收

# 查看可用 overlay
sudo dtoverlay -a | grep -E "ov5647|ov9281"
# 檢查 FPC 後 CSI 錯誤
dmesg | grep -i -E "unicam|csi|ov5647" | tail -5

1.6 常見誤解澄清

• 「RPi 相機都一樣」：不同感測器不同驅動、不同 overlay、不同 register——不是「插上就能用」。
• 「CSI 很快所以沒問題」：HS 訊號對排線品質敏感；排線過長/折到會掉 frame。
• 「libcamera 是相機」：libcamera 是框架，感測器控制與 ISP 調校都在它之下。

1.6 深入：CSI-2 D-PHY 的 HS/LP 電氣

除錯「訊號層」問題時，D-PHY 的電氣參數是關鍵：

1.7 深入了解 libcamera 的 PipeLine 初始化順序

libcamera 啟動時依 media graph 找出「感測器 + ISP」並組 Camera；tuning 檔在首次使用該 Camera 時載入。若 list-cameras 看得到相機，代表這一串都成功。

1.8 練習：確認你的硬體就緒

1. 列出本機 2 個相機連接器：sudo dtoverlay -a | grep cam。
2. 確認 overlay 清單含 ov5647。
3. 用 dmesg | grep -i -E 'unicam|ov5647' 確認無 error。
4. 把結果記錄下來（寫入你的 bring-up log）。

進階真實情境 Worked Example：雙攝影機同時串流的管線配置

場景：RPi5 同時接 OV5647（Camera 0）與 OV9281（Camera 1），要同時錄影用於雙目視覺。

# 1. 確認兩顆都被 libcamera 偵測
rpicam-hello --list-cameras
# 顯示：0: ov5647  1: ov9281

# 2. 用 picamera2 同時串流（雙 stream）
python3 - <<'EOF'
from picamera2 import Picamera2
import time

cam0 = Picamera2(0)   # OV5647
cam1 = Picamera2(1)   # OV9281

cfg0 = cam0.create_video_configuration(
    main={"size": (1280, 720), "format": "RGB888"})
cfg1 = cam1.create_video_configuration(
    main={"size": (640, 480), "format": "RGB888"})

cam0.configure(cfg0)
cam1.configure(cfg1)
cam0.start()
cam1.start()
time.sleep(3)
cam0.stop()
cam1.stop()
print("雙鏡頭串流完成")
EOF

# 3. 檢查 DMA buffer 分配
dmesg | grep -i "dma\|buffer\|cma" | tail -5

深入原理擴充：CSI-2 D-PHY 的 HS/LP 切換與通道佔用

CSI-2 D-PHY 的 HS（High-Speed）與 LP（Low-Power）模式之間的切換，不是「瞬間」完成的：

• LP→HS 切換：需經 ULPS（Ultra Low Power State）→ HS-Rqst → HS-Prepare → HS-Trail，整個序列約數 µs。
• BTA（Bus Turn-Around）：方向切換時，通道必須回到 LP 模式，這段時間通道不可用。
• RPi5 的 unicam 驅動在收到 SOF（Start-of-Frame）後才鎖定 HS 模式；若 LP→HS 切換太慢，會錯過幀頭 → dmesg 出現「frame sync timeout」。

診斷式疑難排解表

進階挑戰題

1. 用 media-ctl -p -d /dev/media0 畫出完整的 media graph，標出每個 entity 的 role（source/sink）與 pad format。若把 OV5647 的 lane 數從 2 改成 4（假設硬體支援），media graph 會有何變化？
2. 設計一個「排線品質快速篩選」腳本：連續拍 100 張 RAW，統計每張的 frame CRC 錯誤數。若任何一張 CRC 錯誤 > 0，判定排線不合格。
3. RPi5 同時接 OV5647 + OV9281 時，兩顆的 XCLK 頻率是否必须相同？查 datasheet 說明原因。

延伸閱讀

• 下一篇：單元 2 · 影像感測器基礎。
• RPi 相機文件 · MIPI CSI-2 規格
• 學習路線：複習全站

專案級端到端 Worked Example：完整感光元件 bring-up 專案 — 從 DT overlay 到第一張圖

場景：這是一顆全新的 OV5647 模組 + RPi5 開發板。目標是走完「硬體 → overlay → 媒體節點 → 第一張 RAW」的完整端到端流程，驗證整個相機生態鏈就緒。這個專案整合單元 1（CSI-2/生態）、3（I2C）、4（overlay/驅動）、5（出圖）的知識。

# 階段 0：硬體安裝（單元 1 排線 SOP）
# 金手指朝彈片、插入到底、鎖扣壓平

# 階段 1：確認 overlay 就緒
sudo dtoverlay -a | grep -E "ov5647|ov9281"
# 預期：ov5647 在清單中

# 階段 2：確認 probe 與媒體節點
dmesg | grep -i -E "ov5647|unicam|csi" | tail -10
# 預期：ov5647 0-0036: Probing / Chip ID 0x5647，無 error
ls /dev/media* /dev/video*

# 階段 3：I2C 驗證感測器 ID（單元 3）
sudo i2cdetect -y 22 | grep 36          # 預期看到 0x36
sudo i2ctransfer -y 22 w2@0x36 0x30 0x0a r1   # 預期 0x56
sudo i2ctransfer -y 22 w2@0x36 0x30 0x0b r1   # 預期 0x47

# 階段 4：libcamera 偵測（單元 4/5）
rpicam-hello --list-cameras
# 預期：0 : ov5647 [2592x1944 10-bit RGGB] + Modes 清單

# 階段 5：產出第一張 RAW
rpicam-still --raw --shutter 20000 --gain 1.0 --awb off --awbgains 1.0,1.0 -o first.dng
ls -la first.dng
# 預期：first.dng 存在（RAW 檔）

量測/驗證 SOP：平台相機生態就緒驗證

1. 排線重插（金手指朝彈片、壓平鎖扣），記錄插拔次數。
2. sudo dtoverlay -a | grep ov5647 確認 overlay 清單。
3. dmesg | grep -i -E "unicam|ov5647|csi" 確認無 error（回看最後 10 行）。
4. sudo i2cdetect -y 22 確認 0x36 回應。
5. rpicam-hello --list-cameras 確認 camera 0 出現。
6. 拍一張 RAW 並用 rawpy 讀出 shape（2592×1944 且非全黑）。

平台間對照：相機生態與 CSI 介面

互動式檢核清單

• - [ ] 能背出 15-pin 連接器腳位與排線 SOP。
• - [ ] 能逐層說明 libcamera 四層堆疊與各層操作對象。
• - [ ] 能用 dmesg + i2cdetect + list-cameras 完成生態就緒驗證。
• - [ ] 能說出「三個決定性問題」判斷感測器是否可用。
• - [ ] 能說出 CSI-2 四層模型與 D-PHY HS/LP 的差異。
• - [ ] 已把生態驗證六步結果寫入 bring-up log。

第 3 輪深度加深

① Register 位元級完整工作流：RPi5 CSI-2 通道啟用

② 多層疑難排解決策樹

決策樹 A：相機完全無畫面

相機無畫面
├─ 檢查 A：dmesg 有無 ov5647 probe 訊息
│  ├─ 無 → overlay 未啟用 → /boot/firmware/config.txt 加 dtoverlay=ov5647
│  └─ 有 → probe 成功，繼續
├─ 檢查 B：i2cdetect 0x3C 是否有回應
│  ├─ 無 → I2C 通道未開 / 排線問題 / 供電異常
│  └─ 有 → I2C 正常，繼續
├─ 檢查 C：rpicam-hello --list-cameras 是否出現 camera 0
│  ├─ 無 → libcamera 管線未正確綁定 → 檢查 /etc/libcamera/ipa_rpi.yaml
│  └─ 有 → 硬體層 OK，問題在應用層
└─ 檢查 D：測試擷取 RAW 是否為全黑
   ├─ 全黑 → sensor 曝光設定異常 / MIPI 訊號未到達 ISP
   └─ 有資料 → 基本功能 OK

決策樹 B：i2cdetect 有回應但畫面異常

i2cdetect 有回應但畫面異常
├─ 檢查 A：dmesg 有無 CSI error / frame sync error
│  ├─ 有 → MIPI 時序問題 → 檢查 clock lane 頻率設定
│  └─ 無 → 繼續
├─ 檢查 B：曝光時間是否合理
│  ├─ 0 或最大值 → AE 未收斂 → 檢查 tuning 檔案
│  └─ 正常 → 繼續
└─ 檢查 C：是否只在特定解析度下異常
   ├─ 是 → 該解析度 lane 數/時序不匹配 → 調整 MIPI config
   └─ 否 → 軟體管線問題

③ 量測驗證完整 SOP：CSI-2 訊號完整性

1. 工具準備：示波器（≥200MHz）、SMA 探棒、15-pin 排線 breakout 板
2. 接線：探棒接至 CSI connector 的 DATA0+ 與 GND
3. 觸發設定：示波器觸發於 HS 模式進入（Voltage threshold ≈ 200mV）
4. 量測項目：
   a. HS 模式差動振幅：預期 100–300mV
   b. LP→HS 切換時間：預期 <100ns
   c. Clock frequency：150MHz (2-lane) / 300MHz (4-lane)
5. 重複量測：每條件量 10 次，計算平均值與 ±σ
6. 判讀標準：振幅 <80mV = 訊號衰減（排線品質差）；時序抖動 >50ps = EMI 干擾
7. 常見偏差：排線彎折半徑太小 → 阻抗不連續 → 振幅下降；接地不良 → 共模雜訊

④ 四平台終極對照

⑤ 完整 Bring-up 專案 Checklist

• - [ ] 確認 RPi5 韌體版本（vcgencmd version ≥ 2024-01）
• - [ ] 安裝最新 Raspberry Pi OS（64-bit Bookworm）
• - [ ] /boot/firmware/config.txt 加入 dtoverlay=ov5647（或對應感測器）
• - [ ] 排線插入 CSI0 連接器，確認卡扣到位
• - [ ] 重啟後執行 dmesg | grep ov5647 確認 probe 成功
• - [ ] i2cdetect -y 1 確認 0x3C 出現
• - [ ] rpicam-hello --list-cameras 確認 camera 0 列出
• - [ ] 拍攝測試 RAW（rpicam-hello -k --nopreview -t 5000 --raw）
• - [ ] 用 rawpy / dcraw 驗證 RAW 尺寸與非全黑
• - [ ] 將所有步驟結果寫入 bring-up log，含時間戳
• - [ ] 如失敗，依決策樹 A/B 逐步排查
• - [ ] 記錄 MIPI lane 數、時鐘頻率、排線型號以備查