單元 4 · 平台相機框架與驅動

media-ctl -p -d /dev/media0     # 列出所有實體與連結
v4l2-ctl --list-devices         # 對應的 /dev/videoX
v4l2-ctl -d /dev/v4l-subdev0 --list-ctrls   # 列出感測器 controls

media-ctl -p -d /dev/media0

v4l2-ctl --list-devices

v4l2-ctl -d /dev/v4l-subdev0 --list-ctrls

cat /sys/class/video4linux/video0/name   # device name
readlink -f /sys/class/video4linux/video0/device   # 對應 DT 節點

readlink -f /sys/class/video4linux/video0/device   # 指向 DT 節點
cat /sys/class/video4linux/video0/name             # 節點名稱
cat /sys/bus/i2c/devices/3-003c/name               # 感測器 i2c device name

cat /sys/class/video4linux/video0/name
readlink -f /sys/class/video4linux/video0/device
ls -la /sys/bus/platform/devices/*/video4linux/

ls /sys/bus/i2c/devices/
cat /sys/bus/i2c/devices/3-003c/name   # 應為 "ov5640"
readlink -f /sys/bus/i2c/devices/3-003c/driver

media-ctl -p -d /dev/media0 2>/dev/null | grep "entity"
# 正常應有 sensor + csi + (isp) + video = 3~5 entities

for d in /sys/class/video4linux/*; do
  name=$(basename $d)
  devname=$(cat $d/name)
  dt=$(readlink -f $d/device)
  echo "$name | $devname | $dt"
done

media-ctl -p -d /dev/media0 | grep -E "entity|type|device node" | head -30

v4l2-ctl -d /dev/v4l-subdev0 --list-ctrls

#!/bin/bash
echo "===== 平台相機節點盤點表 $(date) ====="
echo "--- video devices ---"
v4l2-ctl --list-devices
echo "--- i2c devices bound to ov5640 ---"
ls -la /sys/bus/i2c/devices/ | grep -i ov
echo "--- driver ---"
readlink -f /sys/bus/i2c/devices/*/driver 2>/dev/null | grep -i ov

- [ ] 我能跑出 camera_inventory.sh 並產出完整盤點表。
- [ ] 我能指出 video 節點與 subdev 節點的 API 差異。
- [ ] 我已從 /sys 追蹤出 OV5640 的驅動綁定鏈。
- [ ] 我能列出本平台感測器的全部 controls 與範圍。
- [ ] 我了解 libcamera / Argus / V4L2 之間的抽象層差異。
- [ ] 我能從「media graph 不完整」反推是驅動還是 DT 問題。

media-ctl -p 有 sensor entity 嗎？
├─ 無 → DT 未描述 sensor 節點
│  ├─ 檢查 DT overlay 是否含 i2c + sensor
│  └─ 檢查 compatible 字串是否匹配驅動
├─ 有但缺 link → 驅動未建 link
│  ├─ 手動建：media-ctl -l "..."
│  └─ 檢查 DT 的 port/endpoint 描述
└─ 有 link 但缺 format → 需手動設定
   └─ media-ctl -V "...:0[fmt:SRGGB10_1X10/1920x1080]"

v4l2-ctl -l 無控制項？
├─ subdev 節點不存在 → 驅動未 probe
│  └─ dmesg 看 probe 失敗原因
├─ subdev 存在但無 controls → 驅動未暴露
│  └─ 檢查 ov5640.c 的 .s_ctrl 實作
└─ controls 有但 set 失敗 → register 被鎖
   └─ 檢查 AEC/AGC auto 模式是否覆蓋手動

- [ ] 確認所有 /dev/v4l-subdev* 節點存在
- [ ] 用 v4l2-ctl -l 列出全部 controls 與範圍
- [ ] 用 media-ctl -p 確認完整 media graph
- [ ] 手動建 link 並設定 format
- [ ] 用 v4l2-ctl 設定 exposure 並回讀驗證
- [ ] 追蹤 /sys 下的驅動綁定鏈
- [ ] 產出「platform inventory」（subdev/video/controls/media）
- [ ] 確認 libcamera / Argus / V4L2 的抽象差異
- [ ] 驗證 DT overlay 描述與實際 media graph 一致
- [ ] 用 dmesg 追蹤 probe 回呼序列