From 568c959ab87435cab84a859deb16cf19263c1e58 Mon Sep 17 00:00:00 2001 From: netnef <153968663+netnef@users.noreply.github.com> Date: Fri, 15 Dec 2023 23:52:39 -0600 Subject: [PATCH 01/12] Tips for code contributions --- docs/contribute.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/contribute.md b/docs/contribute.md index 02258c43..76b93c2b 100644 --- a/docs/contribute.md +++ b/docs/contribute.md @@ -4,6 +4,9 @@ The T2 project itself currently does not accept financial donations. However, so The best way of donation which we believe is in the form of skill. If you think you have the potential to help us in pushing the project further like fixing bugs, adding new features etc., you are free to do so. For this, you may contact our discord server, where other members of this organization are present. +## Contribute to the code +See "partially working" features at [State](https://wiki.t2linux.org/state/) to get an idea of what's being worked on, and what should be worked on. + ## Support our maintainers Here is the list and links to donate some of our maintainers. From a6ee73fcfa8bb3f5dd4fe881de623a7db6562e76 Mon Sep 17 00:00:00 2001 From: netnef <153968663+netnef@users.noreply.github.com> Date: Fri, 15 Dec 2023 23:54:29 -0600 Subject: [PATCH 02/12] Update state.md --- docs/state.md | 53 ++++++++++++++++++++++----------------------------- 1 file changed, 23 insertions(+), 30 deletions(-) diff --git a/docs/state.md b/docs/state.md index ca3185cc..3caa2d48 100644 --- a/docs/state.md +++ b/docs/state.md @@ -1,35 +1,28 @@ -# Introduction +# State While Linux is usable on all T2 models, some features are limited due to the lack of drivers or similar. This page should give a general overview of what is working and what is not. -## Working - -- Internal Drive / SSD: Support for the SSD has been upstreamed to the Linux Kernel -- Screen -- USB -- Keyboard -- Camera -- Wi-Fi (requires macOS firmware) -- Bluetooth (requires macOS firmware only for devices with BCM4377 chip. Also, Bluetooth glitches on devices with BCM4377 Chip if connected to a 2.4 Ghz Wi-Fi connection. Thus, in order to use Bluetooth either turn off your Wi-Fi or use a 5Ghz Wi-Fi connection.) -- Touch Bar: There is support for the "Touch Bar Keyboard" device configuration, where only the Function Keys or the Media/Brightness Control Keys can be shown. No other graphics can be shown on the Touchbar (this is what Windows with Bootcamp drivers uses). -- Suspend - -## Partially Working - -- Trackpad: Functions, but it is far from the experience on macOS (No force touch or palm rejection). Some models have deadzones on the edges of their trackpads where swipes along the trackpad that start in these deadzones will not be registered. -- Audio: With proper configuration audio can work, however it is not stable in some older kernels and switching between speakers and when using the microphone. Microphone volume is low in some Macs. -- Hybrid Graphics: If the device has a dedicated AMD GPU (15 and 16 inch MacBookPro's) as well as an Intel iGPU, the iGPU can be used, but this breaks resume, see the [Hybrid Graphics](https://wiki.t2linux.org/guides/hybrid-graphics/) page. -- AMD GPUs: Changing resolution, using DRI_PRIME and doing various other things can cause crashes, but `echo high | sudo tee /sys/bus/pci/drivers/amdgpu/0000:??:??.?/power_dpm_force_performance_level` or adding `amdgpu.dpm=0` to the kernel commandline stops these crashes. -- MacPro7,1: Users have encountered PCIE Address Space issues, with auto remap breaking. - -## Not working - -- Custom graphics on Touchbar: There is currently no Linux driver for the Touchbar's "Touch Bar Display" device configuration, which is what macOS uses, and gives full control over the display to the Operating System. -- T2 Secure Enclave Processor (Touch ID, storing encryption keys on the T2) -- The T2's onboard Audio Video Encoder (used for Sidecar on macOS) -- Graphics switching without rebooting (gmux) - -## Other - +|Feature|Status|Upstream|Notes|Issues/links| +|-|-|-|-|-| +|Internal Drive / SSD|🟢 Working|🟢 Kernel 5.4||[Filesystem notes](#filesystem-notes)| +|Screen|🟢 Working|🟢 Yes||| +|USB|🟢 Working|🟢 Yes||| +|Keyboard|🟢 Working|🔴 No||[apple-bce](https://github.com/t2linux/apple-bce-drv)| +|Camera|🟢 Working|🟢 Yes||| +|Wi-Fi|🟢 Working|🔴 No|Requires macOS firmware|[Setup guide](https://wiki.t2linux.org/guides/wifi-bluetooth/)| +|Bluetooth|🟢 Working|🔴 No|Requires macOS firmware only for devices with BCM4377 chip. Also, Bluetooth glitches on devices with BCM4377 Chip if connected to a 2.4 Ghz Wi-Fi connection. Thus, in order to use Bluetooth either turn off your Wi-Fi or use a 5Ghz Wi-Fi connection.|[Setup guide](https://wiki.t2linux.org/guides/wifi-bluetooth/)| +|Touch Bar|🟢 Working|🔴 No|There is support for the "Touch Bar Keyboard" device configuration, where only the Function Keys or the Media/Brightness Control Keys can be shown. There is work in progress support for custom graphics on the Touch Bar.|[tiny-dfr](https://github.com/kekrby/tiny-dfr)
[apple-ib](https://github.com/t2linux/apple-ib-drv)| +|Suspend|🟡 Partially working|🟢 Yes|A firmware upgrade attached to macOS Sonoma broke suspend. Some users were having difficulty with it even before Sonoma.|[#53](https://github.com/t2linux/T2-Ubuntu-Kernel/issues/53)| +|Trackpad|🟡 Partially working|🔴 No|Functions, but it is far from the experience on macOS (No force touch or palm rejection). Some models have deadzones on the edges of their trackpads where swipes along the trackpad that start in these deadzones will not be registered.|[apple-bce](https://github.com/t2linux/apple-bce-drv)| +|Audio|🟡 Partially working|🔴 No|With proper configuration audio can work, however it is not stable in some older kernels and switching between speakers and when using the microphone. Microphone volume is low in some Macs.|[apple-bce](https://github.com/t2linux/apple-bce-drv)| +|Hybrid Graphics|🟡 Partially working|🟡 Partial|If the device has a dedicated AMD GPU (15 and 16 inch MacBookPro's) as well as an Intel iGPU, the iGPU can be used, but this breaks resume.|[Hybrid Graphics](https://wiki.t2linux.org/guides/hybrid-graphics/)| +|AMD GPUs|🟡 Partially working||Changing resolution, using DRI_PRIME and doing various other things can cause crashes, but `echo high \| sudo tee /sys/bus/pci/drivers/amdgpu/0000:??:??.?/power_dpm_force_performance_level` or adding `amdgpu.dpm=0` to the kernel commandline stops these crashes.|| +|MacPro7,1|🟡 Partially working||Users have encountered PCIE Address Space issues, with auto remap breaking.|| +|T2 Secure Enclave|🔴 Not working||Used for Touch ID, storing encryption keys on macOS|| +|T2 Audio Video Encoder|🔴 Not working||Used for Sidecar on macOS|| + + + +## Filesystem notes - Linux using APFS filesystems: Linux cannot read the internal SSD's macOS APFS parition's Data and System volume (for other APFS volumes, [linux-apfs-rw](https://github.com/linux-apfs/linux-apfs-rw) can be used for reading data, but attempting to write is risky). - macOS using Linux filesystems: There are FUSE implementations of some Linux Filesystems that can be used on macOS (but again, most only have experemental write support). From 9a34ed3c2857d5143916f6f25a529b7149614056 Mon Sep 17 00:00:00 2001 From: netnef <153968663+netnef@users.noreply.github.com> Date: Sat, 16 Dec 2023 00:26:17 -0600 Subject: [PATCH 03/12] Update state.md --- docs/state.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/state.md b/docs/state.md index 3caa2d48..7410249f 100644 --- a/docs/state.md +++ b/docs/state.md @@ -21,8 +21,6 @@ While Linux is usable on all T2 models, some features are limited due to the lac |T2 Secure Enclave|🔴 Not working||Used for Touch ID, storing encryption keys on macOS|| |T2 Audio Video Encoder|🔴 Not working||Used for Sidecar on macOS|| - - ## Filesystem notes - Linux using APFS filesystems: Linux cannot read the internal SSD's macOS APFS parition's Data and System volume (for other APFS volumes, [linux-apfs-rw](https://github.com/linux-apfs/linux-apfs-rw) can be used for reading data, but attempting to write is risky). - macOS using Linux filesystems: There are FUSE implementations of some Linux Filesystems that can be used on macOS (but again, most only have experemental write support). From 2cdf3bd0ff15b97a1db67e14bafd3fe2a15fa903 Mon Sep 17 00:00:00 2001 From: Aditya Garg <85610623+AdityaGarg8@users.noreply.github.com> Date: Sat, 16 Dec 2023 17:56:44 +0530 Subject: [PATCH 04/12] Contribute: Remove AdityaGarg8 PayPal --- docs/contribute.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/contribute.md b/docs/contribute.md index 76b93c2b..b5088f64 100644 --- a/docs/contribute.md +++ b/docs/contribute.md @@ -16,5 +16,5 @@ Here is the list and links to donate some of our maintainers. - [marcosfad](https://github.com/marcosfad) - Played major role in getting Ubuntu working on T2 Macs. Donate via [Paypal](https://paypal.me/marcosfad) or [GitHub Sponsors](https://github.com/sponsors/marcosfad). - [NoaHimesaka1873](https://github.com/NoaHimesaka1873) - Currently maintains boot images for Arch, EndeavourOS, and Manjaro. Also maintains kernel for Manjaro too. Donate via [GitHub Sponsors](https://github.com/sponsors/NoaHimesaka1873) or [Toss (South Korea residents only)](https://toss.me/yuifmirror). - [Redecorating](https://github.com/Redecorating) - Currently maintains Arch kernel package, has written T2 related kernel patches and worked on T2 related kernel regressions. Donate via [PayPal](https://paypal.me/redecorating). -- [AdityaGarg8](https://github.com/AdityaGarg8) - Current maintainer of Ubuntu. Has also helped in writing T2 kernel patches and upstreaming various patches. Donate via **Amazon Gift Cards India** ([Link for Indians](https://www.amazon.in/s?k=amazon+e-gift+voucher&adgrpid=60620499282&ext_vrnc=hi&gclid=Cj0KCQjw8O-VBhCpARIsACMvVLMW9KEhsWO9xHEvOh7VLo3lCimvvJJqaKdqwj-OlN_ZAMp3ZIztQ0AaAtGAEALw_wcB&hvadid=294106443315&hvdev=m&hvlocphy=9075215&hvnetw=g&hvqmt=b&hvrand=11733182626932158840&hvtargid=kwd-314681002020&hydadcr=15237_1791630&tag=googinhydrmob-21&ref=pd_sl_3qs6ai50tg_b), [Link for other countries](https://www.g2a.com/search?query=Amazon%20India)), **GitHub sponsors** ([Link](https://github.com/sponsors/AdityaGarg8)) or **PayPal** ([Link](https://www.paypal.com/paypalme/AdityaGarg8)). The cards can be emailed to **gargaditya08@live.com** or via the discord. +- [AdityaGarg8](https://github.com/AdityaGarg8) - Current maintainer of Ubuntu. Has also helped in writing T2 kernel patches and upstreaming various patches. Donate via **Amazon Gift Cards India** ([Link for Indians](https://www.amazon.in/s?k=amazon+e-gift+voucher&adgrpid=60620499282&ext_vrnc=hi&gclid=Cj0KCQjw8O-VBhCpARIsACMvVLMW9KEhsWO9xHEvOh7VLo3lCimvvJJqaKdqwj-OlN_ZAMp3ZIztQ0AaAtGAEALw_wcB&hvadid=294106443315&hvdev=m&hvlocphy=9075215&hvnetw=g&hvqmt=b&hvrand=11733182626932158840&hvtargid=kwd-314681002020&hydadcr=15237_1791630&tag=googinhydrmob-21&ref=pd_sl_3qs6ai50tg_b), [Link for other countries](https://www.g2a.com/search?query=Amazon%20India)) or **GitHub sponsors** ([Link](https://github.com/sponsors/AdityaGarg8)). The cards can be emailed to **gargaditya08@live.com** or via the discord. - [networkException](https://github.com/networkException) - Wiki creator and maintainer. Donate via [GitHub Sponsors](https://github.com/sponsors/networkException). From 528d744d591af05e4663e0745c542eded451038f Mon Sep 17 00:00:00 2001 From: netnef <153968663+netnef@users.noreply.github.com> Date: Sat, 16 Dec 2023 08:20:06 -0600 Subject: [PATCH 05/12] Update state.md --- docs/state.md | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/docs/state.md b/docs/state.md index 7410249f..22902886 100644 --- a/docs/state.md +++ b/docs/state.md @@ -5,17 +5,18 @@ While Linux is usable on all T2 models, some features are limited due to the lac |Feature|Status|Upstream|Notes|Issues/links| |-|-|-|-|-| |Internal Drive / SSD|🟢 Working|🟢 Kernel 5.4||[Filesystem notes](#filesystem-notes)| -|Screen|🟢 Working|🟢 Yes||| +|Screen, iGPU|🟢 Working|🟡 Partial||| |USB|🟢 Working|🟢 Yes||| |Keyboard|🟢 Working|🔴 No||[apple-bce](https://github.com/t2linux/apple-bce-drv)| -|Camera|🟢 Working|🟢 Yes||| -|Wi-Fi|🟢 Working|🔴 No|Requires macOS firmware|[Setup guide](https://wiki.t2linux.org/guides/wifi-bluetooth/)| -|Bluetooth|🟢 Working|🔴 No|Requires macOS firmware only for devices with BCM4377 chip. Also, Bluetooth glitches on devices with BCM4377 Chip if connected to a 2.4 Ghz Wi-Fi connection. Thus, in order to use Bluetooth either turn off your Wi-Fi or use a 5Ghz Wi-Fi connection.|[Setup guide](https://wiki.t2linux.org/guides/wifi-bluetooth/)| -|Touch Bar|🟢 Working|🔴 No|There is support for the "Touch Bar Keyboard" device configuration, where only the Function Keys or the Media/Brightness Control Keys can be shown. There is work in progress support for custom graphics on the Touch Bar.|[tiny-dfr](https://github.com/kekrby/tiny-dfr)
[apple-ib](https://github.com/t2linux/apple-ib-drv)| -|Suspend|🟡 Partially working|🟢 Yes|A firmware upgrade attached to macOS Sonoma broke suspend. Some users were having difficulty with it even before Sonoma.|[#53](https://github.com/t2linux/T2-Ubuntu-Kernel/issues/53)| -|Trackpad|🟡 Partially working|🔴 No|Functions, but it is far from the experience on macOS (No force touch or palm rejection). Some models have deadzones on the edges of their trackpads where swipes along the trackpad that start in these deadzones will not be registered.|[apple-bce](https://github.com/t2linux/apple-bce-drv)| +|Trackpad|🟢 Working|🔴 No|Works, but isn't as great as on macOS (no force touch or palm rejection). Some models have deadzones on the edges of their trackpads where swipes along the trackpad that start in these deadzones will not be registered.|[apple-bce](https://github.com/t2linux/apple-bce-drv)| +|Wi-Fi|🟢 Working|🟢 Yes|Requires macOS firmware|[Setup guide](https://wiki.t2linux.org/guides/wifi-bluetooth/)| +|Bluetooth|🟡 Partially working|🟢 Yes|Requires macOS firmware only for devices with BCM4377 chip. Also, Bluetooth glitches on devices with BCM4377 Chip if connected to a 2.4 Ghz Wi-Fi connection. Thus, in order to use Bluetooth either turn off your Wi-Fi or use a 5Ghz Wi-Fi connection.|[Setup guide](https://wiki.t2linux.org/guides/wifi-bluetooth/)| +|Camera|🟢 Working|🔴 No||[apple-bce](https://github.com/t2linux/apple-bce-drv)| +|Thunderbolt|🟢 Working|🟢 Yes|If it doesn't work, try replacing `pcie_ports=compat` with `pcie_ports=native` in the kernel parameters via GRUB.|| +|Touch Bar|🟢 Working|🔴 No|"Touch Bar Keyboard" mode works OOTB, where only the Function Keys or the Media/Brightness Control Keys are shown. Support for custom graphics on the Touch Bar is being actively developed.|[tiny-dfr](https://github.com/kekrby/tiny-dfr)
[apple-ib](https://github.com/t2linux/apple-ib-drv)| +|Suspend|🟡 Partially working|🟢 Yes|A firmware upgrade attached to macOS Sonoma broke suspend. Some users were having difficulty with it even before Sonoma. The issue has something to do with the apple-bce driver, because suspend works when it's disabled.|[#53](https://github.com/t2linux/T2-Ubuntu-Kernel/issues/53)| |Audio|🟡 Partially working|🔴 No|With proper configuration audio can work, however it is not stable in some older kernels and switching between speakers and when using the microphone. Microphone volume is low in some Macs.|[apple-bce](https://github.com/t2linux/apple-bce-drv)| -|Hybrid Graphics|🟡 Partially working|🟡 Partial|If the device has a dedicated AMD GPU (15 and 16 inch MacBookPro's) as well as an Intel iGPU, the iGPU can be used, but this breaks resume.|[Hybrid Graphics](https://wiki.t2linux.org/guides/hybrid-graphics/)| +|Hybrid Graphics|🟡 Partially working|🟡 Partial|Toggling dGPU power doesn't work.|[Hybrid Graphics](https://wiki.t2linux.org/guides/hybrid-graphics/)| |AMD GPUs|🟡 Partially working||Changing resolution, using DRI_PRIME and doing various other things can cause crashes, but `echo high \| sudo tee /sys/bus/pci/drivers/amdgpu/0000:??:??.?/power_dpm_force_performance_level` or adding `amdgpu.dpm=0` to the kernel commandline stops these crashes.|| |MacPro7,1|🟡 Partially working||Users have encountered PCIE Address Space issues, with auto remap breaking.|| |T2 Secure Enclave|🔴 Not working||Used for Touch ID, storing encryption keys on macOS|| From a0d06954c7a90d2d475cb139f242494ff595afb7 Mon Sep 17 00:00:00 2001 From: Aditya Garg <85610623+AdityaGarg8@users.noreply.github.com> Date: Mon, 18 Dec 2023 16:05:28 +0530 Subject: [PATCH 06/12] Update contribute.md --- docs/contribute.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/contribute.md b/docs/contribute.md index b5088f64..0d5fac90 100644 --- a/docs/contribute.md +++ b/docs/contribute.md @@ -16,5 +16,5 @@ Here is the list and links to donate some of our maintainers. - [marcosfad](https://github.com/marcosfad) - Played major role in getting Ubuntu working on T2 Macs. Donate via [Paypal](https://paypal.me/marcosfad) or [GitHub Sponsors](https://github.com/sponsors/marcosfad). - [NoaHimesaka1873](https://github.com/NoaHimesaka1873) - Currently maintains boot images for Arch, EndeavourOS, and Manjaro. Also maintains kernel for Manjaro too. Donate via [GitHub Sponsors](https://github.com/sponsors/NoaHimesaka1873) or [Toss (South Korea residents only)](https://toss.me/yuifmirror). - [Redecorating](https://github.com/Redecorating) - Currently maintains Arch kernel package, has written T2 related kernel patches and worked on T2 related kernel regressions. Donate via [PayPal](https://paypal.me/redecorating). -- [AdityaGarg8](https://github.com/AdityaGarg8) - Current maintainer of Ubuntu. Has also helped in writing T2 kernel patches and upstreaming various patches. Donate via **Amazon Gift Cards India** ([Link for Indians](https://www.amazon.in/s?k=amazon+e-gift+voucher&adgrpid=60620499282&ext_vrnc=hi&gclid=Cj0KCQjw8O-VBhCpARIsACMvVLMW9KEhsWO9xHEvOh7VLo3lCimvvJJqaKdqwj-OlN_ZAMp3ZIztQ0AaAtGAEALw_wcB&hvadid=294106443315&hvdev=m&hvlocphy=9075215&hvnetw=g&hvqmt=b&hvrand=11733182626932158840&hvtargid=kwd-314681002020&hydadcr=15237_1791630&tag=googinhydrmob-21&ref=pd_sl_3qs6ai50tg_b), [Link for other countries](https://www.g2a.com/search?query=Amazon%20India)) or **GitHub sponsors** ([Link](https://github.com/sponsors/AdityaGarg8)). The cards can be emailed to **gargaditya08@live.com** or via the discord. +- [AdityaGarg8](https://github.com/AdityaGarg8) - Current maintainer of Ubuntu. Has also Current maintainer of Ubuntu. Has also helped in writing T2 kernel patches and upstreaming various patches. Donate via **Amazon Gift Cards India** ([Link for Indians](https://www.amazon.in/s?k=amazon+e-gift+voucher&adgrpid=60620499282&ext_vrnc=hi&gclid=Cj0KCQjw8O-VBhCpARIsACMvVLMW9KEhsWO9xHEvOh7VLo3lCimvvJJqaKdqwj-OlN_ZAMp3ZIztQ0AaAtGAEALw_wcB&hvadid=294106443315&hvdev=m&hvlocphy=9075215&hvnetw=g&hvqmt=b&hvrand=11733182626932158840&hvtargid=kwd-314681002020&hydadcr=15237_1791630&tag=googinhydrmob-21&ref=pd_sl_3qs6ai50tg_b), [Link for other countries](https://www.g2a.com/search?query=Amazon%20India)), **GitHub sponsors** ([Link](https://github.com/sponsors/AdityaGarg8)) or **PayPal** ([Link](https://www.paypal.com/paypalme/AdityaGarg8)). The cards can be emailed to **gargaditya08@live.com** or via the discord. - [networkException](https://github.com/networkException) - Wiki creator and maintainer. Donate via [GitHub Sponsors](https://github.com/sponsors/networkException). From 8c6e59ca0f63845ee0f91d62afd4c5b881752c0a Mon Sep 17 00:00:00 2001 From: netnef <153968663+netnef@users.noreply.github.com> Date: Mon, 18 Dec 2023 16:32:29 -0600 Subject: [PATCH 07/12] contribute.md: Fix lint error --- docs/contribute.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/contribute.md b/docs/contribute.md index 0d5fac90..39f6fa55 100644 --- a/docs/contribute.md +++ b/docs/contribute.md @@ -5,6 +5,7 @@ The T2 project itself currently does not accept financial donations. However, so The best way of donation which we believe is in the form of skill. If you think you have the potential to help us in pushing the project further like fixing bugs, adding new features etc., you are free to do so. For this, you may contact our discord server, where other members of this organization are present. ## Contribute to the code + See "partially working" features at [State](https://wiki.t2linux.org/state/) to get an idea of what's being worked on, and what should be worked on. ## Support our maintainers From c7fb06e89ad180f6d42b96dd6168e1d6c95a0e2d Mon Sep 17 00:00:00 2001 From: netnef <153968663+netnef@users.noreply.github.com> Date: Mon, 18 Dec 2023 16:35:50 -0600 Subject: [PATCH 08/12] state.md: Fix lint errors --- docs/state.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/state.md b/docs/state.md index 22902886..31f4b662 100644 --- a/docs/state.md +++ b/docs/state.md @@ -13,7 +13,7 @@ While Linux is usable on all T2 models, some features are limited due to the lac |Bluetooth|🟡 Partially working|🟢 Yes|Requires macOS firmware only for devices with BCM4377 chip. Also, Bluetooth glitches on devices with BCM4377 Chip if connected to a 2.4 Ghz Wi-Fi connection. Thus, in order to use Bluetooth either turn off your Wi-Fi or use a 5Ghz Wi-Fi connection.|[Setup guide](https://wiki.t2linux.org/guides/wifi-bluetooth/)| |Camera|🟢 Working|🔴 No||[apple-bce](https://github.com/t2linux/apple-bce-drv)| |Thunderbolt|🟢 Working|🟢 Yes|If it doesn't work, try replacing `pcie_ports=compat` with `pcie_ports=native` in the kernel parameters via GRUB.|| -|Touch Bar|🟢 Working|🔴 No|"Touch Bar Keyboard" mode works OOTB, where only the Function Keys or the Media/Brightness Control Keys are shown. Support for custom graphics on the Touch Bar is being actively developed.|[tiny-dfr](https://github.com/kekrby/tiny-dfr)
[apple-ib](https://github.com/t2linux/apple-ib-drv)| +|Touch Bar|🟢 Working|🔴 No|"Touch Bar Keyboard" mode works OOTB, where only the Function Keys or the Media/Brightness Control Keys are shown. Support for custom graphics on the Touch Bar is being actively developed.|[tiny-dfr](https://github.com/kekrby/tiny-dfr), [apple-ib](https://github.com/t2linux/apple-ib-drv)| |Suspend|🟡 Partially working|🟢 Yes|A firmware upgrade attached to macOS Sonoma broke suspend. Some users were having difficulty with it even before Sonoma. The issue has something to do with the apple-bce driver, because suspend works when it's disabled.|[#53](https://github.com/t2linux/T2-Ubuntu-Kernel/issues/53)| |Audio|🟡 Partially working|🔴 No|With proper configuration audio can work, however it is not stable in some older kernels and switching between speakers and when using the microphone. Microphone volume is low in some Macs.|[apple-bce](https://github.com/t2linux/apple-bce-drv)| |Hybrid Graphics|🟡 Partially working|🟡 Partial|Toggling dGPU power doesn't work.|[Hybrid Graphics](https://wiki.t2linux.org/guides/hybrid-graphics/)| @@ -23,5 +23,7 @@ While Linux is usable on all T2 models, some features are limited due to the lac |T2 Audio Video Encoder|🔴 Not working||Used for Sidecar on macOS|| ## Filesystem notes + - Linux using APFS filesystems: Linux cannot read the internal SSD's macOS APFS parition's Data and System volume (for other APFS volumes, [linux-apfs-rw](https://github.com/linux-apfs/linux-apfs-rw) can be used for reading data, but attempting to write is risky). + - macOS using Linux filesystems: There are FUSE implementations of some Linux Filesystems that can be used on macOS (but again, most only have experemental write support). From eb59407740ef1338964a6268d34e83f462862299 Mon Sep 17 00:00:00 2001 From: netnef <153968663+netnef@users.noreply.github.com> Date: Fri, 22 Dec 2023 17:48:58 -0600 Subject: [PATCH 09/12] Update contribute.md --- docs/contribute.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/contribute.md b/docs/contribute.md index 39f6fa55..bbb97b70 100644 --- a/docs/contribute.md +++ b/docs/contribute.md @@ -17,5 +17,5 @@ Here is the list and links to donate some of our maintainers. - [marcosfad](https://github.com/marcosfad) - Played major role in getting Ubuntu working on T2 Macs. Donate via [Paypal](https://paypal.me/marcosfad) or [GitHub Sponsors](https://github.com/sponsors/marcosfad). - [NoaHimesaka1873](https://github.com/NoaHimesaka1873) - Currently maintains boot images for Arch, EndeavourOS, and Manjaro. Also maintains kernel for Manjaro too. Donate via [GitHub Sponsors](https://github.com/sponsors/NoaHimesaka1873) or [Toss (South Korea residents only)](https://toss.me/yuifmirror). - [Redecorating](https://github.com/Redecorating) - Currently maintains Arch kernel package, has written T2 related kernel patches and worked on T2 related kernel regressions. Donate via [PayPal](https://paypal.me/redecorating). -- [AdityaGarg8](https://github.com/AdityaGarg8) - Current maintainer of Ubuntu. Has also Current maintainer of Ubuntu. Has also helped in writing T2 kernel patches and upstreaming various patches. Donate via **Amazon Gift Cards India** ([Link for Indians](https://www.amazon.in/s?k=amazon+e-gift+voucher&adgrpid=60620499282&ext_vrnc=hi&gclid=Cj0KCQjw8O-VBhCpARIsACMvVLMW9KEhsWO9xHEvOh7VLo3lCimvvJJqaKdqwj-OlN_ZAMp3ZIztQ0AaAtGAEALw_wcB&hvadid=294106443315&hvdev=m&hvlocphy=9075215&hvnetw=g&hvqmt=b&hvrand=11733182626932158840&hvtargid=kwd-314681002020&hydadcr=15237_1791630&tag=googinhydrmob-21&ref=pd_sl_3qs6ai50tg_b), [Link for other countries](https://www.g2a.com/search?query=Amazon%20India)), **GitHub sponsors** ([Link](https://github.com/sponsors/AdityaGarg8)) or **PayPal** ([Link](https://www.paypal.com/paypalme/AdityaGarg8)). The cards can be emailed to **gargaditya08@live.com** or via the discord. +- [AdityaGarg8](https://github.com/AdityaGarg8) - Current maintainer of Ubuntu. Has also helped in writing T2 kernel patches and upstreaming various patches. Donate via **Amazon Gift Cards India** ([Link for Indians](https://www.amazon.in/s?k=amazon+e-gift+voucher&adgrpid=60620499282&ext_vrnc=hi&gclid=Cj0KCQjw8O-VBhCpARIsACMvVLMW9KEhsWO9xHEvOh7VLo3lCimvvJJqaKdqwj-OlN_ZAMp3ZIztQ0AaAtGAEALw_wcB&hvadid=294106443315&hvdev=m&hvlocphy=9075215&hvnetw=g&hvqmt=b&hvrand=11733182626932158840&hvtargid=kwd-314681002020&hydadcr=15237_1791630&tag=googinhydrmob-21&ref=pd_sl_3qs6ai50tg_b), [Link for other countries](https://www.g2a.com/search?query=Amazon%20India)), **GitHub sponsors** ([Link](https://github.com/sponsors/AdityaGarg8)) or **PayPal** ([Link](https://www.paypal.com/paypalme/AdityaGarg8)). The cards can be emailed to **gargaditya08@live.com** or via the discord. - [networkException](https://github.com/networkException) - Wiki creator and maintainer. Donate via [GitHub Sponsors](https://github.com/sponsors/networkException). From 45cb1c7b6a0326fe30135442484fcfbb02e65df1 Mon Sep 17 00:00:00 2001 From: netnef <153968663+netnef@users.noreply.github.com> Date: Fri, 22 Dec 2023 18:17:12 -0600 Subject: [PATCH 10/12] Update index.md --- docs/index.md | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/docs/index.md b/docs/index.md index 0ac226a6..1254216f 100644 --- a/docs/index.md +++ b/docs/index.md @@ -43,7 +43,8 @@ The following repos contain kernel modules for said support: ## Guides and similar -Note that, if you are using one of the distributions listed above, you should follow their install guides rather than the ones listed under this section. However, they might still be important to gain a better general picture or to help with specific issues. +!!! Warning "The following guides are third party" + These guides/configurations aren't supported by t2linux maintainers. Use at your own risk. If you are using one of the distributions listed above, you should follow their install guides rather than the ones listed under this section. However, they might still be important to gain a better general picture or to help with specific issues. - List of Mac Model Identifiers on [everymac.com](https://everymac.com/systems/by_capability/mac-specs-by-machine-model-machine-id.html) - Using Luks with the integrated keyboard [https://github.com/DimitriDokuchaev/GrubLuksUnlock](https://github.com/DimitriDokuchaev/GrubLuksUnlock) @@ -53,11 +54,17 @@ Note that, if you are using one of the distributions listed above, you should fo - Get SMART information of your Apple Internal SSD using Linux [https://gist.github.com/AdityaGarg8/b03e57826213019fbffa747e1c724cac](https://gist.github.com/AdityaGarg8/b03e57826213019fbffa747e1c724cac) - Keyboard related issues [https://wiki.archlinux.org/title/Apple_Keyboard](https://wiki.archlinux.org/title/Apple_Keyboard) - Get silent boot experience similar to macOS and Windows on [Ubuntu](https://gist.github.com/AdityaGarg8/a39063f0d8c39572f03f55cbe02f9beb) and [Arch Linux](https://wiki.archlinux.org/title/silent_boot). -- Implement macOS-like Keyboard and trackpad experience on **Gnome Xorg**. Read the top comments of each file in the links given below to understand requirements, additional tools and usage. - - [Synaptics Config](https://gist.github.com/smileBeda/f0452f0d7f1f6d8aa772603411f7876f) (for general trackpad behaviour using Synaptics) - - [Fusuma Config](https://gist.github.com/smileBeda/74a52fe7cb0901da9e67ae4e39966982) (for additional gestures commands using Fusuma) -*Outdated* +### Trackpad tuning + +- Wayland + - libinput tuning is typically applied by distribution maintainers rather than end users. You can test changes on your own, see [debugging touchpad pressure](https://wayland.freedesktop.org/libinput/doc/latest/touchpad-pressure-debugging.html) and [palm detection](https://wayland.freedesktop.org/libinput/doc/latest/palm-detection.html) guides. If you get a configuration that works well, please notify the t2linux maintainers. +- Xorg **(deprecated, use Wayland instead if possible)** + - Implement macOS-like Keyboard and trackpad experience on Gnome Xorg. Read the top comments of each file in the links given below to understand requirements, additional tools and usage. + - [Synaptics Config](https://gist.github.com/smileBeda/f0452f0d7f1f6d8aa772603411f7876f) (for general trackpad behaviour using Synaptics) + - [Fusuma Config](https://gist.github.com/smileBeda/74a52fe7cb0901da9e67ae4e39966982) (for additional gestures commands using Fusuma) + +### Outdated - State of Linux on the MacBook Pro (technical documentation) [https://github.com/Dunedan/mbp-2016-linux](https://github.com/Dunedan/mbp-2016-linux) - Arch on 2018 MacBook Pro [https://gist.github.com/TRPB/437f663b545d23cc8a2073253c774be3](https://gist.github.com/TRPB/437f663b545d23cc8a2073253c774be3) From 79f3e04badb67f2b816c0b0395615658d9f6c2f3 Mon Sep 17 00:00:00 2001 From: netnef <153968663+netnef@users.noreply.github.com> Date: Fri, 22 Dec 2023 18:19:14 -0600 Subject: [PATCH 11/12] Update state.md --- docs/state.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/state.md b/docs/state.md index 31f4b662..b2298b15 100644 --- a/docs/state.md +++ b/docs/state.md @@ -8,7 +8,7 @@ While Linux is usable on all T2 models, some features are limited due to the lac |Screen, iGPU|🟢 Working|🟡 Partial||| |USB|🟢 Working|🟢 Yes||| |Keyboard|🟢 Working|🔴 No||[apple-bce](https://github.com/t2linux/apple-bce-drv)| -|Trackpad|🟢 Working|🔴 No|Works, but isn't as great as on macOS (no force touch or palm rejection). Some models have deadzones on the edges of their trackpads where swipes along the trackpad that start in these deadzones will not be registered.|[apple-bce](https://github.com/t2linux/apple-bce-drv)| +|Trackpad|🟢 Working|🔴 No|Works, but isn't as great as on macOS (no force touch or palm rejection). Some models have deadzones on the edges of their trackpads where swipes along the trackpad that start in these deadzones will not be registered.|[apple-bce](https://github.com/t2linux/apple-bce-drv), [Trackpad tuning](https://wiki.t2linux.org/#trackpad-tuning)| |Wi-Fi|🟢 Working|🟢 Yes|Requires macOS firmware|[Setup guide](https://wiki.t2linux.org/guides/wifi-bluetooth/)| |Bluetooth|🟡 Partially working|🟢 Yes|Requires macOS firmware only for devices with BCM4377 chip. Also, Bluetooth glitches on devices with BCM4377 Chip if connected to a 2.4 Ghz Wi-Fi connection. Thus, in order to use Bluetooth either turn off your Wi-Fi or use a 5Ghz Wi-Fi connection.|[Setup guide](https://wiki.t2linux.org/guides/wifi-bluetooth/)| |Camera|🟢 Working|🔴 No||[apple-bce](https://github.com/t2linux/apple-bce-drv)| From f00998060da8be5a67a48e57ffa3b75ebbf8002a Mon Sep 17 00:00:00 2001 From: netnef <153968663+netnef@users.noreply.github.com> Date: Fri, 22 Dec 2023 21:24:07 -0600 Subject: [PATCH 12/12] Update state.md --- docs/state.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/state.md b/docs/state.md index b2298b15..560ed7fd 100644 --- a/docs/state.md +++ b/docs/state.md @@ -8,7 +8,7 @@ While Linux is usable on all T2 models, some features are limited due to the lac |Screen, iGPU|🟢 Working|🟡 Partial||| |USB|🟢 Working|🟢 Yes||| |Keyboard|🟢 Working|🔴 No||[apple-bce](https://github.com/t2linux/apple-bce-drv)| -|Trackpad|🟢 Working|🔴 No|Works, but isn't as great as on macOS (no force touch or palm rejection). Some models have deadzones on the edges of their trackpads where swipes along the trackpad that start in these deadzones will not be registered.|[apple-bce](https://github.com/t2linux/apple-bce-drv), [Trackpad tuning](https://wiki.t2linux.org/#trackpad-tuning)| +|Trackpad|🟢 Working|🔴 No|Works, but isn't as great as on macOS (no force touch or palm rejection).|[apple-bce](https://github.com/t2linux/apple-bce-drv), [Trackpad tuning](https://wiki.t2linux.org/#trackpad-tuning)| |Wi-Fi|🟢 Working|🟢 Yes|Requires macOS firmware|[Setup guide](https://wiki.t2linux.org/guides/wifi-bluetooth/)| |Bluetooth|🟡 Partially working|🟢 Yes|Requires macOS firmware only for devices with BCM4377 chip. Also, Bluetooth glitches on devices with BCM4377 Chip if connected to a 2.4 Ghz Wi-Fi connection. Thus, in order to use Bluetooth either turn off your Wi-Fi or use a 5Ghz Wi-Fi connection.|[Setup guide](https://wiki.t2linux.org/guides/wifi-bluetooth/)| |Camera|🟢 Working|🔴 No||[apple-bce](https://github.com/t2linux/apple-bce-drv)|