{"id":2230923,"url":"http://patchwork.ozlabs.org/api/1.2/patches/2230923/?format=json","web_url":"http://patchwork.ozlabs.org/project/uboot/patch/71a675d6947a679b73b422c708231e01837e1b4c.1777536451.git.simona.toaca@nxp.com/","project":{"id":18,"url":"http://patchwork.ozlabs.org/api/1.2/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":"<71a675d6947a679b73b422c708231e01837e1b4c.1777536451.git.simona.toaca@nxp.com>","list_archive_url":null,"date":"2026-04-30T08:33:33","name":"[v4,4/4] doc: board: nxp: Add Quickboot documentation","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"65414116b8fb9d65867bf6874e4ff8cda15ecb3a","submitter":{"id":92829,"url":"http://patchwork.ozlabs.org/api/1.2/people/92829/?format=json","name":"Simona Toaca (OSS)","email":"simona.toaca@oss.nxp.com"},"delegate":{"id":151988,"url":"http://patchwork.ozlabs.org/api/1.2/users/151988/?format=json","username":"festevam","first_name":"Fabio","last_name":"Estevam","email":"festevam@gmail.com"},"mbox":"http://patchwork.ozlabs.org/project/uboot/patch/71a675d6947a679b73b422c708231e01837e1b4c.1777536451.git.simona.toaca@nxp.com/mbox/","series":[{"id":502232,"url":"http://patchwork.ozlabs.org/api/1.2/series/502232/?format=json","web_url":"http://patchwork.ozlabs.org/project/uboot/list/?series=502232","date":"2026-04-30T08:33:29","name":"imx9{4,5,52}: Add Quickboot support","version":4,"mbox":"http://patchwork.ozlabs.org/series/502232/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/2230923/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/2230923/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 (2048-bit key;\n unprotected) header.d=NXP1.onmicrosoft.com header.i=@NXP1.onmicrosoft.com\n header.a=rsa-sha256 header.s=selector1-NXP1-onmicrosoft-com\n header.b=wvXLj8k3;\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=none (p=none dis=none) header.from=oss.nxp.com","phobos.denx.de;\n spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de","phobos.denx.de;\n\tdkim=pass (2048-bit key;\n unprotected) header.d=NXP1.onmicrosoft.com header.i=@NXP1.onmicrosoft.com\n header.b=\"wvXLj8k3\";\n\tdkim-atps=neutral","phobos.denx.de;\n dmarc=none (p=none dis=none) header.from=oss.nxp.com","phobos.denx.de;\n spf=pass smtp.mailfrom=simona.toaca@oss.nxp.com","dkim=none (message not signed)\n header.d=none;dmarc=none action=none header.from=oss.nxp.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 4g5nJP6fWcz1yGq\n\tfor ; Thu, 30 Apr 2026 18:24:04 +1000 (AEST)","from h2850616.stratoserver.net (localhost [IPv6:::1])\n\tby phobos.denx.de (Postfix) with ESMTP id 1CFAD84676;\n\tThu, 30 Apr 2026 10:23:28 +0200 (CEST)","by phobos.denx.de (Postfix, from userid 109)\n id B3C7684666; Thu, 30 Apr 2026 10:23:23 +0200 (CEST)","from MRWPR03CU001.outbound.protection.outlook.com\n (mail-francesouthazlp170110003.outbound.protection.outlook.com\n [IPv6:2a01:111:f403:c207::3])\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 C0EE584653\n for ; Thu, 30 Apr 2026 10:23:21 +0200 (CEST)","from VI0PR04MB11917.eurprd04.prod.outlook.com (2603:10a6:800:306::9)\n by DB8PR04MB7036.eurprd04.prod.outlook.com (2603:10a6:10:12f::21)\n with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.9870.20; Thu, 30 Apr\n 2026 08:23:19 +0000","from VI0PR04MB11917.eurprd04.prod.outlook.com\n ([fe80::a506:3460:d2bc:26e7]) by VI0PR04MB11917.eurprd04.prod.outlook.com\n ([fe80::a506:3460:d2bc:26e7%4]) with mapi id 15.20.9870.016; Thu, 30 Apr 2026\n 08:23:18 +0000"],"X-Spam-Checker-Version":"SpamAssassin 3.4.2 (2018-09-13) on phobos.denx.de","X-Spam-Level":"","X-Spam-Status":"No, score=-0.9 required=5.0 tests=BAYES_00,DKIM_SIGNED,\n DKIM_VALID,FORGED_SPF_HELO,RCVD_IN_DNSWL_BLOCKED,SPF_HELO_PASS,\n T_SPF_PERMERROR autolearn=no autolearn_force=no version=3.4.2","ARC-Seal":"i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none;\n b=JjHQQ/R3JEmpO1cCqSxrUX4oDQj4HubX48Kn/y5tSWblG4s3SitJjDBg2Kl2AVPqBfgp+l6RzHlBdp6y7Mt8opudpyGZ7R1VFjEHmL8UStt8EzZb7WlKFL3Gn35H1LTz3v0gI9rEVyq13FvRGQUyuKG7uX3mTBCaFtH8rnjhuqxJ+/YQ6IpMXLrvTeKZZjhpmlOymxli978Kjtw087Efja8dpQ38JXxnY+iFLfjGCM8YJnuq5f306Ermw1ccQLJyJ0LI4DNq/nJLta91skLpWSS795xP37FoKMZYH/k2YFyA5mVaHspFJ4kiFWFZTK53rMnneRCezUGg8uYBRRFsYQ==","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=Qm3MNfvxF7jzA1wHDFI5jFgFJmPL0omqjkCdrhId/8k=;\n b=BmWhLfNZMI43i1smgjXCXmrhDXW2h4Drq36nJCb/5kQwxZXc/zDQ5ph0flBdn6eI8QmQnGQZ4mw1mxyPfgfOYPS1upQhCVZz0YSdomGNR9v6Df/T9OrxlsA41YuvkDzcpb5j6W3zFQCPqfc5+DauvscGAveqCmo3ojWdKgXxY8sKIFWBMWVI3GVbMQoxyyeF8FTyN9ur2V6bbSzlIF0jsaYS5U02jVFi+JaTIUDXA8ts486nAWzrWjHjq7QpkVu04eoDJxzJzTlZyr9KjIdAaoEsRVX6vlETjPz/mzIQH2ecIHfRvRkfpJBdb1MQhAXEOY0obgHl7329FxVlPG3ifw==","ARC-Authentication-Results":"i=1; mx.microsoft.com 1; spf=pass\n smtp.mailfrom=oss.nxp.com; dmarc=pass action=none header.from=oss.nxp.com;\n dkim=pass header.d=oss.nxp.com; arc=none","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed; d=NXP1.onmicrosoft.com;\n s=selector1-NXP1-onmicrosoft-com;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck;\n bh=Qm3MNfvxF7jzA1wHDFI5jFgFJmPL0omqjkCdrhId/8k=;\n b=wvXLj8k3r+xcSdj4+mZ/qBPsu+/fNVB0/sK9P2INHzOw+dKOcK8lYICxgQfZNFqFoez3oaV+nNmb2WxehnMY69cfaQY9fyhmBWLHHB/rml1vehWRCNVWh3gssu3lM0MTBSiyazIIPK2V3SWvCUlhjWDmZWLuyLzlnQm9WbuJaVzb6PJflli3SZka4z5Ir0/FiNa+MQeCe94Txx8XQ+3eNCHgqSSxzX7NOt40s+4++zlLcJm6sFdI4H6LsfOMzUXbuV4gugZFT0e5iaOunCzU0IhcAHLtKkPueNkE8/7zftjzWltxSsNxDjkKa7mWxAeKdIyDkUsXsJ2OliCkfu7Akg==","From":"\"Simona Toaca (OSS)\" ","To":"uboot-imx@nxp.com,\n\tu-boot@lists.denx.de","Cc":"Stefano Babic , festevam@gmail.com, peng.fan@nxp.com,\n alice.guo@nxp.com, ye.li@nxp.com, simona.toaca@nxp.com,\n viorel.suman@nxp.com, fedor.ross@ifm.com, marex@nabladev.com,\n joao.goncalves@toradex.com, ravi@prevas.dk, ping.bai@nxp.com,\n ji.luo@nxp.com, qijian.guo@nxp.com","Subject":"[PATCH v4 4/4] doc: board: nxp: Add Quickboot documentation","Date":"Thu, 30 Apr 2026 11:33:33 +0300","Message-ID":"\n <71a675d6947a679b73b422c708231e01837e1b4c.1777536451.git.simona.toaca@nxp.com>","X-Mailer":"git-send-email 2.43.0","In-Reply-To":"","References":"","Content-Transfer-Encoding":"8bit","Content-Type":"text/plain","X-ClientProxiedBy":"AM9P250CA0022.EURP250.PROD.OUTLOOK.COM\n (2603:10a6:20b:21c::27) To VI0PR04MB11917.eurprd04.prod.outlook.com\n (2603:10a6:800:306::9)","MIME-Version":"1.0","X-MS-Exchange-MessageSentRepresentingType":"1","X-MS-PublicTrafficType":"Email","X-MS-TrafficTypeDiagnostic":"VI0PR04MB11917:EE_|DB8PR04MB7036:EE_","X-MS-Office365-Filtering-Correlation-Id":"7625d4a1-f390-4d2a-a89a-08dea691bbea","X-MS-Exchange-SharedMailbox-RoutingAgent-Processed":"True","X-LD-Processed":"686ea1d3-bc2b-4c6f-a92c-d99c5c301635,ExtAddr","X-MS-Exchange-SenderADCheck":"1","X-MS-Exchange-AntiSpam-Relay":"0","X-Microsoft-Antispam":"BCL:0;\n ARA:13230040|366016|1800799024|19092799006|376014|18002099003|56012099003|22082099003;","X-Microsoft-Antispam-Message-Info":"\n fieuPSvp+fVoKWRik5ttCk62KoMBvyOG7ZsmamBowykVbu1elAbBRoYt5NqD8igX4h/SSWiVY4vDJ5VFJRBmZzGYKCoIzLvBPO5bZguJmsavLJgGQbqgLkiUlsFV9g6Gk1SAJPe36RLZoIy4K5kw2UefPV2/tdNXXfO7ao4ia2CRPVAB2sI/Qu77DOs/sNd2a4T5XgqWj61Pbn9C3cv5cxmd6TO9NewSBXICTmPbXE4x3oeO9kSEAvvuABuEzTETOB4TI229jAyrQs8cWgMYgenebR1Bn2HFLJZ3C5+/LBZpA+tQek4eOUU9M/xOW/nH+Iz5cJKYIPWj2eEwvwFCzXtGYNrc4aeLZGabuVoxM9Y3n5l9vOe3kcAu/zl+12YSQ7TkJb2/y8WsRRXWwvUUk8rqwm3K0SYwroplqo/AgDrTKA3dJiUKmv+baYazfPOM6o5dmyLCN9VOf0Ys2I+x+ucLTKyepZwT0UHY85FwXliSi92gu6jZj/eDs4jskBrsx38VT7T/f5Nm0OTbKK17JSZ0QsNfKTjH3WGLj2hacNGQfpeRGYyYW9qM9S3O/nYMLv6IGFyXoEhoc4q5wH8oAtsQxRc9F52ZlN1zvxbSCG4QnJdaBkjPCLQwOU5v6XAsKUX2YgGR7MAtW6nUqfVUlq+qpCpI10ONEWdBJSA59m+OC2JYjDbbaW74OGRz+32pQif6Te58azZ0dOACWhoF4UVvGXKSyA7sssJunn0NdME=","X-Forefront-Antispam-Report":"CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:;\n IPV:NLI; SFV:NSPM; H:VI0PR04MB11917.eurprd04.prod.outlook.com; PTR:;\n CAT:NONE;\n SFS:(13230040)(366016)(1800799024)(19092799006)(376014)(18002099003)(56012099003)(22082099003);\n DIR:OUT; SFP:1101;","X-MS-Exchange-AntiSpam-MessageData-ChunkCount":"1","X-MS-Exchange-AntiSpam-MessageData-0":"\n Nt8OEEbl7ybMN4P89uSu4zaPbBqZG5Xc7jCY5nJsL9QMxmXqpua1x4AER3PpXaFrKargh33JTRBEDraGmyPo6n0n3D5QKE/XhOOpQdnatjwoWOpW5BGHwMwDFaIa5LDGOI1Hsriexp+ZotAMyVkKDwDPGCpmQlKvpearKslb3c7F2hm4gvqvJCqWKrXNyXRG09iGE428HwIRHnROJWOE9iOsovftWEsi+OGUCWsuTxmlxFZR0JGwhzX/KwyRjurDqLVvyxyImoheRSPFlpMGQUxVpu5xNcYQrddhTNB7vYFbfFfTL3jR7axTeBHt90LP3D40NTwP+CR66C1P16olWC8uTzKG3YgHaF7QyQj4feMp3pgD+KpDRA5xf0tLGCZC/LZfPC5kgCa385M7Z1AvzFNSGtsp2jT4U06q0x1uGp5syX9tgBHZ57br2FCF1JDTWaZE4EOPHPz68P+k2eJEOj1JQUHDo2AidPDXqUMZUmn6vNVzMQyuSpMLBn+5gxwLPAlEWieWmSeE3Xm8RZPKr6HQcI2SBAJA9ohNIbZBaM+/aMsRUVVEcCnXVYfPGAuUwVVcm/gOVTYYZaZGiH7SoRtS53eSlbeVRlRTCG7fJ4x/3SsL9nKgJckMBel9OCbtIGEoW2OENMHPJX5hiCzPOoUW9vutmuUPG3VLeqZ+UsL1l7Edt4TJ5AuVJwC/1CTfHLQs9vTNqEDNfMxvggaKH+Kc+nAFWcyM8V9/+yh1NvIcudPn2tvMATpxV8ZPY+7fsURPvjAQ3ZD2i/r1H/ZANdcTx2rfeimTtkhEkNVvwubpjSAqKpJg4aLi1WdzHQ0aaDcdVGKX7+UNh7fOJzDRkztcHrA89NbN8KoFt0l/S5stZM+kugx7RiBhblhHCl9EpT8yJLWtPg5eXJAFI6TYfJwglAUR1QY2GVpy0QuAhnnsMYEKUbequhn23oQ+QW7Uz7HwqLuGJTzVrcnzC4osiFg6vgR+5u8GuWozh2rQ/Vrxa1kreiki/2m37vOTaBF2ztmTxiF27knGoJlng6ZkdaKotUEB4L0WXTxsQRmQdOOiwcjchjGEGV6eppyjGJMRDt/1ImmK9bDI9FKD4d3jz9gY7xIfNsnR6m7LFEGb7eGLx3WQKvAZKJQoO2xOB7rd/kFzRgo4I1OXIZlcSz+bpdc8TF3IpdwoWdpLMLaDlPAm3v5t4TI3R1n+HTQ7LvQ6Ex3KOqH34Cn/qJjNcN6g/P/66PuvsYnsxdR3N3nSsFjdhnMyUQK1GRiKQLSbV7cViVRA08jC6sz6SVM4Z+VUA1BjpXFuDfprvvIQj4EKMy1rowoeJj6Wmco4G2ZL9V3/5MlLCo3yhXHjquN65430tFhftCT1zfeq35+7uFoCMwSmO2PKKVJB7YYtkTJb2CdxgZYVChEgbgKgq52GxlTbNV5s9DkAXQDkNCe/LJR/2Mz/gdBQAJ91kKcm/E2y12N/65H3sqbZ33FJxlqgeovBGgEelAlClIA549dz20B8oAZxzdRjNzLbsIdSewU9nnjJdm4JE6fn8ODd1Kd5Uq5r3B1yUCovt/oI0Hq3mfklA/jOiYzOd7KF65OG9HdgSVGBNToSwbKLLFH84XJAZ8iSPdG7af9XT+R/6ZvgBaVVd6ErlhGNN7IpPZMP7MEUwFQc7M54xOznH2dCF9KTVv782+0nIhaGGPe7KCxg+JMcWtJ6K9yKPqRTpgypYQ/lbL3UZTLcgz3Qr2H1evXa++jUZw==","X-OriginatorOrg":"oss.nxp.com","X-MS-Exchange-CrossTenant-Network-Message-Id":"\n 7625d4a1-f390-4d2a-a89a-08dea691bbea","X-MS-Exchange-CrossTenant-AuthSource":"VI0PR04MB11917.eurprd04.prod.outlook.com","X-MS-Exchange-CrossTenant-AuthAs":"Internal","X-MS-Exchange-CrossTenant-OriginalArrivalTime":"30 Apr 2026 08:23:18.8246 (UTC)","X-MS-Exchange-CrossTenant-FromEntityHeader":"Hosted","X-MS-Exchange-CrossTenant-Id":"686ea1d3-bc2b-4c6f-a92c-d99c5c301635","X-MS-Exchange-CrossTenant-MailboxType":"HOSTED","X-MS-Exchange-CrossTenant-UserPrincipalName":"\n ar8RLqA6nucKpwvx/8SezJCYLs4tfxrqjGSVbnLhfC5WDnc4YyxHAeu4xf4iguM8ZsH74HtOgMXl2mAfEuTb0Q==","X-MS-Exchange-Transport-CrossTenantHeadersStamped":"DB8PR04MB7036","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":"From: Simona Toaca \n\nAdd instructions on how to use U-Boot to save\nDDR training data to NVM and explain the saving\nprocess.\n\nSigned-off-by: Simona Toaca \n---\n doc/board/nxp/index.rst | 1 +\n doc/board/nxp/quickboot.rst | 59 +++++++++++++++++++++++++++++++++++++\n 2 files changed, 60 insertions(+)\n create mode 100644 doc/board/nxp/quickboot.rst","diff":"diff --git a/doc/board/nxp/index.rst b/doc/board/nxp/index.rst\nindex 8cd24aecf33..52c8e85fa5b 100644\n--- a/doc/board/nxp/index.rst\n+++ b/doc/board/nxp/index.rst\n@@ -30,3 +30,4 @@ NXP Semiconductors\n mx6ullevk\n rproc\n psb\n+ quickboot\ndiff --git a/doc/board/nxp/quickboot.rst b/doc/board/nxp/quickboot.rst\nnew file mode 100644\nindex 00000000000..0fd72b4e13b\n--- /dev/null\n+++ b/doc/board/nxp/quickboot.rst\n@@ -0,0 +1,59 @@\n+.. SPDX-License-Identifier: GPL-2.0+\n+ Copyright 2026 NXP\n+\n+DDR QuickBoot flow\n+------------------\n+\n+Some NXP SoCs (which use OEI - iMX943, iMX95, iMX952 etc.) support saving\n+DDR training data (collected by OEI during Training flow) from volatile\n+to non-volatile memory, which is then available to OEI at next cold reboot.\n+OEI uses the saved data to run Quickboot flow and avoid training the DDR again.\n+This significantly reduces the boot time.\n+\n+The location of the quickboot data in NVM is a space left in the bootloader by\n+mkimage, with the size of 64K. The qb command searches for this space to\n+save the data. Thus, the NVM should also be a boot device and contain\n+the bootloader at the time of the saving.\n+\n+U-Boot provides no authentication for quickboot data, only its integrity\n+is verified via the CRC32. The authentication is done in OEI. With\n+the exception of iMX95 A0/A1, which use CRC32 as well for verifying\n+the data, the rest of the SoCs use ELE to verify the MAC stored\n+in the ddrphy_qb_state structure.\n+\n+If the quickboot data in memory is not valid (CRC32 check fails),\n+U-Boot does not save it to NVM. So, if OEI runs Quickboot flow -> no\n+data is written to volatile memory -> invalid data -> no saving happens\n+(qb save fails during qb check).\n+\n+After successful saving, U-Boot clears the data in volatile memory so\n+that qb check fails at next reboot and the NVM isn't accessed again.\n+\n+There are 2 ways to save this data, both can be enabled:\n+\n+1. automatically, in SPL (by enabling CONFIG_SPL_IMX_QB)\n+\n+- this will save the data on the current boot device (e.g. SD)\n+- other configs specific to the boot device need to be enabled (CONFIG_SPL_MMC_WRITE for saving to eMMC/SD)\n+- use for: automating qb save / saving quickboot data if using Falcon mode (skipping U-Boot proper)\n+\n+2. using qb command in U-Boot console (by enabling CONFIG_CMD_IMX_QB)\n+\n+- supports saving on the current boot device, or on another, specified device.\n+- supports specifying the hwpartition for eMMC (for booting from boot0/boot1)\n+- if flashing via uuu, the command can be added in an uuu script (boot device needs to be specified)\n+- use 'qb erase' to force DDR re-training\n+- use for: saving quickboot data during flashing / controlling the NVM to save to / forcing re-training\n+\n+::\n+\n+ # To save/erase on current boot device\n+ # For eMMC boot1, mmc 0:2 has to be specified explicitly\n+ => qb save/erase\n+\n+ # To save/erase on other boot device\n+ => qb save/erase mmc 0 # eMMC boot0\n+ => qb save/erase mmc 0:1 # eMMC boot0\n+ => qb save/erase mmc 0:2 # eMMC boot1\n+ => qb save/erase mmc 1 # SD\n+ => qb save/erase spi # NOR SPI\n","prefixes":["v4","4/4"]}