MartinMac

Appearance

Booter ​

本文档会把 config 的项目分开来，内容繁琐，请仔细阅读相关配置项。配置 config.plist 强制要求在 Windows 环境下使用 Propertree 来编辑，其他任何软件都不建议使用。

本部分允许在 Apple BootLoader （boot.efi）上应用不同种类的 UEFI 修改。目前，这些修改为不同的固件提供了各种补丁和环境更改。

对于 Booter 的配置顺序建议按照如下的顺序执行：

  1. Quirks
  2. Patch

如果是在第一次安装黑苹果的硬件上使用此功能请检查主板的BIOS设置，以下BIOS选项建议检查：

  • 更新BIOS的最新固件（如果主板支持BIOS固件更新，具体方法请浏览各大主板的官网）
  • 禁用快速启动相关配置Fast Boot和Hardware Fast Boot
  • 启用大于 4G 地址空间解码 Above 4G decoding
  • 禁用VT-d
  • 禁用CFG Lock
  • 禁用兼容性支持模块CSM
  • 启用EHCI/XHCI Hand-off功能。仅在系统启动过程中出现USB相关报错建议启用。
  • 建议在BIOS中启用 VT-x、Hyper Threading、Execute Disable Bit。
  • 可能在BIOS中禁用 Thunderbolt Support、Intel SGX、Intel Platform Trust。此配置不是必须的。

注

以上BIOS配置项在不同主板上都会略用不同，有些主板可能找不到相关选项，忽略即可。

MmioWhitelist ​

  1. Address

    内存地址

  2. Comment

    注释

  3. Enabled

    设置为 true 则应用此条补丁。

以下是默认项的说明:

  • 第一项是为 Haswell (4 代酷睿)芯片提供的内存寻址修复。
  • 第二项是解决开机在 PCI Configuration 这里卡住。ACPI、PCI device 同时释放到内存时发生 0x1000 内存地址被占用导致在 PCI Configuration 卡住。

Patch ​

该功能可以对 Bootx64.efi 进行修改。

Quirks ​

此项与 OpenRuntime.efi 有关。这里的选项对于无法原生NVRAM需要格外注意。

  • AllowRelocationBlock: False

    • 允许通过重定位块来启动 macOS。此功能用于 10.7 及更早的 MacOS 系统。

  • AvoidRuntimeDefrag: True

    • 防止 boot.efi 运行时执行内存碎片整理。这个选项修复了包括日期、时间、NVRAM、电源控制等 UEFI Runtime 服务。

  • DevirtualiseMmio: True

    • 从某些 MMIO 区域中删除 Runtime 属性。

KASLR 是更加高效的内存注入方式，但不代表每台机器都能使用这种方案，这里我提供两种关于内存的设置:

1: 开启 KASLR 内存注入方式。

  • DevirtualiseMmio 选择 True
  • ProtectUefiServices 选择 True
  • 删除 NVRAM-Add 中 boot-args 里面的 slide=1
  • 删除 Drivers 文件夹下的 Memoryallocations.efi

2: 开启连续性内存注入方式。

  • DevirtualiseMmio 选择 True
  • ProtectUefiServices 选择 False
  • 保留 NVRAM-Add 中 boot-args 里面的 slide=1
  • 保留 Drivers 文件夹下的 Memoryallocations.efi

  • DisableSingleUser: False

    • 禁用 Apple 单用户模式。

  • DisableVariableWrite: False

    • 防止 macOS 获取 NVRAM 的写入权限。

      • 主板支持原生 NVRAM 设置 True
      • 主板不支持原生 NVRAM 设置 False

  • DiscardHibernateMap: False

    • 复用原始的休眠内存映射。台式机不需要讨论如何休眠(睡眠sleep和休眠hibernation是两个概念)。

  • EnableSafeModeSlide: False

    • 修补引导加载程序以在安全模式下启用 KASLR。
    • 启用此配置必须启用 ProvideCustomSlide。

  • EnableWriteUnprotector: True

    • 保证 NVRAM 能正常写入而不受 CR0 寄存器的写入保护影响。

  • ForceBooterSignature: False

    • 将 macOS 启动器签名设置为 OpenCore 启动器。

  • ForceExitBootServices: False

    • 在失败时用新的内存映射（Memory Map）重试 ExitBootServices。
    • 是否启用这个 Quirk 取决于你是否遇到了 Early Boot 故障。除非你详细了解这一选项可能导致的后果，否则请勿启用这一选项。

  • ProtectMemoryRegions: False

    • 保护内存区域免于不正确的读写。
    • 是否启用这一 Quirk 取决于你是否遇到了休眠、睡眠无法唤醒、启动失败或其他问题。

  • ProtectSecureBoot: False

    • 保护 UEFI 安全启动变量不被写入。

  • ProtectUefiServices: True

    • 保护 UEFI 服务不被固件覆盖。解决 Z390 系列主板卡开机卡++++的问题。

  • ProvideCustomSlide: True

    • 为低内存设备提供自定义 KASLR slide 值。

  • ProvideMaxSlide: 0

    • 当更大的 LASLR slide 值不可用时，手动提供最大的 KASLR slide 值。

  • RebuildAppleMemoryMap: False

    • 生成与 macOS 兼容的内存映射。

    注释

    由于许多固件自带的内存保护不正确，所以一般开启此选项的同时需要同时开启 SyncRuntimePermissions 。

  • ResizeAppleGpuBars: -1

    • 此选项用于适配 BIOS 具备 Resizable BAR 功能的主板，BIOS 支持此功能可以给 Windows 带来更好的显卡性能，但另一方面会导致 macOS 不稳定。

    • 填如下值对应相对功能:

      • 当值为 -1 时:关闭此功能
      • 当值为 0 时:预留 1MB
      • 当值为 1 时:预留 2MB
      • 当值为 2 时:预留 4MB
      • 当值为 10 时:预留 1GB
      • 若要开启此功能建议填 0

  • SetupVirtualMap: True

    • 是否建立虚拟内存并对物理内存进行映射。

  • SignalAppleOS: False

    • 此项是给 Apple 设备用的。

  • SyncRuntimePermissions: False

    • 修正硬件在注入内存时无法注入权限的问题。是否开启这一 Quirk 取决于是否遇到 Early Boot 故障(包括但不限于在黑屏时停止以及更明显的崩溃，影响同一台机子上的其他系统)如果无法进入 Windows 开启此选项。