Skip to content

Commit a044b59

Browse files
committed
asahi docs: add info
1 parent 93586fc commit a044b59

File tree

1 file changed

+20
-13
lines changed

1 file changed

+20
-13
lines changed

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

Lines changed: 20 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -117,19 +117,26 @@ For some time, the kernel, mesa, and uboot packages will have Asahi Linux as
117117
upstream. Their [documentation](https://github.com/AsahiLinux/docs/wiki) is an
118118
excellent source. Here we discuss Void Linux specific aspects only.
119119

120-
Use Asahi Linux install scripts with `UEFI environment only`, then proceed with
121-
usual Void installation. The default is EFI partition at `/boot/efi`, other
122-
choices can be made by editing m1n1 kernel hook config.
123-
124-
At the very least, install `base-system`, `asahi-base`, and an initramfs
125-
generator. By default, `asahi-uboot`, `grub-arm64-efi`, and `asahi-scripts` are
126-
also required, unless one changes initramfs or payload for m1n1.
127-
128-
Void ships a kernel hook for m1n1, modeled on Asahi upstream. This allows you to
129-
either just use m1n1, or use it in combination with uboot and grub (default) by
130-
setting the `PAYLOAD` variable (requires `asahi-uboot` and `grub-arm64-efi`). We
131-
ship tinyramfs config and hooks (to use, add `asahi` to `hooks`). The default is
132-
dracut, its hooks are provided by `asahi-scripts` together with mkinitcpio ones.
120+
Use Asahi Linux install scripts with `UEFI environment only`. U-boot should pick
121+
up the external USB by default, in case it does not the commands
122+
123+
```
124+
setenv boot_targets "usb"
125+
setenv bootmeths "efi"
126+
boot
127+
```
128+
129+
will instruct it to do so. Then proceed with the usual Void installation. At the
130+
very least, install `base-system`, `asahi-base`, and an initramfs generator. By
131+
default, `grub-arm64-efi` and `asahi-scripts` are also required. The latter
132+
provides hooks for dracut and mkinitcpio. Void also ships tinyramfs config and
133+
hooks (to use, add `asahi` to `hooks`). The grub option `--removable` is known
134+
to work.
135+
136+
Optionally, you can install `m1n1`. Void ships a kernel hook for m1n1, modeled
137+
upon Asahi upstream. This allows you to either just use m1n1, or use it in
138+
combination with uboot and grub (default) by setting the `PAYLOAD` variable
139+
(requires `asahi-uboot` and `grub-arm64-efi`).
133140

134141
If using audio, you must install `asahi-audio`, ensure the speakersafetyd
135142
service is [enabled](/config/services/index.md#enabling-services), and set up

0 commit comments

Comments
 (0)