SSDTTime 零门槛教程:5 步生成黑苹果 ACPI 补丁
2026/8/27 11:04:49 网站建设 项目流程

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补充主表缺漏和错误的附表装修增补图
.amlSSDT 编译后的二进制文件,真正被引导程序加载通过验收的图纸

SSDTTime 是个"装修设计师":你交出竣工图,它画增补图、自动报审,活全让它干,你只管收图纸。

动手前的自检

  • 环境:Python 3.8 及以上版本(终端启动方式需要)。首次运行会自动下载iasl编译器,网络要能通外网。
  • 文件位置:解压到可读写的目录,别放只读路径。所有产物落在同级Results/文件夹,自动创建。
  • 启动方式
    • Windows:双击SSDTTime.bat,导出 DSDT 时建议管理员权限
    • macOS:双击SSDTTime.command
    • Linux:python3 SSDTTime.py

5 步从零到跑通

  1. 启动工具:双击对应平台的启动文件,进入主菜单。首次运行会先下载 iasl,卡住就看下面急救站。
  2. 载入竣工图:按D进入 Select ACPI table。Linux 和 Windows 可按P自动转储系统表到Results/;macOS 把之前导出的.aml文件拖进输入框。
  3. 选号画增补图:输入2生成SSDT-EC(假 EC,睡眠与键盘刚需);输入5生成SSDT-PLUG(给 CPU 设置plugin-type为 1)。选完即编译,几秒出结果。
  4. 收图纸:打开Results/文件夹,拿到SSDT-EC.aml和登记单patches_OC.plist。把.aml复制到 OpenCore 分区的EFI/OC/ACPI/目录。
  5. 递交登记材料:双击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.exeacpidump.exe
窗口一闪就退Python 低于 3.8 或没装终端跑python3 SSDTTime.py看真实报错,再升级 Python
No valid .aml files were found路径传错,或多个 DSDT 签名混在一起传单个.aml或干净的表文件夹,同时只允许一个 DSDT 签名
编译失败并弹出一个.dslASL 模板和当前表不匹配Results/里该.dsl的报错行;菜单M切换 4 档 Match Mode 重试
打上补丁后进不了系统新加的.aml有问题进安全模式,移除该.amlconfig.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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询