From 1f0d45470c36dace811b2ef054fb5fbb0179630c Mon Sep 17 00:00:00 2001 From: Jos Dehaes Date: Wed, 14 May 2025 10:24:26 +0200 Subject: [PATCH 1/3] add firmware update steps Signed-off-by: Jos Dehaes --- docs/fw/fw-update.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 docs/fw/fw-update.md diff --git a/docs/fw/fw-update.md b/docs/fw/fw-update.md new file mode 100644 index 00000000..5ed1df28 --- /dev/null +++ b/docs/fw/fw-update.md @@ -0,0 +1,22 @@ +# Firmware update + +- boot into Linux +- edit /etc/fstab and comment out the line with /boot/efi +- reboot into macOS +- mount the EFI partition of your linux install with `diskutil mount 'EFI - LINUX'` or similar (check the correct name with `diskutil list`) +- copy the contents of this partition (using finder or cp) somewhere in macOS +- unmount the partition again with `diskutil umount 'EFI - LINUX'` +- wipe the APFS container (2.5 GB) using `diskutil apfs deleteContainer disk0s3` !! double and triple check the device id !! +- wipe the EFI partition (500MB) using `diskutil eraseVolume free free disk0s4` +- you should now have 3 GB free between the macOS APFS container and the 'Linux Filesystem' with your rootfs +- start the asahi installer and choose the option 'UEFI environment only' +- the installer will ask to shutdown and reboot into the recovery of the stub partition +- follow the steps inside recovery until the point it asks to reboot, **don't reboot**, but press Ctrl-C to exit the script +- go to the Apple logo in the top left corner and choose 'Startup Disk' +- set your macOS disk as startup disk and reboot into macOS +- mount the EFI partition again using `diskutil mount` (note that the name may be different from above if you chose a different name for the UEFI install) +- copy the `EFI` and `m1n1` folders from your backup over the new EFI partition +- reboot into Linux by setting the Startup Disk back to Linux or by holding the power button at boot +- check the UUID of the EFI partition with `lsblk -f`. Look for the one which is short (XXXX-XXXX) +- edit `/etc/fstab`, uncomment the /boot/efi line and replace the UUID with the new one +- reboot again and you should now be on latest firmware and back where you were From 930c1de7236387edc426c826b09884f312aae450 Mon Sep 17 00:00:00 2001 From: Jos Dehaes Date: Wed, 14 May 2025 22:41:08 +0200 Subject: [PATCH 2/3] add warning Signed-off-by: Jos Dehaes --- docs/fw/fw-update.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/fw/fw-update.md b/docs/fw/fw-update.md index 5ed1df28..96a6bfef 100644 --- a/docs/fw/fw-update.md +++ b/docs/fw/fw-update.md @@ -1,5 +1,12 @@ # Firmware update +These steps allow you to upgrade the firmware in the macOS stub partition. These are manual steps, and the risk of messing up is high. + +``` + Please ensure you have a restorable backup of your Fedora installation. + Please attempt this only if you’re comfortable with the steps mentioned here and be prepared to do a fresh install. +``` + - boot into Linux - edit /etc/fstab and comment out the line with /boot/efi - reboot into macOS From 9f6cc7291bcd2c0f7088e0017479ba248d94dcd3 Mon Sep 17 00:00:00 2001 From: Jos Dehaes Date: Wed, 14 May 2025 22:46:45 +0200 Subject: [PATCH 3/3] add link to partitioning cheatsheet Signed-off-by: Jos Dehaes --- docs/fw/fw-update.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/fw/fw-update.md b/docs/fw/fw-update.md index 96a6bfef..22d21ad0 100644 --- a/docs/fw/fw-update.md +++ b/docs/fw/fw-update.md @@ -7,6 +7,8 @@ These steps allow you to upgrade the firmware in the macOS stub partition. These Please attempt this only if you’re comfortable with the steps mentioned here and be prepared to do a fresh install. ``` +Make sure to read and understand how macOS partitions work in the [partitioning cheatsheet](https://github.com/AsahiLinux/docs/wiki/Partitioning-cheatsheet). + - boot into Linux - edit /etc/fstab and comment out the line with /boot/efi - reboot into macOS