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-1-5

Changed

OC to 0.6.5 and upgraded various Acidanthera kexts
Added ocvalidate (0.6.5) in OC to easily check and validate config.plist changes.

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
Fan Control	✅	`SSDT-EC.aml`, YogaSMC.kext, and YogaSMCPane	Adjust with YogaSMC App.
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-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	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 and Differences.pdf in each OpenCore 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:
- benbender/x1c6-hackintosh
- zhtengw/EFI-for-X1C6-hackintosh
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.

wbsouza / x1c6-hackintosh Goto Github PK

x1c6-hackintosh's Introduction