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

&ov9281_cam0 {
    status = "okay";
    reg = <0x36>;        # I2C 位址
    reset-gpios = ...;
    mode0 { ... mclk_khz, pixel_phase ... };
};

argus_camera --list-cameras
v4l2-ctl --list-devices

&ov9281_cam0 {
    status = "okay";
    reg = <0x36>;               # I2C 位址
    mode0 {
        mclk_khz = <24000>;    # MCLK 24 MHz
        num_lanes = <2>;       # CSI lane 數
        tegra_sinterface = "serial_a";
        phy_mode = "DPHY";
        pixel_phase = "bggr";   # Bayer 起點
        active_w = <1280>; active_h = <800>;
        min_framerate = <1>; max_framerate = <120>;
        min_exp_time = <1>; max_exp_time = <33333>;
    };
};

# 1. 確認 overlay 已套用
dmesg | grep -i "camera|tegra-camera|ov9281"
# 2. 檢查 media 管線拓撲
media-ctl -p -d /dev/media0
# 3. 檢查 subdev 與 controls
v4l2-ctl -d /dev/v4l-subdev0 --list-ctrls
# 4. Argus 列舉
argus_camera --list-cameras

# 印出拓撲與格式
media-ctl -p -d /dev/media0
# 設定感測器 source pad 格式（範例）
media-ctl -d /dev/media0 --set-v4l2 '"ov9281 0-0036":0[fmt:SRGGB10_1X10/1280x800]'

# 1. 重建 DTB 並刷入（bootloader / overlay 方式）
# 2. 重開機，確認 overlay 有套
dmesg | grep -i "camera|ov9281"
# 3. 檢查新 mode 是否列得出來
argus_camera --list-cameras
v4l2-ctl -d /dev/video0 --list-formats-ext
# 4. 取一幀，驗證尺寸與格式符合新 mode
v4l2-ctl -d /dev/video0 --stream-mmap=1 --stream-count=1 --stream-to=t.raw

# 1. 從感測器 datasheet 取得：I2C 位址、lane 數、init register table
# 2. 在 NVIDIA jetson-camera module 驅動目錄新增 OV2775 driver
# 3. 建立 DT overlay（.dts）
cat > ov2775-overlay.dts <<'EOF'
/dts-v1/;
/plugin/;
/ {
    overlay-name = "ov2775 camera";
    fragment@0 {
        target = <&csi_i2c>;
        __overlay__ {
            ov2775@10 {
                compatible = "ovti,ov2775";
                reg = <0x10>;
                clocks = <&clk_ext_cam 24000000>;
                clock-frequency = <24000000>;
                reset-gpios = <&gpio 100 0>;
                port {
                    ov2775_out: endpoint {
                        remote-endpoint = <&csi_in>;
                        data-lanes = <1 2>;
                        clock-lanes = <0>;
                        link-frequencies = /bits/ 64 <360000000>;
                    };
                };
            };
        };
    };
};
EOF
# 4. 編譯 overlay
dtc -@ -I dtb -O dtb -o ov2775.dtbo ov2775-overlay.dts
# 5. 套用
sudo cp ov2775.dtbo /boot/dtb/overlays/
sudo reboot

# M1 · 驅動骨架（依 tegracam 慣例，OV9281 為藍本）
#   - 建立 ov2775.c：init table + get/set controls
#   - compatible = "ovti,ov2775"
# M2 · DTB overlay（回顧 4.12 流程）
#   - fragment target = csi_i2c bus，reg = 0x10
#   - mode0：4-lane、RAW10、active_w/h、pixel_phase
# M3 · 編譯 + 套用 + 重開機
dtc -@ -I dts -O dtb -o ov2775.dtbo ov2775.dts
sudo cp ov2775.dtbo /boot/dtb/overlays/ && sudo reboot
# M4 · 驗證鏈路（逐層確認）
dmesg | grep -i ov2775          # probe success + ID
media-ctl -p -d /dev/media0     # ov2775 出現在拓撲
v4l2-ctl -d /dev/v4l-subdev0 --list-ctrls   # exposure/gain 在列
argus_camera --list-cameras     # 看得到 ov2775
argus_camera --mode 0 --capture-auto 1 --duration 1   # 出圖

#!/bin/bash
echo "=== Phase 1: Overlay 套用確認 ==="
dmesg | grep -i "camera|ov9281" | tail -5
echo ""
echo "=== Phase 2: Media 拓撲 ==="
media-ctl -p -d /dev/media0 2>/dev/null || echo "WARN: no media0"
echo ""
echo "=== Phase 3: Controls ==="
v4l2-ctl -d /dev/v4l-subdev0 --list-ctrls 2>/dev/null | head -20
echo ""
echo "=== Phase 4: Formats ==="
v4l2-ctl -d /dev/video0 --list-formats-ext 2>/dev/null
echo ""
echo "=== Phase 5: Argus ==="
argus_camera --list-cameras 2>/dev/null || echo "WARN: argus failed"
echo ""
echo "=== Phase 6: Capture ==="
v4l2-ctl -d /dev/video0 --stream-mmap=1 --stream-count=1 --stream-to=dtb_test.raw 2>/dev/null
ls -l dtb_test.raw 2>/dev/null

1. "of_device_alloc failed"？
   ├─ 是 → overlay 屬性超出 kernel 限制
   │       簡化 overlay：逐一註釋定位問題屬性
   └─ 否 ┐
2. "Unable to match"？
   ├─ 是 → compatible string 與驅動不匹配
   │       確認驅動模組已載入（lsmod | grep ov）
   └─ 否 ┐
3. "probe failed: -12"（ENOMEM）？
   ├─ 是 → kernel 記憶體不足
   │       減少不必要的 overlay / module
   └─ 否 ┐
4. probe 成功但無 /dev/videoN？
   ├─ 是 → media entity 註冊失敗
   │       media-ctl -p 檢查 pipeline
   └─ 否 → ✅ probe 正常

1. 兩個 overlay 同時套用後異常？
   ├─ 是 ┐
   │   2. 是否修改了同一節點的同一屬性？
   │      ├─ 是 → 合併為單一 overlay
   │      └─ 否 → 調整 fragment target 避開衝突
   └─ 否 → 逐一移除 overlay 定位問題源