Batocera系统休眠唤醒脚本的扩展实现与优化

在Batocera游戏系统中，用户脚本的自动化执行是系统高度可定制化的重要特性之一。近期社区发现并解决了一个关于系统休眠/唤醒事件触发脚本的重要技术问题，本文将深入剖析这一功能的实现原理、解决方案以及扩展应用场景。

问题背景与发现

Batocera系统原有的脚本触发机制存在一个关键限制：当用户通过图形界面选择"暂停系统"功能时，位于/userdata/system/configs/emulationstation/scripts/sleep和/userdata/system/configs/emulationstation/scripts/wake目录下的脚本不会被执行。这一现象与系统通过自动休眠（屏幕变暗）触发脚本的行为形成了不一致性。

经过技术分析，发现这是由于系统菜单中的暂停功能直接调用了pm-suspend命令，绕过了EmulationStation原有的脚本触发机制。这种设计上的差异导致用户无法在系统级休眠/唤醒事件中执行自定义操作。

技术解决方案

通过深入系统机制，我们采用了Linux电源管理(PM)的标准hook机制来实现统一的事件触发。具体实现步骤如下：

1. 创建PM hook脚本： 在/etc/pm/sleep.d目录下创建名为99es_scripts_runner的可执行脚本，内容如下：

#!/bin/bash
SCRIPTS_BASE_PATH=/userdata/system/configs/emulationstation/scripts
case "$1" in
    suspend)
        for script in $SCRIPTS_BASE_PATH/suspend/*; do
            /bin/bash $script
        done           
    ;;
    resume|thaw)
        for script in $SCRIPTS_BASE_PATH/resume/*; do
            /bin/bash $script
        done           
    ;;
esac

2. 目录结构调整： 为了区分自动休眠和手动暂停的不同场景，将脚本存放路径细分为：

• suspend/：系统暂停时执行
• resume/：系统恢复时执行
• sleep/：屏幕自动休眠时执行（原有功能）
• wake/：从自动休眠恢复时执行（原有功能）

3. 持久化设置： 执行batocera-save-overlay命令使修改永久生效。

实现原理详解

该解决方案利用了Linux电源管理子系统提供的标准接口。当系统发生电源状态变更时，PM会按顺序执行/etc/pm/sleep.d目录下的脚本，并传入相应的状态参数：

• suspend：系统即将进入休眠状态
• resume：系统从休眠状态恢复
• thaw：特殊恢复场景（与resume类似）

通过这种机制，我们实现了对系统级电源事件的统一捕获，确保了无论通过何种方式触发的休眠/唤醒操作都能正确执行用户脚本。

扩展应用场景

这一改进不仅解决了原有问题，还为系统自动化开启了更多可能性：

1. HDMI-CEC模拟： 通过休眠/恢复脚本可以模拟游戏主机的HDMI-CEC行为，实现电视的自动开关和输入源切换。

2. 外设事件响应： 未来可扩展支持控制器连接/断开事件的脚本触发，典型应用包括：

• 连接特定控制器时自动启动对应游戏
• 外设状态变化时触发家庭自动化系统
• 播放音效增强用户体验

3. 系统状态同步： 与智能家居系统集成，在系统状态变化时同步更新房间照明、显示屏等设备状态。

最佳实践建议

1. 脚本命名规范： 建议采用有意义的命名，如99_user_hook，确保脚本执行顺序符合预期。

2. 错误处理： 在关键脚本中添加错误处理和日志记录功能：

#!/bin/bash
LOG_FILE="/userdata/system/logs/power_hooks.log"
exec >> $LOG_FILE 2>&1
echo "$(date) - 执行暂停脚本 $0"
# 主要逻辑代码

3. 性能考量： 避免在hook脚本中执行耗时操作，以免影响电源状态转换速度。

总结

Batocera系统通过这次改进完善了其电源事件处理机制，为用户提供了更加统一和强大的自动化能力。这种基于标准Linux电源管理接口的实现既保证了可靠性，又为未来的功能扩展奠定了基础。建议用户在升级系统后，按照新的目录结构调整自己的自动化脚本，以获得最佳的使用体验。