Skip to content

Commit

Permalink
Merge pull request marcosfad#4 from AdityaGarg8/master
Browse files Browse the repository at this point in the history
Updated readme
  • Loading branch information
Redecorating authored Jul 23, 2021
2 parents 2301b61 + e475043 commit 4e3dec3
Showing 1 changed file with 14 additions and 52 deletions.
66 changes: 14 additions & 52 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,53 +1,22 @@
# mbp-ubuntu-kernel

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

We release 2 alternative kernels: **"mbp"** which includes all patches from [Aunali1's linux mbp arch](https://github.com/aunali1/linux-mbp-arch) which should work in mostly everywhere and an alternative release (**"mbp-alt"**) which do not include the patch 2001 (drm amd display force link-rate).
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.

**!! Warning:**

Starting from the kernel 5.8 the release naming were switch with respect to kernel 5.7: Before the "mbp" release did not include all the patches. **Now the "mbp" includes all patches** and the "mbp-alt" don't.

**!! Warning:**

It seems, that the kernel 5.8 is not working as smooth as the 5.7 branch. If you experience problems while installing or running the linux in your mbp, try using an older Kernel.

**Drivers included:**

- 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 this repo helped you in any way, consider inviting a coffee to the people in the [credits](https://github.com/marcosfad/mbp-ubuntu-kernel#credits) or [me](https://paypal.me/marcosfad)**

## CI status

Drone kernel build status:
[![Build Status](https://cloud.drone.io/api/badges/marcosfad/mbp-ubuntu-kernel/status.svg)](https://cloud.drone.io/marcosfad/mbp-ubuntu-kernel)

Travis kernel publish status - <http://mbp-ubuntu-kernel.herokuapp.com/> :
[![Build Status](https://travis-ci.com/marcosfad/mbp-ubuntu-kernel.svg?branch=master)](https://travis-ci.com/marcosfad/mbp-ubuntu-kernel)
**If this repo helped you in any way, consider inviting a coffee to the people in the [credits](https://github.com/marcosfad/mbp-ubuntu-kernel#credits).**

## INSTALLATION

### The easy way

Use the [mbp-ubuntu](https://github.com/marcosfad/mbp-ubuntu/releases) live cd to install ubuntu on your Mac.
Download the .deb packages of **linux headers** and **linux image** of the kernel you wish to install from the [releases](https://github.com/Redecorating/mbp-ubuntu-kernel/releases) section.

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

Add the repo to your apt sources
```bash
echo "deb https://mbp-ubuntu-kernel.herokuapp.com/ /" >/etc/apt/sources.list.d/mbp-ubuntu-kernel.list
curl -L https://mbp-ubuntu-kernel.herokuapp.com/KEY.gpg | apt-key add -
apt-get update
```
Install the kernel using apt, for example kernel 5.7.9:
```bash
apt-get install linux-headers-5.7.9-mbp linux-image-5.7.9-mbp
```
Do the similar process for **linux images** package.

Restart your Mac.

### Building yourself

Expand All @@ -72,7 +41,7 @@ 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. Similarly install the `linux-image` package too.
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.

Expand All @@ -81,7 +50,9 @@ You may then delete the `/root/work` directory to free up space.
## Docs

- Discord: <https://discord.gg/Uw56rqW>
- WiFi firmware: <https://packages.aunali1.com/apple/wifi-fw/18G2022>
- 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>
Expand All @@ -98,23 +69,14 @@ You may then delete the `/root/work` directory to free up space.
- <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

- @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

Expand Down

0 comments on commit 4e3dec3

Please sign in to comment.