黑苹果OpenCore引导总结

前言

众多黑苹果驱动的作者已经停止对Clover的兼容支持，改向Opencore的兼容。所以也许在未来的某一天，Clover就越来越难用了。提前了解了解OpenCore，还是很有必要的。但是OpenCore毕竟没有Clover成熟，同样也没有很好用的可视化编辑器（OpenCore Configurator会导致config出错，慎用），fix的选项也没有，对hotpatch的要求就高了。经过一周的摸索，总结一些OC的坑，帮助以后的朋友少走一些弯路。

系统10.15.1→10.15.3自动更新顺利。之后升级OpenCore版本出现问题，0.5.2→0.5.5，卡驱动。找到问题后在文章中增加版本更新方法，需要可以研究一下。

我的配置

雷 神 G170P 笔 记 本，蓝 天(CLEVO)P170SMA模 具
CPU：Core i7-4710MQ 2.50GHz
主 板：CLEVO P17SM-A
硬 盘：威刚SSD 256GB
内 存：16 GB ( 威 刚 DDR3L 1600MHz )
显 卡：Nvidia GTX970M（DSDT屏蔽） Intel HD4600
有 线 网 卡：瑞 昱 RTL8168/8111/8112
无 线 网 卡：博通BCM94352HMB（原 装intel网 卡，无 解）
声 卡：Realtek ALC892

目录

一.准备工作
二.调试Config.plist
三.调试驱动
四.OpenCore更新

一、准备工作

准备工作分为以下几步：

①.在Clover引导下，正常运行macOS系统
②.BIOS设置
③.下载最新的OpenCore
④.安装Xcode或使用ProperTree
⑤.efi基础驱动
⑥.U盘或硬盘建立引导分区
⑦.确认电脑是否支持原生NVRAM

① 至少要先用Clover安装系统，并能够正常进入macOS系统，这样能测试OC能方便很多。如果零基础从OC直接安装系统，难度比较大。对于已经配置好Clover的，则需要精简EFI，把不必要的驱动，dsdt和ssdt删除。防止OC使用过程中不兼容导致的问题。

② BIOS设置
禁用
| Fast Boot |             | 快速启动 |
| CFG Lock |             | CFG锁 |
| VT-d |                     | Hyper Threading |
| CSM |                     | 兼容性支持模块 |

启用
| VT-x |                                | VT-x |
| Above 4G decoding |      | 大于4G地址空间解码 |
| Hyper Threading |           | 超线程|
| Execute Disable Bit |       | 执行禁止位 |
| EHCI/XHCI Hand-off |     | 接手EHCI/XHCI控制 |
|OS type:Windows 8.1/10|     |操作系统类型Windows8.1/10|

③ 下载最新的OpenCore
OpenCore-Releases：https://github.com/williambj1/OpenCore-Factory/releases
官方发布页下载的文件包里的Docs文件夹内的samplefull.plist改名为config.plist作为基础配置自己的OC。

④ 对于OC中Config.plist，Xcode是最好的选择。其次是ProperTree。
Plist Editor Pro会破坏结构，不能转换Base64.
OpenCore Configurator目前更新速度落后于OpenCore，因此会导致Config的损坏

⑤ efi基础驱动

• ApfsDriverLoader.efi 或 Apfs.efi      识别APFS分区

• FwRuntimeServices.efi     用来替换AptioMemoryFix.efi

• UsbKbDxe.efi     OC内置驱动不工作，可以提供Apple热键和FileVault的支持。卡OC引导界面，可以删除

• VirtualSMC.efi     配合VirtualSMC.kext使用，不能和FakeSMC.kext同时使用。

• VBoxHfs.efi 或 HFSPlus.efi     识别HFS分区，对于不能进入Recovery，需要使用HFSPlus.efi

• EmuVariableRuntimeDxe.efi     模拟NVRAM，对于没有原生NVRAM，需要此驱动（该驱动已和最新的FwRuntimeServices.efi合并，建议使用最新驱动)

将需要的驱动，放置在EFI——OC——Drivers中，同时在Config.plist——UEFI——Drivers添加efi驱动名

⑥ 使用硬盘工具新建一个esp(Fat16)新分区，空间不低于200MB来存放。U盘或硬盘分区都可以。我是在Windows中使用DiskGenius分的区。

⑦确认电脑是否支持原生NVRAM

打开终端输入：sudo nvram TestVar=HelloWorld然后输入密码
重启系统后输入：sudo nvram -p | grep 'TestVar'
如果显示：TestVar HelloWorld
说明原生支持NVRAM

二、调试Config.plist

OC的Config.plist与Clover的Config.plist结构有很大的不同，因此不能通用。整体结构以及说明参考黑果小兵:精解OpenCore和XJN`S BLOG:使用OpenCore引导黑苹果，以下主要说明容易出现的问题。OC中的config.plist是由Docs文件夹内的samplefull.plist改名而来。

①Misc—security—requiresignature—NO
防止出现报错：OC:configuration signed vault but no public key provided

②misc—security—requirevault—NO
防止出现报错：OC：configuration requires vault but no vault procided

③可以删除 #WARNING - 1 和 #WARNING - 2等

④Booter—Quirks—DisableVariableWrite—NO
禁止NVRAM写入，没有原生macOS支持NVRAM需要开启

⑤DeviceProperties—Add可以加入设备硬件地址以及补丁
可以使用Hackintool应用补丁生成设备硬件代码驱动硬件
例如：核显驱动、核显缓冲帧、EDID注入，声卡LayoutID注入、读卡器等等

注意：这里使用的代码与Clover的Config.plist中的Devices—Properties的代码通用

⑥OC上所有的kext、.efi驱动、.aml补丁都需要填入config.plist，并且都有加载顺序，有依赖的驱动要放在所依赖的驱动之后。

注意：Kernel—Add  按加载顺序加入kext名称
            ACPI—Add  按加载顺序加入.aml名称
            UEFI—Drivers  按加载顺序加入.efi驱动名称

⑦Kernel—Quirks—XhciPortLimit: YES
USB的15个端口限制补丁，建议定制USB后关闭该选项

⑧Misc—Boot—ShowPicker: YES
显示OpenCore的UI，可选引导项。

⑨NVRAM—LegacyEnable: NO
允许将 NVRAM 存储在 nvram.plist 中, 没有原生 NVRAM 的设备必须开启

⑩NVRAM—7C436110-AB2A-4BBB-A880-FE41995C9F82—csr-active-config： bytes = 0xe7030000 - SIP 完全关闭

⑪设置默认语言为中文，在NVRAM—7C436110-AB2A-4BBB-A880-FE41995C9F82—prev-lang:kbd中填入<7a682d48 616e733a 323532>（需要NVRAM支持，不支持原生NVRAM或者没弄好模拟NVRAM不生效）

⑫Misc—Security—AllowNvramReset：YES
在OC引导界面显示 Reset NVRAM选项

注意：如果用Clover启动过系统后，再用OpenCore启动系统，需要执行Reset NVRAM来清除NVRAM。清除NVRAM，会清除BIOS自定义引导项名称。

⑬Misc—Security—ScanPolicy：0
在OC引导界面显示所有可用硬盘

定义：
（01）0x00000001 — 限定为文件系统，由以下允许扫描文件系统子项开启
（02）0x00000002 — 限定为设备类型，由以下允许扫描设备类型子项开启
允许扫描文件系统子项：
（03）0x00000100 — 允许扫描APFS文件系统
（04）0x00000200 — 允许扫描HFS文件系统
（05）0x00000400 — 允许扫描EFI系统分区文件系统
允许扫描设备类型子项：
（06）0x00010000 — 允许扫描SATA设备
（07）0x00020000 — 允许扫描SAS和Mac NVMe设备
（08）0x00040000 — 允许扫描SCSI设备
（09）0x00080000 — 允许扫描NVMe设备
（10）0x00100000 — 允许扫描CD / DVD设备
（11）0x00200000 — 允许扫描USB设备
（12）0x00400000 — 允许扫描FireWire设备
（13）0x00800000 — 允许扫描读卡器设备
扫描策略数值=（01）+（02）+1个或数个允许扫描文件系统子项+1个或数个允许扫描设备类型子项
例如：希望扫描对象是APFS文件系统的USB设备，扫描策略数值=（01）+（02）+（03）+（11），经16进制加法计算得出，扫描策略数值=0x200103。
注意，使用时需将16进制转换为10进制。示例最终扫描策略数值=2097411

⑭ACPI—Patch放入dsdt、ssdt补丁
Kernel—Patch放入kext补丁

⑮PlatformInfo中直接删除Datahub,PlatfromNVRAM,SMBIOS这三项，无需填写。

⑯IgnoreInvalidFlexRatio: YES
(在 BIOS 中无法禁用 MSR_FLEX_RATIO(0x194) ，或OpenCore卡引导项时开启)

注意：部分OpenCore卡引导项，是由于UsbKbDxe.efi与键盘不兼容导致的，删除UsbKbDxe.efi即可

三、调试驱动

以我自身的驱动来说明

驱动目录

①建议使用VirtualSMC.kext，因为需要与Drivers中的VirtualSMC.efi配合
②建议定制USB驱动，如自定义的USBInjectAll.kext、USBPorts.Kext、或加载SSDT-UIAC
③建议定制声卡驱动，虽然万能声卡驱动也支持OC
④VoodooPS2Controller.kext与ApplePS2SmartTouchPad.kext中存在插件kext，在Config.plist中Kernel—Add分别加入
⑤.kext中没有驱动，只有info.plist的，Kernel—Add加入info.plist的path，不必加入kext的path。
⑥建议核显驱动使用Hackintool应用补丁生成核显代码、相关补丁以及EDID的注入，防止添加过多kext影响兼容性，同时定义CPU接口，方便加载HDMI视频音频

HD4600核显

四、OpenCore版本更新

写这篇文章时我的系统版本是10.15.1，OC是0.5.2。之后更新为10.15.3和0.5.5。
更新OpenCore版本需要注意以下四点：
①做好原有EFI的备份，config.plist—NVRAM—Add—7C4361......—boot-args中添加-v，更新时出错，可以及时发现问题

②下载最新OpenCore，替换原有EFI中的Bootx64.efi和OpenCore.efi

③最新OpenCore—Drivers找到需要的驱动，对原有EFI中的Drivers驱动进行替换
注：在0.5.5后Divers最新驱动已经合并到最新的OpenCore中

④查看最新OpenCore—Docs—SampleFull.plist中是否有更新，如有更新可以查看作者的说明进行修改，没有则直接使用之前的config.plist

---