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 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 568AFEB64DD for ; Tue, 25 Jul 2023 18:53:26 +0000 (UTC) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 6E9CD86604; Tue, 25 Jul 2023 20:53:24 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=quarantine dis=none) header.from=ti.com 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=ti.com header.i=@ti.com header.b="QfJcK6uj"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id 979BD86783; Tue, 25 Jul 2023 20:53:03 +0200 (CEST) Received: from lelv0143.ext.ti.com (lelv0143.ext.ti.com [198.47.23.248]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by phobos.denx.de (Postfix) with ESMTPS id 2F3F986708 for ; Tue, 25 Jul 2023 20:52:57 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=quarantine dis=none) header.from=ti.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=nm@ti.com Received: from fllv0035.itg.ti.com ([10.64.41.0]) by lelv0143.ext.ti.com (8.15.2/8.15.2) with ESMTP id 36PIqt5K068124; Tue, 25 Jul 2023 13:52:55 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ti.com; s=ti-com-17Q1; t=1690311175; bh=IsEt2FJTVqW9ba/3BtrnoyBiE4gBXvXYgFBceAbKy3c=; h=From:To:CC:Subject:Date:In-Reply-To:References; b=QfJcK6ujlkQJBW1bobjOuQEsqD/bRXbkFjkxPf3ZDYw2EMn6TNVP8rHKZdeimshY2 MLpHA2PKzPk71O0pgixf4p4+LwvCWGm168FIXg2BafEorIURSX4Z+BukWj5LL7l1W4 56VFjRhH2lEQIgMMrb+x5oKRXwq4Q0a6IM2ndhjE= Received: from DFLE109.ent.ti.com (dfle109.ent.ti.com [10.64.6.30]) by fllv0035.itg.ti.com (8.15.2/8.15.2) with ESMTPS id 36PIqsrE011391 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=FAIL); Tue, 25 Jul 2023 13:52:55 -0500 Received: from DFLE109.ent.ti.com (10.64.6.30) by DFLE109.ent.ti.com (10.64.6.30) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.2507.23; Tue, 25 Jul 2023 13:52:54 -0500 Received: from fllv0040.itg.ti.com (10.64.41.20) by DFLE109.ent.ti.com (10.64.6.30) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.2507.23 via Frontend Transport; Tue, 25 Jul 2023 13:52:54 -0500 Received: from localhost (ileaxei01-snat2.itg.ti.com [10.180.69.6]) by fllv0040.itg.ti.com (8.15.2/8.15.2) with ESMTP id 36PIqs4P056021; Tue, 25 Jul 2023 13:52:54 -0500 From: Nishanth Menon To: Neha Malcom Francis , Tom Rini CC: Bryan Brattlof , Praneeth Bajjuri , Andrew Davis , Robert Nelson , Vignesh R , , Nishanth Menon Subject: [PATCH 6/6] doc: board: ti: Add beagleplay documentation Date: Tue, 25 Jul 2023 13:52:53 -0500 Message-ID: <20230725185253.2123433-7-nm@ti.com> X-Mailer: git-send-email 2.40.0 In-Reply-To: <20230725185253.2123433-1-nm@ti.com> References: <20230725185253.2123433-1-nm@ti.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain X-EXCLAIMER-MD-CONFIG: e1e8a2fd-e40a-4ac6-ac9b-f7e9cc9ee180 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.8 at phobos.denx.de X-Virus-Status: Clean Add base documentation for beagleplay Signed-off-by: Nishanth Menon --- doc/board/ti/am62x_beagleplay.rst | 169 ++++++++++++++++++++++++++++++ doc/board/ti/k3.rst | 1 + 2 files changed, 170 insertions(+) create mode 100644 doc/board/ti/am62x_beagleplay.rst diff --git a/doc/board/ti/am62x_beagleplay.rst b/doc/board/ti/am62x_beagleplay.rst new file mode 100644 index 000000000000..4bb131c03736 --- /dev/null +++ b/doc/board/ti/am62x_beagleplay.rst @@ -0,0 +1,169 @@ +.. SPDX-License-Identifier: GPL-2.0+ OR BSD-3-Clause +.. sectionauthor:: Nishanth Menon + +Beagleboard.org Beagleplay +========================== + +Introduction: +------------- +BeagleBoard.org BeaglePlay is an easy to use, affordable open source +hardware single board computer based on the Texas Instruments AM625 +SoC that allows you to create connected devices that work even at long +distances using IEEE 802.15.4g LR-WPAN and IEEE 802.3cg 10Base-T1L. +Expansion is provided over open standards based mikroBUS, Grove and +QWIIC headers among other interfaces. + +Further information can be found at: +https://beagleplay.org/ +https://git.beagleboard.org/beagleplay/beagleplay + +The boot flow follows the standard AM62X bootflow [1]_. + +Sources: +-------- +1. Trusted Firmware-A: + Tree: https://git.trustedfirmware.org/TF-A/trusted-firmware-a.git/ + Branch: master + +2. OP-TEE: + Tree: https://github.com/OP-TEE/optee_os.git + Branch: master + +3. U-Boot: + Tree: https://source.denx.de/u-boot/u-boot + Branch: master + +4. TI Linux Firmware: + Tree: git://git.ti.com/processor-firmware/ti-linux-firmware.git + Branch: ti-linux-firmware + +Build procedure: +---------------- +1. Trusted Firmware-A: + +.. code-block:: bash + + $ make CROSS_COMPILE=aarch64-none-linux-gnu- ARCH=aarch64 PLAT=k3 \ + TARGET_BOARD=lite SPD=opteed + +2. OP-TEE: + +.. code-block:: bash + + $ make PLATFORM=k3 CFG_ARM64_core=y CROSS_COMPILE=arm-none-linux-gnueabihf- \ + CROSS_COMPILE64=aarch64-none-linux-gnu- + +3. U-Boot: + +* 3.1 R5: + +.. code-block:: bash + + $ make ARCH=arm am62x_beagleplay_r5_defconfig + $ make ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabihf- \ + BINMAN_INDIRS= + +* 3.2 A53: + +.. code-block:: bash + + $ make ARCH=arm am62x_beagleplay_a53_defconfig + $ make ARCH=arm CROSS_COMPILE=aarch64-none-linux-gnu- \ + BL31=/build/k3/lite/release/bl31.bin \ + TEE=/out/arm-plat-k3/core/tee-raw.bin \ + BINMAN_INDIRS= + +Target Images +-------------- +Copy the below images to an SD card and boot: + +* tiboot3-am62x-gp-evm.bin from step 3.1 as tiboot3.bin +* tispl.bin_unsigned from step 3.2 as tispl.bin +* u-boot.img_unsigned from step 3.2 as uboot.img + +Image formats: +-------------- + +The Image format follows the standard AM62X image format [1]_. + +A53 SPL DDR Memory Layout +------------------------- + +This provides an overview memory usage in A53 SPL stage. + +.. list-table:: + :widths: 16 16 16 + :header-rows: 1 + + * - Region + - Start Address + - End Address + + * - EMPTY + - 0x80000000 + - 0x80080000 + + * - TEXT BASE + - 0x80080000 + - 0x800d8000 + + * - EMPTY + - 0x800d8000 + - 0x80200000 + + * - BMP IMAGE + - 0x80200000 + - 0x80b77660 + + * - STACK + - 0x80b77660 + - 0x80b77e60 + + * - GD + - 0x80b77e60 + - 0x80b78000 + + * - MALLOC + - 0x80b78000 + - 0x80b80000 + + * - EMPTY + - 0x80b80000 + - 0x80c80000 + + * - BSS + - 0x80c80000 + - 0x80d00000 + + * - BLOBS + - 0x80d00000 + - 0x80d00400 + + * - EMPTY + - 0x80d00400 + - 0x81000000 + +Switch Setting for Boot Mode +---------------------------- + +The Boot time switch option is configured via "USR" button on the board. +See https://git.beagleboard.org/beagleplay/beagleplay/-/blob/main/BeaglePlay_sch.pdf +for details. + +*Boot Modes* + +=========== ============ ============== +Switch Posn Primary Boot Secondary Boot +=========== ============ ============== +Not Pressed eMMC UART +Pressed SD FS mode USB DFU +=========== ============ ============== + +The procedure for using the USR button for switching to SD card boot mode +is to keep the USR button pressed while providing power over the Type-C power +supply and releasing the USR button once the power LED glows. + +References +---------- + +.. [1] :doc:`am62x_sk` diff --git a/doc/board/ti/k3.rst b/doc/board/ti/k3.rst index 126d4e153c0a..5366beedb6a3 100644 --- a/doc/board/ti/k3.rst +++ b/doc/board/ti/k3.rst @@ -30,6 +30,7 @@ K3 Based SoCs .. toctree:: :maxdepth: 1 + am62x_beagleplay am62x_sk am65x_evm j7200_evm -- 2.40.0