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

Co-authored-by: dkwo <[email protected]>

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,42 @@
+# 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
+about topics not covered here.
+
+## Installation
+
+Before installing, use the Asahi Linux install script to install "UEFI
+environment only". 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:
+
+```
+setenv boot_targets "usb"
+setenv bootmeths "efi"
+boot
+```
+
+will instruct it to do so. Then proceed with the usual Void installation.
+
+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`. This package provides important configurations and installs the
+necessary dependencies. When running `grub-install`, the `--removable` flag may
+be required. If using another bootloader, you may want to change the m1n1
+`PAYLOAD` in `/etc/m1n1.conf`.
+
+## 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)