From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 88B75C433EF for ; Sun, 3 Oct 2021 18:36:10 +0000 (UTC) Received: from phobos.denx.de (phobos.denx.de [85.214.62.61]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id E2FB961A02 for ; Sun, 3 Oct 2021 18:36:09 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.1 mail.kernel.org E2FB961A02 Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=openbsd.org Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=lists.denx.de Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id AC79983480; Sun, 3 Oct 2021 20:36:03 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=none (p=none dis=none) header.from=openbsd.org Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Received: by phobos.denx.de (Postfix, from userid 109) id 7937583460; Sun, 3 Oct 2021 20:35:24 +0200 (CEST) Received: from lb2-smtp-cloud7.xs4all.net (lb2-smtp-cloud7.xs4all.net [194.109.24.28]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) (No client certificate requested) by phobos.denx.de (Postfix) with ESMTPS id DBC9A83480 for ; Sun, 3 Oct 2021 20:35:14 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=none (p=none dis=none) header.from=openbsd.org Authentication-Results: phobos.denx.de; spf=fail smtp.mailfrom=kettenis@openbsd.org Received: from cust-df1d398c ([IPv6:fc0c:c1f5:9ac0:c45f:1583:5c5b:91fa:2436]) by smtp-cloud7.xs4all.net with ESMTPA id X6GJmiwcM3tiGX6KPmemEg; Sun, 03 Oct 2021 20:35:14 +0200 From: Mark Kettenis To: u-boot@lists.denx.de Cc: Mark Kettenis , Bharat Gooty , Rayagonda Kokatanur , Simon Glass , Andre Przywara , Fabio Estevam , Jagan Teki , Kever Yang , Priyanka Jain , Peter Robinson , Tim Harvey , Konstantin Porotchkin , Heiko Schocher , Lokesh Vutla , Dario Binacchi , Bin Meng , Neil Armstrong , Nandor Han , Sean Anderson , Claudiu Manoil , Jean-Jacques Hiblot , Michael Walle , Patrick Delaunay , Wasim Khan , =?UTF-8?q?Fr=C3=A9d=C3=A9ric=20Danis?= , AKASHI Takahiro , Alexandru Gagniuc , Steffen Jaeckel , Alper Nebi Yasak , Nicolas Saenz Julienne , Heinrich Schuchardt , Asherah Connor , Oliver Graute , Anup Patel , Kishon Vijay Abraham I , Stephan Gerhold , Masami Hiramatsu , Pratyush Yadav , Kunihiko Hayashi , Jaehoon Chung , Ye Li , Philippe Reynes , Stefan Roese , Vabhav Sharma , Stefano Babic , Michal Simek , Weijie Gao , Andy Shevchenko Subject: [PATCH v2 7/7] doc: board: apple: Add Apple M1 documentation Date: Sun, 3 Oct 2021 20:30:33 +0200 Message-Id: <20211003183050.67925-8-kettenis@openbsd.org> X-Mailer: git-send-email 2.33.0 In-Reply-To: <20211003183050.67925-1-kettenis@openbsd.org> References: <20211003183050.67925-1-kettenis@openbsd.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-CMAE-Envelope: MS4xfDRn2O8xS55w6A+Jh1ammmhUXRLcTm5wWBgU4vN8r5/ckj4NxPy9OLjJYRH8bYah8AAdRZsAXmhmLWIGDeZGxDQ5SBruRRsWlrl0Wxzm8JTg0OWciPOt iSHC2Vt8KvWNqigUtRvP/eJXDa9xUoaHl6abIRWtYZToD6cFsJRzjdca3ZcsrDTzHLQyN9mFJlO0krTAzTWNyelHKd5Pwsfv5bCwtk+WDsraRYpcpBzd/t+H CnlbOaY24M75G9hTG9laHheGzJHazi2GlyTaFl1+Q9AAWC0zehWCME3XViLiTGoR8ygv9br7Iua6lxp4AmkZN6AsXUtyDQ9i8ldJGBuhJhuJl+DfyXmulctL rh2gx4YOTEiJAasNPy8sg9ZJtxRqhZeFZiiCib8m74v78rsTrHJYJ4SAI43LgQHuSY3au7fGUWb0jb4aTej/tW9bHReIUpHNdmPMbF8XTPIzWXu9NgKTVxEW A+TXU3nORvMC6t21waHYnf8yoKMLqcqt8FIH0Op61ZhBZXM29w40+XHP564KF+n7WmMYSxYm5B0R4CralpAUjXmVcvDuUSZigfiRJeXw7AL7VukcZGzwNIDs gPgIelTlXAMfWoY0QJtJEZ6nbxyEwH7iLxd089LfAZc4XQP4dU1gwEhI5PXXgO/WdfEfOsM1oO38Ac60V4vmwuLjnWbccme5c8IhfOlri6emGAaF3LFUyWbj Tla1cxx2Vwj3uqdm6tTbtnYCX3O5MyQJs+eS8ID+ivFzaVPNS7fw9bDR94x3LTDQw0iIbnkm0stp2PqiLw/FbXD0xKmNsOsiZmQIzt6i8nvOBYBA6bOav6ob DbV0NWG20lLQtls2/ZTlwn7V5YXP7ZEeC+rnm8aGu/YR52tzCVaJ9rl8PNdGyMtaafQ3rObv/t+SVrB3aQhxHZhx+vScoCwiVLYAp8szivQKY4B4ZX51TVc+ /3dGqSbMTnd7D6aWXGWocHIYBvtDSZIHTXM8gxOy4LzL8APW3dEvuEg7P4+4HkYf/XptGsTwpeknu0xaYBAremiHhSiyFzn1CVEKHv0B7klEWPYb2DVYU4Rb VGa3Sol/ueP8zJ/WSKyaIfWT4p+MAukIkEyUuR6TJQyEcmXLCYLXdYvj99W/ZBpAWPXd9NJeqDOQIrvyuXCPyaiKc13QWF1/JbuKObxG4HlHguXZ8bTzdvwR RZfWGYX/f61d8skEOKMo120dZ1A8rCLtjiIjhIh1/typdEG9EcNMcqHvyHIq9Bv/zvMIU/NLmgNCOhA2Cafth1HlYOAcS/6HdghFS7VCxQ4QyBwGeW+Vbeu4 Mg50J8hVZc8ZYSCBkj06Rr78TuTKyVP/5tftJXS2k49NVqcsNCIzDUAMt+Ev8TSTQrZHw3bFrGoUK7WEoVTQWXkqGvs/LWgkXsIYr/2J2ZoTfBYTQGJt/PSL hnG+LBS6Om1ci2oh90nC94xYriPISUfUbsfpEPTT8oAHiIEZYVdLNy9nV/99zhGN92jIjR2oHX9diMSouu0Cn48udKW81KKEYNr4TcmQDn+nB5/kYXZxopxU CEjJCOPC6g5QsCjYFP/CI8Rp8u2jdjUb1Yqsdtk3VRGzzkNlTcvOoz99jLucPP5BcRofKr252XddD29dRksZ1SOzF1CMxteZ0NomMkM1Vd3TeUHgWMCfK5B4 n2cNBHVhj2CifsQ/Co+UpFjV2aVp9LnawRgpqsB6BH3lbzLqLpL+swjBu9Nj6wY1TtBdZypFDTUdDNRtToE9OXcOnyfxeb65g7svCtQZaHOkauJ8IrYBsKXK QiHN/mHDT6pl7SJ0tK7RScytzAjm0kc7Dn5G8g11 X-Mailman-Approved-At: Sun, 03 Oct 2021 20:36:00 +0200 X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.34 Precedence: list List-Id: U-Boot discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: u-boot-bounces@lists.denx.de Sender: "U-Boot" X-Virus-Scanned: clamav-milter 0.103.2 at phobos.denx.de X-Virus-Status: Clean Provide preliminary instructions on how to get U-Boot to run on Apple Silicon Macs. Signed-off-by: Mark Kettenis --- doc/board/apple/index.rst | 9 +++++++ doc/board/apple/m1.rst | 56 +++++++++++++++++++++++++++++++++++++++ doc/board/index.rst | 1 + 3 files changed, 66 insertions(+) create mode 100644 doc/board/apple/index.rst create mode 100644 doc/board/apple/m1.rst diff --git a/doc/board/apple/index.rst b/doc/board/apple/index.rst new file mode 100644 index 0000000000..8446847818 --- /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 0000000000..2f2d940a4c --- /dev/null +++ b/doc/board/apple/m1.rst @@ -0,0 +1,56 @@ +.. 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 + +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 33087074fa..0add55b5d3 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 -- 2.33.0