diff options
| author | Mark Kettenis <kettenis@openbsd.org> | 2021-10-23 16:58:07 +0200 |
|---|---|---|
| committer | Tom Rini <trini@konsulko.com> | 2021-10-31 08:46:44 -0400 |
| commit | 91ce6bf20bdffe3f67dfa2637d14a74e2244f3c5 (patch) | |
| tree | 4cad56c54a44923d629f128606e5462cec5458e8 | |
| parent | 3dfef536103d61b4a2b98a248af236aa9bf05e45 (diff) | |
| download | u-boot-91ce6bf20bdffe3f67dfa2637d14a74e2244f3c5.zip u-boot-91ce6bf20bdffe3f67dfa2637d14a74e2244f3c5.tar.gz u-boot-91ce6bf20bdffe3f67dfa2637d14a74e2244f3c5.tar.bz2 | |
doc: board: apple: Add Apple M1 documentation
Provide preliminary instructions on how to get U-Boot to run on
Apple Silicon Macs.
Signed-off-by: Mark Kettenis <kettenis@openbsd.org>
Reviewed-by: Simon Glass <sjg@chromium.org>
| -rw-r--r-- | doc/board/apple/index.rst | 9 | ||||
| -rw-r--r-- | doc/board/apple/m1.rst | 59 | ||||
| -rw-r--r-- | doc/board/index.rst | 1 |
3 files changed, 69 insertions, 0 deletions
diff --git a/doc/board/apple/index.rst b/doc/board/apple/index.rst new file mode 100644 index 0000000..8446847 --- /dev/null +++ b/doc/board/apple/index.rst @@ -0,0 +1,9 @@ +.. SPDX-License-Identifier: GPL-2.0+ + +Apple +===== + +.. toctree:: + :maxdepth: 2 + + m1 diff --git a/doc/board/apple/m1.rst b/doc/board/apple/m1.rst new file mode 100644 index 0000000..9fa2176 --- /dev/null +++ b/doc/board/apple/m1.rst @@ -0,0 +1,59 @@ +.. SPDX-License-Identifier: GPL-2.0+ + +U-Boot for Apple Silicon Macs +============================= + +Allows Apple Silicon Macs to boot U-Boot via the m1n1 bootloader +developed by the Asahi Linux project. At this point the machines with +the following SoCs work: + + - Apple M1 SoC + +On these SoCs the following hardware is supported: + + - S5L serial port + - Framebuffer + - USB 3.1 Type-C ports + +Device trees are currently provided for the M1 Mac mini (2020, J274) +and M1 MacBook Pro 13" (2020, J293). The M1 MacBook Air (2020) is +expected to work with the J293 device tree. The M1 iMac (2021) may +work with the J274 device tree. + +Building U-Boot +--------------- + +.. code-block:: bash + + $ export CROSS_COMPILE=aarch64-none-elf- + $ make apple_m1_defconfig + $ make + +This will build ``u-boot-nodtb.bin`` as well as devices trees for some +of the supported machines. These device trees can be found in the +``arch/arm/dts`` subdirectory of your build. + +Image creation +-------------- + +In order to run U-Boot on an Apple Silicon Mac, U-Boot has to be used +as a payload for the m1n1 bootloader. Instructions for building m1n1 +can be found here: + + https://github.com/AsahiLinux/docs/wiki/SW%3Am1n1 + +.. code-block:: bash + + $ cat m1n1.macho t8103-j274.dtb u-boot-nodtb.bin > u-boot.macho + +This uses ``u-boot-nodtb.bin`` as the device tree is passed to U-Boot +by m1n1 after making some adjustments. + +Image installation +------------------ + +Instructions on how to install U-Boot on your Mac can be found at: + + https://github.com/AsahiLinux/docs/wiki/Developer-Quickstart + +Just replace ``m1n1.macho`` with ``u-boot.macho`` in the instructions. diff --git a/doc/board/index.rst b/doc/board/index.rst index aa397ab..1b93ced 100644 --- a/doc/board/index.rst +++ b/doc/board/index.rst @@ -10,6 +10,7 @@ Board-specific doc advantech/index AndesTech/index amlogic/index + apple/index atmel/index congatec/index coreboot/index |