[RK3568 Android11] 设备树配置详解：定制RK809电源键的短按与长按行为

1. 从一次产品需求说起：为什么需要定制电源键行为？

大家好，我是老张，在嵌入式这行摸爬滚打十几年了，从早期的单片机一路做到现在的复杂SoC平台。今天想和大家聊聊一个非常具体，但在产品开发中又特别容易“踩坑”的问题：如何为基于RK3568和Android 11的设备，定制电源键的短按和长按行为。

你可能觉得，电源键不就是按一下开机，长按关机吗？这有什么好讲的？但在实际产品里，这里面的门道可多了。我最近就遇到一个真实的项目需求：客户要求他们的设备，短按开机响应要极快，最好在100毫秒内就有反应，给用户一种“秒开”的爽快感；而长按关机呢，为了防止误触，又希望设置得长一些，比如10秒，并且长按后不是直接断电，而是触发一个优雅的重启流程，让系统有机会保存状态。你看，这就不再是简单的“开”和“关”了，而是涉及到用户体验、系统稳定性和硬件特性的综合考量。

要实现这些定制化需求，核心的配置文件就是设备树（Device Tree，简称DTS）。对于很多从应用层转过来的安卓开发者，或者刚接触Linux底层的新手来说，设备树可能有点神秘。简单理解，它就像一份写给Linux内核的“硬件说明书”，告诉内核我们这个板子上有什么芯片（比如RK809电源管理芯片）、这些芯片挂在哪条总线上、它们的地址是什么、以及它们有哪些特殊的属性和功能。我们今天要做的，就是通过修改这份“说明书”里关于RK809电源键的章节，来精确控制它的行为。

所以，这篇文章我会手把手带你走一遍完整的流程。我们不仅会看懂RK809芯片手册里相关的寄存器，还会深入驱动代码，看看内核是如何解析我们写在设备树里的那几个神奇的数字的。最后，我会给出可以直接复制粘贴的DTS配置片段，并解释每一个参数的意义。无论你是正在为产品功能发愁的嵌入式工程师，还是对Android系统底层感兴趣想深入学习的朋友，相信这篇都能给你带来实实在在的帮助。

2. 理解基石：RK809电源管理芯片与设备树节点

在动手修改之前，我们得先搞清楚两个关键概念：RK809 和 设备树节点。这是所有操作的基础。

RK809 是瑞芯微（Rockchip）推出的一款高性能电源管理单元（PMIC）。在RK3568这样的核心板上，它通常作为一个独立的芯片存在，负责整板的电源时序管理、电压调节、电池充电，以及——我们今天的主角——电源键（PWRON Key）的检测与控制。你可以把它想象成板子的“大管家”，不仅管着电怎么来，还管着开关按钮怎么用。这个管家有一些可以配置的“工作规则”，就写在它的内部寄存器里。我们的目标，就是通过软件去修改这些寄存器。

那么，软件怎么和这个硬件“管家”对话呢？在Linux内核（包括Android底层）的世界里，普遍采用设备树来描述硬件。对于RK809，它在设备树中通常会有一个专门的节点。这个节点就像它的“身份证”和“属性卡”。我们来看一个最常见的RK809设备树节点长什么样：

&i2c0 {
    status = "okay";

    rk809: pmic@20 {
        compatible = "rockchip,rk809";
        reg = <0x20>;
        interrupt-parent = <&gpio0>;
        interrupts = <RK_PA0 IRQ_TYPE_LEVEL_LOW>;
        #clock-cells = <1>;
        clock-output-names = "rk808-clkout1", "rk808-clkout2";

        regulators {
            // 这里定义各种电压调节器，如DCDC、LDO等
        };

        pwrkey {
            status = "okay";
        };
    };
};

我来拆解一下这个节点里几个关键信息：

1. &i2c0：表示这个RK809芯片挂载在I2C0这条总线上。I2C是一种常用的低速串行通信总线，PMIC这类芯片经常通过它和主控通信。
2. rk809: pmic@20：这是节点的标签和名字。rk809是标签，方便其他地方引用；pmic@20是节点名，@20表示这个芯片在I2C总线上的设备地址是0x20（十六进制）。这个地址必须和硬件设计一致。
3. compatible = "rockchip,rk809"：这是最重要的属性！它告诉内核：“喂，这里有一个设备，它的驱动应该用 rockchip,rk809 这个兼容性字符串去匹配。”内核会根据这个字符串，找到并加载对应的驱动程序（就是我们后面要分析的 rk8xx.c 驱动）。
4. reg = <0x20>：再次确认I2C设