2. 设备树基础：设备树(DTS)语法、节点与属性

设备树（Device Tree，DT）是嵌入式 Linux 系统中用于描述硬件拓扑结构的一种数据结构。它采用树形节点层次结构，将 CPU、内存、外设、中断控制器、GPIO 控制器等硬件资源以节点和属性的形式呈现给内核。在摄像头驱动开发中，设备树是连接硬件寄存器映射、电源管理（Regulator）和 GPIO 控制的关键桥梁。

2.1 设备树语法基础

设备树使用一种类似于 C 语言的结构化文本格式，以分号结尾，支持宏定义和包含文件（#include）。其基本单元是节点（node）和属性（property）。

/dts-v1/;

/ {
    model = "Embedded Camera Board v1.0";
    compatible = "vendor,camera-board";

    chosen {
        bootargs = "console=ttyS0,115200 root=/dev/mmcblk0p2 rw";
    };

    cpus {
        #address-cells = <1>;
        #size-cells = <0>;
        cpu@0 {
            compatible = "arm,cortex-a7";
            reg = <0x0>;
        };
    };

    memory@80000000 {
        device_type = "memory";
        reg = <0x80000000 0x40000000>;  /* 1GB RAM */
    };

    soc {
        #address-cells = <1>;
        #size-cells = <1>;
        compatible = "simple-bus";
        ranges;

        i2c@ffd00000 {
            compatible = "vendor,i2c-controller";
            reg = <0xffd00000 0x1000>;
            #address-cells = <1>;
            #size-cells = <0>;
            status = "okay";

            camera_sensor: camera@3c {
                compatible = "vendor,camera-sensor-v1";
                reg = <0x3c>;
                clocks = <&clkc 15>;
                reset-gpios = <&gpio1 7 GPIO_ACTIVE_LOW>;
                power-gpios = <&gpio2 5 GPIO_ACTIVE_HIGH>;
                avdd-supply = <&reg_camera_avdd>;
                dvdd-supply = <&reg_camera_dvdd>;
            };
        };
    };
};

2.2 节点与属性详解

设备树中的每个节点代表一个硬件设备或总线，属性则描述设备的配置参数。以下表格总结了摄像头驱动开发中最常用的属性及其用途。

2.3 compatible 属性：驱动匹配的核心

compatible 属性是设备树与驱动之间建立联系的唯一标识。当内核遍历设备树节点时，会将该节点的 compatible 值与已注册的 platform_driver 中的 of_match_table 进行匹配。

// 驱动端匹配表示例
static const struct of_device_id camera_sensor_of_match[] = {
    { .compatible = "vendor,camera-sensor-v1", .data = &sensor_v1_config },
    { .compatible = "vendor,camera-sensor-v2", .data = &sensor_v2_config },
    { /* sentinel */ }
};
MODULE_DEVICE_TABLE(of, camera_sensor_of_match);

static struct platform_driver camera_sensor_driver = {
    .probe  = camera_sensor_probe,
    .remove = camera_sensor_remove,
    .driver = {
        .name = "camera_sensor",
        .of_match_table = camera_sensor_of_match,
    },
};
module_platform_driver(camera_sensor_driver);

2.4 reg 属性：地址空间描述

reg 属性用于描述设备在总线上的地址范围。对于内存映射设备，它表示基地址和长度；对于 I2C/SPI 设备，它表示从机地址。其格式由父节点的 #address-cells 和 #size-cells 决定。

// 驱动中读取 reg 属性的典型方式
struct resource *res;
void __iomem *base;

// 方式1：使用 platform_get_resource (推荐)
res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
base = devm_ioremap_resource(&pdev->dev, res);

// 方式2：使用 of 函数直接读取
u32 addr, size;
of_property_read_u32_index(np, "reg", 0, &addr);
of_property_read_u32_index(np, "reg", 1, &size);

2.5 中断描述

设备树使用 interrupts 属性描述设备的中断资源，同时需要 interrupt-parent 属性指定中断控制器。对于摄像头驱动，通常使用 interrupts-extended 来显式指定中断控制器，避免依赖父节点继承。

// 标准中断描述
camera_sensor: camera@3c {
    compatible = "vendor,camera-sensor-v1";
    reg = <0x3c>;
    interrupt-parent = <&gic>;          // 中断控制器
    interrupts = <GIC_SPI 55 IRQ_TYPE_EDGE_RISING>;
    // GIC_SPI: 共享外设中断, 55: 中断号, IRQ_TYPE_EDGE_RISING: 上升沿触发
};

// 使用 interrupts-extended 显式指定
camera_sensor: camera@3c {
    compatible = "vendor,camera-sensor-v1";
    reg = <0x3c>;
    interrupts-extended = <&gic GIC_SPI 55 IRQ_TYPE_EDGE_RISING>;
};

2.6 GPIO 描述

GPIO 在设备树中使用 *-gpios 属性描述，格式为 <&gpio_controller pin_number flags>。摄像头驱动中常见的 GPIO 包括复位引脚、电源使能引脚、帧同步中断引脚等。

// 摄像头传感器 GPIO 描述
camera_sensor: camera@3c {
    compatible = "vendor,camera-sensor-v1";
    reg = <0x3c>;

    // 复位引脚：GPIO1 第7脚，低电平有效
    reset-gpios = <&gpio1 7 GPIO_ACTIVE_LOW>;

    // 电源使能引脚：GPIO2 第5脚，高电平有效
    power-gpios = <&gpio2 5 GPIO_ACTIVE_HIGH>;

    // 帧同步中断引脚：GPIO3 第2脚，上升沿触发
    vsync-gpios = <&gpio3 2 GPIO_ACTIVE_HIGH>;
};

// 驱动中获取 GPIO 并操作
#include <linux/gpio/consumer.h>

struct gpio_desc *reset_gpio, *power_gpio;

// 获取 GPIO 描述符
reset_gpio = devm_gpiod_get(&pdev->dev, "reset", GPIOD_OUT_HIGH);
power_gpio = devm_gpiod_get(&pdev->dev, "power", GPIOD_OUT_LOW);

if (IS_ERR(reset_gpio) || IS_ERR(power_gpio)) {
    dev_err(&pdev->dev, "Failed to get GPIOs\n");
    return PTR_ERR(reset_gpio);
}

// 操作 GPIO：拉低复位引脚（低有效）
gpiod_set_value_cansleep(reset_gpio, 1);  // 输出低电平（复位）
msleep(10);
gpiod_set_value_cansleep(reset_gpio, 0);  // 输出高电平（释放复位）

// 操作 GPIO：使能电源
gpiod_set_value_cansleep(power_gpio, 1);  // 输出高电平（使能）

2.7 设备树包含与复用

实际项目中，设备树通常通过 #include 机制复用公共定义，避免重复编写。摄像头驱动开发中常用的包含文件包括 GPIO 标志、中断类型、时钟定义等。

// camera-sensor.dtsi (设备树包含文件)
#include <dt-bindings/gpio/gpio.h>
#include <dt-bindings/interrupt-controller/irq.h>
#include <dt-bindings/clock/sun8i-a33-ccu.h>

/ {
    reg_camera_avdd: regulator-camera-avdd {
        compatible = "regulator-fixed";
        regulator-name = "camera_avdd";
        regulator-min-microvolt = <2800000>;
        regulator-max-microvolt = <2800000>;
        regulator-always-on;
    };

    reg_camera_dvdd: regulator-camera-dvdd {
        compatible = "regulator-fixed";
        regulator-name = "camera_dvdd";
        regulator-min-microvolt = <1200000>;
        regulator-max-microvolt = <1200000>;
    };
};

// 主设备树文件 board.dts
#include "camera-sensor.dtsi"

&i2c0 {
    status = "okay";
    camera_sensor: camera@3c {
        compatible = "vendor,camera-sensor-v1";
        reg = <0x3c>;
        reset-gpios = <&pio 7 0 GPIO_ACTIVE_LOW>;  // PH7
        avdd-supply = <&reg_camera_avdd>;
        dvdd-supply = <&reg_camera_dvdd>;
    };
};