You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/Accelerator-Engines.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
The SoC has several onboard accelerator units, this is a useful list of the names and what they refer to. Most of the accelerators run firmware that can be found in the pre-boot partition `/System/Volumes/Preboot/[UUID]/restore/Firmware`, packaged as im4p files which may be extracted with https://github.com/19h/ftab-dump/blob/master/rkos.py and some dd.
2
2
3
-
*Update none of the ANE, AVE, ADT im4p's extract with that. I'm not sure which ones do. You are better off following the im4p extraction steps in [[ADT wiki]](https://github.com/AsahiLinux/docs/wiki/FW%3AADT). Can we make a progress matrix regarding firmware?
3
+
*Update none of the ANE, AVE, ADT im4p's extract with that. I'm not sure which ones do. You are better off following the im4p extraction steps in [ADT wiki](FW-ADT.md). Can we make a progress matrix regarding firmware?
4
4
5
5
## Names
6
6
@@ -25,4 +25,4 @@ Names can be formatted the following ways depending on their official-ness:
25
25
***PMP**: "Power Management Processor?". Handles power functionality
26
26
27
27
### S
28
-
***SEP**: **Secure Enclave Processor**. The M1's built-in HSM/TPM/etc device. Handles Touch ID and most crypto, as well as boot policy decisions. Harmless to Linux, but we can use its features if we want to. Contrast to AP.
28
+
***SEP**: **Secure Enclave Processor**. The M1's built-in HSM/TPM/etc device. Handles Touch ID and most crypto, as well as boot policy decisions. Harmless to Linux, but we can use its features if we want to. Contrast to AP.
Copy file name to clipboardExpand all lines: docs/Developer-Quickstart.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
3
3
This guide documents a manual installation process that is only required for kernel developers doing reverse engineering of macOS drivers using the m1n1 hypervisor.
4
4
5
-
If you are a more typical developer and you want to help work on the kernel or just experiment with the platform, and are happy doing tethered boots via USB (uploading the kernel from another machine), have a look [[over here|TetheredBootSetup (ForDevelopers)]].
5
+
If you are a more typical developer and you want to help work on the kernel or just experiment with the platform, and are happy doing tethered boots via USB (uploading the kernel from another machine), have a look [over here][Tethered-Boot-Setup-For-Developers.md].
6
6
7
7
If you are an end user or you would otherwise like to set up a stand-alone install, stop now. It isn't ready yet. It will be soon. Just hang tight.
8
8
@@ -323,7 +323,7 @@ picocom /dev/ttyACM1
323
323
324
324
Note that this method cannot (yet) be used as an earlycon for Linux, and USB gadget support is not yet in our main Linux tree either.
325
325
326
-
* See [Running Linux via USB cable](https://github.com/AsahiLinux/docs/wiki/SW:Linux#running-linux-via-usb-cable) for some more details
326
+
* See [Running Linux via USB cable](SW-Linux.md#running-linux-via-usb-cable) for some more details
327
327
328
328
## Using m1n1
329
329
@@ -465,7 +465,7 @@ Run `python shell.py` for an interactive debug shell.
Our main kernel package. Usually built from the `asahi` branch on [AsahiLinux/linux](https://github.com/AsahiLinux/linux). Frequently updated and often based on bleeding-edge kernels (linux-next). Reference kernel config is [here](https://github.com/AsahiLinux/docs/wiki/Reference-Asahi-kernel-config).
41
+
Our main kernel package. Usually built from the `asahi` branch on [AsahiLinux/linux](https://github.com/AsahiLinux/linux). Frequently updated and often based on bleeding-edge kernels (linux-next). Reference kernel config is [here](Reference-Asahi-kernel-config.md).
42
42
43
43
This kernel is built with a large assortment of USB device drivers to allow for external devices, but only the PCI/SPI/I²C/SPMI/etc drivers useful for Apple machines (PCI drivers will be enabled once Thunderbolt works). It is not intended to be bootable on non-Apple systems.
44
44
45
-
[Notes on modifying your kernel configuration to include Asahi](https://github.com/AsahiLinux/docs/wiki/Kernel-config-notes-for-distros)
45
+
[Notes on modifying your kernel configuration to include Asahi](Kernel-config-notes-for-distros.md)
46
46
47
47
If you need .config options not yet enabled, feel free to request it on IRC or as an issue [here](https://github.com/AsahiLinux/PKGBUILDs).
Copy file name to clipboardExpand all lines: docs/Glossary.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -93,7 +93,7 @@ If you want to collect a large set of terms specific to a sub-field (such as GPU
93
93
94
94
### R
95
95
***RecoveryOS:** The recovery environment, which can either be a recovery image paired to an OS install (located inside an APFS subvolume) or the global recovery image installed in the last APFS container on disk. macOS 11.x uses the global image by default, while macOS 12.0 and newer uses a paired recoveryOS.
96
-
***RestoreOS:** The restore environment, loaded onto the device when "reviving" it through DFU mode by Apple Configurator. [more info](more-info.md)(https://www.theiphonewiki.com/wiki/Restore_Ramdisk)
96
+
***RestoreOS:** The restore environment, loaded onto the device when "reviving" it through DFU mode by Apple Configurator. [more info](https://www.theiphonewiki.com/wiki/Restore_Ramdisk)
97
97
***ROM** is an acronym for Read-Only Memory. It refers to computer memory chips containing permanent or semi-permanent data.
98
98
***RTKit:** Apple's proprietary real-time operating system. Most of the accelerators (AGX, ANE, AOP, DCP, AVE, PMP) run RTKit on an internal processor. The string "RTKSTACKRTKSTACK" is characteristic of a firmware containing RTKit.
* Under Linux booted via [USB drive](https://github.com/AsahiLinux/docs/wiki/SW:Linux:USB-drive) or [nvme](https://github.com/AsahiLinux/docs/wiki/SW:Linux:NVME) rootfs Create the firmware directory:
10
+
* Under Linux booted via [USB drive](SW-Linux-USB-drive.md) or [nvme](SW-Linux-NVME.md) rootfs Create the firmware directory:
11
11
`sudo mkdir -p /usr/lib/firmware`
12
12
* Install the wifi firmware you extracted earlier
13
13
`sudo tar -C /usr/lib/firmware -xf firmware.tar`
14
14
* Install any other networking / WiFi packages you will need. e.g. wpasupplicant
15
15
## Enable WiFi
16
16
* You need to have built a Asahi Linux kernel with the M1 WiFI support such as the [wifi/take5](https://github.com/AsahiLinux/linux/tree/wifi/take5) branch
17
-
* Before you boot that kernel via [m1n1 over USB](https://github.com/AsahiLinux/docs/wiki/SW:Linux#directly) - run this script to enable the WiFi hardware
17
+
* Before you boot that kernel via [m1n1 over USB](SW-Linux.md#directly) - run this script to enable the WiFi hardware
* Snapshot of [rev a2281d64fdbc](https://github.com/amworsley/AsahiLinux/tree/asahi-kbd) with config such as [this one](https://raw.githubusercontent.com/amworsley/asahi-wiki/main/images/config-keyboard+nvme)
28
28
## Boot with your USB cables plugged in
29
-
* Plug your USB cables/hubs/adapters **before** booting your Mac as m1n1/linux doesn't do the USB low level PHY setup yet. Let the iBoot do this when it boots to m1n1 you installed via your [setup of boot to m1n1](https://github.com/AsahiLinux/docs/wiki/Developer-Quickstart#setup)
29
+
* Plug your USB cables/hubs/adapters **before** booting your Mac as m1n1/linux doesn't do the USB low level PHY setup yet. Let the iBoot do this when it boots to m1n1 you installed via your [setup of boot to m1n1](Developer-Quickstart.md#setup)
30
30
* If m1n1 C code has been updated since the set up you should chain load the new .macho image
* Connecting [USB Type-C to Type A/C cable](https://github.com/AsahiLinux/docs/wiki/Developer-Quickstart#usb-gadget-mode-using-a-standard-usb-cable) to M1 Mac provides two USB serial interfaces on the other computer
35
+
* Connecting [USB Type-C to Type A/C cable](Developer-Quickstart.md#usb-gadget-mode-using-a-standard-usb-cable) to M1 Mac provides two USB serial interfaces on the other computer
36
36
* This can be connected to via the python proxy tool to boot up Linux directly or load up a macho binary like an updated m1n1 version or combined with a Linux image
37
37
* Get a 27Mb initrd from debian arm64 installer
38
38
```
@@ -385,12 +385,12 @@ Still running 21
385
385
</details>
386
386
387
387
# Root filesystem options
388
-
*[initrd + USB keyboard](https://github.com/AsahiLinux/docs/wiki/SW:Linux:USBKeyboard#linux-usb-keyboard)
0 commit comments