mirror of
https://github.com/t2linux/T2-Ubuntu.git
synced 2024-09-11 13:17:27 +03:00
Update README.md
This commit is contained in:
parent
fa99d8d053
commit
0c838a64ef
62
README.md
62
README.md
@ -1,18 +1,18 @@
|
||||
# mbp-ubuntu
|
||||
# T2-Ubuntu
|
||||
|
||||
The ISO in from this repo should allow you to install ubuntu without using an external keyboard or mouse on a MacBook Pro. It work in my MacBook with T2.
|
||||
The ISOs from this repo should allow you to install Ubuntu without using an external keyboard or mouse on a T2 Mac. It works in my MacBook Pro 16 inch, 2019.
|
||||
|
||||
[![CI](https://github.com/AdityaGarg8/mbp-ubuntu/actions/workflows/CI.yml/badge.svg)](https://github.com/marcosfad/mbp-ubuntu/actions/workflows/CI.yml)
|
||||
|
||||
**If this repo helped you in any way, consider inviting a coffee to the people in the [credits](https://github.com/marcosfad/mbp-ubuntu#credits) or [me](https://paypal.me/marcosfad).**
|
||||
**If this repo helped you in any way, consider inviting a coffee to the people in the [credits](https://github.com/marcosfad/mbp-ubuntu#credits), [link](https://wiki.t2linux.org/contribute/).
|
||||
|
||||
UBUNTU ISO with Apple T2 patches built-in.
|
||||
|
||||
Apple T2 drivers are integrated with this iso.
|
||||
|
||||
This repo is a rework of the great work done by [@mikeeq](https://github.com/mikeeq/mbp-fedora)
|
||||
This repo is a rework of the great work done by [@mikeeq](https://github.com/mikeeq/mbp-fedora) and [@marcosfad](https://github.com/marcosfad/mbp-ubuntu)
|
||||
|
||||
I'm using the Kernel from - <https://github.com/marcosfad/mbp-ubuntu-kernel>
|
||||
I'm using the Kernel from - <https://github.com/t2linux/T2-Ubuntu-Kernel>
|
||||
|
||||
Using additional drivers:
|
||||
- [Apple T2 (apple-bce) (audio, keyboard, touchpad)](https://github.com/t2linux/apple-bce-drv)
|
||||
@ -20,16 +20,10 @@ Using additional drivers:
|
||||
|
||||
Bootloader is configure correctly out of the box. No workaround needed.
|
||||
|
||||
## Before I begin, what version should I use? "mbp" or "mbp-16x-wifi"?
|
||||
|
||||
The difference between the two is that the mbp-16x-wifi version includes a different version of the brcmfmac wifi driver, made by corellium for M1 macs. This version of the wifi driver works on some models that the brcmfmac driver included with the mbp version doesn't support. Refer to the table on [this page](https://wiki.t2linux.org/guides/wifi/) to figure out which versions will work (Look at the "Firmware Options" column, Mojave means you can use the "mbp" version, and Big Sur means you can use the "mbp-16x-wifi" version).
|
||||
|
||||
**!! Please note that as of the v20.04-5.10.52 release, the mbp-16x-wifi iso does not support wifi on models with the BCM4377 chipset. For now, you can install a kernel from [here](https://github.com/AdityaGarg8/mbp-16.x-ubuntu-kernel/releases/tag/v5.13.12-1) after installing ubuntu if you have the BCM4377 chipset.**
|
||||
|
||||
## Installation
|
||||
|
||||
1. Reduce the size of the mac partition in MacOS
|
||||
2. Download ISO file from releases. (Use the command line to unzip (`unzip /path/to/file.zip`) or "The Unarchiver" app)
|
||||
2. Download ISO file from releases.
|
||||
3. Copy it to a USB using dd (or gdd if installed over brew):
|
||||
```bash
|
||||
diskutil list # found which number has the USB
|
||||
@ -42,12 +36,11 @@ sudo gdd bs=4M if=ubuntu-20.04-5.6.10-mbp.iso of=/dev/diskX conv=fdatasync statu
|
||||
7. Launch Ubuntu Live
|
||||
8. Use Ubiquity to install (just click on it)
|
||||
9. Select the options that work for you and use for the partition the following setup:
|
||||
* Leave the efi boot as preselected by the installer. Your Mac will keep on working with out problems.
|
||||
* Add a ext4 partition and mounted as `/boot` (1024MB).
|
||||
* Add a ext4 partition and monted as `/` (rest).
|
||||
* Select the `/boot` partition as a target for GRUB installation, otherwise the system won't boot.
|
||||
10. Run the installer (In my case it had some problem removing some packages at the end, but this is no real problem)
|
||||
11. Shutdown and remove the USB Drive
|
||||
* Leave the efi boot as preselected by the installer, unless you require a [separate efi partition](https://wiki.t2linux.org/guides/windows/#using-seperate-efi-partitions).
|
||||
* Add a ext4 partition and monted as `/`.
|
||||
* Swap and other partitions are optional.
|
||||
10. Run the installer.
|
||||
11. Shutdown and remove the USB Drive.
|
||||
12. Start again using the option key. Select the new efi boot.
|
||||
13. Enjoy.
|
||||
|
||||
@ -62,8 +55,6 @@ sudo gdd bs=4M if=ubuntu-20.04-5.6.10-mbp.iso of=/dev/diskX conv=fdatasync statu
|
||||
options hid_apple swap_fn_leftctrl=1
|
||||
options hid_apple swap_opt_cmd=1
|
||||
```
|
||||
- I switch the touchbar to show f* by default. If you like another configuration, change /etc/modprobe.d/apple-tb.conf or remove it.
|
||||
- To update grub, run: `grub-mkconfig -o /boot/grub/grub.cfg`
|
||||
|
||||
## MISC
|
||||
|
||||
@ -79,46 +70,26 @@ and then:
|
||||
|
||||
## Update to newer kernels
|
||||
|
||||
**IF YOU UPDATE THE KERNEL, REMEMBER TO ADD THE REQUIRED DRIVERS AGAIN.**
|
||||
|
||||
### The easy way:
|
||||
|
||||
The live cd includes dkms and will automatically run when a new kernel is installed. You can use `dkms status` to see it.
|
||||
|
||||
If you are upgrading from 5.7.19 to a newer kernel version (5.10+), you will need updated versions of these kernel modules. Instructions for installing updated ones are [here](https://wiki.t2linux.org/guides/dkms/).
|
||||
|
||||
### Another way:
|
||||
|
||||
Check <https://github.com/marcosfad/mbp-ubuntu/blob/master/files/chroot_build.sh> to see how it is done.
|
||||
Follow [this guide](https://github.com/t2linux/T2-Ubuntu-Kernel#pre-installation-steps).
|
||||
|
||||
## Know issues
|
||||
|
||||
- Sound is not working after the install. Follow the instructions detailed by @kevineinarsson: <https://gist.github.com/kevineinarsson/8e5e92664f97508277fefef1b8015fba>
|
||||
On MBP 16,1, you might also need to disable realtime scheduling if the above gist doesn't work, because the pulseaudio server might get killed if the realtime budget is exceeded (<https://bugs.freedesktop.org/show_bug.cgi?id=94629>). Just add `realtime-scheduling = no` to `/etc/pulse/daemon.conf`.
|
||||
- Checksum is failing for 2 files: md5sum.txt and /boot/grub/bios.img
|
||||
- I'm having troubles shutting down ubuntu. Screen is black but fan keeps on working. I have to force shutdown.
|
||||
- Checksum is failing for 2 files: md5sum.txt and /boot/grub/bios.img
|
||||
|
||||
## Not working (Following the mikeeq/mbp-fedora)
|
||||
|
||||
- Dynamic audio input/output change (on connecting/disconnecting headphones jack)
|
||||
- TouchID - (@MCMrARM is working on it - https://github.com/Dunedan/mbp-2016-linux/issues/71#issuecomment-528545490)
|
||||
- TouchID
|
||||
- Thunderbolt (is disabled, because driver was causing kernel panics (not tested with 5.5 kernel))
|
||||
- Microphone (it's recognised with new apple t2 sound driver, but there is a low mic volume amp)
|
||||
|
||||
## TODO
|
||||
## Known issues
|
||||
|
||||
- ISO is using gzip initramfs. It would be great to change it lz4
|
||||
- Optimize the software installed.
|
||||
|
||||
## Known issues (Following the mikeeq/mbp-fedora)
|
||||
|
||||
- Kernel/Mac related issues are mentioned in kernel repo
|
||||
- `ctrl+x` is not working in GRUB, so if you are trying to change kernel parameters - start your OS by clicking `ctrl+shift+f10` on external keyboard
|
||||
- `ctrl+x` is not working in GRUB, so if you are trying to change kernel parameters - start your OS by pressing `F10` on external keyboard
|
||||
|
||||
## Docs
|
||||
|
||||
- Discord: <https://discord.gg/Uw56rqW> Shout out to the great community support. If you are not there yet, you must definitely join us.
|
||||
- WiFi firmware: <https://packages.aunali1.com/apple/wifi-fw/18G2022>
|
||||
- Linux on a MBP Late 2016: <https://gist.github.com/gbrow004/096f845c8fe8d03ef9009fbb87b781a4>
|
||||
- Repack Bootable ISO: <https://wiki.debian.org/RepackBootableISO>
|
||||
- <https://github.com/syzdek/efibootiso>
|
||||
@ -148,6 +119,7 @@ On MBP 16,1, you might also need to disable realtime scheduling if the above gis
|
||||
## Credits
|
||||
|
||||
- @mikeeq - thanks for the amazing work in mbp-fedora
|
||||
- @marcosfad - thanks for the original work in mbp-ubuntu
|
||||
- @MCMrARM - thanks for all RE work
|
||||
- @ozbenh - thanks for submitting NVME patch
|
||||
- @roadrunner2 - thanks for SPI (touchbar) driver
|
||||
|
Loading…
Reference in New Issue
Block a user