实战OpenCore之ACER4738G

青青子矜

未经本人同意不得转发

OpenCore是最近兴起的在PC机上引导MacOS系统的新程序。在非常顺利地引导了ASUS_Z370-P +8700k+Vega56台式机之后，开始折腾ACER4738G，这笔记本已经老掉牙了，i380m的CPU，ATI 6370M显卡。运行的系统是MacOS10.13.6。
11月24日
除了将FakeSMC.kext替换成VirtualSMC.kext之外，其他驱动一概平移到OC中。
本次使用特意用了个U盘做OC引导，选用了SampleFull.plist作为Config.plist的模版。
第一步，就是按照模版补全SMBIOS信息，不是一般的费时间。
第二步，编辑efi文件和Kext驱动的信息，这里要注意的是VoodooPS2Controller.kext这个驱动套件，它的Plugins里还有三个驱动，我们就需要再添加三项，并注意在绑定驱动路径时，BundlePath这一项直接写全路径，比如这样写：

• VoodooPS2Controller.kext/Contents/PlugIns/VoodooPS2Keyboard.kext
  

[color=rgb(34, 101, 169) !important]复制代码
之后的ExecutablePath和PlistPatch，都是相对于这个路径的。也就是基本上按照原格式写就行了。千万别写错啊，否则OC会卡在那里的。

因为是传统BIOS，U盘的EFI分区直接放进OC引导文件是不能启动系统的。所以需要使用OC提供的Bootinstall工具。打开终端，将Bootinstall.command拖进终端，按照提示，键入U盘的Disk id号。继续按提示操作。


然后把Bootinstall提供的boot文件复制到U盘的EFI分区（不是里面的EFI文件夹）。
重新开机，选择U盘引导，见证奇迹的时刻到了——

• OCS: No Schema for RequestBootVarFallBack at 9 index!
• OCS: No Schema for UnBlockFsConnect at 12 index!
• OC: Configuratuin requires vault but no vault provided!
  

系统启动失败。究其原因是传统BIOS需要对config.plist做一些特别设置。

• NVRAM——>LegacyEnable—>YES
• Misc——>Security——>RequireSignature——>NO
• Misc——>Security——>RequireVault——>NO
  

至此，可以进入系统，并能对付使用了。
剩下一个最大的问题就是6370M显卡驱动问题，Clover里有专门的ATIConnectors配置选项，OC里没有，不知道可不可以平移过来，我尝试使用Path方式无效。另一个问题是无线网卡。
首次尝试到此告一段落。
11月28日

驱动无线网卡，去掉笨重的DSDT。
同时，此网卡设备并没有体现在机器的ACPI中，dsdt中唯独缺少0x001c0005这个硬件位置，但是用其他工具能找到这个硬件位置，并且系统识别无线网卡的设备ID为PCI68c,2e。苹果无线网卡驱动中没有pci168c,2e这个ID，所以必须仿冒为pci168c,2a。
原来的做法是在DSDT中添加这个设备，不过用了OC，觉得加载DSDT有点说不过去，所以做了个无线网卡的SSDT。

1. DefinitionBlock ("", "SSDT", 1, "qingqing", "AR92xx", 0x00000000)
   
2. {
   
3. External (_SB_.PCI0, DeviceObj)
   
4. 
   
5. Scope (\_SB.PCI0)
   
6.     {
   
7.     Device (AIRP)
   
8.     {
   
9.         Name (_ADR, 0x001C0005)
   
10.         Device (ARPT)
    
11.     {
    
12.     Name (_ADR, Zero)
    
13.     Name (_SUN, 0x03)
    
14.     Method (_DSM, 4, NotSerialized)
    
15.              {
    
16.                 Store (Package (0x10)
    
17.                            {
    
18.                             "AAPL,slot-name",
    
19.                             Buffer (0x08)
    
20.                            {
    
21.                                "AirPort"
    
22.                             },
    
23. 
    
24.                             "device-id",
    
25.                             Buffer (0x04)
    
26.                             {
    
27.                              0x2A, 0x00, 0x00, 0x00                        
    
28.                             },
    
29. 
    
30.                             "compatible",
    
31.                              Buffer (0x0B)
    
32.                             {
    
33.                             "pci168c,2a"
    
34.                             },
    
35. 
    
36.                            "IOName",
    
37.                            Buffer (0x0B)
    
38.                            {
    
39.                                 "pci168c,2a"
    
40.                             },
    
41. 
    
42.                             "name",
    
43.                             Buffer (0x28)
    
44.                             {
    
45.                                 "Atheros AR5B97 Wireless Network Adapter"
    
46.                             },
    
47. 
    
48.                             "device_type",
    
49.                             Buffer (0x10)
    
50.                             {
    
51.                                 "AirPort Extreme"
    
52.                             },
    
53. 
    
54.                             "model",
    
55.                             Buffer (0x28)
    
56.                             {
    
57.                                 "Atheros AR5B97 Wireless Network Adapter"
    
58.                             },
    
59. 
    
60.                             "built-in",
    
61.                             Buffer (One)
    
62.                             {
    
63.                                  0x01                                          
    
64.                             }
    
65.                         }, Local0)
    
66.                     DTGP (Arg0, Arg1, Arg2, Arg3, RefOf (Local0))
    
67.                     Return (Local0)
    
68.                 }
    
69. 
    
70.                 Method (_STA, 0, NotSerialized)
    
71.                 {
    
72.                     If (_OSI ("Darwin"))
    
73.                     {
    
74.                         Return (0x0F)
    
75.                     }
    
76.                     Else
    
77.                     {
    
78.                         Return (Zero)
    
79.                     }
    
80.                 }
    
81.             }
    
82.         }
    
83. 
    
84.         Method (DTGP, 5, NotSerialized)
    
85.         {
    
86.             If (LEqual (Arg0, ToUUID ("a0b5b7c6-1318-441c-b0c9-fe695eaf949b")))
    
87.             {
    
88.                 If (LEqual (Arg1, One))
    
89.                 {
    
90.                     If (LEqual (Arg2, Zero))
    
91.                     {
    
92.                         Store (Buffer (One)
    
93.                             {
    
94.                                  0x03                                          
    
95.                             }, Arg4)
    
96.                         Return (One)
    
97.                     }
    
98. 
    
99.                     If (LEqual (Arg2, One))
    
100.                     {
     
101.                         Return (One)
     
102.                     }
     
103.                 }
     
104.             }
     
105. 
     
106.             Store (Buffer (One)
     
107.                 {
     
108.                      0x00                                          
     
109.                 }, Arg4)
     
110.             Return (Zero)
     
111.         }
     
112.     }
     
113. }

复制代码

然后把这个SSDT添加到OpenCore配置中。至此，无线网卡驱动成功。
同时对系统ACPI做了优化，解决了睡眠唤醒、电池显示问题。

12月6日

考虑到OpenCore里可以为设备注入属性，所以再次调整无线网卡驱动方案，只在SSDT里为无线网卡添加设备位置。

1. DefinitionBlock ("", "SSDT", 1, "qingqing", "AR92xx", 0x00000000)
   
2. {
   
3.     External (_SB_.PCI0, DeviceObj)
   
4.     Scope (\_SB.PCI0)
   
5.     {
   
6.         Device (AIRP)
   
7.         {
   
8.             Name (_ADR, 0x001C0005)
   
9.             Device (ARPT)
   
10.             {
    
11.                 Name (_ADR, Zero)
    
12.                 Method (_STA, 0, NotSerialized)
    
13.                 {
    
14.                     If (_OSI ("Darwin"))
    
15.                     {
    
16.                         Return (0x0F)
    
17.                     }
    
18.                     Else
    
19.                     {
    
20.                         Return (Zero)
    
21.                     }
    
22.                 }
    
23.             }
    
24.         }
    
25.     }
    
26. }

复制代码

然后用OC注入属性。


12月22日

从使用OpenCore开始就一直为AMD Radeon HD 6370M显卡的驱动方法所困扰。在Clover时代，AMD显卡的驱动方式大致是这样几种：

• InjectATI，让Clover检测并注入显卡信息，也可以使用SSDT注入。
• LoadVBios，载入AMD显卡rom。所有正确驱动的AMD显卡都会载入VBios，但是有些无法自动载入的，就需要强制注入VBios数据。
• ATIConnectorsDataPatch，修复AMD显卡的显示接口的缓冲帧数据，指定FBName。
  

这几种方式有时需要联合使用。但是如果厘清了显卡的驱动机制，在OpenCore下只需要用设备属性注入或SSDT两种方式之一就可搞定。

一、通过OC的DeviceProerties设备属性注入修复AMD显卡。

这种方式基本上抛弃了DSDT的修补和SSDT的使用。下面结合AMD6370M的实例进行讲解。

图1

首先确定显卡的PCI位置，比如我的是这样：_SB.PCI0.P0P2.PEGP
那在DeviceProerties的Add下添加如下的设备驱动目录

• PciRoot(0x0)/PCi(0x1,0x0)/Pci(0x0,0x0)
  

一般会是这个样子，也有的会多好几层的，自己用IOReg或Hackintool看一下在做确定。比如在ASUS Z370-P主板上，后边就多了两层。

图2
在IOReg里查看是图3的样子

图3
我的意思是你要根据自己机器的具体情况具体分析，拿过来别人的直接用，成功是幸运。

然后我们在这个新建的设备属性组里注入具体数据。我一条一条讲解；

1、device-id （data）指定显卡id，对于仿冒特别需要。如果你的显卡id在AMD的显卡驱动里有，device-id属性就不是必须注入项。

2、@0,name  （String）
重点之一，指定显示接口的FBName。我的显卡有3个显示接口，LVDS/HDMI/VGA，那我可以写3个，“@0,name”、“@1,name”、“@2,name”。当然只想用一个也行。不管是@几，FBName都是哪一个。
FBName的确定需要一个PHP脚本工具ATI_FrameBuffers_Edutuin.php
ATI_FrameBuffers_Edition.php.zip (1.51 KB, 下载次数: 23)
打开终端写上命令php 然后把脚本拖进去回车。

图4
10.15下，这个脚本工具好像有点问题，但不影响，这个工具以前的帖子有介绍，有需要的自己搜一下。

如果不做缓冲帧修补，其实不用这么麻烦，你到S/L/E里找自己显卡的驱动文件，里面的info.plist文件里都有FBName的定义。

使用万能的WhateverGreen.kext有个问题，他会使用默认的FBName，就是没有名字。我估计可能对性能有影响，比如电源管理加速什么的。因为翻看AMD的相关驱动，不同的FBName参数都是不同的，那个没名字的默认设置里也有一些参数。

3、@0,connector-type  （String）
（图1上后几个打错了，少了个C）
指定接口类型，是DP还是HDMI，就在这里写。我的@0是LDVS，所以后面写上02，HDMI写01。
一般情况这个connector-type可以不写，系统会检测到的。只要系统能载入ATY,bin_image数据就能检测到。

图5

4、VRAM,totalsize  （Numbr或data）
重点之二，指定显存大小。可以用Number型数据格式写，比如你是1024MB，就写1024。 我填的是data型的数据。
这个数据在系统不能载入ATY,bin_image时有效，而且有些许的顺滑作用，但是当载入ATY,bin_image时，这个参数就不起作用了。

5、ATY,bin_image  （data）
重点之三，这一项相当于CLover里的LoadVBios，就是载入显卡rom。非必须，但是能解决特殊问题。
成功驱动的显卡，都会载入ATY,bin_image数据的。载入不进来，那就只有强行注入了。
ATY,bin_image 和显卡的rom 数据还是有些不一样的。怎么提取，怎么修正这里略过。

6、ATY,RevID   （data）
防止花屏用的（一般是唤醒花屏），非必需品。

7、model   （String）
指定显卡的名称，在关于本机里显示。

8、AAPL,slot-name （String）
这一项是显示PCI插槽信息的，如果写上，会在关于本机的PCI里显示设备信息。我没有填写着一项，所以pci信息里就像白苹果一样干净。

最后，得到的结果就是这样：

图6

忘记在OC中做PEGP to GFX0了（不要和下面讲的混淆哦）。

关于A卡的属性还有其他值，限于能力不做探讨。

下图是我为Vega56做的属性注入。

图7
下图是为Vega56显卡注入FBName后IOReg信息。

图8

二、使用SSDT驱动显卡。
这里我提出一种使用SSDT实现PEGP to GFX0的方法，不需要做ACPI的重命名。
这一部分是使用SSDT驱动显卡，和上面讲的无关，但可以联合使用。

无论是Clover还是OpenCore，都有为ACPI重命名的功能。使用SSDT的方式处理PEGP to GFX0的基本思路就是让ACPI里的PEGP失效。
别误会，如果单单是为了PEGP to GFX0，就不需要使用SSDT这么折腾，我们的目的是要做一个全新的GFX0。

图9

我这个做的比较狠，原始的ACPI是这样的

图10
因为如果单独让PEGP失效的话，系统会去找下一个VGA，会去驱动VGA（图10，新主板一般不会遇到这种麻烦）。所以我直接让P0P2整体失效。然后我在做一个GFX0驱动。这样就达到了PEGP to GFX0的效果。
再建的设备驱动就不能是P0P2了，必须换一个名字，随你喜欢。如果你非要用P0P2，那你需要在Clover/OC里先把P0P2改名，
这样就多此一举了。

怎么让P0P2失效，就是使用_STA方法让原来的P0P2返回一个Zero，就像图9中的那样。当然，如果只使用苹果系统，就不需要用If做OSI判断，直接Return (Zero)，写成这样：

• Scope (\_SB.PCI0.P0P2)
•     {
•         Method (_STA, 0, NotSerialized)
•          {
•             Return (Zero)
•          }
•     }
  

这样做的好处在于，原来的ACPI设备驱动方法，不会再干扰我们的设备属性注入了。

特别说说明，如果你的ACPI是下图这样，你才需要让PEGP失效。

图11
图11里的PEGP，是开启状态，无论你是否给他改名，系统都会向里面注入信息的。你可能直接驱动成功，但是要做修补就是个麻烦。
我最开始还使用过一个比较笨的办法，就是用二进制补丁，强制把这行代码改成了，Name (_ADR, Zero)。也是为了防止他的干扰。

现在的大多数主板的ACPI一般是这样的：

图12
这个就没有必要了。直接在SSDT里定一个GFX0就可以了。
那么主要的问题是你GFX0到插到了哪里，

像图13这种情况，他就应该是
_SB.PCI0.PEG0.PEGP.XXX.GFX0
定义的时候，XXXX自行确定，其实随意。

三、对于AMD显卡显示接口的修正在CLover时代有专门的ATIConnectorsDataPatch项来对内核驱动打补丁。在OpenCore下，直接使用Kernel下的Patch项目处理就行。

总结，黑苹果引导程序OpenCore比起Clover，逻辑严谨、结构明晰、简洁高效，但需要对电脑的ACPI有一定的了解，难度大了些，但是能让你对电脑有更深入的认知。

青青子矜

三、AMD显卡显示接口修正


由于品牌与型号的差异，我们使用的显卡多不是苹果定制的类型，这就会出现与苹果显卡的显示接口不一致的问题。
虽然WhateverGreen.kext能很好地适配显示接口，但WEG这个驱动有个天生的缺陷，不能指定FBName。FBName的作用我理解是能更好地发挥显卡的效能，毕竟一个驱动要适配几种型号的显卡及不同机型，这区别就在FBName上，实际应用也验证了我的猜测。
有个问题，FBName同时定义了显卡的显示接口及顺序，一旦在OC或Clover中指定了显卡的FBName，就有很大的概率出现某个或某几个显示接口不能使用或不正常的问题，不论你是否使用了WEG驱动。

（在翻阅10.13.6/10.14.5/10.15.2的AMD10000时，发现里面的FBName在逐渐增多，由原来的Vega10/vega12增加到了Vega20等等，原来Vega56/64被定义为Radeon Pro，后来变成了Radeon RX，而Vega64FE/w9100才是Radeon Pro，这也就是为什么丢功能集问题的由来。）
猜测FBName是分显卡型号的，有某种对应关系，但是具体我们不是很清楚，只能一个一个地试。

比如蓝宝石Vega56超白金OC板的显示接口为DP/DP/HDMI/HDMI，这个在AMD10000驱动的定义中是没有的。
通过筛选，AMD10000的驱动中只两个比较接近并可以使用的FBName。
Kamarang (4) DP, DP, DP, HDMI
Iriri (4)   DP, DP, DP, HDMI



这是指定FBName后的结果，我们看到@2接口被Kamarang定义成了DP（就是右边显示的connector-type 0x400)，这与实际的接口HDMI是不一致的。@2这个端口就不能用了。

在强迫症的驱使下，我决定对@2接口进行修正。首先我们通过ATI_FrameBuffers_Edition.php这个php脚本得到接口的缓冲帧数据，我提取了两个，
Kamarang (4) DP, DP, DP, HDMI
000400000403000000010101000000002205020200000000
000400000403000000010201000000001204010100000000
000400000403000000010300000000001000050500000000
000800000402000000010400000000002001060600000000
还有Iriri (4) DP, DP, DP, HDMI 与Kamarang一模一样

据此我猜测，要让FrameBuffers数据变成DP,DP,HDMI,HDMI，大致是这个样。
Kamarang (4) DP, DP, HDMI, HDMI
000400000403000000010101000000002205020200000000
000400000403000000010201000000001204010100000000
000800000402000000010300000000001000050500000000
000800000402000000010400000000002001060600000000

按颜色分组说明一下各部分的意思。

00080000	04020000	0001	0300	0000000	20	01	06	06	00000000
接口类型	控制标志	显示特征	占位符		发射器	解码器	热插拔ID	检测ID

整理一下，需要查找的数据是
000400000403000000010300000000001000050500000000000800000402000000010400000000002001060600000000
替换成
000800000402000000010300000000001000050500000000000800000402000000010400000000002001060600000000

现在把得到的数据做成补丁，写到kernel的patch里。


重新启动电脑，显卡接口修正成功。

插上HDMI显示器，可以正常输出了。