²⁰¹⁹⁄₇ 更新

八代同方机型 Z7(m)-KP7/5GZ(GC, EC) 和部分九代同方机型 Z7-CT7GK, G7-CT7VK 可以直接使用下面的 Clover 配置文件安装：https://github.com/kirainmoe/hasee-tongfang-macos .

EFI 配置文件替换教程参见 GitHub Wiki.

以下内容可能已经过时。

RT. 这篇文章主要用来记录一下这个机型安装 macOS 的一些要点和注意事项。

以下内容基于神舟战神 Z7-KP7GZ (i7-8750H + GTX1060) 版摸索得到，安装的 macOS 版本为 Mojave (10.14.2).该文章理论适用于使用该模具的其它机器，如 Z7m-KP7GZ / Z7m-KP5GZ.

国际惯例先上张图：

虽然目前关于该机型的黑苹果资源较少，但因为神舟战神 Z7-KP7GZ 及其同系列的机型都是同方模具，并且和机械革命 Z2/Z2Air/X8Ti 都是同款模具，所以这些机型的一些资源我们可以直接拿来用。整体完成度的话大概接近 95%.

Info

先贴一发机器配置：

Type	Model
CPU	Intel Core™ i7-8750H
GPU	Intel UHD630 / Nvidia GTX1060
RAM	8GB
Wireless	Intel AC9560
Ethernet	Realtek RTL8168H
Audio	Realtek ALC269vc

Preparation

首先镜像文件是肯定需要的啦，这里推荐下载黑果小兵集成 Clover 的镜像，或到远景论坛下载 Len’s DMG. 注意，不推荐使用任何“X苹果乐园”的镜像。

同时下载 TransMac 用于写入镜像。注意写入镜像需要一个 8GB 以上的 U 盘。

驱动 Z7-KP7GZ 用到的相关 Kext, Patch 等文件都可以在 https://github.com/kirainmoe/hasee-z7-kp7gz-macos 找到。建议在一个有线网络的环境下安装，或者提前下载好所有需要的东西。

What’s working

以下部分是已经完美或者部分工作的：

• CPU 变频、睿频
• UHD630 核显
• RT8168H 有线网卡
• ALC269vc 声卡
• 亮度调节和小太阳快捷键
• 电池
• 触摸板
• 蓝牙（需要热启动）
• USB3.0
• 睡眠
• etc.

What’s not working

以下部分是工作不正常或无解的：

• 独显 GTX1060 (1. BIOS 不支持禁用核显；2. Nvidia 没有推出 10.14 可用的 WebDriver)
• 无线网卡 AC9462 (Intel 嘛……你知道的，全球无解……)

Details

接下来记录一些安装细节和几个常见的问题的解决方案。

关于 CoffeeLake UHD630 和亮度调节

首先，CoffeeLake 的 UHD630 驱动难度不大，部分是白果原生支持的。以往需要注入 ig-platform-id 或者给 Framebuffer 打补丁来驱动 CoffeeLake 的核显，现在驱动只需要使用 Lilu + WhateverGreen 即可。

8 代平台的 UHD630 驱动下比较经常遇到的问题是开机跑完条后黑屏 3 分钟的问题。对此新版本的 Lilu 和 WhateverGreen 已经解决了这个问题。将上述两个 kext 的最新版本（或者上文链接提供的版本）放到 Clover 的 Kexts 文件夹中，然后编辑 Clover 的引导配置文件 config.plist:

• 去除勾选 Clover FixMask 中的 Add PNLF
• 在 Boot Args 中添加 igfxcflbklt=1 参数
• 在 Devices/Properties 中添加 enable-cfl-backlight-fix 项，数值为 01000000, 类型为 DATA.

但是，使用上面的方法有个缺点，就是能解决开机黑屏，但是不能调节亮度，因为调节亮度需要 PNLF. CoffeeLake 需要特定的 SSDT-PNLF 补丁 SSDT-PNLFCFL.aml, 将其放入 ACPI/patched 中。在 Clover 的 Boot Args 中去掉 igfxcflbklt=1 的参数，安装最新 lilu / WhateverGreen / AppleBacklightFixup 三个驱动，然后都 Clover ACPI 的 SortOrder 中添加 SSDT-PNLFCFL.aml，保存，重启，就可以调节亮度了。

关于亮度调节的小太阳快捷键：需要外接一个 USB 键盘，然后到设置——键盘——快捷键中，左侧会出现一个“显示器”的项，修改热键为你喜欢的键即可。注意修改为 Fn+F11, Fn+F12 时似乎无效。此外快捷键还可以用其它内核拓展驱动来解决。

关于电池

电池的话一般使用 Clover Hotpatch 给 DSDT 打补丁来解决。然而，在我尝试驱动该电池的时候，我发现 Z7-KP7GZ 的电池 ACPI 部分和机械革命 X6Ti 的电池 ACPI 部分惊人的相似，而且 MaciASL 的补丁源中就提供了 X6Ti 的电池补丁，补丁的重合度非常高，因此稍作修改即可使用。所以这里是通过给 DSDT 打补丁的方法来驱动的。电池补丁的内容在上文提供的 GitHub 链接中的 dsdt-patch.txt.

系统安装完成后，使用 Clover 按 F4 提取 DSDT，进入系统下载并打开 MaciASL，打开你提取的 DSDT（位于 /EFI/CLOVER/ACPI/origin 中），点击上方的 Patch，找到本仓库内的 battery-patch.txt，将里面的内容粘贴到 Patch 中，然后点击 Apply 应用即可，检查并编译没有错误后，保存新的 DSDT 到 patched 目录中。记得配合 ACPIBatteryManager.kext 使用哦。

关于声卡

ALC269vc 虽然可以直接使用 VoodooHDA 驱动，但是呢需要手动切换外放和耳机，不是太完美（如果不想折腾可以直接 VoodooHDA 2.9.1 走起），因此考虑使用 AppleALC 仿冒来驱动。经过测试，使用最新版 AppleALC (在 1.3.4 测试可用)下，Clover 注入 layout-id 为 88 即可（注入 ID 需要在 Devices->Audio 或 Audio turning 中把 Inject 的 layout-id 设置为 88，同时 Properties 中也要设置 layout-id(ps2. 注意不是#layout-id，没有 # 字符) 值为 88）。外放、耳机、麦克风均正常。

关于触摸板

Z7-KP7GZ 使用的是 I2C HID 的触摸板，需要 VoodooI2CHID.kext 和 VoodooI2C.kext 两个内核扩展来驱动。安装这两个内核扩展之后，就可以使用触摸板和手势了，支持的手势和 Windows Precision 差不多，除了从右向左滑打开通知中心之类的无法实现之外。不需要 AppleSmartPS2Touchpad.kext 驱动。 现在使用 SSDT 仿冒触摸板可以驱动大部分手势。

需要注意的是，要设置触摸板手势的话，需要先驱动电池。虽然我也不知道这是什么操作，总之搞就完事了。没有驱动电池的话打开触摸板设置会提示你找不到触摸板并搜索蓝牙触摸板；如果没有设置，默认辅助点按等等手势是不可用的。

关于网络/蓝牙

因为 Z7-KP7GZ 喜闻乐见地用了 Intel 家的无线网卡，是全球无解的，所以如何联网也是我们比较头疼的地方。

1. 有线网络。幸运的是 Z7-KP7GZ 的有线网卡使用的是比较大众的 Realtek RT8168H, 驱动得比较完美，所以如果不介意牵着根线连电脑的话有线网络一定是最好的选择；
2. 更换无线网卡。这台机器没有网卡白名单，所以只要某宝找一块免驱的无线网卡就行，推荐博通的无线网卡；可能需要安装额外的 fix 驱动，具体自己爬远景好了；
3. 使用 USB 网卡。尽量选择容易驱动或者免驱的 USB 网卡，不推荐选择小米/360/小度之类的迷你 WiFi 网卡，虽然用的都是同一个芯片，kext 在 10.14 下可以安装，但是网络管理软件 Wireless Utility 无法在 10.14.1+ 运行；并且也不太稳定；
4. 使用蓝牙共享网络。虽然这块无线网卡附带的蓝牙在 macOS 下也是半残状态，但好歹还能工作，所以凑合用吧；偶尔会碰到共享网络连接失败的情况，似乎全看玄学；
5. 使用 USB 共享网络。Android 机福利，安装一个叫做 HoRNDIS 的驱动就让 Android 手机与 mac 通过 USB 共享网络。

PS1. 对于方案 3 使用小米/360/小度等的用户，虽然在 10.14.1+ 系统无法打开 WirelessUtility, 但是可以用 BearExtender 代替，只是稳定性没有那么好而已。

关于蓝牙：虽然基本可用，但是不太稳定，只能用半残来形容了= =

关于 CPU 变频和睿频

8 代 CPU 算是比较容易驱动的，直接使用 MacBook 15,1 的 SMBIOS 即可（也就是 Macbook Pro 2018, 15-inch），自带从 1.3GHz-4.1GHz 的 16 档变频。因为 8750H 的默频是 2.2GHz，能上到 4.1GHz 说明睿频也是正常的。

关于睡眠

正常的睡眠功能需要正确驱动 USB，注入 USB Connector 的信息，并且打上 USB _PRW 的补丁。这台机器上比较特殊，必须要给 GLAN/XDCI/HDAS/CVNW 下的 _PRW 全部修改或者删除才可以正常睡眠，否则会一睡眠就立刻唤醒……（天知道为了解决这个问题我花了多少天、爬了多少的帖子……）使用仓库中的 dsdt-patch.txt 同时可以解决睡眠立刻唤醒 (instant wake) 的问题。

如果还有无法让睡眠工作的，可以在文章下评论让我知道。

---

以上差不多就是这台机型的安装要点。还有一些问题没有解决。解决之后或者说想到什么别的再来补充~