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

uname -a                          # 看架構與 kernel 版本
cat /etc/os-release | head -3     # 確認發行版（Armbian / Orange Pi OS…）

ls /dev/video* 2>/dev/null        # 有 /dev/video0 代表有 video device
ls /dev/v4l-subdev* 2>/dev/null   # subdev 節點（感測器/CSI）
dmesg | grep -i -E "ov5640|csi|camera|mipi"

ls /dev/i2c-*                     # 找相機掛在哪個 bus
sudo i2cdetect -l                 # 每個 bus 的編號與種類

media-ctl -p -d /dev/media0 2>/dev/null || echo "無 /dev/media0"

cat /proc/device-tree/compatible | tr '\0' '\n' | head -1
ls /dev/media*          # RK3588 可能有多個 media device

v4l2-ctl --list-devices
ls /dev/v4l-subdev*

sudo i2cdetect -y 3    # OV5640 應在 0x3c
sudo i2cdetect -y 4    # OV9281 應在 0x60
sudo i2cget -y 3 0x3c 0x300a   # → 0x56
sudo i2cget -y 4 0x60 0x300a   # → 0x92（OV9281 ID）

media-ctl -p -d /dev/media0 2>/dev/null | grep -E "ov5640|ov9281|csi"
media-ctl -p -d /dev/media1 2>/dev/null | grep -E "ov5640|ov9281|csi"

uname -a
ls /dev/video* /dev/v4l-subdev* 2>/dev/null
sudo i2cdetect -l

# 最小 overlay：啟用 I2C3 + 感測器節點
/dts-v1/;
/plugin/;
&i2c3 {
  status = "okay";
  ov5640: ov5640@3c {
    compatible = "ovti,ov5640";
    reg = <0x3c>;
    clocks = <&clk_cam0>;
    clock-frequency = <24000000>;
    pinctrl-names = "default";
    pinctrl-0 = <&camera_pwr_en>;
  };
};

dmesg | grep -i -E "ov5640|probe"
sudo i2cget -y 3 0x3c 0x300a    # 預期 0x56

media-ctl -d /dev/media0 -r
media-ctl -d /dev/media0 -l "'ov5640 3-003c':0->'csi2':0[1]"
media-ctl -d /dev/media0 -V "'ov5640 3-003c':0[fmt:UYVY8_2X8/1280x720]"
v4l2-ctl -d /dev/video0 --set-fmt-video=width=1280,height=720,pixelformat=YUYV \
  --stream-mmap=3 --stream-count=1 --stream-to=first.yuv
ls -l first.yuv   # 1,843,200 bytes

- [ ] 我能背出我板卡的 SoC、CSI 數量、有無平台 ISP。
- [ ] 我能用 media-ctl -p 畫出板卡完整的 media graph。
- [ ] 我已跑完 1.14 SOP 並產出「平台盤點表」。
- [ ] 我能解釋「感測器位址 0x3c vs 0x36」的由來。
- [ ] 我能指出 RK3588 與 H618 在「調校能力」上的本質差異。
- [ ] 我已開始 1.13 專案，至少完成階段 1 盤點。

dmesg 無任何相機字樣？
├─ 是 → DT 未啟用相機 → 檢查 overlay 是否含 i2c + sensor 節點
│  └─ DT overlay 已載入但無字樣 → compatible 字串不對（查 ov5640.c）
└─ 否 → 有 probe 字樣
   ├─ probe failure → 依 dmesg 錯誤：
   │  ├─ "no chip id" → I2C 通但 ID 錯 → 位址/模組型號問題
   │  ├─ "clk prepare" → clock 未就緒 → DT clock-frequency 設定
   │  └─ "reset" → reset GPIO 極性/時序 → 檢查 reset-gpios
   └─ probe success → 檢查 /dev/video* 是否存在

ls /dev/video* 有節點？
├─ 否 → media controller 未綁定 → 檢查 DT 的 video device 節點
└─ 是 → v4l2-ctl --list-devices 有對應？
   ├─ 否 → subdev 未 probe → dmesg 看 csi/entity 錯誤
   └─ 是 → media-ctl -p 有完整管線？
      ├─ link 缺失 → media-ctl -l 手動建 link
      ├─ format 缺失 → media-ctl -V 設定 pad format
      └─ 管線完整 → v4l2-ctl 取流（回單元 5）

- [ ] 確認 SoC 型號（RK3588 / H618 / H616）
- [ ] 列出所有 /dev/video* 與 /dev/v4l-subdev* 節點
- [ ] 執行 i2cdetect -l 列出所有 I2C bus
- [ ] 在正確 bus 上掃描到 0x3c（OV5640 位址）
- [ ] 讀取 0x300A 確認回 0x56（OV5640 ID）
- [ ] 讀取 0x300B 確認回 0x40
- [ ] dmesg 確認 "probe success" 無 error
- [ ] media-ctl -p 確認 sensor → csi → video 完整管線
- [ ] 用 media-ctl -l 建立 link 並 -V 設定格式
- [ ] v4l2-ctl 取一幀 YUV 並驗證 sizeimage
- [ ] 產出「平台盤點表」文件（SoC/I2C/media/格式）
- [ ] 確認 BSP「已知可用組合」與你的硬體一致
- [ ] 若有多顆感測器，逐一確認各自的 bus/位址/video node