Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 32 additions & 3 deletions src/content/docs/installation/installation_t2macbook.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,37 @@ import { Tabs, TabItem, Steps } from '@astrojs/starlight/components';
CachyOS provides out of the box support for the T2 MacBook. The required kernel patches are shipped in all the kernels provided by CachyOS.

**WiFi connection** is **not available** out of the box because it is a closed source firmware, which CachyOS is not allowed to redistribute.
The installation will only work with a LAN connection. WiFi support can be set-up after the installation.
See [installation of the firmware](#installation-of-the-firmware)
The installation needs internet to proceed, so either use a LAN network, or follow [this section](#getting-wifi-firmware-for-the-installation) to get WiFi firmware.

### Getting WiFi firmware for the installation

<Steps>

1. First boot into macOS and run this command:
```sh
curl -sL https://wiki.t2linux.org/tools/firmware.sh | bash -s copy_to_efi
```

2. Now boot into the CachyOS ISO. Open Konsole there, and run these commands:
```sh
sudo mkdir -p /tmp/apple-wifi-efi
sudo mount /dev/nvme0n1p1 /tmp/apple-wifi-efi
bash /tmp/apple-wifi-efi/firmware.sh get_from_efi
sudo umount /tmp/apple-wifi-efi
```

3. Setup `iwd` as backend for NetworkManager. You can run the following commands in Konsole to do so:
```sh
cat <<EOF | sudo tee /etc/NetworkManager/conf.d/wifi_backend.conf
[device]
wifi.backend=iwd
EOF
sudo systemctl restart NetworkManager
```

</Steps>

Now you can connect to a WiFi network and proceed with the installation.

### Proceeding with Installation

Expand Down Expand Up @@ -68,4 +97,4 @@ sudo modprobe -r brcmfmac
sudo modprobe brcmfmac
```

The firmware can also be extracted from an ISPW file, see the [t2linux wiki page](https://wiki.t2linux.org/guides/wifi-bluetooth/)
For more ways to get the firmware, see the [t2linux wiki page](https://wiki.t2linux.org/guides/wifi-bluetooth/)