台式 Comet Lake

支持	版本
初始macOS支持	macOS 10.15, Catalina

起点

制作一个config.plist看起来很难，其实并不难。这只是需要一些时间，但本指南将告诉你如何配置所有的东西，你不会被冷落。这也意味着如果你有问题，检查你的配置设置以确保它们是正确的。OpenCore的主要注意事项:

• 所有属性必须被定义，没有默认的OpenCore将出错，所以不要删除节，除非有明确告知你。如果指南没有提到该选项，请将其保留为默认值。
• Sample plist不能按原样使用，必须配置到您的系统中。
• 不要使用配置器，这些配置器很少遵守OpenCore的规则，甚至一些像Mackie的配置器会添加Clover属性和破坏plists!

现在，我们来快速地提醒一下我们需要哪些工具

• ProperTree (opens new window)
  • 通用plist编辑器
• GenSMBIOS (opens new window)
  • 用于生成SMBIOS数据
• Sample/config.plist (opens new window)
  • 参见上一节中如何获取:config.plist Setup

注意

在设置OpenCore之前，请多次阅读本指南，并确保设置正确。请注意，图像并不总是最新的，所以请阅读下面的文本，如果没有提到，则保留为默认值。

ACPI

Add

信息

这是你将为系统添加ssdt的地方，这些对于引导macOS非常重要，并且有许多用途，例如USB映射 (opens new window), 禁用不支持的gpu 等，这对于我们的系统来说是启动所必须的。制作指南可以在这里找到:ACPI入门 (opens new window)

我们需要几个ssdt来恢复Clover提供的功能:

所需ssdt	描述
SSDT-PLUG (opens new window)	在Haswell和更新的版本上允许本地CPU电源管理，请参阅ACPI入门指南 (opens new window)了解更多细节。
SSDT-EC-USBX (opens new window)	修复了嵌入式控制器和USB电源，请参阅开始与ACPI指南 (opens new window)了解更多细节。
SSDT-AWAC (opens new window)	这是300系列RTC补丁 (opens new window)，用于所有B460和Z490板，以防止系统引导macOS。另一种选择是SSDT-rtc0 (opens new window)，当AWAC SSDT由于缺少遗留的RTC时钟而不兼容时，请检查您是否需要它以及使用哪个，请参阅开始使用ACPI (opens new window)页面。
SSDT-RHUB (opens new window)	需要修复Asus和MSI板上的根设备错误。Gigabyte和AsRock主板不需要这个SSDT

注意，你不应该在这里添加你生成的DSDT aml，它已经在你的固件中了。因此，如果存在，请在你的config.plist和EFI/OC/ACPI下删除它的条目。

对于那些想要更深入地了解转储您的DSDT、如何制作这些ssdt以及编译它们的人，请参阅开始使用ACPI (opens new window) 页面。编译的ssdt有一个 .aml 扩展名(组装)，将被放入EFI/OC/ACPI文件夹，并且必须在你的配置文件ACPI -> Add下指定。

Delete

这将阻止某些ACPI表加载，对于我们来说，我们可以忽略它。

Patch

本节允许我们通过OpenCore动态修改ACPI的部分内容(DSDT、SSDT等)。对我们来说，我们的补丁由我们的ssdt处理。这是一个更简洁的解决方案，因为这将允许我们使用OpenCore引导Windows和其他操作系统

Quirks

与ACPI相关的设置，将所有内容保留为默认设置，因为我们不需要这些选项。

Booter

本节专门讨论使用OpenRuntime (AptioMemoryFix.efi的替代品)进行引导efi补丁的相关问题

MmioWhitelist

本节允许将通常被忽略的设备直通到macOS，对我们来说，我们可以忽略本节。

Quirks

信息

与boot.efi补丁和固件修复相关的设置，对我们来说，我们需要更改以下内容:

选项	启用	注释
DevirtualiseMmio	是
EnableWriteUnprotector	否
ProtectUefiServices	是
RebuildAppleMemoryMap	是
ResizeAppleGpuBars	-1	如果您的固件支持增加GPU Bar大小(如：可调整大小的BAR支持)，请将其设置为0
SetupVirtualMap	否
SyncRuntimePermissions	是

更多深入信息

• AvoidRuntimeDefrag: YES
  • 修复UEFI运行时服务，如日期，时间，NVRAM，电源控制等
• DevirtualiseMmio: YES
  • 减少内存占用，扩展slide=N值的选项，并对修复内存分配问题非常有帮助，对于Z490也需要ProtectUefiServices。
• EnableSafeModeSlide: YES
  • 允许slide变量在安全模式下使用。
• EnableWriteUnprotector: NO
  • 这一选项和RebuildAppleMemoryMap通常会发生冲突，建议在较新的平台上启用后者并禁用此条目。
  • 然而，由于原始设备制造商没有使用最新的EDKII版本，您可能会发现上述组合将导致早期启动失败。这是由于缺少MEMORY_ATTRIBUTE_TABLE，因此我们建议禁用RebuildAppleMemoryMap并启用EnableWriteUnprotector。关于这个的更多信息在故障排除部分中有介绍。
• ProtectUefiServices: YES
  • 保护UEFI服务不被固件覆盖，Z490所需。
• ProvideCustomSlide: YES
  • 用于Slide变量计算。然而，这种怪异的必要性取决于 OCABC: Only N/256 slide values are usable! 调试日志中的消息。如果显示 OCABC: All slides are usable! You can disable ProvideCustomSlide! 在你的日志中，你可以禁用ProvideCustomSlide.
• RebuildAppleMemoryMap: YES
  • 生成与macOS兼容的内存映射，可能会在一些笔记本电脑的OEM固件上损坏，所以如果你收到早期启动失败，请禁用此功能。
• ResizeAppleGpuBars: -1
  • 启动macOS时，如果设置为0，将减少GPU PCI Bars的大小，设置为-1则禁用
  • 使用此选项可以设置其他PCI Bar值，但可能导致不稳定
  • 只有在固件中启用了对Resizable BAR的支持时，才需要将此属性设置为0。
• SetupVirtualMap: NO
  • 修复了SetVirtualAddresses对虚拟地址的调用，但由于Comet Lake的内存保护而中断。华硕，技嘉和AsRock主板无法启动与此有关。
• SyncRuntimePermissions: YES
  • 修正了与MAT表的对齐，并要求使用MAT表启动Windows和Linux，也推荐用于macOS。主要与重建苹果内存映射的用户相关。

DeviceProperties

Add

从映射设置设备属性。

PciRoot(0x0)/Pci(0x2,0x0)

本节是通过WhateverGreen的Framebuffer补丁指南 (opens new window)建立的，用于设置重要的iGPU属性。如果你有-F系列CPU，你可以忽略这一部分，因为你没有iGPU。

config.plist还没有这个部分，所以你必须手动创建它。

AAPL,ig-platform-id 是macOS用来确定iGPU驱动程序如何与我们的系统交互的值，两个值之间的选择如下:

AAPL,ig-platform-id	注释
07009B3E	当桌面iGPU用于驱动显示器时使用
00009B3E	如果它不起作用，可以替代07009B3E
0300C89B	当桌面iGPU仅用于计算任务而不驱动显示时使用

• 注意:在macOS 10.15.5及更新版本中，使用07009B3E时黑屏似乎有很多问题，如果你遇到类似的问题，请尝试切换到00009B3E

我们还添加了另外两个属性，framebuffer-patch-enable和framebuffer-stolenmem。第一个启用WhateverGreen.kext打补丁，第二个设置最小共享内存为19MB。这通常是不必要的，因为可以在BIOS中配置(推荐64MB)，但在不可用时是必需的。

• 注意:无头帧缓冲区(其中dGPU是显示出来的)不需要framebuffer-patch-enable和framebuffer-stolenmem

键	类型	值
AAPL,ig-platform-id	Data	07009B3E
framebuffer-patch-enable	Data	01000000
framebuffer-stolenmem	Data	00003001

(这是一个桌面UHD 630没有dGPU和iGPU内存没有BIOS选项的例子)

PciRoot(0x0)/Pci(0x1C,0x1)/Pci(0x0,0x0)

这篇文章与Intel的I225-V 2.5GBe控制器有关，我们在这里要做的是让Apple的I225LM驱动程序支持我们的I225-V网络控制器:

键	类型	值
device-id	Data	F2150000

• 注:如果你的主板没有附带Intel I225网卡，没有理由添加这个条目。
• 注2:如果你在AppleIntelI210Ethernet kext上得到内核崩溃，你的以太网路径可能是 PciRoot(0x0)/Pci(0x1C,0x4)/Pci(0x0,0x0)

PciRoot(0x0)/Pci(0x1b,0x0)

layout-id

• 应用AppleALC音频注入，你需要自己研究你的主板有哪个编解码器，并将其与AppleALC的布局匹配。AppleALC支持的编解码器 (opens new window).
• 你可以直接删除这个属性，因为我们现在还没有使用它

对于我们来说，我们将使用引导参数alcid=xxx来完成此操作。alcid将覆盖所有其他layout- id。更多信息可以在安装后页面 (opens new window)中找到。

Delete

从映射中删除设备属性，我们可以忽略它

Kernel

Add

在这里，我们指定要加载哪些kext，以什么特定的顺序加载，以及每个kext适用于什么体系结构。默认情况下，我们建议保留ProperTree所做的操作，但对于32位cpu，请参见以下内容:

更深入的信息

The main thing you need to keep in mind is:

• 装载顺序
  • 记住，任何插件都应该在它的依赖后面加载
  • 这意味着像Lilu这样的kext 必须出现在VirtualSMC、AppleALC、WhateverGreen等之前

提醒一下 ProperTree (opens new window) 用户可以运行 Cmd/Ctrl + Shift + R 以正确的顺序添加他们所有的kext，而无需手动输入每个kext。

• Arch
  • 这个kext支持的架构
  • 目前支持的值是 Any, i386 (32位), 和x86_64 (64位)
• BundlePath
  • kext的名称
  • 例如: Lilu.kext
• Enabled
  • 不言自明，启用或禁用kext
• ExecutablePath
  • 实际可执行文件的路径隐藏在kext中，您可以通过右键单击并选择显示包内容来查看kext的路径。一般来说，它们将是Contents/MacOS/Kext，但有些将Kext隐藏在Plugin文件夹下。请注意，kext中仅plist时不需要填充该属性。
  • 例如: Contents/MacOS/Lilu
• MinKernel
  • kext将被注入到的最低内核版本，有关可能的值，请参见下表
  • 例如. 12.00.00 用于 OS X 10.8
• MaxKernel
  • kext将被注入到的最高内核版本，可能的值见下表
  • 例如. 11.99.99 用于 OS X 10.7
• PlistPath
  • 隐藏在kext中的info.plist的路径
  • 例如: Contents/Info.plist

内核支持表

OS X 版本	MinKernel	MaxKernel
10.4	8.0.0	8.99.99
10.5	9.0.0	9.99.99
10.6	10.0.0	10.99.99
10.7	11.0.0	11.99.99
10.8	12.0.0	12.99.99
10.9	13.0.0	13.99.99
10.10	14.0.0	14.99.99
10.11	15.0.0	15.99.99
10.12	16.0.0	16.99.99
10.13	17.0.0	17.99.99
10.14	18.0.0	18.99.99
10.15	19.0.0	19.99.99
11	20.0.0	20.99.99
12	21.0.0	21.99.99
13	22.0.0	22.99.99

Emulate

需要欺骗不支持的cpu，幸运的是在10.15.5+ Comet Lake中添加了支持，所以不需要在这里欺骗。对于那些运行High Sierra或Mojave的人，您将需要下面的代码来欺骗到一个受支持的CPU模型(由于稳定性问题，本指南将不讨论此类CPUID欺骗)

Force

用于从系统卷中加载kext，仅适用于某些kext不存在于缓存中的旧操作系统(例如IONetworkingFamily在10.6)。

对我们来说，我们可以忽略。

Block

阻止某些kext的加载。与我们无关。

Patch

对内核和kext进行补丁。

修复I225-V控制器

此条目与在更高端的 Comet Lake 板上找到的英特尔 I225-V 2.5GBe 控制器相关，我们将在这里做的是欺骗 Apple 的 I225LM 驱动程序以支持我们的 I225-V 网络控制器。 但是，这仅在 Catalina 和 Big Sur 上需要，最高为 11.3。

键	类型	值
Base	String	__Z18e1000_set_mac_typeP8e1000_hw
Comment	String	I225-V patch
Count	Number	1
Enabled	Boolean	True
Find	Data	F2150000
Identifier	String	com.apple.driver.AppleIntelI210Ethernet
MinKernel	String	19.0.0
MaxKernel	String	20.4.0
Replace	Data	F3150000

• 注 1：如果您的主板未附带 Intel I225 NIC，则没有理由添加此条目。
• 注 2：保留所有其他键的默认值

Quirks

信息

与内核相关的设置，我们将启用以下功能：

选项	启用	注释
AppleXcpmCfgLock	是	如果在 BIOS 中禁用了 CFG-Lock，则不需要
DisableIoMapper	是	如果在 BIOS 中禁用了 VT-D 如果在 BIOS 中禁用了
LapicKernelPanic	否	惠普机器将需要这个选项
PanicNoKextDump	是
PowerTimeoutKernelPanic	是
XhciPortLimit	是	如果运行 macOS 11.3+ 则禁用

更深入的信息

• AppleCpuPmCfgLock: NO
  • 仅当BIOS中不能禁用CFG-Lock时需要
  • 仅适用于 Ivy Bridge 和更旧的
    • 注意:Broadwell及更老版本在运行10.10或更老版本时需要此功能
• AppleXcpmCfgLock: YES
  • 仅当BIOS中不能禁用CFG-Lock时需要
  • 仅适用于Haswell和更新版本
    • 注意:Ivy Bridge-E也包括在内，因为它支持XCPM
• CustomSMBIOSGuid: NO
  • 为UpdateSMBIOSMode设置为Custom时执行GUID补丁。通常与戴尔笔记本电脑有关
  • 通过UpdateSMBIOSMode自定义模式启用此选项也可以禁用SMBIOS注入到“非苹果”操作系统中，但我们不支持这种方法，因为它破坏了Bootcamp兼容性。使用风险自负
• DisableIoMapper: YES
  • 如果在BIOS中无法禁用或其他操作系统需要启用VT-D，则需要绕过VT-D，这是dart=0的更好替代方案，因为SIP可以在Catalina中继续运行
• DisableLinkeditJettison: YES
  • 允许Lilu和其他kext在不需要keepsyms=1的情况下拥有更可靠的性能
• DisableRtcChecksum: NO
  • 防止AppleRTC写入主校验和(0x58-0x59)，这对于接收BIOS重置或在重启/关机后进入安全模式的用户是必需的
• ExtendBTFeatureFlags: NO
  • 对于那些非apple /非fenvi卡有连续性问题的人很有帮助
• LapicKernelPanic: NO
  • 在AP核心lapic中断上禁用内核崩溃，一般HP系统需要。相当于Clover的Kernel LAPIC
• LegacyCommpage: NO
  • 解决了macOS中64位cpu的SSSE3要求，主要适用于64位Pentium 4 cpu (即Prescott)
• PanicNoKextDump: YES
  • 允许在发生内核严重故障时读取内核严重故障日志
• PowerTimeoutKernelPanic: YES
  • 帮助修复macOS Catalina中与苹果驱动程序权限变化相关的内核崩溃，尤其是数字音频。
• SetApfsTrimTimeout: -1
  • 为ssd上的APFS文件系统设置以微秒为单位的修剪超时时间，仅适用于macOS 10.14及更新版本的有问题的ssd。
• XhciPortLimit: YES
  • 这实际上是15端口限制补丁，不要依赖它，因为它不是修复USB的保证解决方案。如果可能，请创建一个USB映射 (opens new window)
  • 在macOS 11.3+中，XhciPortLimit可能无法正常工作。 (opens new window) 我们建议用户在升级前禁用此功能和 映射或 从Windows映射 (opens new window). 你也可以安装macOS 11.2.3或更旧的版本。

Scheme

与传统引导(例如10.4-10.6)相关的设置，大多数情况下你可以跳过，但是对于那些计划引导传统操作系统的人，你可以查看以下内容:

更深入的信息

• FuzzyMatch: True

  • 用于忽略内核缓存的校验和，而不是选择可用的最新缓存。可以帮助提高10.6中许多机器的启动性能

• KernelArch: x86_64

  • 设置内核的arch类型，你可以在Auto、i386(32位)和x86_64(64位)之间选择。
  • 如果你正在启动需要32位内核的旧操作系统(例如:10.4和10.5)我们建议将其设置为Auto，并让macOS根据您的SMBIOS决定。支持的值见下表:
    • 10.4-10.5 — x86_64, i386 或 i386-user32
      • i386-user32 是32位的用户空间，所以32位的cpu必须使用这个(或cpu缺少SSSE3)
      • x86_64 仍然有一个32位的内核空间，但是在10.4/5中将确保64位的用户空间
    • 10.6 — i386, i386-user32, 或 x86_64
    • 10.7 — i386 或 x86_64
    • 10.8 或更新的 — x86_64

• KernelCache: Auto

  • 设置内核缓存类型，主要用于调试，因此我们建议使用Auto以获得最佳支持

Misc

Boot

信息

选项	启用	注释
HideAuxiliary	是	按空格键显示 macOS 恢复和其他辅助条目

更深入的信息

• HideAuxiliary: YES
  • 此选项将在选择器中隐藏补充条目，例如macOS恢复和工具。隐藏辅助条目可以提高多磁盘系统的启动性能。您可以在选择器处按空格键来显示这些条目

Debug

信息

有助于调试 OpenCore 启动问题（我们将更改所有内容 但 显示会延迟）：

选项	启用
AppleDebug	是
ApplePanic	是
DisableWatchDog	是
Target	67

更深入的信息

• AppleDebug: YES
  • 启用boot.efi的日志记录，用于调试。注意只有10.15.4及更高版本支持这个功能
• ApplePanic: YES
  • 尝试将内核崩溃记录到磁盘
• DisableWatchDog: YES
  • 禁用UEFI watchdog，可以帮助解决早期引导问题
• DisplayLevel: 2147483650
  • 显示更多的调试信息，需要调试版本的OpenCore
• SysReport: NO
  • 有助于调试，例如转储ACPI表
  • 注意，这仅限于调试版本的OpenCore
• Target: 67
  • 显示更多的调试信息，需要OpenCore的调试版本

这些值是基于 OpenCore 调试中计算的值。

Security

信息

安全性是不言而喻的，不要跳过。我们将修改以下内容:

选项	启用	注释
AllowSetDefault	是
BlacklistAppleUpdate	是
ScanPolicy	0
SecureBootModel	Default	将此设置为默认，以便OpenCore自动设置与您的SMBIOS对应的正确值。下一页将详细介绍此设置。
Vault	Optional	这是一个词,不是可选的省略此设置。如果您没有将其设置为Optional，您将后悔，请注意它是区分大小写的

更深入的信息

• AllowSetDefault: YES

  • 允许按 CTRL+Enter 和CTRL+Index 在选择器中设置默认启动条目

• ApECID: 0

  • 用于网络个性化的安全启动标识符，由于macOS安装程序中的一个bug，目前这种方式是不可靠的，因此我们强烈建议您保留默认设置。

• AuthRestart: NO

  • 为FileVault 2启用身份认证重启，因此在重启时不需要密码。可以被认为是一个可选的安全风险

• BlacklistAppleUpdate: YES

  • 用于阻止固件更新，作为额外的保护级别，因为macOS Big Sur不再使用run-efi-updater变量

• DmgLoading: Signed

  • 确保只加载经过签名的dmg

• ExposeSensitiveData: 6

  • 显示更多的调试信息，需要OpenCore的调试版本

• Vault: Optional

  • 我们不会处理这个，所以我们可以忽略，你不会启动这个设置，因为安全
  • 这是一个单词，省略此设置是不可以的。如果你不把它设置为Optional，你会后悔的，注意它是区分大小写的

• ScanPolicy: 0

  • 0允许您查看所有可用的驱动器，请参阅安全 (opens new window)部分了解更多详细信息。如果设置为默认，将不会启动USB设备

• SecureBootModel: Default

  • 在macOS中控制Apple的安全启动功能，请参阅安全 (opens new window) 部分了解更多细节。
  • 注意:用户可能会发现在已经安装的系统上升级OpenCore可能会导致早期引导失败。要解决这个问题，请参见这里:卡在 OCB: LoadImage failed - Security Violation

Serial

用于串行调试(一切都保留默认值)。

Tools

用于运行OC调试工具，如shell, ProperTree的快照功能将为您添加这些。

Entries

用于指定OpenCore无法自然找到的不规则引导路径。

这里不会介绍更多信息，请参阅Configuration.pdf (opens new window) for more info

NVRAM

Add

4D1EDE05-38C7-4A6A-9CC6-4BCCA8B38C14

用于OpenCore的UI缩放，default对我们有用。更多信息请参见深入部分

更深入的信息

启动器路径，主要用于UI修改

• DefaultBackgroundColor: boot.efi使用的背景色
  • 00000000: Syrah Black
  • BFBFBF00: Light Gray

4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102

OpenCore的NVRAM GUID，主要与RTCMemoryFixup用户相关

更深入的信息

• rtc-blacklist: <>
  • 要与RTCMemoryFixup一起使用，请参阅这里了解更多信息:修复RTC写入问题 (opens new window)
  • 大多数用户可以忽略此部分

7C436110-AB2A-4BBB-A880-FE41995C9F82

系统完整性保护位掩码

• 通用引导参数:

引导参数	描述
-v	这将启用详细模式，在你启动时显示所有滚动的幕后文本，而不是苹果logo和进度条。它对任何黑苹果来说都是非常宝贵的，因为它让您了解了引导过程的内部情况，并可以帮助您识别问题、问题kext等。
debug=0x100	禁用了macOS的watchdog，它有助于防止在内核出现严重错误时重新启动。 这样你就有希望收集到一些有用的信息并按照分层导航的方式来解决问题。
keepsyms=1	这是debug=0x100的配套设置，它告诉操作系统在内核出现崩溃时也打印这些符号。这可以提供一些更有用的信息，以了解造成崩溃本身的原因。
alcid=1	用于为AppleALC设置layout-id，请参阅支持的编解码器 (opens new window)以确定您的特定系统使用哪种布局。更多信息可以在安装后页面 (opens new window) 中找到

• 网络特定的引导参数:

引导参数	描述
e1000=0	禁用com apple DriverKit-AppleEthernetE1000(苹果的DEXT驱动程序)与高端Comet Lake板上找到的英特尔I225- v以太网控制器匹配，以加载苹果的I225 kext驱动程序。 这个引导参数在大多数板上是可选的，因为它们与DEXT驱动程序兼容。但在Gigabyte和其他几个主板上是必需的，这些主板只能使用kext驱动程序，因为DEXT驱动程序会导致挂起。 如果你的主板没有附带I225-V网卡，你不需要这个。 在macOS 12.2.1及以下版本，使用dk.e1000=0 代替

• gpu特定的引导参数:

引导参数	描述
agdpmod=pikera	用于禁用一些Navi gpu (RX 5000 & 6000系列)的board ID检查，如果没有这个，你将得到一个黑屏。如果你没有Navi请不要使用 (比如： Polaris 和 Vega 卡不应该使用它)
-radcodec	用于允许官方不支持的AMD gpu(欺骗)使用硬件视频编码器
radpg=15	U用于禁用一些电源开关模式，有助于正确初始化基于Verde based的 AMD 显卡
unfairgva=1	用于在支持的AMD gpu上修复硬件DRM支持
nvda_drv_vrl=1	用于在macOS Sierra和High Sierra的Maxwell和Pascal卡上启用NVIDIA的Web驱动程序
-wegnoegpu	用于禁用除集成的Intel iGPU之外的所有其他gpu，对于那些想运行新版本的macOS，而他们的dGPU不支持的人很有用

• csr-active-config: 00000000

  • '系统完整性保护' (SIP)的设置。通常建议通过恢复分区使用csrutil进行更改。
  • 默认情况下，csr-active-config设置为00000000，以启用系统完整性保护。您可以选择许多不同的值，但总的来说，为了最佳安全实践，我们建议启用此选项。更多信息可以在我们的故障排除页面中找到:禁用SIP

• run-efi-updater: No

  • 这用于防止苹果的固件更新包安装的时候破坏引导顺序;这很重要，因为这些固件更新(意味着mac)将无法工作。

• prev-lang:kbd: <>

  • *需要lang-COUNTRY:keyboard格式的非拉丁键盘，建议保持空白，尽管你可以指定它(示例配置中默认是俄语):
  • 中文: zh-Hans:252(7A682D48616E733A323532 这是十六进制)
  • 完整列表可在这里找到AppleKeyboardLayouts.txt (opens new window)
  • 提示:prevr-lang:kbd可以被转换成String，所以你可以直接输入zh-Hans:252，而不是转换成十六进制
  • 提示2:prevr-lang:kbd可以设置为一个空白变量(例如:<>)，这将强制在首次启动时显示语言选择器。

Key	Type	Value
prev-lang:kbd	String	zh-Hans:252

Delete

信息

强制重写NVRAM变量，请注意，Add 不会覆盖 NVRAM中已经存在的值，所以像boot-args这样的值应该保持不变。对我们来说，我们将更改以下内容:

选项	启用
WriteFlash	是

更深入的信息

• LegacySchema

  • 用于赋值NVRAM变量，与OpenVariableRuntimeDxe.efi一起使用。仅适用于没有原生NVRAM的系统

• WriteFlash: YES

  • 允许所有添加的变量写入闪存。

PlatformInfo

信息

为了设置SMBIOS信息，我们将使用CorpNewt的GenSMBIOS (opens new window)应用程序。

对于这个Comet Lake示例，我们将选择iMac20,1 SMBIOS—这是为了兼容性而特意这样做的。有两个主要的SMBIOS用于Comet Lake:

SMBIOS	硬件
iMac20,1	i7 - 10700k及以下(即：8核心及以下)
iMac20,2	i9-10850K 和更高(即：10核心)

运行GenSMBIOS，选择选项1下载MacSerial，选择选项3选择SMBIOS。这会给我们一个类似下面的输出:

  #######################################################
 #               iMac20,1 SMBIOS Info                  #
#######################################################

Type:         iMac20,1
Serial:       C02XG0FDH7JY
Board Serial: C02839303QXH69FJA
SmUUID:       DBB364D6-44B2-4A02-B922-AB4396F16DA8

• 注意:MacSerial目前不支持Linux，所以你必须使用Windows或macOS机器来生成值

Type 部分复制到 Generic -> SystemProductName.

Serial 部分复制到 Generic -> SystemSerialNumber.

Board Serial 部分复制到 Generic -> MLB.

SmUUID 部分复制到 Generic -> SystemUUID.

我们将Generic -> ROM设置为苹果ROM(从真正的Mac中转储)，你的网卡Mac地址，或任何随机的Mac地址(可以是6个随机字节，在本指南中我们将使用11223300 0000。安装后，请参考修复iServices (opens new window)页面，了解如何找到你的真实MAC地址)

提醒你需要一个无效的串行!当你在苹果的检查覆盖页面 (opens new window)中输入你的序列号时，你会得到一条信息，比如“无法检查此序列号的覆盖范围”。

Automatic: 是

• 基于Generic节而不是DataHub、NVRAM和SMBIOS节生成platformminfo

Generic

更深入的信息

• AdviseFeatures: NO

  • 用于当EFI分区不是Windows驱动器上的第一个分区

• MaxBIOSVersion: NO

  • 设置BIOS版本为Max，以避免在Big Sur+固件更新，主要适用于正版mac。

• ProcessorType: 0

  • 设置为0用于自动类型检测，但是如果需要，这个值可以被覆盖。参见AppleSmBios.h (opens new window) 获取可能的值

• SpoofVendor: YES

  • 将供应商字段替换为Acidanthera，在大多数情况下使用苹果作为供应商通常不安全

• SystemMemoryStatus: Auto

  • 在SMBIOS信息中设置内存是否焊接，纯粹用于修饰，因此我们建议使用Auto

• UpdateDataHub: YES

  • 更新数据中心字段

• UpdateNVRAM: YES

  • 更新NVRAM字段

• UpdateSMBIOS: YES

  • 更新SMBIOS字段

• UpdateSMBIOSMode: Create

  • 用新分配的EfiReservedMemoryType替换表，在需要CustomSMBIOSGuid的Dell笔记本电脑上使用Custom
  • 设置为Custom并启用CustomSMBIOSGuid也可以禁用SMBIOS注入到“非apple”操作系统中，但是我们不支持这种方法，因为它破坏了Bootcamp的兼容性。使用风险自负

UEFI

ConnectDrivers: 是

• 强制.efi驱动程序，更改为NO将自动连接添加的UEFI驱动程序。这可以使引导稍微快一点，但不是所有的驱动程序都连接自己。例如某些文件系统驱动程序不能加载。

Drivers

在这里添加你的.efi驱动程序。

在这里的驱动程序应该只有:

• HfsPlus.efi
• OpenRuntime.efi

更深入的信息

Key	Type	描述
Path	String	文件在OC/Drivers目录中的路径
LoadEarly	Boolean	在安装NVRAM之前尽早加载驱动程序，如果使用旧的NVRAM，应该只启用OpenRuntime.efi和OpenVariableRuntimeDxe.efi
Arguments	String	有些驱动程序接受这里指定的其他参数。

APFS

默认情况下，OpenCore只从macOS Big Sur及更新版本加载APFS驱动程序。如果你启动的是macOS Catalina或更早的版本，你可能需要设置一个新的最低版本/日期。 不设置这个会导致OpenCore找不到你的macOS分区!

macOS Sierra和更早的版本使用HFS而不是APFS。如果启动旧版本的macOS，您可以跳过本节。

APFS 版本

如果修改最小版本，则需要同时设置MinVersion和MinDate。

macOS 版本	Min Version	Min Date
High Sierra (10.13.6)	748077008000000	20180621
Mojave (10.14.6)	945275007000000	20190820
Catalina (10.15.4)	1412101001000000	20200306
No restriction	-1	-1

Audio

对于AudioDxe设置，我们将忽略(保留默认值)。这与macOS中的音频支持无关。

• 要进一步使用AudioDxe和音频部分，请参见安装后页面:添加主题和启动铃声 (opens new window)

Input

与boot.efi键盘直通用于FileVault和热键支持相关，这里保留所有默认设置，因为我们不需要这些选项。请参阅这里了解更多细节:Security and FileVault (opens new window)

Output

关于OpenCore的视觉输出，将所有内容保留为默认值，因为我们不需要这些选项。

更深入的信息

Output	Value	Comment
UIScale	0	0将根据分辨率自动设置 -1将保持不变 1为1x缩放，对于正常显示器 2为2倍缩放，对于HiDPI显示器

ProtocolOverrides

主要针对虚拟机、传统mac和FileVault用户。更多细节请参阅此处:Security and FileVault (opens new window)

Quirks

信息

关于UEFI环境的选项，对于我们来说，我们将改变以下内容:

选项	启用	注释
UnblockFsConnect	否	主要由惠普主板使用

更深入的信息

• DisableSecurityPolicy: 否

  • 禁用固件中的平台安全策略，建议用于有bug的固件，其中禁用安全引导不允许第三方固件驱动加载。
  • 如果运行微软Surface设备，建议启用此选项

• RequestBootVarRouting: 是

  • 将AptioMemoryFix从EFI_GLOBAL_VARIABLE_GUID重定向到OC_VENDOR_VARIABLE_GUID。当固件试图删除启动项时需要启用，建议在所有系统上启用，以确保正确的更新安装，启动磁盘控制面板的功能等。

• UnblockFsConnect: 否

  • 一些固件块分区处理通过驱动模式打开它们，这导致文件系统协议无法安装。主要适用于没有列出驱动器的HP系统

ReservedMemory

用于免除操作系统对某些内存区域的使用，主要适用于Sandy Bridge igpu或内存故障的系统。在本指南中没有涉及这种选项的使用

清理

现在，您可以保存它，并将其放入EFI/OC下的EFI中。

对于那些有启动问题的人，请务必先阅读故障排除部分，如果您的问题仍然没有得到解答，我们有大量的资源供您使用:

• r/Hackintosh Subreddit (opens new window)
• r/Hackintosh Discord (opens new window)

Intel BIOS 设置

• 注意: 大多数选项可能不会出现在你的固件中，我们建议尽可能匹配，但如果这些选项在你的BIOS中不可用，不要太担心

关闭

• Fast Boot（快速启动）
• Secure Boot（安全引导）
• Serial/COM Port（串口/COM端口）
• Parallel Port（并口）
• VT-d (如果将DisableIoMapper设置为YES，则可以启用)
• Compatibility Support Module (CSM) （兼容性支持模块）(在大多数情况下必须关闭，当该选项启用时，像gIO这样的GPU错误/停顿很常见)
• Thunderbolt （雷电）(用于初始安装，因为如果没有正确安装，Thunderbolt可能会导致问题)
• Intel SGX
• Intel Platform Trust
• CFG Lock (MSR 0xE2写保护)(此选项必须关闭，如果你找不到该选项，则在Kernel -> Quirks下启用AppleXcpmCfgLock。你的黑苹果将无法在启用CFG-Lock的情况下启动)

启用

• VT-x
• Above 4G Decoding（4G以上解码）
  • 2020+ BIOS注意事项:当启用4g以上时，Resizable BAR支持可能会在一些Z490和更新的主板上可用。如果启用，请确保Booter -> Quirks -> ResizeAppleGpuBars设置为0。
• Hyper-Threading（超线程）
• Execute Disable Bit（执行禁用位）
• EHCI/XHCI Hand-off（EHCI/XHCI切换）
• 操作系统类型:Windows 8.1/10 UEFI模式(一些主板可能需要”其他操作系统”代替)
• DVMT Pre-Allocated（DVMT预分配）(iGPU内存): 64MB或更高
• SATA模式:AHCI

完成后，我们需要编辑一些额外的值。访问苹果安全启动页面