OpenCore 文件收集

所需驱动程序

对于大多数系统，您只需要 2 个.efi驱动程序即可启动和运行：

• HfsPlus.efi （打开新窗口）（必需的）
  • 查看 HFS 卷（即 macOS 安装程序和恢复分区/映像）所需。不要混合其他 HFS 驱动程序
  • 对于 Sandy Bridge 及更早版本（以及低端 Ivy Bridge（i3 和 Celerons）），请参阅下面的旧版部分
• OpenRuntime.efi （打开新窗口）（必需的）
  • AptioMemoryFix.efi的替代品 （打开新窗口），用作 OpenCore 的扩展，以帮助修补 boot.efi 以实现 NVRAM 修复和更好的内存管理。
  • 提醒一下，它捆绑在我们之前下载的 OpenCorePkg 中

所需的内核扩展

如果没有以下 2 个，系统将无法启动：

• Lilu（打开新窗口）（必需的）
  • 用于修补许多进程的 kext，是 AppleALC、WhateverGreen、VirtualSMC 和许多其他 kext 所需的。没有莉露，他们就无法工作。
  • 请注意，虽然 Lilu 最早支持 Mac OS X 10.4，但许多插件仅适用于较新的版本。
• VirtualSMC （打开新窗口）（必需的）
  • 模拟真实 Mac 上的 SMC 芯片，否则 macOS 将无法启动
  • 需要 Mac OS X 10.4 或更高版本

• VirtualSMC 插件

  以下插件不需要启动，只是向系统添加额外的功能，例如硬件监控。除非另有说明，这些插件均随 VirtualSMC 一起提供

  提示

  虽然 VirtualSMC 支持 10.4，但插件可能需要更新版本。

  • SMCProcessor.kext
    • 用于监控Intel CPU温度
    • 不适用于基于 AMD CPU 的系统
    • 需要 Mac OS X 10.7 或更高版本
  • SMCAMD处理器（打开新窗口）
    • 用于监控基于 AMD Zen 的系统上的 CPU 温度
    • 正在积极开发中，可能不稳定
    • 需要 AMDRyzenCPUPowerManagement（请参阅AMD CPU 特定 Kexts）
    • 需要 macOS 10.13 或更高版本
  • SMC Radeon GPU（打开新窗口）
    • 用于监控 AMD GPU 系统上的 GPU 温度
    • 需要来自同一存储库的 RadeonSensor
    • 需要 macOS 11 或更高版本
  • SMCSuperIO.kext
    • 用于监控风扇速度
    • 不适用于基于 AMD CPU 的系统
    • 需要 Mac OS X 10.6 或更高版本
  • SMCLightSensor.kext
    • 用于笔记本电脑上的环境光传感器
    • 如果您没有环境光传感器（即台式机），请勿使用，否则可能会导致问题
    • 需要 Mac OS X 10.6 或更高版本
  • SMCBatteryManager.kext
    • 用于测量笔记本电脑上的电池读数
    • 请勿在桌面上使用
    • 需要 Mac OS X 10.4 或更高版本
  • SMCDellSensors.kext
    • 允许对支持系统管理模式 (SMM) 的戴尔计算机上的风扇进行更精细的监控和控制
    • 如果您没有受支持的戴尔机器，请不要使用，主要是戴尔笔记本电脑可以从此 kext 中受益
    • 需要 Mac OS X 10.7 或更高版本

  #图形

  • WhateverGreen（必需的）
    • 用于图形修补、DRM 修复、主板 ID 检查、帧缓冲区修复等；所有 GPU 都受益于这个 kext。
    • 请注意，仅笔记本电脑和 AIO 需要包含的 SSDT-PNLF.dsl 文件，请参阅ACPI 入门 （打开新窗口）了解更多信息
    • 需要 Mac OS X 10.6 或更高版本

  #声音的

  • AppleALC（打开新窗口）
    • 用于 AppleHDA 修补，支持大多数板载声音控制器
    • AppleALCU.kext 是 AppleALC 的精简版本，仅支持数字音频 – 但您仍然可以在纯数字音频系统上使用 AppleALC.kext
    • AMD 15h/16h 可能存在 AppleALC 问题，而 Ryzen/Threadripper 系统很少有麦克风支持
    • 需要 OS X 10.4 或更高版本
    • 旧版音频 Kext对于那些计划启动 10.7 及更早版本的人可能希望选择这些 kext：
      • 巫毒HDA（打开新窗口）
        • 需要 OS X 10.6 或更高版本
      • VoodooHDA-FAT（打开新窗口）
        • 与上面类似，但支持 32 和 64 位内核，非常适合 OS X 10.4-5 启动和 32 位 CPU

  以太网

  在这里，我们假设您知道您的系统有什么以太网卡，提醒您产品规格页面很可能会列出网卡的类型。

  • IntelMausi（打开新窗口）
    • 大多数 Intel NIC 都需要，基于 I211 的芯片组将需要 SmallTreeIntel82576 kext
    • 正式支持Intel 82578、82579、I217、I218、I219网卡
    • 需要 OS X 10.9 或更高版本，10.6-10.8 用户可以使用 IntelSnowMausi 代替旧操作系统
  • AppleIGB（打开新窗口）
    • 在 macOS Monterey 及更高版本上运行的 I211 NIC 需要
    • 某些网卡可能存在不稳定问题，建议留在 Big Sur 并使用 SmallTree
    • 大多数运行 Intel NIC 的 AMD 主板都需要
    • 需要 macOS 12 及更高版本
  • SmallTreeIntel82576（打开新窗口）
    • 在 macOS 版本（最高至 Big Sur）上运行的 I211 NIC 是必需的，基于 SmallTree kext，但经过修补以支持 I211（不适用于 macOS 12 Monterey或更高版本）
    • 大多数运行 Intel NIC 的 AMD 主板都需要
    • 需要 OS X 10.9-12(v1.0.6)、macOS 10.13-14(v1.2.5)、macOS 10.15+(v1.3.0)
  • AtherosE2200以太网（打开新窗口）
    • Atheros 和 Killer NIC 所需
    • 需要 OS X 10.8 或更高版本
    • 注意：Atheros Killer E2500 型号实际上基于 Realtek，对于这些系统，请使用RealtekRTL8111 （打开新窗口）反而
  • 瑞昱RTL8111（打开新窗口）
    • 适用于 Realtek 千兆位以太网
    • v2.2.0 及以下版本需要 OS X 10.8 及更高版本，v2.2.2 版本需要 macOS 10.12 及更高版本，v2.3.0 及更高版本需要 macOS 10.14 及更高版本
    • 注意：有时最新版本的 kext 可能无法在您的以太网上正常工作。如果您看到此问题，请尝试旧版本。
  • LucyRTL8125以太网（打开新窗口）
    • 适用于 Realtek 2.5Gb 以太网
    • 需要 macOS 10.15 或更高版本
  • 对于 Intel 的 I225-V NIC，桌面Comet Lake DeviceProperties部分中提到了补丁。不需要 kext。
    • 需要 macOS 10.15 或更高版本
  • 对于 Intel 的 I350 NIC，HEDT Sandy 和 Ivy Bridge-E DeviceProperties部分中提到了补丁。不需要 kext。
    • 需要 OS X 10.10 或更高版本

  传统以太网 Kext

  与旧版 macOS 安装或较旧的 PC 硬件相关。

  • 苹果Intele1000e（打开新窗口）
    • 主要与基于 10/100MBe 的英特尔以太网控制器相关
    • 需要 10.6 或更高版本
  • 瑞昱RTL8100（打开新窗口）
    • 主要与基于 10/100MBe 的 Realtek 以太网控制器相关
    • 需要 macOS 10.12 或更高版本 v2.0.0+
  • BCM5722D（打开新窗口）
    • 主要与基于 BCM5722 的 Broadcom 以太网控制器相关
    • 需要 OS X 10.6 或更高版本

  另请记住，某些 NIC 实际上在 macOS 中是原生支持的：

  本机以太网控制器

  #Aquantia系列

  # AppleEthernetAquantiaAqtion.kext
  pci1d6a,1    = Aquantia AQC107
  pci1d6a,d107 = Aquantia AQC107
  pci1d6a,7b1  = Aquantia AQC107
  pci1d6a,80b1 = Aquantia AQC107
  pci1d6a,87b1 = Aquantia AQC107
  pci1d6a,88b1 = Aquantia AQC107
  pci1d6a,89b1 = Aquantia AQC107
  pci1d6a,91b1 = Aquantia AQC107
  pci1d6a,92b1 = Aquantia AQC107
  pci1d6a,c0   = Aquantia AQC113
  pci1d6a,4c0  = Aquantia AQC113
  

  注意：由于许多 Aquantia NIC 上附带了一些过时的固件，您可能需要更新 Linux/Windows 中的固件以确保其与 macOS 兼容。

  #英特尔系列

  # AppleIntel8254XEthernet.kext
  pci8086,1096 = Intel 80003ES2LAN
  pci8086,100f = Intel 82545EM
  pci8086,105e = Intel 82571EB/82571GB
  
  # AppleIntelI210Ethernet.kext
  pci8086,1533 = Intel I210
  pci8086,15f2 = Intel I225LM (Added in macOS 10.15)
  
  # Intel82574L.kext
  pci8086,104b = Intel 82566DC
  pci8086,10f6 = Intel 82574L
  
  

  #博通系列

  # AppleBCM5701Ethernet.kext
  pci14e4,1684 = Broadcom BCM5764M
  pci14e4,16b0 = Broadcom BCM57761
  pci14e4,16b4 = Broadcom BCM57765
  pci14e4,1682 = Broadcom BCM57762
  pci14e4,1686 = Broadcom BCM57766
  

  #USB

  • USB工具箱（工具 （打开新窗口）和驱动程序 （打开新窗口））
    • 适用于 Windows 和 macOS 的 USB 映射工具。
    • 强烈建议在安装 macOS 之前映射 USB 端口，以避免任何端口限制问题
    • 特征
      • 支持 Windows 和 macOS 映射（Linux 支持正在进行中）
      • 可以使用 USBToolBox kext 或本机 Apple kexts (AppleUSBHostMergeProperties) 构建地图
      • 支持多种匹配方式
      • 支持配套端口（在 Windows 上）
  • XHCI-不支持（打开新窗口）
    • 非本机 USB 控制器需要
    • 基于 AMD CPU 的系统不需要这个
    • 需要此功能的常见芯片组：
      • H370
      • B360
      • H310
      • Z390（Mojave 及更新版本不需要）
      • X79
      • X99
      • 华擎 Intel 主板（B460/Z490+ 主板不需要）

  #无线网络和蓝牙

  #非本机蓝牙卡

  • 蓝色工具修复（打开新窗口）
    • 修补 macOS 12+ 蓝牙堆栈以支持第三方卡
    • 所有非本机（非 Apple Broadcom、Intel 等）蓝牙卡都需要
    • 包含在BrcmPatchRAM zip中
    • 请勿在 macOS 11 及更早版本上使用

  #英特尔

  • 机场Itlwm（打开新窗口）
    • 添加了对多种 Intel 无线卡的支持，并通过 IO80211 系列集成在恢复中本地工作
    • 需要 macOS 10.13 或更高版本，并且需要 Apple 的安全启动才能正常运行
  • 伊特鲁姆（打开新窗口）
    • 对于无法启用 Apple 安全启动的系统，AirportItlwm 的替代方案
    • 需要直升机场（打开新窗口）
    • 它将被视为以太网卡，您必须通过直升机场连接到 Wi-Fi
    • 不适用于 macOS 恢复
  • 英特尔蓝牙固件（打开新窗口）
    • 与 Intel 无线卡配对时，为 macOS 添加蓝牙支持
    • 除了修补 macOS 中的错误之外，还可以使用 IntelBTPatcher（随附）
    • 需要 macOS 10.13 或更高版本
    • 在 macOS 10.13 至 11 上，您还需要 IntelBluetoothInjector（已包含）

  有关启用 AirportItlwm 的更多信息

  要启用 OpenCore 的 AirportItlwm 支持，您需要：

  • Misc -> Security -> SecureBootModel通过将其设置为Default或其他一些有效值 来启用
    • 本指南和安装后指南稍后都会对此进行讨论：Apple 安全启动（打开新窗口）
  • 如果无法启用 SecureBootModel，您仍然可以强制注入 IO80211Family（强烈建议不要这样做）
    • Kernel -> Force在 config.plist 中设置以下内容（本指南稍后讨论）：
    • 

  博通

  • 机场Brcm修复（打开新窗口）
    • 用于修补非 Apple/非 Fenvi Broadcom 卡，不适用于 Intel、Killer、Realtek 等
    • 需要 OS X 10.10 或更高版本
    • 对于 Big Sur，请参阅Big Sur 已知问题，了解有关 AirPortBrcm4360 驱动程序的额外步骤。
  • Brcm补丁RAM（打开新窗口）
    • 用于在 Broadcom 蓝牙芯片组上上传固件，这是所有非 Apple/非 Fenvi Airport 卡所需的。
    • 与 BrcmFirmwareData.kext 配对
      • BrcmPatchRAM3 for 10.15+（必须与 BrcmBluetoothInjector 配对）
      • BrcmPatchRAM2 适用于 10.11-10.14
      • BrcmPatchRAM 适用于 10.8-10.10
    • 在 macOS 10.11 到 macOS 11 上，您还需要 BrcmBluetoothInjector（已包含）

  BrcmPatchRAM 加载顺序

  的顺序Kernel -> Add应该是：

  1. BrcmBluetoothInjector（如果需要）
  2. Brcm固件数据
  3. BrcmPatchRAM3（或 BrcmPatchRAM2/BrcmPatchRAM）

  BlueToolFixup 可以位于 Lilu 之后的任何位置。

  不过 ProperTree 会为您处理这个问题，所以您不必担心

  AMD CPU 特定 kext

  • XLNC USB固定（打开新窗口）
    • 针对 AMD FX 系统的 USB 修复，不推荐用于 Ryzen
    • 需要 macOS 10.13 或更高版本
  • 巫毒HDA（打开新窗口）
    • 适用于 FX 系统的音频和适用于 Ryzen 系统的前面板麦克风+音频支持，请勿与 AppleALC 混合。Zen CPU 上的音频质量明显比 AppleALC 差
    • 需要 OS X 10.6 或更高版本
    • 不建议在 macOS 11.3 及更高版本上使用此 kext，因为您需要修改 macOS 文件系统并禁用 SIP
  • AMDRyzenCPU电源管理（打开新窗口）
    • Ryzen 系统的 CPU 电源管理
    • 正在积极开发中，可能不稳定
    • 需要 macOS 10.13 或更高版本

  #附加功能

  • AppleMCEReporterDisabler（打开新窗口）
    • 在 AMD 系统上的 macOS 12.3 及更高版本以及双路 Intel 系统上的 macOS 10.15 及更高版本上需要。
    • 受影响的 SMBIOS：
      • MacPro6,1
      • MacPro7,1
      • iMacPro1,1
  • CPUTsc同步（打开新窗口）
    • 在某些 Intel HEDT 和服务器主板上同步 TSC 需要，否则 macOS 可能会非常慢甚至无法启动。
    • 不适用于 AMD CPU
    • 需要 OS X 10.8 或更高版本
  • NVMe修复（打开新窗口）
    • 用于修复非 Apple NVMe 上的电源管理和初始化
    • 需要 macOS 10.14 或更高版本
  • SATA-不支持（打开新窗口）
    • 添加了对多种 SATA 控制器的支持，主要与在 macOS 中看到 SATA 驱动器时遇到问题的笔记本电脑相关。我们建议先在没有这个的情况下进行测试。
    • Big Sur+ 注：CtlnaAHCIPort （打开新窗口）由于许多控制器从二进制文件本身中删除，因此需要使用
      • 卡塔利娜和年长者无需担心
  • CPU拓扑重建（打开新窗口）
    • 一个实验性的 Lilu 插件，可优化 Alder Lake 的异构核心配置。仅适用于 Alder Lake CPU
  • 限制事件（打开新窗口）
    • 修补macOS的各种功能，请参阅README （打开新窗口）了解更多信息
  • 翡翠SDHC（打开新窗口）
    • 用于 eMMC 支持的 macOS 内核扩展。目前仅支持速度高达 HS200 的 eMMC/MMC 卡。该驱动程序目前正在开发中，在某些设备上可能会出现性能不佳或无法运行的情况。目前尚不支持 SD 卡。

旧版 SATA Kext

• AppleIntelPIIXATA.kext（打开新窗口）
  • 适用于旧版 Core 2 Duo/Quad 和 Pentium 4 系统的旧版 IDE 和 ATA kext。macOS 11 (Big Sur) 及更新版本需要此 kext，因为此 kext 已在 macOS 10.15 (Catalina) 中删除
• AHCI端口注入器（打开新窗口）
  • 传统 SATA/AHCI 注入器，主要与 Penryn 时代的旧机器相关
• ATA端口注入器（打开新窗口）
  • 传统 ATA 注入器，主要与 IDE 和 ATA 设备相关（即当 BIOS 中不存在 AHCI 选项时）
  • 依赖于 AppleIntelPIIXATA.kext，使用 macOS 11 (Big Sur) 及更高版本时需要包含该文件

笔记本电脑输入

要了解您拥有哪种类型的键盘和触控板，请检查 Windows 或dmesg | grep -i inputLinux中的设备管理器

#PS2 键盘/触控板

• 巫毒PS2（打开新窗口）
  • 适用于各种 PS2 键盘、鼠标和触控板
  • 需要 macOS 10.11 或更高版本才能使用 MT2 (Magic Trackpad 2) 功能
• 康复者的巫毒PS2（打开新窗口）
  • 对于带有 PS2 键盘、鼠标和触控板的旧系统，或者当您不想使用 VoodooInput 时
  • 支持 macOS 10.6+

#SMBus 触控板

• 巫毒RMI（打开新窗口）
  • 适用于配备 Synaptics SMBus 触控板的系统
  • MT2 功能需要 macOS 10.11 或更高版本
  • 取决于 Acidanthera 的 VoodooPS2
• 巫毒SMBus（打开新窗口）
  • 适用于配备 ELAN SMBus 触控板的系统
  • 目前支持 macOS 10.14 或更高版本

#I2C/USB HID 设备

• VoodooI2C（打开新窗口）
  • 支持 macOS 10.11+
  • 连接到 I2C 控制器以允许插件与 I2C 触控板通信
  • 使用以下插件的USB设备仍然需要VoodooI2C
  • 必须与如下所示的一个或多个插件配对：

#杂项

• EC启动器（打开新窗口）
  • 修复了许多设备上读取电池状态的问题（允许读取超过 8 位长的 EC 字段）
  • 支持 OS X 10.7 及更高版本（10.4 – 10.6 不需要）
• 亮度键（打开新窗口）
  • 自动修复亮度键

请参考Kexts.md （打开新窗口）支持的 kext 的完整列表

#SSDT

因此，您在 AcpiSamples 文件夹中看到所有这些 SSDT，并想知道是否需要其中任何一个。对于我们来说，我们将在config.plist 的特定 ACPI 部分中检查您需要哪些 SSDT ，因为您需要的 SSDT 是特定于平台的。甚至有些系统特定于需要配置的地方，如果我现在给您一个 SSDT 列表供您选择，您很容易迷失方向。

ACPI 入门 （打开新窗口）有关于 SSDT 的扩展部分，包括在不同平台上编译它们。

所需 SSDT 的快速 TL;DR（这是源代码，您必须将它们编译成 .aml 文件）：

桌面