[V2X]按键（PWRKEY / RESETKEY）配置与加载流程

1. 平台按键概述

按键功能全部由 PMIC PON（Power-On）外设 实现，软件链路分三层：

DT 配置 (pm.dtsi) → PmicLib 解析+编程 (PON 寄存器) → EFI 协议 (PmicDxe) → 各 DXE/库消费

2. DT 基本配置（pm.dtsi）

节点：&sw { pmic { pm { pon { … } } } }，binding 为 qcom,pm-pon
文件：boot/Settings/Soc/Kuno/Core/PMIC/pm.dtsi，schema：boot/Settings/dtschema/Common/Core/PMIC/qcom,pm-pon.yaml（additionalProperties: false，节点内属性不可随意增加）

宏定义（boot/Settings/Include/pm_defines.h）：PM_WARM_RESET=0、PM_HARD_RESET=1、PM_PON_RESET_SOURCE_KPDPWR 等。

时长档位表（PON 定时器不是连续值，是硬件档位）

换算用 pm_utils_get_upper_idx()（PmicLib/utils/inc/pm_utils.h:111）：取 ≥ 目标值 的最近档。
即 dtsi 里 s1-ms=10256、s2-ms=2000 都是各自档位表的最大档——长按电源键 10.256s 判定进入 S1，再保持 2s 才触发复位。

3. 按键行为映射

⚠️ S2 是"复位"不是"关机"：触发后 PMIC 重新给系统上电。产品上"长按关机并保持关机"必须走正常软关机（PS_HOLD 拉低），不能依赖 S2 通路。
Kuno target 另有 target 级有效按键校验：pm_config_target.c:237（chk_at=CORE、dbnc=400ms，与 dtsi 的 200ms/LOADER 是两处独立软校验）。

4. 按键加载全过程（函数链）

4.1 PMIC DT 解析（PmicLib）

pm_dt_get_node(PMIC_DT_NODE_PM_PON) // pm_dt_parser.c:980
└─ pm_target_information_dt_init() // DT blob 初始化
└─ pm_dt_parse_pon_config(prop_id) // pm_dt_parser.c:268
├─ pm_get_uint8_value ( &hNode, "enable", …) // 各子节点 enable
├─ pm_get_uint8_value ( &hNode, "reset-type",…) // PM_WARM/HARD_RESET
├─ pm_get_uint32_value( &hNode, "s1-ms", …)
├─ pm_get_uint32_value( &hNode, "s2-ms", …)
├─ pm_get_uint32_value( &hNode, "smpl-delay",…)
├─ pm_get_uint8_value ( &hNode, "s3-src", …) + "timer-value-ms"
├─ pm_get_uint8_value ( &hNode, "chk-at", …) + "dbnc-time-ms"
└─ → 填充 pm_dt_pon_config 结构体 // pm_dt_parser.h:167-202

4.2 PON 配置（后初始化，XBL 启动时执行一次）

pm_device_post_init() // target/kuno/system/src/pm_sbl_boot_oem.c:531
├─ pm_print_psi_version()
├─ pm_sbl_boot_pon_reset_config() // pm_sbl_boot_oem.c:456
│ ├─ pon_dt = pm_dt_get_node(PMIC_DT_NODE_PM_PON)
│ ├─ pm_app_pon_pshold_cfg(ps_hold_reset_type) // app/pon/src/pm_app_pon.c:70
│ ├─ pm_app_pon_reset_cfg(PM_APP_PON_RESET_SOURCE_KPDPWR, // pm_app_pon.c:142
│ │ WARM_RESET, 10256, 2000)
│ │ ├─ pm_app_pon_map_app_level_reset_resource() // app→drv 资源映射
│ │ ├─ pm_tgt_get_kpdpwr_reset_cfg() // 每颗 PMIC 差异化配置
│ │ ├─ pm_pon_reset_source_cfg() // drivers/pon/src/pm_pon.c
│ │ │ ├─ pm_utils_get_upper_idx(s1, pon_s1_timer_val) // ms→档位
│ │ │ ├─ pm_utils_get_upper_idx(s2, pon_s2_timer_val)
│ │ │ ├─ 写 KPDPWR_N_RESET_S1_TIMER / S2_TIMER 寄存器
│ │ │ └─ 写 RESET_S2_SW_CTL: reset_type + S2_RESET_EN
│ │ └─ pm_pon_tgt_specific_kpd_reset_cfg()
│ ├─ pm_app_pon_reset_cfg(RESIN_AND_KPDPWR, HARD_RESET, 10256, 2000) // pwr+vol down
│ │ （disable 时改调 pm_pon_reset_source_ctl(PMIC_A, 源, PM_OFF)）
│ ├─ pm_app_pon_reset_cfg(RESIN, …) / pm_pon_reset_source_ctl(RESIN, PM_OFF)
│ └─ pm_app_pon_s3_reset_timer_cfg(s3_src, timer_ms) // pm_app_pon.c:213
├─ pm_pon_tgt_uvlo_ovlo_cfg() // UVLO/OVLO config-value
└─ pm_app_pwrkey_long_press_check(PM_PON_PWRKEY_DBNC_CHK_AT_LOADER) // app/pon/src/pm_app_key_press.c:53
├─ 取 dbnc_chk 配置（chk_at / dbnc_time_msec）
├─ 读 PMIC PON 实时 IRQ 状态并等待 dbnc_time_msec
├─ 读 SDAM 按键按下/释放时间（pm_config_target.c: MEM_026/030）
└─ 判定本次启动是否为"有效长按"（影响 PON reason/特殊模式判定）

4.3 运行期按键消费（EFI 协议使用者）

ButtonsInit() // QcomPkg/Library/ButtonsLib/ButtonsLib.c:301
├─ gBS->LocateProtocol(PmicPONProtocol / PmicGpioProtocol / TLMMProtocol)
├─ 配置按键 GPIO
└─ ReadRealTimeIRQStatus(EFI_PM_PON_IRQ_KPDPWR_ON, …) // ButtonsLib.c:463
PollPowerKey() → 电源键 RT 状态 // ButtonsLib.c:459
PollButtonArray()→ pwr / vol+ / vol-(EFI_PM_PON_IRQ_RESIN_ON) / home / camera
↓ 被消费
ButtonsDxe DriverEntry → PollButtonArray() // Drivers/ButtonsDxe/ButtonsDxe.c:403（按键服务/热键）
KeypadDxe(Deprecated) → PollPowerKey() // Drivers/Deprecated/KeypadDxe/KeypadDxe.c:371

QcomChargerDxe（关机充电等场景，Drivers/QcomChargerDxe/WP/QcomChargerPlatform_Fw.c）
├─ SetIrqTriggerType(0, EFI_PM_PON_IRQ_KPDPWR_ON, RISING_EDGE) // L339 等"松手"判定
├─ EnableIrq(0, KPDPWR_ON, TRUE) // L340
└─ GetPonIrqStatus(LATCHED) / ClearIrq // L343/L463

ChargerExDxe / CrashDumpDxe 等：LocateProtocol(gQcomPmicPwrOnProtocolGuid) 后读
GetPonReason / GetAllPonReasons / GetAllFaultReasons 判定上次启动原因

4.4 协议层（PmicDxe → PmicLib）

协议安装：Drivers/PmicDxe/Pmic.c:180（gQcomPmicPwrOnProtocolGuid → PmicPwronProtocolImplementation）

5. Linux 侧补充说明

进入 kernel 后 pwrkey 事件由 qcom-pon / gpio-keys 驱动产生（interrupt-type 在 kernel dts 配），不属于 bp/boot 改动范围；boot 里配的内容（S2 复位、上电触发沿、去抖）在关机态依然由 PMIC 硬件执行。

6. 修改 PWRKEY 上电触发方式（沿触发 → 电平触发，实现"按住 2s 才开机"）

6.1 原理

KPDPWR_N 低有效：按下 = 下降沿。上电触发类型由 PON option bit 决定（drivers/pon/src/pm_pon.c:1762-1767）：

两个 API 配合 = 目标时序：关机态点按/按一下松手 → 保持关机；重新按下 → 重新计 2s；持续 2s → 开机。
（该函数同时把配置写入 SDAM 的 PON_TRIG_CFG 与 PMIC 中断寄存器，关机后仍生效。）

6.2 落点与示例

加在 pm_sbl_boot_pon_reset_config() 或 pm_device_post_init()（target/kuno/system/src/pm_sbl_boot_oem.c）末尾，每次开机执行一次最稳：

pm_err_flag_type
pm_device_post_init( void )
{
pm_err_flag_type err_flag = PM_ERR_FLAG_SUCCESS;

err_flag |= pm_print_psi_version();
err_flag |= pm_sbl_boot_pon_reset_config();
err_flag |= pm_pon_tgt_uvlo_ovlo_cfg();
err_flag |= pm_app_pwrkey_long_press_check(PM_PON_PWRKEY_DBNC_CHK_AT_LOADER);

/* === 新增：PWRKEY 上电改电平触发 + 2s 去抖 === */
err_flag |= pm_pon_set_option_bit(PMIC_A, PM_PON_OPTION_KPDPWR_FEDGE_PON, FALSE);
err_flag |= pm_pon_debounce_ctl(PMIC_A, 2000);

return err_flag;
}

注意：

• pm_pon_set_option_bit() 已在 Include/api/pmic/pm/pm_pon.h:1148 导出；pm_pon_debounce_ctl() 未在任何头文件导出（全树仅定义处一处），调用处需 extern 声明：extern pm_err_flag_type pm_pon_debounce_ctl(uint32 pmic_device_index, uint32 time_delay);
• EFI 协议侧等价接口：PmicPwrOnProtocol->EnableEdgePonTrigger(0, EFI_PM_PON_OPTION_KPDPWR_FEDGE_PON, FALSE)（PmicPonProtocol.c:605）
• 也可不改 XBL，在 kernel 侧写相同寄存器（PMIC PON/SDAM regmap），但推荐 XBL 一次配好，POR 之前即生效
• 只改 KPDPWR 一路，USB 插入 / DC 充电等其它 PON 源不受影响
• 与 S2 长按复位（s1/s2 定时器）是独立通路，互不影响

6.3 验证（冷关机后）

7. 文件速查表