From 7c42bc1aa80e2d193f2bcec8d9ca8a653434f705 Mon Sep 17 00:00:00 2001 From: classabbyamp Date: Wed, 22 Jan 2025 01:39:03 -0500 Subject: [PATCH] installation/guides/arm-devices/apple-silicon: add page Co-authored-by: dkwo --- src/SUMMARY.md | 2 + .../guides/arm-devices/apple-silicon.md | 50 +++++++++++++++++++ src/installation/guides/arm-devices/index.md | 1 + 3 files changed, 53 insertions(+) create mode 100644 src/installation/guides/arm-devices/apple-silicon.md diff --git a/src/SUMMARY.md b/src/SUMMARY.md index aa2f3e1a..969193fa 100644 --- a/src/SUMMARY.md +++ b/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) diff --git a/src/installation/guides/arm-devices/apple-silicon.md b/src/installation/guides/arm-devices/apple-silicon.md new file mode 100644 index 00000000..e54c41d7 --- /dev/null +++ b/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. diff --git a/src/installation/guides/arm-devices/index.md b/src/installation/guides/arm-devices/index.md index aa5a7c33..0ddf7454 100644 --- a/src/installation/guides/arm-devices/index.md +++ b/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)