macOS on Hasee Tongfang Laptops
用于神舟战神 8 / 9 代同方机型安装最新版 macOS （黑苹果）的 Clover/OpenCore 配置文件
Clover 配置文件下载地址 | 安装视频教程 | 帮助文档 | 更新日志 | English
✽ 如何使用 ✽
还没装好系统？
- 请按照 安装教学视频 里的指引安装好系统，并替换配置文件即可。
- 替换配置文件后，请按照此视频指导，使用 Clover Configurator 或更新脚本生成新的 SMBIOS 序列号、UUID，并执行以下优化脚本修复睡眠：
sudo sh -c "$(curl -fsSL https://aya-buildbot.kirainmoe.com/optimizer)"macOS 下安装/更新最新配置文件
使用更新脚本可以安装/更新最新配置文件。安装完系统后，在 macOS 的终端执行以下命令：
curl -fsSL https://aya-buildbot.kirainmoe.com/installer > inst && chmod +x ./inst && sudo ./inst手动下载和替换
你可以到 Aya Buildbot 下载对应机型的最新版本配置文件，然后按照《EFI 替换教程》 替换。
若想要使用 OpenCore 引导
可以前往对应机型带有 -opencore 后缀的分支，在 GitHub 页面点击 "Clone or Download" => "Download Zip" 下载最新版本。
✽ 导航 ✽
✽ 兼容情况 ✽
兼容的型号
| 模具代号 | 型号 | 分支 |
|---|---|---|
| GK5CN5X GK5CN6X |
Z7-KP7GZ Z7M-KP7GZ Z7M-KP5GZ Z7-KP7Z Z7M-KP7Z Z7M-KP5Z Shinelon Yao 7000 (炫龙 耀7000) Mechrevo Z2 Air (机械革命 Z2 Air) |
gk5cn6/5x-clover (Clover) gk5cn6/5x-opencore (OpenCore) |
| GJ5CN64 | Z7-KP7EC Z7-KP7GC Z7-KP7GA Z7-KP7GE Z7-KP7GH |
gj5cn64-clover (Clover) gj5cn64-opencore (OpenCore) |
| GI5CN54 | Z7M-KP7GC Z7M-KP5GC Z7M-KP7GA Z7M-KP5GA Z7M-KP7GE Z7M-KP5GE Z7M-KP7GH Z7M-KP5GH |
gi5cn54-clover (Clover) gi5cn54-opencore (OpenCore) |
| GK7CP6R | Z7-CT7GK Z7-CT7VH G7-CT7VK Z7-CT7VA |
gk7cp6r-clover (Clover) gk7cp6r-opencore (OpenCore) |
| GK5CP6X | Z7M-CT7GS Z7M-CT5GA Mechrevo Z2 Air-G (机械革命 Z2 Air-G) |
gk5cp6x-clover (Clover) gk5cp6x-opencore (OpenCore) |
不兼容的型号
请注意，本仓库只适配使用因特尔第 8 代和第 9 代标压酷睿处理器、使用清华同方模具的笔记本，故以下机型不能正常使用此配置文件，包括但不限于以下机型：
| 型号 | 原因 |
|---|---|
| Z7(m)-KP7/5GT Z7(m)-KP7D2 Z7(m)-KP7/5GS |
使用同方七代以下模具 |
| Z7(m)-CT7/5N* Z7-C7TPro Z7(m)-KP7/5S* Z7(m)-KP7/5D1 Z7(m)-SL* |
使用蓝天笔记本模具 |
| ZX7* GX7* |
使用蓝天桌面模具 |
| K6*0*-**** Z7-i7* |
使用蓝天模具或为四代以下平台 |
| 精盾 U45S1 精盾 U47T1 ... |
使用广达模具 |
对于上述机型，可以到百度、远景或此仓库尝试找到对应模具/机型的 EFI.
兼容的 macOS 版本
注意：因为维护者不再测试旧版系统，故未来的配置文件可能随时停止对 macOS 10.14 (Mojave) 和 macOS 10.13 (High Sierra) 版本系统的支持。
当前版本配置文件的系统支持表如下：
| 版本号 | 版本代号 | 是否理论兼容 | 维护者实机测试正常 | 用户实机测试正常 |
|---|---|---|---|---|
| 10.13.6 | 17G65 | ❌ no | - | - |
| 10.13.6 ~ 10.14.5 | 17G2112 ~ 18F132 | 🔒 deprecated | ❓untest | ❓untest |
| 10.14.6 | 18G87 | ✅ yes | ✅ yes | ✅ yes |
| 10.15 | 19A603 | ✅ yes | ✅ yes | ✅ yes |
| 10.15.1 | 19B88 | ✅ yes | ✅ yes | ✅ yes |
| 10.15.2 | 19C57 | ✅ yes | ✅ yes | ✅ yes |
| 10.15.3 | 19D76 | ✅ yes | ✅ yes | ✅ yes |
✅ yes：当前版本的配置文件在该系统版本下测试通过，各种功能符合预期
🔒 deprecated: 配置文件曾经兼容此版本系统，但现阶段无人测试；且未来可能不再兼容该版本
❓untest：没有用户或开发者在此设备上测试
❌no：配置文件不兼容此版本
✽ 设备驱动情况 ✽
以下为维护者个人电脑的配置详情，以及对比原机的配置。
| Component | Model | Comment |
|---|---|---|
| CPU | Intel Core(TM) i7-8750H | i5 版本与 i7 版本的型号可兼容同一套配置文件 |
| GPU | Intel UHD630 Nvidia GTX1060 |
Nvidia 独显无法驱动，原因详见这里 |
| RAM | Micron Crucial 8GB+8GB | |
| NVMe | WD Black SN750 NVME SSD 500G | 请不要购买三星 PM981(a) 等 macOS 不支持的硬盘 |
| SATA SSD | Phison SATA SSD 128G | |
| Wireless | BCM94360CS2 | 原机自带的 Intel AC9462/AC9560 无法在 macOS 下驱动 |
| Ethernet | Realtek RTL8168H | |
| Audio | Realtek ALC269vc |
正常工作的功能
- CPU 睿频、变频
- 核芯显卡 Intel UHD Graphics 630
- 亮度调节
- 触摸板 (I2C, PS/2) [1]
- 有线网卡
- 声卡 (扬声器、耳机、麦克风) [2]
- 原生电源管理、电池状态
- USB 3.0, Type-C
- Intel 蓝牙 [3]
- 睡眠 [4]
- Fn 快捷键 [5]
- 摄像头
注：
[1] GJ5CN64 / GI5CN54 系列模具的 PS2 触摸板不支持 macOS 原生手势; I2C HID 触摸板可完美使用。
[2] 声卡使用 AppleALC 仿冒内建，通过设备属性的方式，注入layout-id为 29.
[3] 因特尔 AC9462/AC9560/AX200 无线网卡的蓝牙无需热启动即可加载固件。
[4] 睡眠需要在安装系统后人为执行优化脚本调节参数，执行方式参见上文。
[5] Fn 快捷键需要优化脚本安装守护程序支持，执行方式参见上文。
无法使用
- 独立显卡（目前已知没有任何解决方案）
已使用
SSDT-DDGPU.aml屏蔽了独显由于同方八代以上模具的 HDMI / miniDP 直接由无法驱动的独显输出，所以 HDMI / miniDP 也无法使用。
- 无线网卡（Intel AC9462 无解）
无线网卡无法使用的替代方案：
- 蓝牙共享网络
- USB共享网络 (HoRNDIS)
- USB网卡
- 更换无线网卡[推荐更换“BCM94360CS2 + 转接卡”方案]
由于 “隔空投送 AirDrop” 和 “接力 Handoff” 依赖于无线网络和蓝牙，所以此两项功能不可用。
- 读卡器（读卡器为 USB 2.0 外置通道，没有兼容驱动）
✽ 获取社区帮助 ✽
QQ 群
请确保你在群里问问题之前，已经看过了教学视频、并使用了搜索功能查找并仔细阅读了项目文档内的相关内容！
| 群名称 | 神舟战神黑苹果 1 群 | 神舟战神黑苹果 2 群 |
|---|---|---|
| 群号 | 833022235 | 815359928 |
| 加群二维码 |  |
 |
| 加群链接 | https://jq.qq.com/?_wv=1027&k=5G82zlQ | https://jq.qq.com/?_wv=1027&k=5b7ZJWl |
| 规模 | 1000 人群 | 500 人群 |
| 特殊限制 | 因人数爆满，暂需付费 1 元入群 | 仅限清华同方模具的 8/9 代机型用户加入 |
| 备注 | - | 新群人数较少，推荐新用户加入 2 群 |
联系我
当你有看了文档后仍然无法解决的问题、对配置文件的建议和改进，可以通过以下渠道联系我。
请注意，本仓库中的配置文件都是免费使用的，为了保护你的权益，建议你不要通过 任何渠道 以 任何价格 购买上述机型的配置文件。同时请认准维护者在以下平台的 ID：
✽ 贡献本项目与鸣谢 ✽
欢迎大家一起完善该系列机型的 EFI. 如果你认为这份配置文件有可以改进的地方，请注册一个 Github 账号，fork 本仓库自行修改后提交 Pull Request.
特别鸣谢
- 感谢 @Goshin 修复了 VoodooI2C 触摸板驱动的遗留问题、修复了九代同方机型无法使用 VoodooPS2Controller 驱动的问题、补充了 Fn 快捷键的功能。
- 感谢 @zxystd 提供了因特尔蓝牙驱动 IntelBluetoothFirmware.kext.
- 其它内核拓展和 SSDT 的作者，可在本仓库的其它 README 文档或对应的 Info.plist 中找到。
✽ 许可协议 & 捐赠 ✽
许可
在 Maruyama License 协议 的许可下，使用本仓库下的所有配置文件都是免费的。如果有人向你售卖配置文件，请立刻要求他退款。
希望你们也能够发扬开源和分享精神，积极提出建议和想法、Pull Request，由大家共同打造完美的黑果体验。
捐赠
当然，如果您认可我的工作，也可以通过捐赠支持我。所有的捐赠将会成为我更新的动力。
| 支付宝 | 微信 |
|---|---|
 |
 |