Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/2222477/?format=api
{ "id": 2222477, "url": "http://patchwork.ozlabs.org/api/patches/2222477/?format=api", "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=api", "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=api", "name": "Siddharth Vadapalli", "email": "s-vadapalli@ti.com" }, "delegate": { "id": 68728, "url": "http://patchwork.ozlabs.org/api/users/68728/?format=api", "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=api", "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": "<u-boot-bounces@lists.denx.de>", "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 <incoming@patchwork.ozlabs.org>; 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 <u-boot@lists.denx.de>; 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 <s-vadapalli@ti.com>", "To": "<trini@konsulko.com>, <mkorpershoek@kernel.org>, <u-kumar1@ti.com>,\n <anshuld@ti.com>", "CC": "<u-boot@lists.denx.de>, <srk@ti.com>, <s-vadapalli@ti.com>", "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 <u-boot.lists.denx.de>", "List-Unsubscribe": "<https://lists.denx.de/options/u-boot>,\n <mailto:u-boot-request@lists.denx.de?subject=unsubscribe>", "List-Archive": "<https://lists.denx.de/pipermail/u-boot/>", "List-Post": "<mailto:u-boot@lists.denx.de>", "List-Help": "<mailto:u-boot-request@lists.denx.de?subject=help>", "List-Subscribe": "<https://lists.denx.de/listinfo/u-boot>,\n <mailto:u-boot-request@lists.denx.de?subject=subscribe>", "Errors-To": "u-boot-bounces@lists.denx.de", "Sender": "\"U-Boot\" <u-boot-bounces@lists.denx.de>", "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 <s-vadapalli@ti.com>\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": [] }