Skip to content
This repository was archived by the owner on Feb 18, 2022. It is now read-only.

Commit 595b405

Browse files
authored
Update README.md
1 parent d425c9f commit 595b405

1 file changed

Lines changed: 26 additions & 79 deletions

File tree

README.md

Lines changed: 26 additions & 79 deletions
Original file line numberDiff line numberDiff line change
@@ -1,90 +1,37 @@
1-
# mbp-ubuntu-kernel
1+
## mbp-ubuntu-kernel:
22

3-
Ubuntu/Mint/Debian kernel 5.6+ with Apple T2 patches built-in. This repo try to keep up with kernel new releases.
3+
Linux kernel 5.8+ with Apple T2 patches built-in, will try to keep up with new kernel releases.
4+
5+
This project is closely inspired by marcosfad/mbp-ubuntu-kernel.
46

5-
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).
7+
## Drivers included:
68

7-
**!! Warning:**
9+
See zappacor-patches-<kernel_version>
810

9-
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.
11+
## Installation:
1012

11-
**!! Warning:**
13+
Follow the steps on zappacor-build-<kernel_version>
1214

13-
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.
15+
## Notes:
1416

15-
**Drivers included:**
17+
WiFi is still not working on the MacBooks 16,2
1618

17-
- Apple T2 (audio, keyboard, touchpad) - <https://github.com/MCMrARM/mbp2018-bridge-drv>
18-
- Apple SMC - <https://github.com/MCMrARM/mbp2018-etc>
19-
- Touchbar - <https://github.com/roadrunner2/macbook12-spi-driver/tree/mbp15>
19+
## If this repo helped you in any way:
2020

21-
This project is closely inspired by mikeeq/mbp-fedora-kernel. Thank you @mikeeq for the scripts and setup.
21+
Please consider inviting a coffee to those on the credits list.
2222

23-
**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)**
23+
## Credits:
2424

25-
## CI status
26-
27-
Drone kernel build status:
28-
[![Build Status](https://cloud.drone.io/api/badges/marcosfad/mbp-ubuntu-kernel/status.svg)](https://cloud.drone.io/marcosfad/mbp-ubuntu-kernel)
29-
30-
Travis kernel publish status - <http://mbp-ubuntu-kernel.herokuapp.com/> :
31-
[![Build Status](https://travis-ci.com/marcosfad/mbp-ubuntu-kernel.svg?branch=master)](https://travis-ci.com/marcosfad/mbp-ubuntu-kernel)
32-
33-
## INSTALLATION
34-
35-
### The easy way
36-
37-
Use the [mbp-ubuntu](https://github.com/marcosfad/mbp-ubuntu/releases) live cd to install ubuntu on your Mac.
38-
39-
### Manually
40-
41-
Add the repo to your apt sources
42-
```bash
43-
echo "deb https://mbp-ubuntu-kernel.herokuapp.com/ /" >/etc/apt/sources.list.d/mbp-ubuntu-kernel.list
44-
curl -L https://mbp-ubuntu-kernel.herokuapp.com/KEY.gpg | apt-key add -
45-
apt-get update
46-
```
47-
Install the kernel using apt, for example kernel 5.7.9:
48-
```bash
49-
apt-get install linux-headers-5.7.9-mbp linux-image-5.7.9-mbp
50-
```
51-
52-
## Docs
53-
54-
- Discord: <https://discord.gg/Uw56rqW>
55-
- WiFi firmware: <https://packages.aunali1.com/apple/wifi-fw/18G2022>
56-
- blog `Installing Fedora 31 on a 2018 Mac mini`: <https://linuxwit.ch/blog/2020/01/installing-fedora-on-mac-mini/>
57-
- iwd:
58-
- <https://iwd.wiki.kernel.org/networkconfigurationsettings>
59-
- <https://wiki.archlinux.org/index.php/Iwd>
60-
- <https://www.vocal.com/secure-communication/eap-types/>
61-
62-
### Ubuntu
63-
64-
- <https://wiki.ubuntu.com/KernelTeam/GitKernelBuild>
65-
- <https://help.ubuntu.com/community/Repositories/Personal>
66-
- <https://medium.com/sqooba/create-your-own-custom-and-authenticated-apt-repository-1e4a4cf0b864>
67-
- <https://help.ubuntu.com/community/Kernel/Compile>
68-
- <https://wiki.ubuntu.com/Kernel/BuildYourOwnKernel>
69-
- <https://www.linux.com/training-tutorials/kernel-newbie-corner-building-and-running-new-kernel/>
70-
- <https://wiki.ubuntu.com/KernelTeam/KernelMaintenance>
71-
72-
### Github
73-
74-
- GitHub issue (RE history): <https://github.com/Dunedan/mbp-2016-linux/issues/71>
75-
- VHCI+Sound driver (Apple T2): <https://github.com/MCMrARM/mbp2018-bridge-drv/>
76-
- AppleSMC driver (fan control): <https://github.com/MCMrARM/mbp2018-etc/tree/master/applesmc>
77-
- hid-apple keyboard backlight patch: <https://github.com/MCMrARM/mbp2018-etc/tree/master/apple-hid>
78-
- TouchBar driver: <https://github.com/roadrunner2/macbook12-spi-driver/tree/mbp15>
79-
- Kernel patches (all are mentioned in github issue above): <https://github.com/aunali1/linux-mbp-arch>
80-
- ArchLinux kernel patches: <https://github.com/ppaulweber/linux-mba>
81-
- hid-apple-patched module for changing mappings of ctrl, fn, option keys: <https://github.com/free5lot/hid-apple-patched>
82-
83-
## Credits
84-
85-
- @MCMrARM - thanks for all RE work
86-
- @ozbenh - thanks for submitting NVME patch
87-
- @roadrunner2 - thanks for SPI (touchbar) driver
88-
- @aunali1 - thanks for ArchLinux Kernel CI and active support.
89-
- @ppaulweber - thanks for keyboard and Macbook Air patches
90-
- @mikeeq - thanks for the fedora kernel project and compilation scripts
25+
@marcosfad - for starting things up on Ubuntu/Debian
26+
27+
@MCMrARM - thanks for all RE work
28+
29+
@ozbenh - thanks for submitting NVME patch
30+
31+
@roadrunner2 - thanks for SPI (touchbar) driver
32+
33+
@aunali1 - thanks for ArchLinux Kernel CI and active support
34+
35+
@ppaulweber - thanks for keyboard and Macbook Air patches
36+
37+
@mikeeq - thanks for the fedora kernel project and compilation scripts

0 commit comments

Comments
 (0)