4. RTC 设备树节点编写：常见芯片示例

设备树中 RTC 节点的编写质量直接决定驱动能否正确匹配、I²C 地址是否冲突、中断是否丢失以及后备电源管理是否生效。本章以三款主流 RTC 芯片——DS1307（Dallas/Maxim）、PCF8563（NXP）和 RX8025（Epson）——给出可直接参考的设备树节点，并解释每个属性的工程含义。

4.1 DS1307 设备树节点

DS1307 是最常见的低成本 I²C RTC，I²C 地址固定为 0x68，支持 56 字节 NVRAM。典型应用中使用外部 32.768 kHz 晶振和 3V 纽扣电池。

/* DS1307 RTC 节点示例 */
&i2c1 {
    status = "okay";
    clock-frequency = <100000>;   /* 标准模式 100kHz */

    ds1307: rtc@68 {
        compatible = "maxim,ds1307";
        reg = <0x68>;
        status = "okay";

        /* 中断引脚：GPIO3_19，上升沿触发 */
        interrupts = <3 19 IRQ_TYPE_EDGE_RISING>;
        interrupt-parent = <&gpio3>;

        /* 后备电池描述（可选，用于电源管理） */
        trickle-resistor-ohms = <2000>;
        aux-voltage-chargeable = <1>;
    };
};

4.2 PCF8563 设备树节点

PCF8563 是 NXP 的低功耗 RTC，I²C 地址为 0x51，内置报警、定时器和时钟输出功能。其设备树节点需要特别注意中断类型和时钟输出频率配置。

/* PCF8563 RTC 节点示例 */
&i2c2 {
    status = "okay";
    clock-frequency = <400000>;   /* 快速模式 400kHz */

    pcf8563: rtc@51 {
        compatible = "nxp,pcf8563";
        reg = <0x51>;
        status = "okay";

        /* 中断引脚：GPIO1_12，下降沿触发 */
        interrupts = <1 12 IRQ_TYPE_EDGE_FALLING>;
        interrupt-parent = <&gpio1>;

        /* 时钟输出频率：0=禁用，1=32.768kHz，2=1.024kHz，3=1Hz */
        clocks = <&clk32k>;
        clock-output-names = "pcf8563-clkout";
        #clock-cells = <0>;
    };
};

4.3 RX8025 设备树节点

RX8025（Epson）是高精度 RTC，内置温度补偿晶振（TCXO），I²C 地址可选 0x32 或 0x33。其设备树节点需要指定地址选择引脚状态，并注意中断输出为开漏结构。

/* RX8025 RTC 节点示例 */
&i2c3 {
    status = "okay";
    clock-frequency = <400000>;

    rx8025: rtc@32 {
        compatible = "epson,rx8025";
        reg = <0x32>;           /* AD0=GND 时地址 0x32 */
        status = "okay";

        /* 中断引脚：GPIO2_5，低电平有效 */
        interrupts = <2 5 IRQ_TYPE_LEVEL_LOW>;
        interrupt-parent = <&gpio2>;

        /* 指定外部晶振频率（内部 TCXO 已校准） */
        clock-frequency = <32768>;
    };
};

4.4 三款 RTC 设备树属性对比

4.5 设备树节点编写通用检查清单

1. 确认 I²C 地址：查阅芯片数据手册，确认 7 位地址（左对齐），避免与同总线其他设备冲突。
2. 匹配 compatible 字符串：在内核源码中搜索对应驱动文件（如 rtc-ds1307.c），确认 compatible 表项。
3. 中断引脚配置：确认 GPIO 编号、中断控制器（interrupt-parent）和触发类型（上升沿/下降沿/电平）。
4. 后备电源描述：对于支持涓流充电的芯片（如 DS1307），添加 trickle-resistor-ohms 属性。
5. 时钟输出（可选）：若需 RTC 输出时钟信号给其他外设，配置 clocks 和 #clock-cells。
6. status 属性：确保节点 status = "okay"，且父 I²C 控制器 status = "okay"。