mbp-ubuntu-kernel

This repo is still a work in progress.

Ubuntu/Mint/Debian kernel 5.6 with Apple T2 patches built-in (Macbooks produced >= 2018).

Drivers:

• Apple T2 (audio, keyboard, touchpad) - https://github.com/MCMrARM/mbp2018-bridge-drv
• Apple SMC - https://github.com/MCMrARM/mbp2018-etc
• Touchbar - https://github.com/roadrunner2/macbook12-spi-driver/tree/mbp15

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

IF YOU ENJOY THIS CODE, CONSIDER CONTRIBUTING TO THE AUTHORS @MCMrARM @roadrunner2 @aunali1 @ppaulweber @mikeeq, they did all the hard work.

CI status

Drone kernel build status:

Travis kernel publish status - http://mbp-ubuntu-kernel.herokuapp.com/ :

Docs

• Discord: https://discord.gg/Uw56rqW
• WiFi firmware: https://packages.aunali1.com/apple/wifi-fw/18G2022
• 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

Github

• GitHub issue (RE history): https://github.com/Dunedan/mbp-2016-linux/issues/71
• VHCI+Sound driver (Apple T2): https://github.com/MCMrARM/mbp2018-bridge-drv/
• AppleSMC driver (fan control): https://github.com/MCMrARM/mbp2018-etc/tree/master/applesmc
• hid-apple keyboard backlight patch: https://github.com/MCMrARM/mbp2018-etc/tree/master/apple-hid
• TouchBar driver: https://github.com/roadrunner2/macbook12-spi-driver/tree/mbp15
• Kernel patches (all are mentioned in github issue above): https://github.com/aunali1/linux-mbp-arch
• ArchLinux kernel patches: https://github.com/ppaulweber/linux-mba
• hid-apple-patched module for changing mappings of ctrl, fn, option keys: https://github.com/free5lot/hid-apple-patched

Credits

• @MCMrARM - thanks for all RE work
• @ozbenh - thanks for submitting NVME patch
• @roadrunner2 - thanks for SPI (touchbar) driver
• @aunali1 - thanks for ArchLinux Kernel CI
• @ppaulweber - thanks for keyboard and Macbook Air patches
• @mikeeq - thanks for the fedora kernel project and compilation scripts