add guidance on bluetooth and asahi-fwextract

tpwrules · Jul 20, 2022 · a8237e7 · a8237e7
1 parent a26c565
commit a8237e7
Show file tree

Hide file tree

Showing 2 changed files with 9 additions and 2 deletions.
diff --git a/README.md b/README.md
@@ -1,6 +1,6 @@
 Attempts to get NixOS up on M1 Macs.
 
-* [UEFI Boot Standalone NixOS (2022-07-18)](docs/uefi-standalone.md)
+* [UEFI Boot Standalone NixOS (2022-07-19)](docs/uefi-standalone.md)
 
 ## Credits
 

diff --git a/docs/uefi-standalone.md b/docs/uefi-standalone.md
@@ -1,4 +1,4 @@
-# UEFI Boot Standalone NixOS (2022-07-18)
+# UEFI Boot Standalone NixOS (2022-07-19)
 
 This guide will build and was tested with the following software:
 * Asahi Linux kernel, as of 2022-07-17 (5.19.0-rc5-asahi)
@@ -353,6 +353,13 @@ $ sudo nixos-rebuild switch
 $ sudo reboot
 ```
 
+In some cases, a kernel update may require new or different firmware to enable a particular feature such as Wi-Fi or Bluetooth support. To re-extract the firmware without recreating the stub partition, use the `asahi-fwextract` tool. You will need to upgrade the M1 support module to the latest version and rebuild your system with it in order to get an `asahi-fwextract` that knows the latest firmware needs. Once this is done, you can run the tool, then rebuild your system again:
+```
+$ sudo asahi-fwextract /boot/asahi/ /etc/nixos-m1/support/firmware/firmware.tar /dev/null
+$ sudo nixos-rebuild boot
+$ sudo reboot
+```
+
 #### Recovering from Boot Failure with `idevicerestore`
 
 In extremely extreme circumstances (i.e. something messed up the firmware partition, recovery partition, or partition table), your Mac may fail to boot. On the Mac mini (and presumably Mac Studio), this state is identifiable by a flashing orange power light indicating the Morse code for SOS. On a Mac laptop, this state is identifiable by an illustration of an exclamation point in a circle on the screen with a link to Apple's website.