 macOS on Tongfang Laptops

适用于神舟战神、机械革命等品牌 8/9 代同方机型安装黑苹果的 OpenCore 配置文件

安装视频教程 | 帮助文档 | 更新日志 | 同方机型适配指南 | English

如何使用

第一步，请先查看兼容性表格，确认此配置文件支持你的机型、模具以及系统版本。

获取 & 更新配置文件

请下载对应平台的同方黑苹果助手，根据你的型号与实际硬件配置，定制 OpenCore 配置文件。

请不要使用 GitHub 上的 "Download Zip" 功能，如下图所示：

获取配置文件正确示例

安装 macOS

请参照安装教学视频里的指引，使用上一步得到的配置文件安装好 macOS。

替换配置文件后，请在 macOS 下使用同方黑苹果助手执行修复睡眠等优化操作。

手动定制配置文件

“同方黑苹果助手”会针对用户的不同硬件情况和需求，定制适合用户机型和硬件情况的 EFI，我们推荐所有用户使用“同方黑苹果助手”定制对应机型的配置文件。

如果因为某些原因你无法使用此工具定制配置文件，请参考以下方式手动修改配置文件，以兼容你的机型：

手动定制方式

使用 Download Zip 下载并解压配置文件。
在 OC/ACPI 文件夹中，根据你的模具选择对应的备选 USB 端口配置文件，改名为 SSDT-UIAC.aml（默认的 SSDT-UIAC.aml 是 GK5CN6X/GK5CN5X 的配置)。
使用 Xcode / ProperTree 等 Plist 编辑工具编辑 config.plist，根据你的机型选择修改你需要启用的 ACPI 补丁、ACPI 重命名和内核拓展。
在 config.plist 的 PlatformInfo 中修改你的三码。

兼容性

兼容的系统

最新配置文件仅完美兼容 macOS Catalina 10.15 及以上版本，不兼容 macOS High Sierra 10.13.x 版本。

目前已测试的最新兼容版本是：

macOS Catalina 10.15.6 (19G73)
macOS Big Sur 11.0 Beta 4 (20A5343i)，支持 OTA 更新和全新安装

提示：OTA 更新 macOS Big Sur Beta 时，日志可能会长时间停留在 Forcing cs_runtime for entitlement，此时是更新程序正在创建系统快照，请耐心等待约 20 分钟后即可正常更新。

适用的机型

理论上所有使用 清华同方模具的标压 8/9 代机型 均可使用对应的配置文件，不兼容蓝天模具机型、广达模具机型、七代（含）以下机型。详细的兼容型号表格如下：

模具型号	神舟战神	炫龙	机械革命
GK5CN6X	Z7-KP7GZ、Z7-KP7Z	耀 9000 II	Z2 Air (8 代)
GK5CN5X	Z7M-KP7GZ、Z7M-KP7Z、 Z7M-KP5GZ、 Z7M-KP5Z	耀 7000	Z2 Air (8 代)
GJ5CN64	Z7-KP7EC、Z7-KP7GC、 Z7-KP7GA、 Z7-KP7GE、 Z7-KP7GH	炎魔 T2 Ti	?
GI5CN54	Z7M-KP7GC、Z7M-KP5GC、Z7M-KP7GA、Z7M-KP5GA Z7M-KP7GE、Z7M-KP5GE、Z7M-KP7GH、Z7M-KP5GH	炎魔 T2 Ti	?
GK5CP6X	Z7-CT7GK、Z7-CT5GA、Z7-CT7GA	?	Z2 Air (9 代)、Z2 Air-G
GK5CP5X	Z7M-CT7GS、Z7M-CT5GA	?	Z2 Air (9 代)、Z2 Air-G
GK7CP6R	G7-CT7VK、G7-CT7RA	炎魔 T3Ti 710S5R / 710S5V / 510S5R	X3
GK5CP6V	Z7-CT7VH、Z7-CT7VA、Z7-CT5VH、Z7-CT5N1	?	?
GK5CP5V	Z7M-CT5VH、Z7M-CT7VH、Z7M-CT5N1
GK5CR0V	Z8-CT7VK
GK5CN6Z GK5CN5Z	?		Z2 / X8Ti 系列（8 代）
GK5CP6Z GK5CP5Z	?		Z2-G、Z2-R（9 代）

如何确定我的笔记本是否兼容？

并不是配置相近就可以使用此仓库的 EFI。如果你的模具型号没有出现在上述列表中，可以到 http://kfgl.hasee.com/lookup/book/bblist.asp 页面，查询你的笔记本型号所对应的准系统名称。

若你的笔记本采用 8/9 代因特尔酷睿标压处理器，且查询到准系统名称中带有 “（同方）” 字样，则你的笔记本可以兼容此仓库的配置文件。

对于其它品牌理论兼容的同方模具机型，若遇到 USB 接口无法识别或速度不正常的问题，建议参照此教程自行定制 USB。

配置文件概况

OpenCore Bootloader 使用官方 0.6.0 版本，GUI 采用 OpenCanopy 模拟白苹果原生 BootCamp 界面.
配置文件的 SMBIOS 采用 MacBookPro15,3 （MacBook Pro 15 inch, 2019）
默认支持 Windows 和 macOS 双引导，若需要引导其他操作系统需自行添加。
此版本对更换了 4K 屏幕的笔记本做了兼容；对于 GI5CN54 / GJ5CN64 模具改 4K 屏的用户，需要先解锁 BIOS 或使用 UEFI Shell 修改 DVMT Pre-allocated 为 64MB 以上。

完美的功能

勉强可用的功能

Intel 无线网卡 (AC9462, AC9560, AX200)
- 基于仍然处于开发阶段的 OpenIntelWireless/itlwm 项目和 HeliPort 项目，目前并不稳定，可能出现频繁的断网或无法联网等问题。
- 在生成 EFI 时勾选添加 Intel 无线网卡驱动并在 macOS 下使用 HeliPort 客户端管理网络，即可实现使用 Intel 无线网卡链接 Wi-Fi。

购买或更换硬件后可用的功能

原生 IO80211 支持的 Wi-Fi 和低功耗蓝牙
隔空投送 AirDrop、接力 Handoff、无线随航 Sidecar
- 若有更换无线网卡的需求，推荐更换 [BCM94360CS2 + NGFF 转接卡] 方案。
- 请注意：DW1820A 无线网卡在同方模具上有已知的兼容性问题，包括双系统使用时可能导致 Windows 蓝屏、重启后找不到无线网卡等，请尽量避免更换此网卡。
外接显示器
- 同方 8 代以上模具的 HDMI / miniDP 接口直连独显，因此无法在 macOS 下使用 HDMI/miniDP 接口外接显示。
- 购买此链接中测试的产品可能可以满足部分外接显示器的需要。

无论如何无法使用的功能

独立显卡
- 8 代以上同方模具的独显无法在 任何 macOS 版本（包括但不限于 10.13.x） 被驱动，关于具体的原因猜测，详见此文章。
- 已使用 SSDT-DDGPU.aml 屏蔽
SD 读卡器
- 由于读卡器通过 USB 2.0 协议连接电脑，没有驱动案例，故内置 SD 读卡器无法使用。

问题反馈 & 交流

你可以通过在 GitHub 上提 issue 的方式反馈问题，或者向 kirainmoe@gmail.com 发送问题报告邮件。

你也可以加入以下 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 代机型用户加入

贡献者 & 鸣谢

许可协议 & 捐赠

使用本仓库下的所有配置文件都是免费的，惟需遵守以下规则：

不允许任何人以任何形式、任何价格出售此配置文件（包括但不限于交易下载、付费下载）。 同时，为了保护你的权益，建议你不要通过 任何渠道 以 任何价格 购买上述机型的配置文件。
若你在此配置文件的基础上适配其它机型的配置文件，则需要保留对本项目的引用和鸣谢 (Credits) 信息，同时需要为大众保留至少一个免费获取、下载的方式（若您不同意此规则，请不要在此配置文件基础上修改）。
若你在任何项目中，使用了从此配置文件中获取的任何由其他人创作的内容，则需要保留对本项目的引用和他人的版权信息。

关于捐赠，如果您认可我的工作，也可以通过捐赠支持我。所有的捐赠将会成为我更新的动力。

支付宝	微信

拓展阅读

提示：涉及硬件层面的修改请谨慎操作。

Jormungendr/hasee-tongfang-macos