Skip to content

Latest commit

 

History

History
213 lines (136 loc) · 9.38 KB

README-en.md

File metadata and controls

213 lines (136 loc) · 9.38 KB
Raw

 macOS on Tongfang Laptops

preview

OpenCore config for "hackintoshing" on Tongfang barebones-based 8th/9th generation platform laptops.

Changelog | 简体中文

Table of Contents

Quick Start

  • Check if this repo's config supports your laptop, see Compatibility.
  • Download Tongfang Utility and customize the OpenCore config for your model.
    • You will have Tongfang_EFI folder on your ~/Desktop.
    • Do not download the full repository using "Download Zip" button.
Exampledownload from githubtongfang hackintosh utility
  • Download a latest version of macOS from somewhere.
    • If you are using Windows, the most convenient way is to use GibMacOS, click here to learn more.
    • If you already has a modified DMG file, use BalenaEtcher to make a installer flash.
  • Part your disk that you are going to install macOS.
    • You should have a GUID partition table and a 200M+ ESP (EFI System Partition).
  • Copy Tongfang_EFI/BOOT and Tongfang_EFI/OC folder you obtained in the first step to the EFI folder of the ESP of your flash disk.
    • After this progress you will have EFI/BOOT and EFI/OC on your ESP.
  • Disable Secure Boot, Launch CSM and change to UEFI Mode in BIOS.
  • Boot OpenCore from USB flash and install macOS.
  • After boot into the system, use Tongfang Utility (for macOS) to improve the experience.
  • Enjoy your hackintosh build!

Community Resources

Tutorials

Monster Laptop Hackintosh Tutorial (@sutsurup) (in Turkish)

EVOO Hackintosh Guide (@N0tJust1n) (in English)

Tools

Tongfang Utility (@kirainmoe): all-in-one hackintosh toolbox and keyboard light controlling for ITE devices with revision 0.02

AUCC (@rodgomesc): keyboard light controlling for ITE devices with revision 0.03

Compatibility

macOS version

Current EFI release is 22.12.9. This release is compatible with the following macOS version:

macOS Compatible Fresh Install OTA Tested version Notes
10.13 High Sierra ⭕ ⭕ ⭕ Untested Installing High Sierra on 8th gen or later Tongfang laptops is not recommended
10.14 Mojave ✅ ✅ ✅ 10.14.6 (18G103)
10.15 Catalina ✅ ✅ ✅ 10.15.7 (19H114)
11 Big Sur ✅ ✅ ✅ 11.6 (20G165)
12 Monterey ✅ ✅ ✅ 12.3 (21E5206e)
13 Ventura ✅ ✅ ✅ 13.0 Beta 3 (22A5295h)

Barebones

Notes: If you have a Intel Tongfang QC7 laptop, try https://github.com/szguomy/hackintosh

Currently, this config is known to be compatible with all 8th / 9th generation Tongfang barebones (except Intel Tongfang QC7, although some barebones models are not listed in the following table). For example:

Barebone Platform Generation
GK5CN5X, GK5CN6X 8th
GK5CN5Z, GK5CN6Z 8th
GK7CN6S, GK7CN5S 8th
GI5CN54, GJ5CN64 (PS/2 Touchpad) 8th
GK5CP6Z, GK5CP5Z 9th
GK5CP6X, GK5CP5X 9th
GK7CP6R, GK7CP0R 9th
GK5CP5V, GK5CP6V 9th

If you have 8th gen platform laptops with I2C touchpad but the barebone model is not in the list, try one of GK5CN6X, GK5CN6Z (GTX 1060) or GK5CN5X, GK5CN5Z (GTX 1050Ti).

If you have 8th gen platform laptops with PS/2 touchpad but the barebone model is not in the list, try one of GJ5CN64 (GTX 1060) or GI5CN54 (GTX 1050Ti).

If you have 9th gen platform laptops but the barebone model is not in the list, try one of GK7CP6R, GK5CP6X, GK5CP5X, GK5CP6V, GK5CP5V, GK5CP6Z, GK5CP5Z...

Please use Tongfang Utility to download / customize the OC config.

Models

Notes: I was not sure that some models can work perfectly with this config. The models listed in the following table are those would be theoretically supported gussing by their barebone model.

If you have any Tongfang laptop and successfully installed with one of the following configs, please open an issue and tell me.

Tips

It is recommended to create a USB map for your machine after installation if your barebone model is not in the following table.

Barebone Models Theoretically Supported Generation
GK5CN5X
GK5CN6X
GK5CN6Z
GK5CN5Z
GK7CN6S
GK7CN5S		 Mechrevo Z2 (Air)
XMG Neo 15
Overpowered Gaming Laptop 15
MACHENIKE F117-B1/2
Monster Abra A7 v10.1
Monster Abra A5 v13.4
Overpowered 17+ laptop		 8th Generation
GJ5CN64
GI5CN54		 Avell A52-5 BS
CyberPower NB-408-109
Machenike T90		 8th Generation
GK7CP6R Illegear Rogue Laptop
XMG Core 17
Mechrevo X3
CyberPowerPC Tracer-III-17
Monster Tulpar T7 v19.3
Monster Tulpar T7 V20.1		 9th Generation
GK5CP6X
GK5CP5X		 Mechrevo Z2 Air-G
EVOO 15.6" model laptops (LP4 / LP5)		 9th Generation

Current Status

  • OpenCore: 0.8.8 (official)
  • SMBIOS: MacBook Pro 15-inch 2019 (MacBookPro15,3)
  • Dual-Boot of Windows & macOS is supported
  • 4K resolution inner monitor support (only macOS Catalina)
    • For Tongfang GI5* / GJ5* laptop users, you need to set DVMT pre-allocated memory to 64MB to make 4K monitor work, Tutorial.

What are working

  • Turbo boost and CPU frequency stage.

  • Intel UHD Graphics 630

    • platform-id: 3E9B0000

  • Audio Realtek ALC269vc

    • layout-id: 29

  • Realtek Ethernet RTL8168H

  • Intel Bluetooth

  • USB 3.0 and Type-C

  • Brightness control

  • Touchpad (both PS/2 and I2C TouchPad have gesture support now)

  • Battery status

  • S3 Sleep / Wake

  • S4 Hibernation / Wake

  • Camera

  • FileVault 2

  • Fn shortcut keys with OSD & Double-tap disable touchpad

  • Keyboard light controlling with Tongfang Utility or AUCC

  • Fan speed controlling with Tongfang Utility

  • SD Card reader

  • etc.

What are partially working

  • Intel Wi-Fi based on itlwm and HeliPort (not stable enough yet)

What are not working

  • nVidia discrete GPU (used SSDT to disable it)
  • HDMI/mini DP (connected to non-working DGPU directly, buy a USB Display Adapter to extend the screen)
  • AirDrop & Handoff & Wireless Sidecar (Replace a Wi-Fi card that is compatible with macOS can solve this)

Unsolved Problems

  • S4 hibernation cannot be recovered on Windows
    • Do not use OpenCore to boot Windows if you rely on the S4 hiberanation.

Contribute & Support

Issues & Pull request & Translation are welcomed.

Join the Discord to get community support.

License

You can use the config from this repo for free, as long as you agree the following rules:

  • Commercial use of the config and its *derivatives* is prohibited. This includes but not limited to:

    • Sell the config provided by this repo at any price.
    • Redistribute the config provided by this repo and provide paid download service.
    • If you are creating a new config which is based on this config, your product must also be free for all users.

  • Reserve the copyright and credit statement when you create a new config which is based on this config for other model.

  • Authors and contributors are not guaranteed for any damage of your device.