READ THE ENTIRE README.MD BEFORE YOU START.

July 16th, 2021, I consider the state of this project to be **very stable**. Everything works the way it should, or at least the things I notice. There will likely never be major changes coming unless a new macOS version break something severely (which I doubt). I will continue to maintain this project with every OpenCore releases, up until it's (MacBookPro14,1) official out of service/support from Apple. #### I am not responsible for any damages you may cause. #### If my work here helped you. Please consider donating, it would mean a lot to me. > ## Update ##### Recent | [Changelog Archive](https://github.com/tylernguyen/x1c6-hackintosh/blob/master/docs/CHANGELOG.md) > ### 2021-6-21 #### Added - A notice in the doc that warns: "modding the BIOS will break TPM and thus, Windows 11. Consider this before you proceed with BIOS modding." #### Removed - The `GitHub-pages` of this project, it was pretty useless since it's just a mirror of the `README.md`. #### Notice - This will likely be the last repo update until macOS Monterey is stable. At which I plan: - Implement AX200 as the network card with the OpenIntelWireless kexts.

SUMMARY

> ### Non-Fuctional: | Feature | Status | Dependency | Remarks | | :----------------------------------- | ------ | ------------------- | ---------------------------- | | Fingerprint Reader | ❌ | `DISABLED` in BIOS to save power if not used in other OSes. | Linux support was only recently added | | Wireless WAN | ❌ | `DISABLED` in BIOS to save power if not used in other OSes. | Unable to investigate as I have no need and my model did not come with WWAN. | > ### Video and Audio | Feature | Status | Dependency | Remarks | | :----------------------------------- | ------ | ------------------- | ---------------------------- | | Full Graphics Accleration (QE/CI) | ✅ | `WhateverGreen.kext` | - | | Audio Recording | ✅ | `AppleALC.kext` with Layout ID = 21 | - | | Audio Playback | ✅ | `AppleALC.kext` with Layout ID = 21 | - | | Automatic Headphone Output Switching | ✅ | `AppleALC.kext` with Layout ID = 21 | - | > ### Power, Charge, Sleep and Hibernation | Feature | Status | Dependency | Remarks | | :----------------------------------- | ------ | ------------------- | ---------------------------- | | Battery Percentage Indication | ✅ | `SSDT-Battery.aml` and `/patches/OpenCore Patches/Battery.plist` | | CPU Power Management (SpeedShift) | ✅ | `XCPM` and `CPUFriend.kext`, generate your own `CPUFriendDataProvider` with [CPUFriendFriend](https://github.com/corpnewt/CPUFriendFriend_) or [one-key-cpufriend](https://github.com/stevezhengshiqi/one-key-cpufriend). | | iGPU Power Management | ✅ | `XCPM`, enabled by `SSDT-PLUG.aml` | | NVMe Drive Battery Management | ✅ | `NVMeFix.kext` | In my experience, NVMe drives will drain more power than SATA drives. | | S3 Sleep/ Hibernation Mode 3 | ✅ | `SSDT-Sleep.aml` | | | Hibernation Mode 25 | ✅ | `RTCMemoryFixup.kext` and `HibernationFixup.kext` | Supported, macOS uses mode 3 by default. Change to mode 25 via `pmset`. | | Custom Charge Threshold | ✅ | `SSDT-EC.aml`, [YogaSMC.kext](https://github.com/zhen-zen/YogaSMC), and [YogaSMCPane](https://github.com/zhen-zen/YogaSMC)| Adjust with YogaSMCPane in System Preferences | Fan Control | ✅ | `SSDT-EC.aml`, [YogaSMC.kext](https://github.com/zhen-zen/YogaSMC), and [YogaSMCPane](https://github.com/zhen-zen/YogaSMC)| Adjust with YogaSMC App. | Battery Life | ✅ | Native, comparable to Windows/Linux. Biggest impact is TB3, see [docs/1_README-HARDWAREandBIOS.md](https://github.com/tylernguyen/x1c6-hackintosh/blob/master/docs/1_README-HARDWAREandBIOS.md) | Will need a modded BIOS to disable `CFG Lock` > ### Input/ Output | Feature | Status | Dependency | Remarks | | :----------------------------------- | ------ | ------------------- | ---------------------------- | | WiFi | ✅ | Native with BCM94360CS2. | See `/patches/ Network Patches/` otherwise. | | Bluetooth | ✅ | Native with BCM94360CS2. | See `/patches/ Network Patches/` otherwise. | | Ethernet | ✅ | `IntelMausi.kext` | Needs Lenovo Ethernet adapter: [Item page](https://www.lenovo.com/us/en/accessories-and-monitors/cables-and-adapters/adapters/CABLE-BO-Ethernet-Extension-Adapter-2/p/4X90Q84427) | | HDMI hotplug | ✅ | Custom EDID Override `/patches/Internal Displays/` | Refer to [Issue #60](https://github.com/tylernguyen/x1c6-hackintosh/issues/60) if one does not exist already for your display. | | 4K UHD output via HDMI/ DisplayPort **(Modded BIOS)** | ✅ | See `DMVT Pre-Allocated` to `64M` | See [docs/1_README-HARDWAREandBIOS.md](https://github.com/tylernguyen/x1c6-hackintosh/blob/master/docs/1_README-HARDWAREandBIOS.md) for information about modding the BIOS. | | 4K UHD output via HDMI/ DisplayPort **(Vanilla BIOS)** | ✅ | See `/patches/OpenCore Patches/4K-Output-wo-BIOSmod.plist` | - | | USB 2.0, USB 3.0, and Micro SD Card Reader | ✅ | `SSDT-XHC1.aml` | - | | USB 3.1 | ⚠️ | `SSDT-TB-DSB2-XHC2.aml` | Hotplug WIP | | USB Power Properties in macOS | ✅ | `SSDT-XHC1.aml` | - | | Thunderbolt 3 Hotplug | ✅ | `SSDT-TB-*` | Native interface within System Report | > ### Display, TrackPad, TrackPoint, and Keyboard | Feature | Status | Dependency | Remarks | | :----------------------------------- | ------ | ------------------- | ---------------------------- | | Brightness Adjustments | ✅ | `WhateverGreen.kext`, `SSDT-PNLF.aml`, `AppleBacklightSmoother.kext`, and `BrightnessKeys.kext`| `AppleBacklightSmoother.kext` is optional for smoother birghtness adjustments | | HiDPI _(Optional)_ | ✅ | [xzhih/one-key-hidpi](https://github.com/xzhih/one-key-hidpi) | Scaling issues post-sleep fixed with AAPL, ig-platform `BAAnWQ==` | | TrackPoint | ✅ | `VoodooPS2Controller.kext` | - | | TrackPad | ✅ | `VoodooPS2Controller.kext` or `VoodooSMBus.kext` and `VoodooRMI.kext` | `VoodooRMI.kext` is recommended and preferred over `VoodooPS2`. | | Built-in Keyboard | ✅ | `VoodooPS2Controller.kext` | Optimizations recommended, see [`docs/3_README-other.md`](https://github.com/tylernguyen/x1c6-hackintosh/blob/master/docs/3_README-other.md) | | Multimedia Keys | ✅ | `BrightnessKeys.kext` and [YogaSMC](https://github.com/zhen-zen/YogaSMC) | `YogaSMC` is recommended and preferred over ThinkpadAssisstant | > ### macOS Continuity | Feature | Status | Dependency | Remarks | | :----------------------------------- | ------ | ------------------- | ---------------------------- | | iCloud, iMessage, FaceTime | ✅ | Whitelisted Apple ID, Valid SMBIOS | See [dortania /OpenCore-Install-Guide](https://dortania.github.io/OpenCore-Post-Install/universal/iservices.html) | | Continuty | ✅ | Native with `BCM94360CS2`. `ExtendBTFeatureFlags` to `True` otherwise. | See `/patches/Network Patches/` for specific network card. | | AirDrop | ✅ | Native with `BCM94360CS2`. `ExtendBTFeatureFlags` to `True` otherwise. | See `/patches/Network Patches/` for specific network card. | | Sidecar | ✅ | Native with `BCM94360CS2`. `ExtendBTFeatureFlags` to `True` otherwise. iPad with >= `iPadOS 13` | Tested with iPad Mini with iPadOS 13.1.2 | | FileVault | ✅ | as configured in `config.plsit` per [Dortania's Post-Install](https://dortania.github.io/OpenCore-Post-Install/universal/security/filevault.html)| | | Time Machine | ✅ | Native | TimeMachine only backups your Macintosh partition. Manually backup your EFI partition using another method. |

REFERENCES

* Read these before you start: - [dortania's Hackintosh guides](https://github.com/dortania) - [dortania's OpenCore Install Guide](https://dortania.github.io/OpenCore-Install-Guide/) - [dortania's OpenCore Post Install Guide](https://dortania.github.io/OpenCore-Post-Install/) - [dortania/ Getting Started with ACPI](https://dortania.github.io/Getting-Started-With-ACPI/) - [dortania/ opencore `multiboot`](https://github.com/dortania/OpenCore-Multiboot) - [dortania/ `USB map` guide](https://dortania.github.io/OpenCore-Post-Install/usb/) - [WhateverGreen Intel HD Manual](https://github.com/acidanthera/WhateverGreen/blob/master/Manual/FAQ.IntelHD.en.md) - `Configuration.pdf` and `Differences.pdf` in each `OpenCore` releases. - In short, if I missed something here, refer to official OpenCore docs first, then Dortania's docs. Only then, if you still haven't found what you're looking for, seek Google or forum help. - Additionally, references specific to the x1c6 are located in `docs/references/` * ### No seriously, please review those resources to get an idea of what's going on before proceeding.

REQUIREMENTS

- A macOS machine(optional): to create the macOS installer. - Flash drive, 12GB or more, for the above purpose. - Xcode works fine for editing plist files on macOS, but I prefer [PlistEdit Pro](https://www.fatcatsoftware.com/plisteditpro/). - [ProperTree](https://github.com/corpnewt/ProperTree) if you need to edit plist files on Windows. - [MaciASL](https://github.com/acidanthera/MaciASL), for patching ACPI tables and editing ACPI patches. - [MountEFI](https://github.com/corpnewt/MountEFI) to quickly mount EFI partitions. - [IORegistryExplorer](https://developer.apple.com/downloads), for diagnosis. - [Hackintool](https://www.insanelymac.com/forum/topic/335018-hackintool-v286/), for diagnostic ONLY, Hackintool should not be used for patching, it is outdated. - [SPI Programmer CH341a and SOIC8 connector](https://www.amazon.com/Organizer-Socket-Adpter-Programmer-CH341A/dp/B07R5LPTYM) are needed if you are going to mod your BIOS for optimizations and a better and more native macOS experience. - Patience and time, especially if this is your first time Hackintosh-ing.

HARDWARE

- These are relevant components on my machine which may differ from yours, keep these in mind as you will need to adjust accordingly, depending on your machine's configuration. | Category | Component | Remarks | | --------- | ------------------------------------ | ------------ | | CPU | [i7-8650U](https://ark.intel.com/content/www/us/en/ark/products/124968/intel-core-i7-8650u-processor-8m-cache-up-to-4-20-ghz.html) | Generate your own `CPUFriendDataProvider.kext`. See `SUMMARY` | SSD | Seagate Firecuda 520 500GB | [Dortania's Anti Hackintosh Buyers Guide](https://dortania.github.io/Anti-Hackintosh-Buyers-Guide/Storage.html) | Display | 14.0" (355mm) HDR WQHD (2560x1440) | `/patches/ Internal Displays/` and [Issue #60](https://github.com/tylernguyen/x1c6-hackintosh/issues/60) | WiFi & BT | BCM94360CS2 | `/patches/ Network Patches/` if non-native. | WWAN | None | Unless needed in other OSes, disable at BIOS to save power - Refer to [/docs/references/x1c6-Platform_Specifications](https://github.com/tylernguyen/x1c6-hackintosh/blob/master/docs/references/x1c6-Platform_Specifications.pdf) for possible stock ThinkPad X1 6th Gen configurations.

GETTING STARTED

Before you do anything, please familiarize yourself with basic Hackintosh terminologies and the basic Hackintosh process by throughly reading Dortania guides as linked in `REFERENCES` - Creating a macOS installer: refer to [Dortania's OpenCore Install Guide](https://dortania.github.io/OpenCore-Install-Guide/installer-guide/) - [**1_README-HARDWAREandBIOS**](https://github.com/tylernguyen/x1c6-hackintosh/blob/master/docs/1_README-HARDWAREandBIOS.md): Requirements before installing. - [**2_README-Patches**](https://github.com/tylernguyen/x1c6-hackintosh/blob/master/docs/2_README-Patches.md): Notes and explainations for ACPI hotpatches. - [**3_README-other.md**](https://github.com/tylernguyen/x1c6-hackintosh/blob/master/docs/3_README-other.md): for post installation settings and other remarks.

OTHER REPOSITORIES

- x1c6-hackintosh repositories: - [benbender/x1c6-hackintosh](https://github.com/benbender/x1c6-hackintosh) - [zhtengw/EFI-for-X1C6-hackintosh](https://github.com/zhtengw/EFI-for-X1C6-hackintosh) - t480-hackintosh repositories: - [EETagent/T480-OpenCore-Hackintosh](https://github.com/EETagent/T480-OpenCore-Hackintosh) Create a pull request if you like to be added, final decision at my discreation.

CREDITS

- [@benbender](https://github.com/benbender) for your hardwork. Much of this repo comes from your research and code. Thank you! - [@Fewtarius](https://github.com/fewtarius) for your help with patching audio. - [@Colton-Ko](https://github.com/Colton-Ko/macOS-ThinkPad-X1C6) for the great features template. - [@stevezhengshiqi](https://github.com/stevezhengshiqi) for the one-key-cpufriend script. - [@corpnewt](https://github.com/corpnewt) for [GibMacOS](https://github.com/corpnewt/gibMacOS) and [EFIMount](https://github.com/corpnewt/MountEFI). - [@xzhih](https://github.com/xzhih) for one-key-hidpi. - [daliansky/OC-little](https://github.com/daliansky/OC-little) for various ACPI hotpatch samples. - [@velaar](https://github.com/velaar) for your continual support and contributions. - [@Porco-Rosso](https://github.com/Porco-Rosso) putting up with my requests to test repo changes. - [@MSzturc](https://github.com/MSzturc) for adding my requested features to ThinkpadAssistant. paranoidbashthot and \x for the BIOS mod to unlocked Intel Advance Menu. - [@zhen-zen](https://github.com/zhen-zen) for YogaSMC The greatest thank you and appreciation to the [Acidanthera](https://github.com/acidanthera) team. And to everyone else who supports and uses my project. Please let me know if I missed you.