中断、时钟与电源子系统工程陷阱与实战避坑指南
1. 中断系统核心工程陷阱与规避
陷阱 1：电平中断未清除源导致中断风暴
- 现象：驱动加载后系统卡顿严重，串口打印
irq XX: nobody cared，随后中断被内核强制禁用。
- 根因：电平中断的引脚状态由外设内部状态机保持。ISR 如果仅向中断控制器发送了 EOI，而没有读取 FIFO 或写入外设的状态清除寄存器（W1C），引脚电平不会改变，导致中断立即二次触发。
- 规范规避：在返回
IRQ_HANDLED 之前，必须确保外设内部的原始中断状态（Raw Interrupt Status）已清除。
陷阱 2：中断处理中调用可能睡眠的 API
- 现象：在硬中断处理函数（Top-Half ISR）中调用
msleep()、mutex_lock() 或 kmalloc(..., GFP_KERNEL)，触发内核 Bug 报警：BUG: scheduling while atomic。
- 根因：硬中断上下文没有独立的
task_struct 调度实体，无法参与调度器休眠与唤醒。任何引发上下文切换的操作都会破坏内核中断栈。
- 规范规避：将耗时或需要休眠的操作推迟到软中断、工作队列（Workqueue）或线程化中断（
request_threaded_irq）中执行。
2. 时钟系统核心工程陷阱与规避
陷阱 1：时钟门控（Clock Gating）引用计数不平衡
- 现象：模块进入低功耗待机失败，或者在热插拔卸载模块时触发内核 Warning：
unbalance clock disabled。
- 根因：驱动中
clk_prepare_enable() 与 clk_disable_unprepare() 的调用次数不匹配。Common Clock Framework（CCF）通过引用计数追踪时钟状态，计数未清零会导致物理门控电路永远常开。
- 规范规避：在驱动的
remove()、suspend() 以及错误返回路径中，严格成对释放已获取并使能的时钟资源；推荐使用 devm_clk_get_enabled() 自动管理生命周期。
陷阱 2：动态调频时未遵循“升频先升压、降频先降压”
- 现象：系统在 CPU 负载突增时偶发死机，而在固定高频或固定低频下压测均表现稳定。
- 根因：DVFS 调频逻辑在提升时钟频率时，未预留足够的 PMIC 升压稳定时间（Slew-Rate Settling Time），导致 CPU 在低电压下运行高频率。
- 规范规避：在设备树中准确配置
regulator-ramp-delay，驱动调频状态机必须在电压稳定确认后方可切换 PLL 频率。
3. 电源与复位系统核心工程陷阱与规避
陷阱 1：电源域断电时缺少边界隔离（Isolation Cells）
- 现象：GPU 或 NPU 域关断电源后，主电源域（AON）静态功耗异常激增数十毫安，芯片异常发热。
- 根因：被下电的逻辑模块其输出引脚处于浮空高阻态（Floating），中间电平传入依然带电的 AON 域逻辑门，导致 CMOS 反相器上下管同时微导通，产生巨大的静态直通电流（Crowbar Current）。
- 规范规避：在硬件断开 Power Switch 之前，必须由 PMU 状态机提前将边界隔离使能信号（
ISO_EN）置位，将所有跨域输出信号强制钳位在确定电平（0 或 1）。
陷阱 2：系统唤醒时 DDR 退出自刷新时序违例
- 现象：系统从 Suspend to RAM 唤醒后，前几行代码执行即发生内存奇偶校验错误或指令译码失败。
- 根因：DDR 物理颗粒从自刷新（Self-Refresh）状态退出并重新稳定（$t_{\text{XS}}$ / $t_{\text{XSR}}$ 延时）需要数百纳秒到微秒级时间。若 CPU 核心被唤醒后立即从外部 DDR 取指，会读出未准备就绪的脏数据。
- 规范规避：Resume 汇编引导代码必须在常开内部 SRAM 中执行，等待 DDR 控制器确认
DDR_STATUS.SELF_REFRESH_EXIT_DONE 置位后，方可跳转至外部 DDR 恢复内核上下文。