Skip to content

Sniki/Lenovo-Thinkpad-X240

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Lenovo Thinkpad X240

macOS OpenCore

Lenovo Thinkpad X240 using OpenCore Bootloader

What works:

  • Intel HD Graphics 4400 QE/CI
  • Brightness Control
  • TouchScreen with Gestures
  • Keyboard & Backlit
  • TouchPad with Gestures
  • Dual Battery Support
  • Secure Boot
  • FileVault
  • Sleep and Wake
  • Audio and DisplayPort Audio
  • Power Management
  • USB Ports
  • LAN
  • DisplayPort
  • VGA
  • Wireless and Bluetooth
  • SD Card Reader
  • Docking Station USB Ports
  • Docking Station LAN
  • Docking Station DisplayPort
  • Docking Station VGA Port
  • Docking Station DVI Port

What doesn't work:

  • DRM content
  • FingerPrint Reader
  • Docking Station Kernel Panic if Sleep, Reboot, Shutdown attempted while external display connected on one of the Dock Ports
  • Docking Station DisplayPort Audio

Bios

These are the recommended settings to have everything working properly:

Security Tab:

  • Security Chip > Security Chip [Disabled]
  • Anti-Theft > Intel (R) AT Module Activation > Current Setting [Disabled]
  • Anti-Theft > Computrace > Computrace Module Activation > Current Setting [Disabled]

Note: These laptops do have whitelist which doesn't allow you to use other Card than the Intel AC7260. In order to use a different / supported card, you need to mod your bios (remove whitelist).

Secure Boot

Users with 1366x768 or 1600x900 displays can go ahead and enable secure boot and enjoy it. Users with upgraded displays to 1080p or native 1080p displays will have garbled screen if CSM is disabled in BIOS (which can't be left enabled if Secure Boot enabled) In order to fix this problem we need to patch Display-EDID.

Patching Display EDID [WIP]

First we need to download these three Applications: Hackintool, AWEDIDEditor and HexFiend

  • Open Hackintool and go to the Displays tab and click the Export icon/button on the bottom-right side.
  • On desktop, you will see some new files appeared, now open the EDID-***-****-orig.bin file with AWEDIDEditor
  • Go to Detailed Data tab and change H. Sync Width: value to 100.
  • Save the EDID as Patched-EDID or whatever name you like just to know which one is the patched one
  • Open the Patched-EDID with HexFiend and make sure you expand it so it contains 8 columns of code bytes.
  • Copy the 128 bytes code and paste it into: EFI>OC>Config.plist>DeviceProperties>PciRoot(0x0)/Pci(0x2,0x0)>AAPL00,override-no-connect
  • Save the config.plist file and reboot, Enjoy Secure Boot without garbled screen.

Non TouchScreen Displays

If your Lenovo Thinkpad X240 doesn't have a TouchScreen display, it is required for you to disable the kext responsible for TouchScreen. Go to EFI/OC/Config.plist > Kernel > Add > and disable the 4 following kexts:

  • VoodooI2CServices.kext - Enabled = No
  • VoodooGPIO.kext - Enabled = No
  • VoodooI2C.kext - Enabled = No
  • VoodooI2CHID.kext - Enabled = No

TouchPad

Most of the users have probably already upgraded to a X250 Touchpad (the one with Physical Buttons) and this one does work natively, no need to touch anything. For you users that have the standard Touchpad that came with this laptop, you have to do some changes as VoodooRMI doesn't seem to work very well with them.

Go to EFI/OC/Config.plist > Kernel > Add and disable the VoodooRMI kexts:

  • VoodooRMI.kext - Enabled = No
  • VoodooRMI.kext/Contents/PlugIns/RMISMBus.kext - Enabled = No
  • VoodooRMI.kext/Contents/PlugIns/VoodooTrackpoint.kext - Enabled = No
  • VoodooRMI.kext/Contents/PlugIns/VoodooInput.kext - Enabled = No

Once done, enable the VoodooPS2Controller kexts for Touchpad:

  • VoodooPS2Controller.kext/Contents/PlugIns/VoodooInput.kext - Enabled = Yes
  • VoodooPS2Controller.kext/Contents/PlugIns/VoodooPS2Trackpad.kext - Enabled = Yes
  • VoodooPS2Controller.kext/Contents/PlugIns/VoodooPS2Mouse.kext - Enabled = Yes

Now enable the SSDT-TPD.aml for Touchpad to work with VoodooPS2:

  • EFI/OC/Config.plist > ACPI > Add > SSDT-TPD.aml > Enabled = Yes

YogaSMC

To have working Keyboard Function Keys (Fn) and Fan reading etc, you need to install the YogaSMCPane and the YogaSMC App. YogaSMC.kext is already included in the EFI so when yo go to releases tab, you download the YogaSMC-App-release.dmg

Audio

ALCPlugFIx is required to fix static noise on headphones, however Black-Dragon74 released a Swift version that doesn't require hda-verb, alc-verb or CodecCommander kext. the ALCPlugFix.zip is included in the Tools folder.

Installation:

  • Extract ALCPlugFix zip into desktop
  • Open terminal and type following commands one by one on the listed order:
  • sudo spctl --master-disable
  • sudo mkdir /usr/local/bin/
  • cd desktop/ALCPlugFix
  • sudo cp -R ALC3232.plist /usr/local/bin/
  • ./install.sh
  • Now the installer will ask you to drop the ALC3232.plist into the terminal window.
  • Open a new finder window and press Shift + Cmd(Alt) + G to open a new go to folder: window
  • Now type: /usr/local/bin/
  • Drag the ALC3232.plist from the /usr/local/bin folder into the terminal window and press enter.
  • Done

Wireless and Bluetooth

Intel AC7260

Users with Intel AC7260 cards can enjoy out of the box support for both Wireless and Bluetooth. Keep in mind that Airportitlwm/itlwm is still in early development and only N speeds are supported.

DW1560 & DW1830

Users with one of these two cards first need to disable the intel kexts:

  • EFI/OC/Config.plist > Kernel > Add > Airportitlwm > Enabled = No
  • EFI/OC/Config.plist > Kernel > Add > IntelBluetoothInjector > Enabled = No
  • EFI/OC/Config.plist > Kernel > Add > IntelBluetoothFirmware > Enabled = No

Then enable the corresponding kexts for those two cards:

  • EFI/OC/Config.plist > Kernel > Add > AirportBrcmFixup > Enabled = Yes
  • EFI/OC/Config.plist > Kernel > Add > AirPortBrcm4360_Injector > Enabled = Yes
  • EFI/OC/Config.plist > Kernel > Add > BrcmBluetoothInjector > Enabled = Yes
  • EFI/OC/Config.plist > Kernel > Add > BrcmFirmwareData > Enabled = Yes
  • EFI/OC/Config.plist > Kernel > Add > BrcmPatchRAM3 > Enabled = Yes

DW1820A

This card uses the same kexts as DW1560, DW1830 but needs this additional injector:

  • EFI/OC/Config.plist > Kernel > Add > AirPortBrcmNIC_Injector > Enabled = Yes

We also need to disable pci-aspm-default to fix system freezes caused from this card: Go into EFI/OC/Config.plist > DeviceProperties > and rename / uncomment:

  • #PciRoot(0x0)/Pci(0x1C,0x1)/Pci(0x0,0x0) to PciRoot(0x0)/Pci(0x1C,0x1)/Pci(0x0,0x0) and the device property:
  • #pci-aspm-default to pci-aspm-default

BCM4360NG

This card is the best one you can find for the moment, it is the same as the Apple BCM94360CS2 which works natively but it does have a standard NGFF form factor.

BCM94360CS2

This is the native Apple Wireless and Bluetooth card that can be found on MacBookPro(s). In order to fit this one you will have to buy the NGFF adapter and the extending cable module. There is not enough room to fit the full height so you will be required to place it somewhere else.

Country Code for Wireless Cards

Some countries have different 5GHz bands and may not be supported for some, the default one is set as US. You can specify other country codes like: US, CN, #a, etc by going into:

  • EFI/OC/Config.plist > DeviceProperties > Add > PciRoot(0x0)/Pci(0x1C,0x1)/Pci(0x0,0x0) and rename/uncomment:
  • #country-code to country-code and set the desired value (#a is the preset value, replace with the country code that you need)

Credits

  • zhen-zen for YogaSMC and BrightnessKeys
  • benbender for SSDT-BATX, Touchscreen Gestures and ACPI refinements

About

Lenovo ThinkPad X240 using OpenCore Bootloader

Topics

Resources

Stars

Watchers

Forks

Languages