{"id":2222477,"url":"http://patchwork.ozlabs.org/api/patches/2222477/?format=json","web_url":"http://patchwork.ozlabs.org/project/uboot/patch/20260412064701.357997-1-s-vadapalli@ti.com/","project":{"id":18,"url":"http://patchwork.ozlabs.org/api/projects/18/?format=json","name":"U-Boot","link_name":"uboot","list_id":"u-boot.lists.denx.de","list_email":"u-boot@lists.denx.de","web_url":null,"scm_url":null,"webscm_url":null,"list_archive_url":"","list_archive_url_format":"","commit_url_format":""},"msgid":"<20260412064701.357997-1-s-vadapalli@ti.com>","list_archive_url":null,"date":"2026-04-12T06:46:17","name":"doc: board: ti: j784s4_evm: Automate BAR address lookup for PCIe Boot","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"7166cc1aafddcf55bc00d9b9f4a3476a6bea1e6f","submitter":{"id":84157,"url":"http://patchwork.ozlabs.org/api/people/84157/?format=json","name":"Siddharth Vadapalli","email":"s-vadapalli@ti.com"},"delegate":{"id":68728,"url":"http://patchwork.ozlabs.org/api/users/68728/?format=json","username":"xypron","first_name":"Heinrich","last_name":"Schuchardt","email":"xypron.glpk@gmx.de"},"mbox":"http://patchwork.ozlabs.org/project/uboot/patch/20260412064701.357997-1-s-vadapalli@ti.com/mbox/","series":[{"id":499586,"url":"http://patchwork.ozlabs.org/api/series/499586/?format=json","web_url":"http://patchwork.ozlabs.org/project/uboot/list/?series=499586","date":"2026-04-12T06:46:17","name":"doc: board: ti: j784s4_evm: Automate BAR address lookup for PCIe Boot","version":1,"mbox":"http://patchwork.ozlabs.org/series/499586/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/2222477/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/2222477/checks/","tags":{},"related":[],"headers":{"Return-Path":"","X-Original-To":"incoming@patchwork.ozlabs.org","Delivered-To":"patchwork-incoming@legolas.ozlabs.org","Authentication-Results":["legolas.ozlabs.org;\n\tdkim=pass (1024-bit key;\n unprotected) header.d=ti.com header.i=@ti.com header.a=rsa-sha256\n header.s=selector1 header.b=EJxd1fxm;\n\tdkim-atps=neutral","legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=lists.denx.de\n (client-ip=85.214.62.61; helo=phobos.denx.de;\n envelope-from=u-boot-bounces@lists.denx.de; receiver=patchwork.ozlabs.org)","phobos.denx.de;\n dmarc=pass (p=quarantine dis=none) header.from=ti.com","phobos.denx.de;\n spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de","phobos.denx.de;\n\tdkim=pass (1024-bit key;\n unprotected) header.d=ti.com header.i=@ti.com header.b=\"EJxd1fxm\";\n\tdkim-atps=neutral","phobos.denx.de;\n dmarc=pass (p=quarantine dis=none) header.from=ti.com","phobos.denx.de;\n spf=pass smtp.mailfrom=s-vadapalli@ti.com"],"Received":["from phobos.denx.de (phobos.denx.de [85.214.62.61])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4ftgyN1svSz1yCx\n\tfor ; Sun, 12 Apr 2026 16:45:00 +1000 (AEST)","from h2850616.stratoserver.net (localhost [IPv6:::1])\n\tby phobos.denx.de (Postfix) with ESMTP id 607BD839D5;\n\tSun, 12 Apr 2026 08:44:57 +0200 (CEST)","by phobos.denx.de (Postfix, from userid 109)\n id B00FE840D8; Sun, 12 Apr 2026 08:44:56 +0200 (CEST)","from BN1PR04CU002.outbound.protection.outlook.com\n (mail-eastus2azlp170100001.outbound.protection.outlook.com\n [IPv6:2a01:111:f403:c110::1])\n (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))\n (No client certificate requested)\n by phobos.denx.de (Postfix) with ESMTPS id 2144A8341A\n for ; Sun, 12 Apr 2026 08:44:54 +0200 (CEST)","from DM6PR03CA0020.namprd03.prod.outlook.com (2603:10b6:5:40::33) by\n IA6PR10MB997681.namprd10.prod.outlook.com (2603:10b6:208:5e3::13)\n with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.9769.17; Sun, 12 Apr\n 2026 06:44:51 +0000","from DS1PEPF0001709D.namprd05.prod.outlook.com\n (2603:10b6:5:40:cafe::af) by DM6PR03CA0020.outlook.office365.com\n (2603:10b6:5:40::33) with Microsoft SMTP Server (version=TLS1_3,\n cipher=TLS_AES_256_GCM_SHA384) id 15.20.9769.46 via Frontend Transport; Sun,\n 12 Apr 2026 06:44:51 +0000","from lewvzet200.ext.ti.com (198.47.23.194) by\n DS1PEPF0001709D.mail.protection.outlook.com (10.167.18.107) with Microsoft\n SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id\n 15.20.9769.17 via Frontend Transport; Sun, 12 Apr 2026 06:44:50 +0000","from DLEE205.ent.ti.com (157.170.170.85) by lewvzet200.ext.ti.com\n (10.4.14.103) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.2562.20; Sun, 12 Apr\n 2026 01:44:48 -0500","from DLEE210.ent.ti.com (157.170.170.112) by DLEE205.ent.ti.com\n (157.170.170.85) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.2562.20; Sun, 12 Apr\n 2026 01:44:48 -0500","from lelvem-mr05.itg.ti.com (10.180.75.9) by DLEE210.ent.ti.com\n (157.170.170.112) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.2562.20 via Frontend\n Transport; Sun, 12 Apr 2026 01:44:48 -0500","from toolbox.dhcp.ti.com (uda0492258.dhcp.ti.com [10.24.73.74])\n by lelvem-mr05.itg.ti.com (8.18.1/8.18.1) with ESMTP id 63C6ijdV2987206;\n Sun, 12 Apr 2026 01:44:46 -0500"],"X-Spam-Checker-Version":"SpamAssassin 3.4.2 (2018-09-13) on phobos.denx.de","X-Spam-Level":"","X-Spam-Status":"No, score=-1.6 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH,\n DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FORGED_SPF_HELO,\n RCVD_IN_DNSWL_BLOCKED,SPF_HELO_PASS,T_SPF_PERMERROR autolearn=no\n autolearn_force=no version=3.4.2","ARC-Seal":"i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none;\n b=uZ+jj1dRZ1GrYGjAuGby9uDu7AYbAjNkBMHvNeMf03I1avSs2QKwm34sjTE3IqIJoZySr0GpFe500hUeCxL3uHgUEYUrdcQ2RR0g8fOiOnYFIYa7CRNpEvZdbWHPtlaMv9rw41vI3UdhDfgwTjWhZxUwBl398RU9+U/406fxR3N5+zOonFO+O8ASyzv8/J+Pxj2WOKM1gMFI/sP559s6EeS+H+YJFIopbq9Z+VCt4ZSqUry40JKJvnqL8+9eJhBlRDG6w/NhQz7U4KraM+bqL+itvoRJPI5XOCmbFU28nI+giFWZlNULlQPy1fe+rLvmJIKe4qDgOS1l8dZWsJj9BA==","ARC-Message-Signature":"i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com;\n s=arcselector10001;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1;\n bh=Qq/YumI1unDt4XkDAQ3K6ukUEbqhponu3zUKvzRQ7tA=;\n b=O+9bfQv7F45KBiYbmceEISlGWAkUdGmhLZlAxP6KO8/1xN9YXpriL1Dt/hY+bJ0a5kvZQ23Zd1I3q6ZjqPYYrlsh/eG4twvvea+83JyyPzzrxvUcCi16qPjL1gsXjoN0EC/16ljPdUmPQde2pWQ7i2hr8jk+8IAYS4wccyB/jtX2x0jrDO424DfHynoRE883c9hg6Aik2aH6pTuo77Nlli0nwe54o110SSvXL0nF3J2I0OMW524NgRdqzEKjjcJOA/Biq4GFeeYulblHcIQlSrKCsYhE/O2Ko+WWq7Xi4KAUe4DdY7w1PENtQpE6fXq6KehWT/1PrVkY/MxWC2QvSQ==","ARC-Authentication-Results":"i=1; mx.microsoft.com 1; spf=pass (sender ip is\n 198.47.23.194) smtp.rcpttodomain=lists.denx.de smtp.mailfrom=ti.com;\n dmarc=pass (p=quarantine sp=none pct=100) action=none header.from=ti.com;\n dkim=none (message not signed); arc=none (0)","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed; d=ti.com; s=selector1;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck;\n bh=Qq/YumI1unDt4XkDAQ3K6ukUEbqhponu3zUKvzRQ7tA=;\n b=EJxd1fxm2g4zR5hUunaFTbxqwL8rXHVtyHrbimi78WbtKEBz9fD6OPFKrdFUCXqsw/i/IF2IOkFrue9kzMrJtIUBN6hkdSbyQ9YAHs/JehA2J/6FKLgH7WelnJib+nRivx58fuuMWIsgJLEupOG2qXQ5zTdXsPK/P6EN2OEQvw8=","X-MS-Exchange-Authentication-Results":"spf=pass (sender IP is 198.47.23.194)\n smtp.mailfrom=ti.com; dkim=none (message not signed) header.d=none;\n dmarc=pass\n action=none header.from=ti.com;","Received-SPF":"Pass (protection.outlook.com: domain of ti.com designates\n 198.47.23.194 as permitted sender) receiver=protection.outlook.com;\n client-ip=198.47.23.194; helo=lewvzet200.ext.ti.com; pr=C","From":"Siddharth Vadapalli ","To":", , ,\n ","CC":", , ","Subject":"[PATCH] doc: board: ti: j784s4_evm: Automate BAR address lookup for\n PCIe Boot","Date":"Sun, 12 Apr 2026 12:16:17 +0530","Message-ID":"<20260412064701.357997-1-s-vadapalli@ti.com>","X-Mailer":"git-send-email 2.51.1","MIME-Version":"1.0","Content-Transfer-Encoding":"8bit","Content-Type":"text/plain","X-C2ProcessedOrg":"333ef613-75bf-4e12-a4b1-8e3623f5dcea","X-EOPAttributedMessage":"0","X-MS-PublicTrafficType":"Email","X-MS-TrafficTypeDiagnostic":"DS1PEPF0001709D:EE_|IA6PR10MB997681:EE_","X-MS-Office365-Filtering-Correlation-Id":"45a80ca3-fba8-4f98-9e8a-08de985eff2e","X-MS-Exchange-SenderADCheck":"1","X-MS-Exchange-AntiSpam-Relay":"0","X-Microsoft-Antispam":"BCL:0;\n ARA:13230040|376014|36860700016|82310400026|1800799024|18002099003|56012099003;","X-Microsoft-Antispam-Message-Info":"\n UODWfTxT9gvpx6zUpJ687Ss+TOXs62yei3sReJy/5WeZ5O5jJ1mxKjymxZQpgd6w0W/c6Qetf+VPI00UIA3uLIzAKE93QgkT9EC5R4bH7yuWiLE4dS8l7nrY4ROSNWWq5yEOOE7CBn1GfFSTD7hAaQJ04qiX+6JWmOwBZdRiGQi4Fib/XdQkguRIQ2/44jcgauvwtZvwniLkHBZFqvcO6vpvx0m3HACDFmYekaqKlQVeUHEnGvgJtrAhi4P3z9Lfx3BP2ym8Br/LiYZJEOAoDxb6NwaFuiKnZcNPjkwPVU/1VjuQG4RX22GRM8wp6+N7P8ox0d5NgGo8TSt1a1TxIuM3IDmKvz+c0zQoknzpVHN+Q1iDVq7kvmhJkp2KFiXHRIgfH7cWInxB1vrz0sEhuoGa2d94jACafRIDelLemc4clDkOu+yqfspBiSDUdUGcwEjbH0LdY6YqmbXyVKeVm6NU+f9vVziDZEwU+xkIuH8a1MMKJSSK6oafpgc5s10oXU+5xzM8KPlHKi0uKGF9jvZt8Pp3LH9NB2GKIRniFxwy85jvDndYlXFsUaqbwKY8yjasAYXYa6ggte6DaEyRbgXqVeXPsmPH0P7XMGiW+imzY9n1vY3hSxpE6GW5hGSBl752dMQw2aHW/k40Sm15PXAbbedNGCfp5vKRX0qBHrdaOnfXYXiYzJCSci8WXYGCYvYry8SCYJnDdhOpN+mORg==","X-Forefront-Antispam-Report":"CIP:198.47.23.194; CTRY:US; LANG:en; SCL:1; SRV:;\n IPV:NLI; SFV:NSPM; H:lewvzet200.ext.ti.com; PTR:InfoDomainNonexistent;\n CAT:NONE;\n SFS:(13230040)(376014)(36860700016)(82310400026)(1800799024)(18002099003)(56012099003);\n DIR:OUT; SFP:1101;","X-MS-Exchange-AntiSpam-MessageData-ChunkCount":"1","X-MS-Exchange-AntiSpam-MessageData-0":"\n YzMcRaS1LP0Ads2x16hSSDfJiQ/oa/PI6m2c/GFl5s9Y3YST19qXv8RXY9PJo1UxL9ZPkO4PlNGD3L/M0eIwmzRUoqCQ6CbVaqVEa+PoTh2DDvg5xlpbKLSVx8oa9PtWDbxm706yQAxPX6xMyEnaIMAwjDiBw+j804ZQO230Tt87a+KE/JC+5SbzMLacvGbmuzhZTvNGDS36HpEwPylPx5gG6dyM4YHJVAFM908LYcnRs1ORFMwHRSrN6NSMiBUidOfTot5404srAkvqJuQL/hKa71++VF+JQuXurja7vcfZEHn6dx0Xl22+lKjpco/pbNEnUX1HytJk8Ayy8YOH3FBheK+gM0dX716DxbL9IAQanCrEigi0viKrPBXiQy1HDWw4CNzYjCHecoZomP6CRPmk1s4v7Rwuwb34FIzwqcdXygtmihrVHW8UNw8C9i0C","X-OriginatorOrg":"ti.com","X-MS-Exchange-CrossTenant-OriginalArrivalTime":"12 Apr 2026 06:44:50.7717 (UTC)","X-MS-Exchange-CrossTenant-Network-Message-Id":"\n 45a80ca3-fba8-4f98-9e8a-08de985eff2e","X-MS-Exchange-CrossTenant-Id":"e5b49634-450b-4709-8abb-1e2b19b982b7","X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp":"\n TenantId=e5b49634-450b-4709-8abb-1e2b19b982b7; Ip=[198.47.23.194];\n Helo=[lewvzet200.ext.ti.com]","X-MS-Exchange-CrossTenant-AuthSource":"\n DS1PEPF0001709D.namprd05.prod.outlook.com","X-MS-Exchange-CrossTenant-AuthAs":"Anonymous","X-MS-Exchange-CrossTenant-FromEntityHeader":"HybridOnPrem","X-MS-Exchange-Transport-CrossTenantHeadersStamped":"IA6PR10MB997681","X-BeenThere":"u-boot@lists.denx.de","X-Mailman-Version":"2.1.39","Precedence":"list","List-Id":"U-Boot discussion ","List-Unsubscribe":",\n ","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n ","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"},"content":"When the J784S4-EVM is configured for PCIe Boot, the Bootloaders are to\nbe written to the address specified by particular BARs. The existing\ndocumentation hard-codes the address corresponding to the BAR under the\nassumption that the Root-Complex transferring the Bootloaders is also\na J784S4-EVM. The Root-Complex assigns addresses to the BARs depending\non the currently available set of free system addresses. Since the free\nsystem addresses vary with the Root-Complex being used, instead of\nhard-coding the BARs, automate the process of identifying the appropriate\nBAR in the form of a command to be run by the user on the Root-Complex.\n\nSigned-off-by: Siddharth Vadapalli \n---\n\nThis patch is based on commit\ne2fa3e570f8 Merge branch 'master' of https://source.denx.de/u-boot/custodians/u-boot-sh\nof the master branch of U-Boot.\n\nPatch has been tested by running the following command to build the\ndocumentation:\nmake htmldocs\nfollowed by verifying that the update is reflected in the generated\ndocumentation with proper formatting.\n\nRegards,\nSiddharth.\n\n doc/board/ti/j784s4_evm.rst | 16 +++++++++-------\n 1 file changed, 9 insertions(+), 7 deletions(-)","diff":"diff --git a/doc/board/ti/j784s4_evm.rst b/doc/board/ti/j784s4_evm.rst\nindex fb767bedbf6..f89def076c2 100644\n--- a/doc/board/ti/j784s4_evm.rst\n+++ b/doc/board/ti/j784s4_evm.rst\n@@ -456,12 +456,12 @@ The following steps describe the process of booting J784S4-EVM over PCIe:\n 0000:01:00.1 Non-VGA unclassified device: Texas Instruments Device 0100\n 0000:01:00.2 Non-VGA unclassified device: Texas Instruments Device 0100\n \n-4. Copy ``tiboot3.bin`` to the endpoint. Use ``lspci -vv`` to identify the BAR\n- address:\n+4. Copy ``tiboot3.bin`` to BAR1 of Physical Function Zero of the endpoint:\n \n .. prompt:: bash\n \n- sudo ./pcie_boot_util 0x4007100000 tiboot3.bin\n+ tiboot3_bar_address=\"0x$(lspci -D -nnvv | awk '/^[0-9a-fA-F]{4}:/ {bdf=$1; ram=($0 ~ /RAM memory/ || $0 ~ /Memory controller/)} ram && /Region [1]+:/ {print bdf, $0}' | cut -d ' ' -f 6)\"\n+ sudo ./pcie_boot_util ${tiboot3_bar_address} tiboot3.bin\n \n The sample program automatically writes the image start address to\n ``0x41CF3FE0`` and the magic word ``0xB17CEAD9`` to ``0x41CF3FE4``.\n@@ -491,11 +491,12 @@ The following steps describe the process of booting J784S4-EVM over PCIe:\n (with appropriate DOMAIN:BUS:DEVICE.FUNCTION corresponding to the Endpoint) to enable\n the BAR.\n \n-6. Copy ``tispl.bin`` to the new BAR address (use ``lspci -vv`` to find):\n+6. Copy ``tispl.bin`` to BAR0 of Physical Function Zero of the endpoint:\n \n .. prompt:: bash\n \n- sudo ./pcie_boot_util 0x4000400000 tispl.bin\n+ tispl_bar_address=\"0x$(lspci -D -nnvv | awk '/^[0-9a-fA-F]{4}:/ {bdf=$1; ram=($0 ~ /RAM memory/ || $0 ~ /Memory controller/)} ram && /Region [0]+:/ {print bdf, $0}' | head -n1 | cut -d ' ' -f 6)\"\n+ sudo ./pcie_boot_util ${tispl_bar_address} tispl.bin\n \n 7. After ``tispl.bin`` is processed, the PCIe link will go down again. Remove\n and rescan the PCIe device:\n@@ -505,11 +506,12 @@ The following steps describe the process of booting J784S4-EVM over PCIe:\n echo 1 > /sys/bus/pci/devices/0000\\:01\\:00.0/remove\n echo 1 > /sys/bus/pci/devices/0000\\:00\\:00.0/rescan\n \n-8. Copy ``u-boot.img``:\n+8. Copy ``u-boot.img`` to BAR0 of Physical Function Zero of the endpoint:\n \n .. prompt:: bash\n \n- sudo ./pcie_boot_util 0x4000400000 u-boot.img\n+ uboot_bar_address=\"0x$(lspci -D -nnvv | awk '/^[0-9a-fA-F]{4}:/ {bdf=$1; ram=($0 ~ /RAM memory/ || $0 ~ /Memory controller/)} ram && /Region [0]+:/ {print bdf, $0}' | head -n1 | cut -d ' ' -f 6)\"\n+ sudo ./pcie_boot_util ${uboot_bar_address} u-boot.img\n \n 9. After ``u-boot.img`` is successfully loaded, the boot process is complete\n and endpoint should boot till U-Boot prompt.\n","prefixes":[]}