diff --git a/README.md b/README.md index f17932ae..5ea95b9d 100644 --- 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 index 6a9a5369..2b8d32d9 100644 --- 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.