t2linux/wiki
0
0
Fork 0
mirror of https://github.com/t2linux/wiki.git synced 2026-04-30 13:32:14 -07:00
Code Issues Packages Projects Releases Wiki Activity

wiki: replace pcie_ports=compat with pm_async=off

Browse Source
This commit is contained in:
Aditya Garg
2026-04-14 09:23:24 +05:30
parent c77c4f3888
commit 1b37211d72
7 changed files with 12 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/distributions/arch/installation.md
+2 -2
View File
@@ -52,7 +52,7 @@ You will need:
- Installing Grub:
1. Edit `/etc/default/grub`, you'll need to install a text editor (i.e. `vim` or `nano`) with `pacman -S PACKAGE_NAME` for this step.
2. On the line with `GRUB_CMDLINE_LINUX="quiet splash"`, add the following kernel parameters: `intel_iommu=on iommu=pt pcie_ports=compat`
2. On the line with `GRUB_CMDLINE_LINUX="quiet splash"`, add the following kernel parameters: `intel_iommu=on iommu=pt pm_async=off`
3. Run `grub-install --target=x86_64-efi --efi-directory=/boot --bootloader-id=GRUB --removable`.
4. Run `grub-mkconfig -o /boot/grub/grub.cfg` to generate configuration file.
@@ -60,6 +60,6 @@ You will need:
1. Follow the Arch wiki's [instructions](https://wiki.archlinux.org/title/Systemd-boot#Installation). You will want `--path=/boot` as an argument to `bootctl` if you mounted your EFI partition there. Also make sure you configure it to boot the `linux-t2` kernel.
2. Install a text editor (i.e. `pacman -S vim` or `pacman -S nano`), and make the following edit for `.conf` files in `/boot/efi/loader/entries/`.
3. Add `intel_iommu=on iommu=pt pcie_ports=compat` to the `options` line to add those kernel parameters.
3. Add `intel_iommu=on iommu=pt pm_async=off` to the `options` line to add those kernel parameters.
9. Exit the `chroot` (Control-d, or `exit`) and reboot. You now will be able to select your Arch install in the macOS Startup Manager by holding option at boot.
docs/distributions/debian/installation.md
+1 -1
View File
@@ -67,7 +67,7 @@ After installation, we need to install a kernel having patches to support the T2
**Note:** Make sure you restart your Mac after installing `tiny-dfr`. In order to make changes to the config for `tiny-dfr`, copy `/usr/share/tiny-dfr/config.toml` to `/etc/tiny-dfr/config.toml` and edit `/etc/tiny-dfr/config.toml` by following the instructions given in that file.
7. Lastly, add `intel_iommu=on iommu=pt pcie_ports=native` kernel parameters using your Bootloader.
7. Lastly, add `intel_iommu=on iommu=pt pm_async=off` kernel parameters using your Bootloader.
# Basic set up
docs/distributions/gentoo/installation.md
+1 -1
View File
@@ -62,6 +62,6 @@
9. Install the bootloader:
1. Choose a bootloader (other than LILO) from the [Configuring the bootloader](https://wiki.gentoo.org/wiki/Handbook:AMD64/Installation/Bootloader) section of the Gentoo Handbook.
2. Add `intel_iommu=on iommu=pt pcie_ports=compat` to the kernel parameters. Refer to the Gentoo Wiki article for your bootloader of choice for instructions on how to do this.
2. Add `intel_iommu=on iommu=pt pm_async=off` to the kernel parameters. Refer to the Gentoo Wiki article for your bootloader of choice for instructions on how to do this.
10. Exit the `chroot` (Control-d, or `exit`) and reboot. You should now be able to select Gentoo from the macOS startup manager by holding option at boot. Congratulations, you should now have a working Gentoo installation! For your next steps, read through the rest of the Gentoo Handbook and consider installing a desktop environment such as [GNOME](https://wiki.gentoo.org/wiki/GNOME), [KDE](https://wiki.gentoo.org/wiki/KDE), or [Xfce](https://wiki.gentoo.org/wiki/Xfce).
docs/guides/audio-config.md
+3 -3
View File
@@ -8,17 +8,17 @@ If there is no output at all you probably do not have T2 Mac support. Follow the
# Enable Pass-Through Kernel Parameters
Run `cat /proc/cmdline` and ensure that your kernel parameters contain `intel_iommu=on iommu=pt pcie_ports=compat`.
Run `cat /proc/cmdline` and ensure that your kernel parameters contain `intel_iommu=on iommu=pt pm_async=off`.
If not present, you'll have to update your bootup kernel parameters:
- edit `/etc/default/grub` and update `GRUB_CMDLINE_LINUX` to include `intel_iommu=on iommu=pt pcie_ports=compat`
- edit `/etc/default/grub` and update `GRUB_CMDLINE_LINUX` to include `intel_iommu=on iommu=pt pm_async=off`
- Apply your edits by running `sudo update-grub` on ubuntu or `sudo grub-mkconfig -o /boot/grub/grub.cfg` for other distros
- `grub`'s command line interface names might differ on different distros, if the commands like `grub-xxx` are not found, try `grub2-xxx` alternatives instead. For example, it should be `sudo grub2-mkconfig ...` instead of `sudo grub-mkconfig ...` on Fedora 36.
- Reboot and ensure `cat /proc/cmdline` contains those params
!!!note "systemd-boot"
If you use systemd-boot you'll instead edit your boot conf files to add `intel_iommu=on iommu=pt pcie_ports=compat` to the options line. The files to edit will have the `.conf` extension and be in the loader/entries/ folder on your EFI partition. This will most likely be `/boot/efi/loader/entries`
If you use systemd-boot you'll instead edit your boot conf files to add `intel_iommu=on iommu=pt pm_async=off` to the options line. The files to edit will have the `.conf` extension and be in the loader/entries/ folder on your EFI partition. This will most likely be `/boot/efi/loader/entries`
# Audio Configuration Files
docs/guides/postinstall.md
+2 -2
View File
@@ -35,10 +35,10 @@ If compiled kernels for your distro are not available, then you will have to com
## Add necessary kernel parameters
Using your bootloader, add the `intel_iommu=on iommu=pt pcie_ports=compat` kernel parameters. For example in GRUB:
Using your bootloader, add the `intel_iommu=on iommu=pt pm_async=off` kernel parameters. For example in GRUB:
1. Edit `/etc/default/grub`.
2. On the line with `GRUB_CMDLINE_LINUX="quiet splash"`, add the following kernel parameters: `intel_iommu=on iommu=pt pcie_ports=compat`.
2. On the line with `GRUB_CMDLINE_LINUX="quiet splash"`, add the following kernel parameters: `intel_iommu=on iommu=pt pm_async=off`.
3. Run `sudo grub-mkconfig -o /boot/grub/grub.cfg` if you are on a non-Debian based distro. If using Debian or Ubuntu based distro, run `sudo update-grub`.
## Make modules load on boot
docs/guides/refind.md
+2 -2
View File
@@ -124,10 +124,10 @@ By default, rEFInd boots Linux indirectly by booting GRUB, systemd-boot etc. But
!!! note "Chroot"
If you have run the in step 5 commands within a chroot, the `ro root=UUID=631c326a-fb48-46ba-b4aa-6dd2033fbb5e` shall likely to be missing. In this case, manually edit the `refind_linux.conf` file in the `/boot` folder of your **chroot** to look like the sample and replace the **UUID** (`631c326a-fb48-46ba-b4aa-6dd2033fbb5e` in the sample) with the one of the partition in which your Linux is installed. You can get the UUID from `/etc/fstab` file of your **chroot** or using a disk utility software.
7. On the line with `"Boot with standard options"`, add the `intel_iommu=on iommu=pt pcie_ports=compat quiet splash` parameters. It is possible that some parameters are already added. In such case, add only the missing parameters. If you don't want a silent boot, you may omit out the `quiet splash` parameter. Finally, the `refind_linux.conf` file should look something like this.
7. On the line with `"Boot with standard options"`, add the `intel_iommu=on iommu=pt pm_async=off quiet splash` parameters. It is possible that some parameters are already added. In such case, add only the missing parameters. If you don't want a silent boot, you may omit out the `quiet splash` parameter. Finally, the `refind_linux.conf` file should look something like this.
```conf
"Boot with standard options" "ro root=UUID=631c326a-fb48-46ba-b4aa-6dd2033fbb5e intel_iommu=on iommu=pt pcie_ports=compat quiet splash"
"Boot with standard options" "ro root=UUID=631c326a-fb48-46ba-b4aa-6dd2033fbb5e intel_iommu=on iommu=pt pm_async=off quiet splash"
#"Boot to single-user mode" "ro root=UUID=631c326a-fb48-46ba-b4aa-6dd2033fbb5e single"
#"Boot with minimal options" "ro root=UUID=631c326a-fb48-46ba-b4aa-6dd2033fbb5e"
```
docs/state.md
+1 -1
View File
@@ -12,7 +12,7 @@ While Linux is usable on all T2 models, some features are limited due to the lac
|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 5 GHz 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.||
|Thunderbolt|🟒 Working|🟒 Yes|If it doesn't work, try adding `pcie_ports=native` in the kernel parameters via GRUB.||
|Touch Bar|🟒 Working|🟑 Partial|"Touch Bar Keyboard" mode works OOTB, where only the Function Keys or the Media/Brightness Control Keys are shown. Touch Bar drivers were upstreamed in kernel 6.15, but we still need apple-bce to make it work.|[apple-bce](https://github.com/t2linux/apple-bce-drv), [tiny-dfr](https://github.com/AsahiLinux/tiny-dfr)|
|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)|