{"id":2218994,"url":"http://patchwork.ozlabs.org/api/patches/2218994/?format=json","web_url":"http://patchwork.ozlabs.org/project/uboot/patch/bf216cd8652419e9ce7b9133775a2ea4509fe763.1775121078.git.simona.toaca@nxp.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":"","list_archive_url":null,"date":"2026-04-02T09:40:47","name":"[v3,5/6] doc: board: nxp: Add Quickboot documentation","commit_ref":null,"pull_url":null,"state":"changes-requested","archived":false,"hash":"f88d72f5cc252eda805ee9b537380ad4d2795c22","submitter":{"id":92829,"url":"http://patchwork.ozlabs.org/api/people/92829/?format=json","name":"Simona Toaca","email":"simona.toaca@oss.nxp.com"},"delegate":{"id":151988,"url":"http://patchwork.ozlabs.org/api/users/151988/?format=json","username":"festevam","first_name":"Fabio","last_name":"Estevam","email":"festevam@gmail.com"},"mbox":"http://patchwork.ozlabs.org/project/uboot/patch/bf216cd8652419e9ce7b9133775a2ea4509fe763.1775121078.git.simona.toaca@nxp.com/mbox/","series":[{"id":498456,"url":"http://patchwork.ozlabs.org/api/series/498456/?format=json","web_url":"http://patchwork.ozlabs.org/project/uboot/list/?series=498456","date":"2026-04-02T09:40:42","name":"imx9{4,5,52}: Add Quickboot support","version":3,"mbox":"http://patchwork.ozlabs.org/series/498456/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/2218994/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/2218994/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=GRgTkU8o;\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=\"GRgTkU8o\";\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 server-signature ECDSA (secp384r1) server-digest SHA384)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4fmc5t0ptZz1yFv\n\tfor ; Thu, 02 Apr 2026 20:30:26 +1100 (AEDT)","from h2850616.stratoserver.net (localhost [IPv6:::1])\n\tby phobos.denx.de (Postfix) with ESMTP id A6D1084106;\n\tThu, 2 Apr 2026 11:29:48 +0200 (CEST)","by phobos.denx.de (Postfix, from userid 109)\n id 7D85384154; Thu, 2 Apr 2026 11:29:47 +0200 (CEST)","from DU2PR03CU002.outbound.protection.outlook.com\n (mail-northeuropeazlp170110003.outbound.protection.outlook.com\n [IPv6:2a01:111:f403:c200::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 955588418A\n for ; Thu, 2 Apr 2026 11:29:39 +0200 (CEST)","from VI0PR04MB11917.eurprd04.prod.outlook.com (2603:10a6:800:306::9)\n by AM7PR04MB7095.eurprd04.prod.outlook.com (2603:10a6:20b:11c::21)\n with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.9745.28; Thu, 2 Apr\n 2026 09:29:37 +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.9769.016; Thu, 2 Apr 2026\n 09:29:37 +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=WrZsdxOeiW5jygAprmQ9SKyA/y2RWievaz4HBnqVtGTmxiOyHTkbsUn0cN69luSaut0u8aJ4NMN/dbjKdtA3z71WKrNEpG2iC57xRbid5OHnDZcqiNF6bQMaRvyvtTtPyiusnNZ8pQ/Fh5qZHVtRRQfoG+6bgMB8W6OE+7mUc6bR4Mt1zs2TsZkzHHJoS1/wSJI47cwuhfTmflvFzsV32MIpZj8ufnafZ/gIm6SUeuKW1bZYfCV/Q27+XCLe5ImelSPYKfCSbrImWJYn0SHACyiBMIPUokXa3xNAw8GP2GJeeHFfsmv6y7HJeD1ij475Orf12bRvbbJaqaSTNRmIrg==","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=/V5c6KnMRM11UFc7kOcxwmzEdMdQ24z3zwt7vcI+6Ms=;\n b=tY41xLkm+F+FQChTthh0ehI2Sof79k9oE1JcuqJNjs6O1IwB2M7Cmq2roHSog/fQQrdWe6nFhIUpxkjR+eYDvNu1Ffs3rtHc0kWY8jhfFOWaOk1cEfntOkx5jYha8p5QcwEvF4BwCEQb9taoUzZHOfXt3QmpCK9F2+8Kctmf8895uacveKATSr472MYvePXM0Ap+3GN2zyPrrJ7W6OtmefK0CHwkS7M93878RRWvSt1/p7bxkeHkV2TxYWH+ivVyjyiNFZ9AMqqePBJQzJb5g8T6VOTj/V0XQXd01L6Uaz3qpxD8ydlzFe8ZtX9ntQV56M38ODs7V3c4lwkSrERSdw==","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=/V5c6KnMRM11UFc7kOcxwmzEdMdQ24z3zwt7vcI+6Ms=;\n b=GRgTkU8osAikp5TG5btr4BNNUdBAoBJRZiorbsSVS0gai2UrP3BA7lH7/vcaQWjy3EfcfExbJgfXBkGIX8vWxZA36l5CLIXXqR4QCkcmVfcrShm/HOusrzypL/48Gj7s6398n8LEqu+gTIrUhUfYCISYRWDlXuNIwvJ5dpDUhgrXKohZOQOzSTJcl4tQsQxRbQ+6d8omHpfIsPm4i6AKu7ETQ92ckx+GVuuctfyvbd99ViHpWPWUtzfgY/kvDTAZFpNazNwZSC0t8b0wsCXv8zzMUf9DayK6vC+PUilxXnHyp8YWXY8cKW8u9OCcQiOnB36Ho2Io0vRijKNsERKLRA==","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, viorel.suman@nxp.com, simona.toaca@nxp.com,\n ye.li@nxp.com, ping.bai@nxp.com, marex@nabladev.com,\n sebastien.szymanski@armadeus.com, ravi@prevas.dk,\n joao.goncalves@toradex.com, ji.luo@nxp.com, semen.protsenko@linaro.org,\n tharvey@gateworks.com, qijian.guo@nxp.com","Subject":"[PATCH v3 5/6] doc: board: nxp: Add Quickboot documentation","Date":"Thu, 2 Apr 2026 12:40:47 +0300","Message-ID":"\n ","X-Mailer":"git-send-email 2.43.0","In-Reply-To":"","References":"","Content-Transfer-Encoding":"8bit","Content-Type":"text/plain","X-ClientProxiedBy":"FR4P281CA0122.DEUP281.PROD.OUTLOOK.COM\n (2603:10a6:d10:b9::6) 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_|AM7PR04MB7095:EE_","X-MS-Office365-Filtering-Correlation-Id":"cb6156a9-2fe0-4a99-0528-08de909a5b95","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|19092799006|376014|1800799024|18002099003|22082099003|56012099003;","X-Microsoft-Antispam-Message-Info":"\n Kv0koNrjqAO/Msk7JRNLNwFDgvL5CsaESZI6jdn/lZTTNmfZh20r52uFC3PzhqTtgpar1eehsPHw9vlIUx9B1Q4WRb8hs8xwRjmIHusoyV8ewlLSM1368fA9/rgtLJS/Uvof1pdaGBO3iQ6BjPq94t3EJvKUHsVQcaPl2JkfLDg1eWq6mUkwGQcITDtdmmYwKetG9/amtyYHBQDpjEd8ufX1Wy25NN0+M41j9IFdqDw6o/gx2RJGxcU/TdmIFOKpLD+ztMPQ6cVDFdpCMfrAIZCuewIStEqzdS+cd4QHw6lQCBbzXANSZKXB1djLtD3RsfwYGp8CW6prlfYUa7+wkJl5j/cTrcZS6gTpZacsGwkMK6AiIJAzq+cqfUW0fUbwQaot+gkUQK3qDu9Y0QDSoD++uCrQ8m1lqpY3m7Oxyj9frgjtPzWcEy8QsUdMgGdxdxZTa6eUQnB2nsCnCh/3Wr3JlT46Fxn/uWjJnHC8EUDv+14j/XGFpQ9Kptzlfb1yGugevpDLD9C/EkBtTbM8xd9Mh2nCaA98VliFr7Bh8qJOkJW8uQ0e+9Ms9apS6OyaNYR0za41MwnNx0eYQcVpSJbQ36JQiBaX1Tke/vQvguZHehEAGtrZDhZNwdNejrPRvJzoVwvVoY2uMKZ6Bud8UbYpPSUZtvN5ASXkGJBLKT8HmIu2AAHDHw4T0ZLe7fPo/vbX36bE4jujMoe6YqQRuOEAPzoByitLYqqTC3XLn3Q=","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)(19092799006)(376014)(1800799024)(18002099003)(22082099003)(56012099003);\n DIR:OUT; SFP:1101;","X-MS-Exchange-AntiSpam-MessageData-ChunkCount":"1","X-MS-Exchange-AntiSpam-MessageData-0":"\n Wls1E79cC6GcV1m67eChzjPj8h7pEC/4Jeonmfcot6woQBJkok8N2KiyL/Jt5lOAUrIIH1l3iLL3qqAk3r7qYNSN4T4CYw1+ji6njLdfwMwVlaC1TymwhRP38x5OLnfczwMBDOE5V9zxxpjbSvz8k8doEOqIOycgcByRMiR4RMOyewCnhf6ag9ITJV67/6WCbN4Vn4P1j6R5EG+7PS7DREG7IdPomswKTYUA7cQ07WeGHNxvwdfUuvwuoPU0ETMznq3cEmXzVvzQm5RRHnNDg5+OUKbC6SNgKKWqAOWH86nUIz5WK+0xgdnHAu61i1tTpKZNyodq2WuVA5nah11oJIB2i6KT3FRU43HtftMYG9IiXnwtuxyrJAWttlwXEfrRxEhbzVDE9Ry0MRzBPoQiE170GPk0xTb5aNxcM/cGRwUUNZLZMXNhWA2FFdj1S6mkHKgub5DGHIQJzwehmUmFb2QBt6/XkEaGyCWxftrawlGBhm/VtOPRKp8V5KptC2Npm8PMLvmQtVWViGW1ixkpD4faeQT9bwj/7+3C+ZuXf7/uQoGvoiVkw9O2hNwtVQZcKXpsosAjfOOCXIcaHROCmVFs7dMF/2hzI0E8XSCwrb60h+M5jXtskcFHUTpqbFSP5cJOIXr/oKuQ15bDxOUTFfkVTOfe2LDUhxSFv942bJ9rY5c0llR+Bks/P6JQ+OC6/HKYmba490pu3Wp/dOf2kV1vt6tQrxE6lKvc7yILdHqYE8HR3O+7JwGM5lzmt0dn6+VlpTvuNFCGIeGZkdwBOToKJDfRSj6OJCn8srCmvjF8/6fd4i0LjkIfuPvZ6IAgtFV6htlMraEoQteSrokwvgjlkFKSH1IJtvQfG+GX2V5B9c7bT3miGNjS09DhleJYMQk1cysLlYIYFQXHuDe66T6fIo8ILxP882gaGYdBjiYCK+yrqgxdcl1OH8/ZPI3L8FnCMe8krx4lHNK/Ed3XjmqTxF8+vKlXRcRX7kojTTIcgJLU11yP1ss11+J+QD4IAsQ16XtJFWQXR9Fpvp4i8oXUP+/smPAPDs5Qlqs9eG/TeWrjxaXgmwKFimqDEXn6pKQC9og3ZyTrrnfEq8EznfPT/ruj6dfyEgRVWpxnGZeZdo46tUR5ZkN99uHCEaaPFb/6LiL8K8HUb8QYWlmJzZGGV81x9lhhQzQdsjCy6+fD6sZ6+CsrPD5bnflw55UoOLFtgJpZDdj6hEcirU7OVvateWx10pZtmXzKDYlBBFrktBx6jUEhRA2Ok+yG0vAbZxOrcYwo2HNbr29DRIag0SHJ0qzB3f/NF51WIg5+ObRpepniVj0soEhbB+SFAyvxPc9sIwpmlXlelmN/EhSnCZf97tqn0qbeVtvcHUdiof7asy9xOSSesiLbOuqFeDtHhEYe7U6QNUn9cttuMUVw6cLjI5GTAI92A9HqFmCoYGCea04Aix5OozP6RtLl9of/+wHP9i3BVMgunn9F5rrBi9UOGm5GzBTS5JkDEBw7z0oG0I2Imqeoovl+oW2ocj3iotv6wPc5Zybs6dHqKPKkMCA4imAjunBceTK1sulDU8m48Y8cBzHkGZqc+XeTjqCVNBilvb5bezFkonMowAjCBXW/5CHjwAr3u0l4ZKzyGfRISjXIoWiSW4UiWANndssOUuCxS4xQpZxrvC79ubEbASj5mpiAjKrlsVJK4vTUBW2ZZt+F3X2cDrkndMhVJOiD70FXj+NdGwGOPubFyQGo6w==","X-OriginatorOrg":"oss.nxp.com","X-MS-Exchange-CrossTenant-Network-Message-Id":"\n cb6156a9-2fe0-4a99-0528-08de909a5b95","X-MS-Exchange-CrossTenant-AuthSource":"VI0PR04MB11917.eurprd04.prod.outlook.com","X-MS-Exchange-CrossTenant-AuthAs":"Internal","X-MS-Exchange-CrossTenant-OriginalArrivalTime":"02 Apr 2026 09:29:37.2362 (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 3nxcmqC4e7nEY6znbs4Xju2Ax8OiE5suRj+VRxOrqTcYac6UAJvtdRnkNFTKT0DZBPMl9aVlfmZdmrhRk6BV9A==","X-MS-Exchange-Transport-CrossTenantHeadersStamped":"AM7PR04MB7095","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/qb.rst | 54 +++++++++++++++++++++++++++++++++++++++++\n 2 files changed, 55 insertions(+)\n create mode 100644 doc/board/nxp/qb.rst","diff":"diff --git a/doc/board/nxp/index.rst b/doc/board/nxp/index.rst\nindex 8cd24aecf33..53ef220d989 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+ qb\ndiff --git a/doc/board/nxp/qb.rst b/doc/board/nxp/qb.rst\nnew file mode 100644\nindex 00000000000..07953a1b7e9\n--- /dev/null\n+++ b/doc/board/nxp/qb.rst\n@@ -0,0 +1,54 @@\n+.. SPDX-License-Identifier: GPL-2.0+\n+ Copyright 2026 NXP\n+\n+DDR QuickBoot flow\n+------------------\n+\n+Some NXP boards (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 qb 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.\n+\n+U-Boot provides no authentication for qb 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 boards 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 qb 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+- 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 qb data during flashing / controlling the NVM to save to / forcing re-training\n+\n+::\n+\n+ # To save/erase on current boot device\n+ => qb save/erase\n+\n+ # To save/erase on other boot device\n+ => qb save/erase mmc 0 # eMMC\n+ => qb save/erase mmc 1 # SD\n+ => qb save/erase spi # NOR SPI\n","prefixes":["v3","5/6"]}