{"id":2221480,"url":"http://patchwork.ozlabs.org/api/1.2/patches/2221480/?format=json","web_url":"http://patchwork.ozlabs.org/project/uboot/patch/20260409133303.31875-7-ansuelsmth@gmail.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":"<20260409133303.31875-7-ansuelsmth@gmail.com>","list_archive_url":null,"date":"2026-04-09T13:33:02","name":"[v6,6/6] doc: dtbinding: Update documentation for Generic Firmware loader","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"79ca704989b172a8a79887a3b74c40b954c0f6b0","submitter":{"id":71108,"url":"http://patchwork.ozlabs.org/api/1.2/people/71108/?format=json","name":"Christian Marangi","email":"ansuelsmth@gmail.com"},"delegate":{"id":3651,"url":"http://patchwork.ozlabs.org/api/1.2/users/3651/?format=json","username":"trini","first_name":"Tom","last_name":"Rini","email":"trini@ti.com"},"mbox":"http://patchwork.ozlabs.org/project/uboot/patch/20260409133303.31875-7-ansuelsmth@gmail.com/mbox/","series":[{"id":499303,"url":"http://patchwork.ozlabs.org/api/1.2/series/499303/?format=json","web_url":"http://patchwork.ozlabs.org/project/uboot/list/?series=499303","date":"2026-04-09T13:32:56","name":"misc: fs_loader: reorg and split to FS and FW loader + FIP loader","version":6,"mbox":"http://patchwork.ozlabs.org/series/499303/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/2221480/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/2221480/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=gmail.com header.i=@gmail.com header.a=rsa-sha256\n header.s=20251104 header.b=V3NUS3Qo;\n\tdkim-atps=neutral","legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=lists.denx.de\n (client-ip=2a01:238:438b:c500:173d:9f52:ddab:ee01; helo=phobos.denx.de;\n envelope-from=u-boot-bounces@lists.denx.de; receiver=patchwork.ozlabs.org)","phobos.denx.de;\n dmarc=pass (p=none dis=none) header.from=gmail.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=gmail.com header.i=@gmail.com header.b=\"V3NUS3Qo\";\n\tdkim-atps=neutral","phobos.denx.de;\n dmarc=pass (p=none dis=none) header.from=gmail.com","phobos.denx.de;\n spf=pass smtp.mailfrom=ansuelsmth@gmail.com"],"Received":["from phobos.denx.de (phobos.denx.de\n [IPv6:2a01:238:438b:c500:173d:9f52:ddab:ee01])\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 4fs1B56vQfz1yCv\n\tfor ; Thu, 09 Apr 2026 23:34:21 +1000 (AEST)","from h2850616.stratoserver.net (localhost [IPv6:::1])\n\tby phobos.denx.de (Postfix) with ESMTP id B2C48841CD;\n\tThu, 9 Apr 2026 15:33:32 +0200 (CEST)","by phobos.denx.de (Postfix, from userid 109)\n id 5D930841F2; Thu, 9 Apr 2026 15:33:31 +0200 (CEST)","from mail-wm1-x32f.google.com (mail-wm1-x32f.google.com\n [IPv6:2a00:1450:4864:20::32f])\n (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits))\n (No client certificate requested)\n by phobos.denx.de (Postfix) with ESMTPS id 6D3B6841B9\n for ; Thu, 9 Apr 2026 15:33:29 +0200 (CEST)","by mail-wm1-x32f.google.com with SMTP id\n 5b1f17b1804b1-48374014a77so12230495e9.3\n for ; Thu, 09 Apr 2026 06:33:29 -0700 (PDT)","from Ansuel-XPS24 (host-82-61-192-155.retail.telecomitalia.it.\n [82.61.192.155]) by smtp.googlemail.com with ESMTPSA id\n 5b1f17b1804b1-488ccf9b919sm52876215e9.0.2026.04.09.06.33.26\n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Thu, 09 Apr 2026 06:33:27 -0700 (PDT)"],"X-Spam-Checker-Version":"SpamAssassin 3.4.2 (2018-09-13) on phobos.denx.de","X-Spam-Level":"","X-Spam-Status":"No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED,\n DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM,\n RCVD_IN_DNSWL_BLOCKED,SPF_HELO_NONE,SPF_PASS autolearn=ham\n autolearn_force=no version=3.4.2","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=gmail.com; s=20251104; t=1775741609; x=1776346409; darn=lists.denx.de;\n h=content-transfer-encoding:mime-version:references:in-reply-to\n :message-id:date:subject:to:from:from:to:cc:subject:date:message-id\n :reply-to; bh=BLr4rz6/NPSRwC+PVD7LgQ5DgBFkgdtUkZlMdTEORZ4=;\n b=V3NUS3QotCTW5f3hKJvC+bMSVkve7eDB95sNRxCBkhJ/cc0bcKxUAZAv77IHfG1Dmz\n MHhjmCgTYzoWwSZhFLx+dbYT2yqjBQZF4c5G0/SBK4GpZaC5EvCu+buIogRNzvMZDa3b\n rkMl3uaLg4YYWRs16mLGvYKegvZ50a4YbVKQa5EhvNMCCfIxfUXzl9hpyPnYHqbNCKHo\n i8+9E3QQLGYUVhhdv+al4JnBwf9uLlWPJFFYRFf7LgPOPKcqGv+KIJtBd/UlZiDpQ2QO\n 9ON8zRafVJKfr+tzC2l96nne1Uz2x23lyg+uDh2z/Lhilo1POHG/Qeb7YKfiw86Z1CmW\n ULtw==","X-Google-DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20251104; t=1775741609; x=1776346409;\n h=content-transfer-encoding:mime-version:references:in-reply-to\n :message-id:date:subject:to:from:x-gm-gg:x-gm-message-state:from:to\n :cc:subject:date:message-id:reply-to;\n bh=BLr4rz6/NPSRwC+PVD7LgQ5DgBFkgdtUkZlMdTEORZ4=;\n b=bo47SQ06SOAZWk5gRN67ItcHQv1AlfVjeCpFIzloc4RSW949CCzIY0sonVbvCdAnin\n qfr4NWRhLZWMm+rgChAWjEA1XJp15HR2PLeI/jEkHX0vh+b6DkTYU3cyAND1yMD1F/O/\n Jp2Fyy4KsCv72ISTXYjA3dVarFrL2KjXxgRjB8GlQw/l1bhKT/8pYFZAFvd7uXnbn1/N\n Rjw9YvfnhbCDJZNM6cJMBkVK1/ZpCy5HfEAenHQjpfOYDZRlsOcNbw8IJ6zLU251FYJA\n EFbilFNvm9fis1B9TK4H0I5VPwSIEQQuYIVqt3L62NB6A/Dnc/ru9mOmAZX0w2pan5Y7\n UjEQ==","X-Forwarded-Encrypted":"i=1;\n AJvYcCW3aNZwXATnAfkYc0CCOlO/o21fd//7QqDebKMTGQlB1D6DXTxjoEwMy/By79KTWcPVacd/Vq4=@lists.denx.de","X-Gm-Message-State":"AOJu0Yym8v4Gq1YjbdFAqG971KrN8Mg7qGEJIoe/IGm+199qg7Er8zs7\n CVhlPb5FYwovjvujree9W/3YACxP8iug0lzwykWrkBze5lJBUZJfK37O","X-Gm-Gg":"AeBDies1dG/U14q3pwL/hfYJ9MTDSerTdp3SmbzwOtQ9JpsdkfCmUAL2QhA/MX/P00t\n MK+Gk6UgoYgB7qSOvEJEf9Nx/RbvaRJhwuqrU1MytJ89F13Iwx+AwXKz3/8/IKoj7ouC9lwngiz\n CwA9vZNK+ZNo5kw9n5xYRPo+1xwDXFQbJ8JGzPM/kyVPI7Urq4bn4WKQzQX0cvCNrPtmMbBIHvJ\n CiFWjneSNHgeh4IAQx5i6Qn0lityOJUeGEDmetEAam56ACz1Mv2ja/Fm3XkOAxCfwSwQX7/M9J7\n nlxZvicSYOY+anL1dFZMuTBoF2izM2omiyAnC605QGckw29cw7IfguksOF7aS5BY3iEK3y3XPre\n HaSqnlIbdlIP3DSedZV/wSdYw7lGZmdxQeCRQllGYT0dWeHjbSJ1163azjbn9aGqYTfvrxk7v5i\n hzpyYpztjg1jE1C9XpISc8IybtKe6P/P/hiUSW9w2pvDCpa/NmltrsNcUU6IVYLguIoeeu0fM=","X-Received":"by 2002:a05:600c:5251:b0:488:c257:a73b with SMTP id\n 5b1f17b1804b1-488c257a952mr119130235e9.9.1775741608413;\n Thu, 09 Apr 2026 06:33:28 -0700 (PDT)","From":"Christian Marangi ","To":"Tom Rini , Simon Glass ,\n Christian Marangi ,\n Casey Connolly ,\n Quentin Schulz , Peng Fan ,\n Kever Yang ,\n Heinrich Schuchardt ,\n Mateus Lima Alves ,\n Jamie Gibbons ,\n Neha Malcom Francis ,\n Justin Klaassen ,\n Leo Yu-Chi Liang ,\n Weijie Gao ,\n Marek Vasut ,\n \"Lucien.Jheng\" , u-boot@lists.denx.de","Subject":"[PATCH v6 6/6] doc: dtbinding: Update documentation for Generic\n Firmware loader","Date":"Thu, 9 Apr 2026 15:33:02 +0200","Message-ID":"<20260409133303.31875-7-ansuelsmth@gmail.com>","X-Mailer":"git-send-email 2.53.0","In-Reply-To":"<20260409133303.31875-1-ansuelsmth@gmail.com>","References":"<20260409133303.31875-1-ansuelsmth@gmail.com>","MIME-Version":"1.0","Content-Transfer-Encoding":"8bit","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":"Update documentation for Generic Firmware loader, generalize it from FS\nspecific and add new property and example for FIP loader.\n\nAlso add details on the usage of 'phandlepart', 'mtdpart' and 'ubivol'\nproperty.\n\nSigned-off-by: Christian Marangi \n---\n .../misc/{fs_loader.txt => fw_loader.txt} | 29 +++++++++++++++++--\n 1 file changed, 26 insertions(+), 3 deletions(-)\n rename doc/device-tree-bindings/misc/{fs_loader.txt => fw_loader.txt} (60%)","diff":"diff --git a/doc/device-tree-bindings/misc/fs_loader.txt b/doc/device-tree-bindings/misc/fw_loader.txt\nsimilarity index 60%\nrename from doc/device-tree-bindings/misc/fs_loader.txt\nrename to doc/device-tree-bindings/misc/fw_loader.txt\nindex 542be4b25a0a..9b00b2c887c0 100644\n--- a/doc/device-tree-bindings/misc/fs_loader.txt\n+++ b/doc/device-tree-bindings/misc/fw_loader.txt\n@@ -1,17 +1,23 @@\n-* File system firmware loader\n+* Generic Firmware loader\n \n Required properties:\n --------------------\n \n-- compatible: should contain \"u-boot,fs-loader\"\n+- compatible: should contain \"u-boot,fs-loader\" or \"u-boot,fip-loader\"\n - phandlepart: which block storage device and partition the image loading from,\n \t this property is required for mmc, usb and sata. This is unsigned\n \t 32-bit array. For example phandlepart=<&mmc_0 1>, meaning use\n \t that MMC0 node pointer, partition 1.\n-- mdtpart: which partition of ubi the image loading from, this property is\n+- mtdpart: which partition of ubi the image loading from, this property is\n \t required for ubi and mounting.\n - ubivol: which volume of ubi the image loading from, this property is required\n \t for ubi and mounting.\n+- partoffset: valid ONLY for \"u-boot,fip-loader\". Offset of the partition to\n+\t parse the FIP partition from.\n+\n+Either 'phandlepart' or 'mtdpart' can be used. For Block device, 'phandlepart'\n+should be used and for MTD device, 'mtdpart' should be used. With UBI device,\n+in addition to 'mtdpart' also 'ubivol' is required.\n \n Example of storage device and partition search set for mmc, usb, sata and\n ubi in device tree source as shown in below:\n@@ -46,3 +52,20 @@ ubi in device tree source as shown in below:\n \t\tmtdpart = \"UBI\",\n \t\tubivol = \"ubi0\";\n \t};\n+\n+\tExample for FIP from eMMC:\n+\tfs_loader4: fip-loader@4 {\n+\t\tbootph-all;\n+\t\tcompatible = \"u-boot,fip-loader\";\n+\t\tphandlepart = <&mmc0 0>;\n+\t\tpartoffset = <0x100>;\n+\t};\n+\n+\tExample for FIP from ubi:\n+\tfs_loader4: fip-loader@4 {\n+\t\tbootph-all;\n+\t\tcompatible = \"u-boot,fip-loader\";\n+\t\tmtdpart = \"ubi\",\n+\t\tubivol = \"bl31\";\n+\t};\n+\n","prefixes":["v6","6/6"]}