okimaureen / gubuntu-kernel

Ubuntu Kernel for MacBook Pro (incl. T2 patches) - This fork has wifi support for 16,X models

mbp-ubuntu-kernel

This repo probably won't be updated, please use https://github.com/AdityaGarg8/mbp-16.x-ubuntu-kernel/releases (probably will be updated faster) or https://github.com/marcosfad/mbp-ubuntu-kernel/releases

Ubuntu/Mint/Debian kernel 5.6+ with Apple T2 patches built-in. This repo will try to keep up with kernel new releases.

This project is closely inspired by mikeeq/mbp-fedora-kernel and marcosfad/mbp-ubuntu-kernel. Thank you @mikeeq and @marcosfad for the scripts and setup.

If this repo helped you in any way, consider inviting a coffee to the people in the credits.

INSTALLATION

The easy way

Download the .deb packages of linux headers and linux image of the kernel you wish to install from the releases section.

On terminal, type sudo apt install and then drag and drop the linux headers file to the terminal and press enter/return key.

Do the similar process for linux images package.

Restart your Mac.

Building yourself

Clone the repo using

git clone https://github.com/Redecorating/mbp-ubuntu-kernel

Open jamlam's repo in your browser.

Check out the kernel version it is offering right now.

Now edit build.sh file in mbp-ubuntu-kernel folder of your home directory. Replace the kernel version given in KERNEL_VERSION by the one on jamlam's repo.

Now edit patch_driver.sh file in the same folder. Replace the commit hash in APPLE_SMC_DRIVER_COMMIT_HASH with the latest one in jamlam's repo. It can be found by click on the shortened hash or time elapsed since last update on the right of jamlam.

Now open a terminal window and run

cd mbp-ubuntu-kernel
sudo ./build.sh

The kernel shall take around an hour to compile. After that you shall find three .deb packages in /root/work.

Install the linux-headers package using apt on terminal as described in the above The easy way section. Similarly install the linux-image package too.

Restart your Mac.

You may then delete the /root/work directory to free up space.

Docs

• Discord: https://discord.gg/Uw56rqW
• WiFi firmware:
  • https://wiki.t2linux.org/guides/wifi/
  • https://github.com/Redecorating/archinstall-mbp/tree/packages/apple-t2-wifi-firmware/bigSurFW
• blog Installing Fedora 31 on a 2018 Mac mini: https://linuxwit.ch/blog/2020/01/installing-fedora-on-mac-mini/
• iwd:
  • https://iwd.wiki.kernel.org/networkconfigurationsettings
  • https://wiki.archlinux.org/index.php/Iwd
  • https://www.vocal.com/secure-communication/eap-types/

Ubuntu

• https://wiki.ubuntu.com/KernelTeam/GitKernelBuild
• https://help.ubuntu.com/community/Repositories/Personal
• https://medium.com/sqooba/create-your-own-custom-and-authenticated-apt-repository-1e4a4cf0b864
• https://help.ubuntu.com/community/Kernel/Compile
• https://wiki.ubuntu.com/Kernel/BuildYourOwnKernel
• https://www.linux.com/training-tutorials/kernel-newbie-corner-building-and-running-new-kernel/
• https://wiki.ubuntu.com/KernelTeam/KernelMaintenance

Credits

• @marcosfad - thanks for the original script for Ubuntu
• @MCMrARM - thanks for all RE work
• @ozbenh - thanks for submitting NVME patch
• @roadrunner2 - thanks for SPI (touchbar) driver
• @aunali1 - thanks for ArchLinux Kernel CI and active support.
• @jamlam - thanks for providing the Correlium wifi patch.
• @ppaulweber - thanks for keyboard and Macbook Air patches
• @mikeeq - thanks for the fedora kernel project and compilation scripts