macOS on Thinkpad X1 Carbon 7th Generation, Model 20R1*

READ THE ENTIRE README.MD BEFORE YOU START.

This template is Forked from Tyler Nguyen's repo x1c6-hackintosh

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.

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.
Internal Microphone	❌	`DISABLED` in BIOS to save power	-

Video and Audio

Feature	Status	Dependency	Remarks
Full Graphics Accleration (QE/CI)	✅	`WhateverGreen.kext`	-
Audio Recording	✅	`AppleALC.kext` with Layout ID = 71	-
Audio Playback	✅	`AppleALC.kext` with Layout ID = 71	-
Automatic Headphone Output Switching	✅	`AppleALC.kext` with Layout ID = 71	-

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)	✅	CPUFriend.kext with CPUFriendFriend	idle at 800mhz
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-SLPWAK.aml`
Custom Charge Threshold	✅	`SSDT-ECRW.aml`, YogaSMC.kext, and YogaSMCPane	Adjust with YogaSMCPane in System Preferences
Fan Control	✅	`SSDT-ECRW.aml`, YogaSMC.kext, and YogaSMCPane	Adjust with YogaSMC App.
Battery Life	✅	Native, comparable to Windows/Linux. Biggest impact is TB3	-

Input/ Output

Feature	Status	Dependency	Remarks
WiFi	✅	AirportIltwm	See Wiki for WiFi fix
Bluetooth	✅	AirportIltwm, IntelBluetoothFirmware.kext and IntelBluetoothInjector.kext	⚠️ audio input (e.g. of headset) is not working
Ethernet	✅	`IntelMausi.kext`	-
HDMI hotplug	✅	-	-
USB 2.0, USB 3.0	✅	-	-
USB 3.1	✅	-	Hotplug
USB Power Properties in macOS	✅	-	-
Thunderbolt 3 Hotplug	✅	-	Native interface within System Report

Display, TrackPad, TrackPoint, and Keyboard

Feature	Status	Dependency	Remarks
Brightness Adjustments	✅	`WhateverGreen.kext`, `SSDT-PNLF-CFL.aml`, `AppleBacklightSmoother.kext`, and `BrightnessKeys.kext`	`AppleBacklightSmoother.kext` is optional for smoother birghtness adjustments
TrackPoint	✅	`VoodooPS2Controller.kext`	-
TrackPad	✅	`VoodooPS2Controller.kext`	-
Built-in Keyboard	✅	`VoodooPS2Controller.kext`	-
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	❌	Tested - Not working in current config	Tested with iPad Air 2, iPad 7th Gen, iPad Air 4
AirDrop	❌	Tested - Not working in current config	Tested with iPad Air 2, iPad 7th Gen, iPad Air 4
Sidecar	❌	Tested - Not working in current config	Tested with iPad Air 2, iPad 7th Gen, iPad Air 4
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 x1c7 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.
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-10710U	-
SSD	Micron 512GB NVMe SSD	-
Display	14.0" (355mm) FHD (1920x1080)	-
WWAN	None	Unless needed in other OSes, disable at BIOS to save power
Ports	2x USB 3.1 Gen 1 (Right USB Always On)
	2x USB 3.1 Type-C Gen 2 / Thunderbolt 3 (Power Delivery and DisplayPort) [Max 5120x2880 @60Hz]
	HDMI 1.4b (Max 4096x2160 @24Hz)
Ethernet	via ThinkPad Ethernet Extension Adapter Gen 2: I219-LM Ethernet (vPro)
WLAN + BT	Intel Wireless-AC 9560, Wi-Fi 2x2 802.11ac + Bluetooth 5.0	See Wiki for WiFi fix
WWAN(optional)	Nothing else supported, no adapters, nothing. Locked by BIOS
Camera	IR and HD720p camera with ThinkShutter. Chicony manufacturer
Audio	Realtek ALC3286 codec Linux: `Realtek ALC285`, layout 11, 21, 31 ; @acidanthera/AppleALC > Supported codecs [Github]
Fingerprint reader	✔️
NFC (optional)	✔️

Refer to /docs/references/ for possible stock ThinkPad X1 7th 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.
Updating

SUPPORT

CREDITS

@zhen-zen for YogaSMC

The greatest thank you and appreciation to the Acidanthera team. https://github.com/aidanchandra/x1c7-hackintosh Project and https://github.com/huyhoang8398/x1c7-hackintosh-20R1 (That I forked)

H3LLC47 / x1c7-hackintosh-20R1