installation/guides/arm-devices/apple-silicon: add page

Co-authored-by: dkwo <npiazza@disroot.org>

Author: classabbyamp

src/SUMMARY.md

@@ -15,6 +15,8 @@
       - [Full Disk Encryption](./installation/guides/fde.md)
       - [Root on ZFS](./installation/guides/zfs.md)
       - [ARM Devices](./installation/guides/arm-devices/index.md)
+         - [Apple Silicon
+            (Asahi)](./installation/guides/arm-devices/apple-silicon.md)
          - [Lenovo Thinkpad
             X13s](./installation/guides/arm-devices/thinkpad-x13s.md)
          - [Pinebook Pro](./installation/guides/arm-devices/pinebook-pro.md)

src/installation/guides/arm-devices/apple-silicon.md

@@ -0,0 +1,50 @@
+# Apple Silicon
+
+Void's Apple Silicon support is based on Asahi Linux. See their
+[website](https://asahilinux.org) and
+[documentation](https://github.com/AsahiLinux/docs/wiki) for more information.
+
+## Installation
+
+Before installing, use the Asahi Linux install script to install "UEFI
+environment only" from macOS:
+
+```
+macos $ curl https://alx.sh > alx.sh
+macos $ sh ./alx.sh
+```
+
+Then, [create a Live USB](../../live-images/prep.md) using an [Apple Silicon
+Void Linux ISO](https://voidlinux.org/download/#arm%20platforms). U-Boot
+(installed by the Asahi installer) should show the external USB as a boot
+option. If it does not, run these commands in the U-Boot prompt to boot:
+
+```
+U-Boot> setenv boot_targets "usb"
+U-Boot> setenv bootmeths "efi"
+U-Boot> boot
+```
+
+To install, follow the [chroot install guide](../chroot.md), using the "XBPS
+method", observing the following modifications:
+
+For the base installation, install `base-system`, `asahi-base`, and
+`asahi-scripts`. These packages provide important configurations and install the
+necessary dependencies. When running `grub-install`, add the `--removable` flag.
+
+To use another bootloader with `m1n1`, ensure it installs the bootloader EFI
+executable at `EFI\BOOT\BOOTAA64.EFI` within the EFI system partition. `m1n1`
+can also be configured to boot a kernel and initramfs directly, without a
+bootloader. To do this, change the `PAYLOAD` in `/etc/default/m1n1-kernel-hook`
+to `kernel`.
+
+## Audio
+
+The `asahi-audio` package is required for audio. Ensure the speakersafetyd
+service is [enabled](../../../config/services/index.md#enabling-services), and
+set up [pipewire and wireplumber](../../../config/media/pipewire.md).
+
+## Firmware
+
+Firmware can be updated with `asahi-fwupdate` from `asahi-scripts`. It is
+recommended to do so whenever the `asahi-firmware` package is updated.

src/installation/guides/arm-devices/index.md

@@ -18,6 +18,7 @@ specific to such devices.
 
 Platform-specific documentation is available for:
 
+- [Apple Silicon](./apple-silicon.md)
 - [Lenovo ThinkPad X13s](./thinkpad-x13s.md)
 - [Pinebook Pro](./pinebook-pro.md)
 - [Raspberry Pi](./raspberry-pi.md)