Press ESC in 5秒内按ESC跳过startup.nsh失败

Question

在UEFI启动过程中，系统常提示“Press ESC in 5 seconds to skip startup.nsh”，意图允许用户中断自动执行的`startup.nsh`脚本。然而，部分用户反馈即使在5秒内按下ESC键，系统仍继续执行脚本，导致跳过失败。该问题多见于快速启动或固件延迟响应场景，可能源于键盘驱动初始化滞后、Boot Manager计时处理不当，或NVRAM中启动变量未正确设置。此外，某些OEM固件对热键扫描周期支持不完整，亦会导致按键无法被及时捕获。此行为虽不影响正常启动，但在调试Shell环境或恢复系统时可能造成困扰，需通过固件更新或调整启动延迟策略解决。

Answer 1

UEFI启动中“Press ESC in 5 seconds to skip startup.nsh”跳过失败问题深度解析

1. 问题现象与背景概述

在UEFI Shell环境中，系统通常会加载并执行位于EFI分区根目录下的startup.nsh脚本。为提供用户干预机会，固件常显示提示信息：“Press ESC in 5 seconds to skip startup.nsh”。该机制允许用户通过按下<kbd>ESC</kbd>键中断脚本执行，进入交互式Shell界面。

然而，在实际部署中，部分设备即使在倒计时窗口内正确按下<kbd>ESC</kbd>，系统仍继续执行脚本，导致跳过功能失效。此问题多发于快速启动（Fast Boot）配置下或特定OEM主板平台。

2. 根本原因分层分析

• 键盘驱动初始化延迟：UEFI驱动模型采用按需加载机制，HID（Human Interface Device）驱动可能在倒计时开始后才完成枚举。
• Boot Manager计时精度不足：部分固件实现的等待逻辑依赖于固定次数的微秒级延时循环，未结合事件轮询机制实时检测按键输入。
• NVRAM变量配置异常：如ConIn、ConOut等控制台设备路径指向错误或缺失，影响输入设备绑定。
• OEM固件热键扫描周期缺陷：某些厂商固件每100ms扫描一次PS/2或USB端口，错过短时按键脉冲。
• CPU唤醒响应延迟：从S3/S4状态恢复时，南桥未及时上报键盘中断至PEI/DXE阶段。

3. 技术诊断流程图

graph TD
    A[显示'Press ESC...'提示] --> B{是否可捕获按键?}
    B -- 否 --> C[检查ConIn设备列表]
    C --> D[验证HID驱动是否加载]
    D --> E[查看MdeModulePkg.Driver.UsbKeyboardDxe日志]
    B -- 是 --> F[确认Event Wait机制是否启用]
    F --> G[分析gST->ConIn->ReadKeyStroke调用频率]
    G --> H[定位BootManager.c中WaitForSingleEvent超时设置]
    H --> I[比对不同固件版本行为差异]

4. 常见排查方法与工具链

步骤	命令/操作	预期输出	工具依赖
1	devices	列出所有句柄设备	UEFI Shell v2.2+
2	drvcfg	显示驱动配置状态	MdePkg
3	dmpstore -d -n ConIn	导出ConIn NVRAM变量	EdkII Tools
4	keytest（自定义应用）	实时监听ScanCode/VKey	UEFI Application
5	BIOS Setup → Advanced → USB Legacy Support	启用传统支持模式	OEM BIOS
6	bcfg boot dump	查看启动选项优先级	ShellCmds
7	禁用Fast Boot	延长驱动初始化时间窗	Setup Menu
8	更新Capsule Firmware	修复已知热键bug	Vendor Patch
9	修改TianoCore源码中的gWaitTime值	延长检测周期	EDK II
10	使用ACPI DBG2表验证串口调试输出	获取底层中断轨迹	Intel UEFITool

5. 深度解决方案对比

针对不同层级的问题根源，可采取以下策略：

1. 固件层修复：在DXE阶段提前加载UsbKbDxe驱动，并注册到gST->ConsoleInHandle。
2. 策略调整：将默认等待时间从5秒提升至10秒，或引入动态延迟——根据是否存在startup.nsh文件决定是否弹出提示。
3. 事件驱动重构：替换简单的gBS->Stall()循环为WaitForEvent(1, &gST->ConIn->WaitForKey, &Index)，确保即时响应。
4. NVRAM重置：执行resetnvram命令清除潜在损坏的控制台变量。
5. OEM协作：推动主板厂商发布固件补丁，修正PS/2控制器Polling Interval设置。

6. 代码片段示例：改进的等待逻辑

// 改进前：基于固定延时
for (Index = 0; Index < 50; Index++) {
    gBS->Stall(100000); // 100ms
}

// 改进后：事件驱动 + 超时控制
Event[0] = gST->ConIn->WaitForKey;
Event[1] = gTimerEvent; // 定时器事件，每100ms触发
Status = gBS->WaitForEvent(2, Event, &Index);
if (Index == 0) {
    gST->ConIn->ReadKeyStroke(gST->ConIn, &Key);
    if (Key.ScanCode == SCAN_ESC) {
        SkipScript = TRUE;
    }
}