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 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 smtp.lore.kernel.org (Postfix) with ESMTPS id BDB27C433F5 for ; Mon, 17 Jan 2022 15:10:07 +0000 (UTC) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 4727B837B5; Mon, 17 Jan 2022 16:09:15 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=none (p=none dis=none) header.from=akkea.ca Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Authentication-Results: phobos.denx.de; dkim=pass (1024-bit key; unprotected) header.d=akkea.ca header.i=@akkea.ca header.b="DqdwDib9"; dkim=pass (1024-bit key) header.d=akkea.ca header.i=@akkea.ca header.b="DqdwDib9"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id D518F8384C; Mon, 17 Jan 2022 16:08:45 +0100 (CET) Received: from node.akkea.ca (li1434-30.members.linode.com [45.33.107.30]) (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 7F39F83834 for ; Mon, 17 Jan 2022 16:08:16 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=none (p=none dis=none) header.from=akkea.ca Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=angus@akkea.ca Received: from localhost (localhost [127.0.0.1]) by node.akkea.ca (Postfix) with ESMTP id EFBAA4E205C; Mon, 17 Jan 2022 15:08:14 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=akkea.ca; s=mail; t=1642432094; bh=0Ppp8740MUnTvcnqOLyvGYuA2K/iZbJJrH055ZBVBoM=; h=From:To:Cc:Subject:Date:In-Reply-To:References; b=DqdwDib9zPoIGVUPcEq9qK/wXW0zKhu7uo6TicH3nD5YJ9QK8FUZTnmIDu3Oq/SK6 q/K5ss/xLm/ficRo/2Dq4OaTByrdpMpO1YIOLTqOtWDXD8sYQ7k0K75+1oCgt84XA3 Tgbetkwaxn9Xd/44ls/3d+n3u8LgU/bbERAbKbLw= Received: from node.akkea.ca ([127.0.0.1]) by localhost (mail.akkea.ca [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 84dM-RfYhWMO; Mon, 17 Jan 2022 15:08:14 +0000 (UTC) Received: from midas.localdomain (S0106788a2041785e.gv.shawcable.net [24.108.106.191]) by node.akkea.ca (Postfix) with ESMTPSA id DF49C4E200C; Mon, 17 Jan 2022 15:08:13 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=akkea.ca; s=mail; t=1642432094; bh=0Ppp8740MUnTvcnqOLyvGYuA2K/iZbJJrH055ZBVBoM=; h=From:To:Cc:Subject:Date:In-Reply-To:References; b=DqdwDib9zPoIGVUPcEq9qK/wXW0zKhu7uo6TicH3nD5YJ9QK8FUZTnmIDu3Oq/SK6 q/K5ss/xLm/ficRo/2Dq4OaTByrdpMpO1YIOLTqOtWDXD8sYQ7k0K75+1oCgt84XA3 Tgbetkwaxn9Xd/44ls/3d+n3u8LgU/bbERAbKbLw= From: Angus Ainslie To: "NXP i.MX U-Boot Team" , u-boot@lists.denx.de Cc: Stefano Babic , Fabio Estevam , Peng Fan , Marcel Ziswiler , Teresa Remmet , Adam Ford , Tim Harvey , Jagan Teki , Ilko Iliev , kernel@puri.sm, Angus Ainslie Subject: [PATCH 13/13] doc: librem5: add Librem5 documentation Date: Mon, 17 Jan 2022 07:07:35 -0800 Message-Id: <20220117150735.218886-14-angus@akkea.ca> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220117150735.218886-1-angus@akkea.ca> References: <20220117150735.218886-1-angus@akkea.ca> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.39 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 Initial commit of the Librem5 documentation Signed-off-by: Angus Ainslie --- doc/board/purism/librem5/librem5.rst | 60 ++++++++++++++++++++++++++++ 1 file changed, 60 insertions(+) create mode 100644 doc/board/purism/librem5/librem5.rst diff --git a/doc/board/purism/librem5/librem5.rst b/doc/board/purism/librem5/librem5.rst new file mode 100644 index 0000000000..d380d48c71 --- /dev/null +++ b/doc/board/purism/librem5/librem5.rst @@ -0,0 +1,60 @@ +.. SPDX-License-Identifier: GPL-2.0+ + +Librem5 +========== + +U-Boot for the Purism Librem5 phone + +Quick Start +----------- + +- Build the ARM Trusted firmware binary +- Get ddr and hdmi firmware +- Build U-Boot + +Get and Build the ARM Trusted firmware +-------------------------------------- + +Note: srctree is U-Boot source directory +Get ATF from: https://source.puri.sm/Librem5/arm-trusted-firmware +branch: librem5 + +.. code-block:: bash + + $ make PLAT=imx8mq bl31 + $ cp build/imx8mq/release/bl31.bin $(builddir) + +Get the ddr and hdmi firmware +----------------------------- + +.. code-block:: bash + + $ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.10.bin + $ chmod +x firmware-imx-8.10.bin + $ ./firmware-imx-8.10.bin + $ cp firmware-imx-8.10/firmware/hdmi/cadence/signed_hdmi_imx8m.bin $(builddir) + $ cp firmware-imx-8.10/firmware/ddr/synopsys/lpddr4*.bin $(builddir) + +Build U-Boot +------------ + +.. code-block:: bash + + $ export CROSS_COMPILE=aarch64-linux-gnu + $ make librem5_defconfig + $ make flash.bin + +Burn the flash.bin +------------------ + +Use uuu to burn flash.bin. Power on the phone while holding vol+ to get it +into uuu mode. + +.. code-block:: bash + + $ git clone https://source.puri.sm/Librem5/librem5-devkit-tools.git + $ cd librem5-devkit-tools + $ cp $(builddir)/flash.bin files/ + $ uuu uuu_scripts/u-boot_flash_librem5.lst + +Reboot the phone. -- 2.25.1