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 X-Spam-Level: X-Spam-Status: No, score=-17.7 required=3.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER,INCLUDES_PATCH, MAILING_LIST_MULTI,MENTIONS_GIT_HOSTING,SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id CE5E5C4332F for ; Mon, 20 Sep 2021 08:45:49 +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 3B4F461056 for ; Mon, 20 Sep 2021 08:45:49 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.1 mail.kernel.org 3B4F461056 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=gmail.com 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 F022C82A15; Mon, 20 Sep 2021 10:45:46 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Authentication-Results: phobos.denx.de; dkim=pass (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.b="Fj2AeNUw"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id 711618201E; Mon, 20 Sep 2021 10:45:44 +0200 (CEST) Received: from mail-ot1-x336.google.com (mail-ot1-x336.google.com [IPv6:2607:f8b0:4864:20::336]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits)) (No client certificate requested) by phobos.denx.de (Postfix) with ESMTPS id 8439582A15 for ; Mon, 20 Sep 2021 10:45:39 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=igor.opaniuk@gmail.com Received: by mail-ot1-x336.google.com with SMTP id c42-20020a05683034aa00b0051f4b99c40cso22665230otu.0 for ; Mon, 20 Sep 2021 01:45:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc:content-transfer-encoding; bh=Ku8oZjprDCvssQJDo4J5FOwklCNlcxiX6hsnrFEsuLA=; b=Fj2AeNUwAfWcqEfslm2BVA2icvgzK/h9RLmNR3VWR6MdYvnmmNpbmSKsLetRdlYxNc Khl881mlcbyOXOLi15fh4AgFuCqgi/Bk8FqQwYgw0ZfDy9Dxw0l6dxR9CvJH2Q9ypLxL 0Jjm4lWUBr1RXoJiYA1mb8+otRE5BN2aWMGAuLP+COnnOdYbzj0QWYqUEK9+yEqSJtRQ /pXTdOH+pipdweceSvQQsr3vpDGiy4J8qupnYUqutuEpbWbQ1xmJcj+bZpc3rr/9EWyZ 29Y+B0utuXxg1dRDoQMPQha8QYhCuswxfEMk5b3vJlu1tKwcSXFw8/VyqlFnpbUmwvaA 6PDA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc:content-transfer-encoding; bh=Ku8oZjprDCvssQJDo4J5FOwklCNlcxiX6hsnrFEsuLA=; b=8IUk/ew86kO9eEA+NZgwScDiN0+0OQQKF67VjRnQfWIt4QCDbfpBUwKPM58uQ7x8sS Cwxq7tkotAp4mCTukrGUoTVmLvTm9b/FrMeK1f5QxE0N+Sqij7PCZB7PTii+aI0/bFkW 7594VJTBPUCYmTx09TxKBOblNzeElbfoXQVnMsuvYakGabAAi9+zUFe0Qz+Z590obma3 bnGNdrvqO6Ib2ssF4HJlwOkAmmbXW2Nl2pEatBvnZXul5XujmLw3W4uhIutgWpJsOirt l5pvUfgA4uILkRENEThOuuG3uMGKb5476Ly0sMIKQEyAhYH9hVCBFtXimB3UiFlq8ZaB mQvQ== X-Gm-Message-State: AOAM531tlC1Gy5Ymqz9b3mOVL/taIyuQ5BStPfMCd/Hiu5pzyfYJwB4X FxzP6oUGMtiXNaWygovMmorOLav33GPodrFPnus= X-Google-Smtp-Source: ABdhPJxc/EtlFoSvWw78aLgd2xUZkHHhPSYl+9TaUtk39nxGFjEffwjXMQG/DV/+HJnaItxDN/BTtqTbZtZ5zn+OvdU= X-Received: by 2002:a9d:6f10:: with SMTP id n16mr19988702otq.150.1632127537570; Mon, 20 Sep 2021 01:45:37 -0700 (PDT) MIME-Version: 1.0 References: <20210918135437.36667-1-kettenis@openbsd.org> <20210918135437.36667-6-kettenis@openbsd.org> In-Reply-To: <20210918135437.36667-6-kettenis@openbsd.org> From: Igor Opaniuk Date: Mon, 20 Sep 2021 11:45:26 +0300 Message-ID: Subject: Re: [PATCH 5/5] doc: board: apple: Add Apple M1 documentation To: Mark Kettenis Cc: U-Boot Mailing List , Oliver Graute , Leo Yu-Chi Liang , Jonathan Balkind , Bin Meng , Michael Walle , Stephan Gerhold , Padmarao Begari , Tianrui Wei , Masami Hiramatsu , Heinrich Schuchardt , Simon Glass , Asherah Connor , Michal Simek , Wasim Khan , Ye Li , Stefan Roese , =?UTF-8?B?TWFyZWsgQmVow7pu?= , Vabhav Sharma , Weijie Gao , AKASHI Takahiro , Pratyush Yadav , Andy Shevchenko Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable 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 On Sat, Sep 18, 2021 at 4:56 PM Mark Kettenis wrote: > > 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 > +=3D=3D=3D=3D=3D > + > +.. 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 > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D > + > +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=3Daarch64-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 > Reviewed-by: Igor Opaniuk --=20 Best regards - Freundliche Gr=C3=BCsse - Meilleures salutations Igor Opaniuk mailto: igor.opaniuk@gmail.com skype: igor.opanyuk +380 (93) 836 40 67 http://ua.linkedin.com/in/iopaniuk