.github | ||
ACPI | ||
docs | ||
EFI-install_USB | ||
EFI-OpenCore | ||
patches | ||
.gitignore | ||
_config.yml | ||
LICENSE | ||
README.md |
macOS on Thinkpad X1 Carbon 6th Generation, Model 20KH*
Check out my blog tylerspaper.com
READ THE ENTIRE README.MD BEFORE YOU START.
I am not responsible for any damages you may cause.
Should you find an error, or improve anything, be it in the config itself or in the my documentation, please consider opening an issue or a pull request to contribute.
I AM A ONE MAN TEAM, AND A FULL TIME STUDENT. SO, I MIGHT NOT BE ABLE TO RESPOND OR HELP YOU IN A TIMELY MANNER. BUT, I PROMISE I WILL GET TO YOU EVENTUALLY. PLEASE UNDERSTAND.
Lastly, if my work here helped you. Please consider donating, it would mean a lot to me.
Update
Recent | Changelog Archive
2020-11-14
Added
SSDT-PWRB
to patch power button.
Changed
- Parition TB3 patch into smaller, more readable chunks.
SSDT-XHC2
is also now apart of this.
- Removed experimental stuff from
SSDT-Sleep
- Updated to
SSDT-Battery
to rev8, thanks @benbender - Updated some documenation, with more detailed documentation coming.
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 or 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, and YogaSMCPane |
Adjust with YogaSMCPane in System Preferences |
Battery Life | ✅ | Native, comparable to Windows/Linux. Biggest impact is TB3, see 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 |
HDMI hotplug | ✅ | Custom EDID Override /patches/Internal Displays/ |
Refer to Issue #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 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-XHC2.aml |
Hotplug WIP |
USB Power Properties in macOS | ✅ | SSDT-USBX.aml |
- |
Thunderbolt 3 Hotplug | ✅ | SSDT-TB3.aml |
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 | 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 |
Multimedia Keys | ✅ | BrightnessKeys.kext and 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 |
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 |
|
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
- dortania's OpenCore Install Guide
- dortania's OpenCore Post Install Guide
- dortania/ Getting Started with ACPI
- dortania/ opencore
multiboot
- dortania/
USB map
guide - WhateverGreen Intel HD Manual
Configuration.pdf
andDifferences.pdf
in eachOpenCore
releases.- Additionally, references specific to the x1c6 are located in
docs/references/
-
No seriously, please read those.
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.
- ProperTree if you need to edit plist files on Windows.
- MaciASL, for patching ACPI tables and editing ACPI patches.
- MountEFI to quickly mount EFI partitions.
- IORegistryExplorer, for diagnosis.
- Hackintool, for diagnostic ONLY, Hackintool should not be used for patching, it is outdated.
- SPI Programmer CH341a and SOIC8 connector 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 | Generate your own CPUFriendDataProvider.kext . See SUMMARY |
SSD | Seagate Firecuda 520 500GB | Dortania's Anti Hackintosh Buyers Guide |
Display | 14.0" (355mm) HDR WQHD (2560x1440) | /patches/ Internal Displays/ and Issue #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 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
- 1_README-HARDWAREandBIOS: Requirements before installing.
- 2_README-ACPIpatching: Notes and explainations for ACPI hotpatches.
- 3_README-other.md: for post installation settings and other remarks.
OTHER REPOSITORIES
- x1c6-hackintosh repositories:
- t480-hackintosh repositories:
- EETagent/T480-OpenCore-Hackintosh Create a pull request if you like to be added, final decision at my discreation.
CONTACT
https://tylerspaper.com/contact
Signal: +1 (202)-644-9951 *This is a Signal ONLY number. You will not get a reply of you text me at this number.
SUPPORT
https://tylerspaper.com/support/
CREDITS
- @benbender for your hardwork. Much of this repo comes from your research and code. Thank you!
- @Fewtarius for your help with patching audio.
- @Colton-Ko for the great features template.
- @stevezhengshiqi for the one-key-cpufriend script.
- @corpnewt for GibMacOS and EFIMount.
- @xzhih for one-key-hidpi.
- daliansky/OC-little for various ACPI hotpatch samples.
- @velaar for your continual support and contributions.
- @Porco-Rosso putting up with my requests to test repo changes.
- @MSzturc for adding my requested features to ThinkpadAssistant.
paranoidbashthot and \x for the BIOS mod to unlocked Intel Advance Menu. - @zhen-zen for YogaSMC
The greatest thank you and appreciation to the Acidanthera team.
And to everyone else who supports and uses my project.
Please let me know if I missed you.