SSDTTime 零门槛教程:5 步生成黑苹果 ACPI 补丁
【免费下载链接】SSDTTimeSSDT/DSDT hotpatch attempts.项目地址: https://gitcode.com/gh_mirrors/ss/SSDTTime
SSDTTime 是一款免费的黑苹果 ACPI 补丁工具。它读取你的硬件信息,自动生成 .aml 文件,解决睡眠、USB、背光等常见问题。不会写 ASL,5 分钟也能出第一个补丁。
先看你中了哪条
- 睡眠唤不醒:合上笔记本盖子,再按键盘,屏幕还是黑的。只能强制重启,没保存的内容一起丢。
- USB 不动作:U 盘插上去,系统毫无反应。睡眠唤醒后更严重,键鼠都不认了。
- 背光失控:笔记本亮度只跳两档,或者 Fn 键完全不工作。
- NVRAM 开不了:300 系主板无法启用原生 NVRAM,机器始终半残状态。
中任何一条,多半是主板那张"图纸"缺页或画错——物业当然看不懂。你不用改线路,补一张图纸就行。
30 秒建立心智模型
| 术语 | 一句话解释 | 对应比喻 |
|---|---|---|
| ACPI | 硬件与 macOS 之间的标准接口,向系统汇报机器怎么造的 | 老房子的竣工图 |
| DSDT | 主板厂商写的主 ACPI 表,描述机器上所有设备 | 原始竣工总图 |
| SSDT | 补充主表缺漏和错误的附表 | 装修增补图 |
| .aml | SSDT 编译后的二进制文件,真正被引导程序加载 | 通过验收的图纸 |
SSDTTime 是个"装修设计师":你交出竣工图,它画增补图、自动报审,活全让它干,你只管收图纸。
动手前的自检
- 环境:Python 3.8 及以上版本(终端启动方式需要)。首次运行会自动下载iasl编译器,网络要能通外网。
- 文件位置:解压到可读写的目录,别放只读路径。所有产物落在同级
Results/文件夹,自动创建。 - 启动方式:
- Windows:双击
SSDTTime.bat,导出 DSDT 时建议管理员权限 - macOS:双击
SSDTTime.command - Linux:
python3 SSDTTime.py
- Windows:双击
5 步从零到跑通
- 启动工具:双击对应平台的启动文件,进入主菜单。首次运行会先下载 iasl,卡住就看下面急救站。
- 载入竣工图:按
D进入 Select ACPI table。Linux 和 Windows 可按P自动转储系统表到Results/;macOS 把之前导出的.aml文件拖进输入框。 - 选号画增补图:输入
2生成SSDT-EC(假 EC,睡眠与键盘刚需);输入5生成SSDT-PLUG(给 CPU 设置plugin-type为 1)。选完即编译,几秒出结果。 - 收图纸:打开
Results/文件夹,拿到SSDT-EC.aml和登记单patches_OC.plist。把.aml复制到 OpenCore 分区的EFI/OC/ACPI/目录。 - 递交登记材料:双击
PatchMerge.command(Windows 为PatchMerge.bat,或终端运行python3 PatchMerge.py),依次拖入Results/文件夹和config.plist,合并好的配置也存回Results/。验证:重启进系统,终端执行ioreg -x | grep ACID0001,有输出行就说明假 EC 补丁已加载。
场景速查
| 场景 | 适用硬件 | 推荐组合 | 关键注意 |
|---|---|---|---|
| 300 系台式机 | Intel 300 系芯片组 | SSDT-EC + SSDT-PLUG + SSDT-PMC | 菜单6补 PMCR 设备,供原生 NVRAM 用 |
| 笔记本日常 | 各品牌笔记本 | SSDT-EC (Laptop) + SSDT-PLUG | 笔记本选菜单3,保留原有 EC 不动 |
| 笔记本背光 | 带屏笔记本 | SSDT-PNLF | 菜单0,需选匹配 CPU 世代的_UID(14~19) |
| 二合一/平板 | 翻转本、平板形态 | SSDT-EC + SSDT-ALS0 | 菜单F假造环境光传感器 |
| USB 映射被挡 | 需要端口映射的机型 | SSDT-USB-Reset | 菜单8,让根集线器返回零状态 |
| 中断冲突 | HPET 报 IRQ 冲突 | FixHPET | 菜单1,把冲突的 IRQ 打补丁剔除 |
踩坑急救站
| 现象 | 可能原因 | 处理办法 |
|---|---|---|
| 提示 Could not locate or download iasl | 下载编译器被网络挡住 | 手动下载 iasl 放进Scripts/目录,Windows 需解出iasl.exe和acpidump.exe |
| 窗口一闪就退 | Python 低于 3.8 或没装 | 终端跑python3 SSDTTime.py看真实报错,再升级 Python |
| No valid .aml files were found | 路径传错,或多个 DSDT 签名混在一起 | 传单个.aml或干净的表文件夹,同时只允许一个 DSDT 签名 |
编译失败并弹出一个.dsl | ASL 模板和当前表不匹配 | 看Results/里该.dsl的报错行;菜单M切换 4 档 Match Mode 重试 |
| 打上补丁后进不了系统 | 新加的.aml有问题 | 进安全模式,移除该.aml及config.plist里对应登记,逐个验证 |
再往深一步
- 精准定位:菜单
E(ACPI > Device)能在已加载的表里查出指定路径对应的设备路径,方便你手写增补图时对准目标。 - 源码获取:
git clone https://gitcode.com/gh_mirrors/ss/SSDTTime,核心逻辑在SSDTTime.py,编译与转储在Scripts/dsdt.py。 - 卡住找谁:先翻项目 Issues,很多机型坑都有现成答案;按菜单
Q退出时也会显示作者联系方式。
第一个 SSDT-EC 验证通过后,照场景速查表一次生成下一个,每加一个就用ioreg验一次。
【免费下载链接】SSDTTimeSSDT/DSDT hotpatch attempts.项目地址: https://gitcode.com/gh_mirrors/ss/SSDTTime
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考