From: Marco Felsch <m.felsch@pengutronix.de>
To: Sascha Hauer <s.hauer@pengutronix.de>,
BAREBOX <barebox@lists.infradead.org>
Cc: Marco Felsch <m.felsch@pengutronix.de>
Subject: [PATCH v6 07/12] of: overlay: add FIT image overlay support
Date: Wed, 20 Aug 2025 11:48:39 +0200 [thread overview]
Message-ID: <20250820-v2024-05-0-topic-fit-overlay-v6-7-9d1b3bab2ee2@pengutronix.de> (raw)
In-Reply-To: <20250820-v2024-05-0-topic-fit-overlay-v6-0-9d1b3bab2ee2@pengutronix.de>
This adds the support to load devicetree overlays from a FIT image.
There are a few options to handle FIT overlays since the FIT overlay
spec is not very strict.
This implements the most configurable case where each overlay does have
its own config node (including the optional signature).
- The "pattern" filter matches the config-node names (the node names
below the configurations node), not the overlay image names (the node
names below the images node).
- The "compatible" filter check doesn't differ from the file based overlay
handling.
Signed-off-by: Marco Felsch <m.felsch@pengutronix.de>
---
Documentation/user/devicetree.rst | 18 +++---
drivers/of/overlay.c | 129 +++++++++++++++++++++++++++++++++++---
2 files changed, 130 insertions(+), 17 deletions(-)
diff --git a/Documentation/user/devicetree.rst b/Documentation/user/devicetree.rst
index 30a15a8865c154f8afe23d641da10d0afa84423b..9702db5c5ad29b212f9ea7823fca4af5e30ab6a8 100644
--- a/Documentation/user/devicetree.rst
+++ b/Documentation/user/devicetree.rst
@@ -109,20 +109,22 @@ Overlays can be applied to the kernel device tree before it is handed over to
the kernel. The behaviour is controlled by different variables:
``global.of.overlay.path``
- Overlays are read from this directory. barebox will try to apply all overlays
- found here if not limited by one of the other variables below. When the path
- given here is an absolute path it is used as is. A relative path is relative
- to ``/`` or relative to the rootfs when using bootloader spec.
+ Overlays are read from this path. The path can either be a directory which
+ contains the overlays or a path to a FIT-image. barebox will try to apply all
+ overlays found if not limited by one of the other variables below. When the
+ path given here is an absolute path it is used as is. A relative path is
+ relative to ``/`` or relative to the rootfs when using bootloader spec.
``global.of.overlay.compatible``
This is a space separated list of compatibles. Only overlays matching one of
these compatibles will be applied. When this list is empty then all overlays
will be applied. Overlays that don't have a compatible are considered being
always compatible.
``global.of.overlay.pattern``
- This is a space separated list of file patterns. An overlay is only applied
- when its filename matches one of the patterns. The patterns can contain
- ``*`` and ``?`` as wildcards. The default is ``*`` which means all files are
- applied.
+ This is a space separated list of file patterns or FIT-image config-node name
+ patterns. An overlay is only applied when its filename or FIT-image
+ config-node name matches one of the patterns. The patterns can contain ``*``
+ and ``?`` as wildcards. The default is ``*`` which means all files or FIT-Image
+ config-nodes are applied.
``global.of.overlay.filter``
This is a space separated list of filters to apply. There are two generic filters:
``pattern`` matches ``global.of.overlay.pattern`` above, ``compatible`` matches
diff --git a/drivers/of/overlay.c b/drivers/of/overlay.c
index f02a12d44f0d53db3fb7bb065461c0ef193d0ab3..b15a0f1fab8f729a1ba48da8d5bd5041cd519acc 100644
--- a/drivers/of/overlay.c
+++ b/drivers/of/overlay.c
@@ -8,10 +8,12 @@
*/
#define pr_fmt(fmt) "of_overlay: " fmt
+#include <bootm.h>
#include <common.h>
#include <of.h>
#include <errno.h>
#include <globalvar.h>
+#include <image-fit.h>
#include <magicvar.h>
#include <string.h>
#include <libfile.h>
@@ -463,8 +465,104 @@ static int of_overlay_apply_dir(struct device_node *root, const char *dirname,
return ret;
}
+static int of_overlay_apply_fit(struct device_node *root, struct fit_handle *fit,
+ struct device_node *config)
+{
+ const char *name = config->name;
+ struct device_node *overlay;
+ unsigned long ovl_sz;
+ const void *ovl;
+ int ret;
+
+ pr_debug("Process FIT config \"%s\"\n", name);
+
+ if (!of_overlay_matches_filter(name, NULL))
+ return 0;
+
+ ret = fit_open_image(fit, config, "fdt", &ovl, &ovl_sz);
+ if (ret)
+ return ret;
+
+ overlay = of_unflatten_dtb(ovl, ovl_sz);
+ if (IS_ERR(overlay))
+ return PTR_ERR(overlay);
+
+ if (!of_overlay_matches_filter(NULL, overlay)) {
+ ret = 0;
+ goto out;
+ }
+
+ ret = of_overlay_apply_tree(root, overlay);
+ if (ret == -ENODEV)
+ pr_debug("Not applied %s (not compatible)\n", name);
+ else if (ret)
+ pr_err("Cannot apply %s: %s\n", name, strerror(-ret));
+ else
+ pr_info("Applied %s\n", name);
+
+out:
+ of_delete_node(overlay);
+
+ return ret;
+}
+
+static bool of_overlay_valid_config(struct fit_handle *fit,
+ struct device_node *config)
+{
+ /*
+ * Either kernel or firmware is marked as mandatory by U-Boot
+ * (doc/usage/fit/source_file_format.rst) except for overlays
+ * (doc/usage/fit/overlay-fdt-boot.rst). Therefore we need to ensure
+ * that only "fdt" config nodes are recognized as overlay config node.
+ */
+ if (!fit_has_image(fit, config, "fdt") ||
+ fit_has_image(fit, config, "kernel") ||
+ fit_has_image(fit, config, "firmware"))
+ return false;
+
+ return true;
+}
+
+static int of_overlay_global_fixup_fit(struct device_node *root,
+ const char *fit_path, loff_t fit_size)
+{
+ enum bootm_verify verify = bootm_get_verify_mode();
+ struct device_node *conf_node;
+ struct fit_handle *fit;
+ int ret;
+
+ if (!IS_ENABLED(CONFIG_FITIMAGE)) {
+ pr_err("FIT based overlay handling requested while CONFIG_FITIMAGE=n\n");
+ return -EINVAL;
+ }
+
+ fit = fit_open(fit_path, 0, verify, fit_size);
+ if (IS_ERR(fit)) {
+ pr_err("Loading FIT image %s failed with: %pe\n", fit_path, fit);
+ return PTR_ERR(fit);
+ }
+
+ for_each_child_of_node(fit->configurations, conf_node) {
+ if (!of_overlay_valid_config(fit, conf_node))
+ continue;
+
+ ret = fit_config_verify_signature(fit, conf_node);
+ if (ret)
+ goto out;
+
+ ret = of_overlay_apply_fit(root, fit, conf_node);
+ if (ret)
+ goto out;
+ }
+
+out:
+ fit_close(fit);
+ return ret;
+}
+
static int of_overlay_global_fixup(struct device_node *root, void *data)
{
+ struct stat s;
char *dir;
int ret;
@@ -476,10 +574,23 @@ static int of_overlay_global_fixup(struct device_node *root, void *data)
else
dir = concat_path_file(of_overlay_basedir, of_overlay_path);
- ret = of_overlay_apply_dir(root, dir, true);
- free(dir);
+ if (stat(dir, &s)) {
+ pr_err("Cannot stat global.of.overlay.path (%s): %m\n", dir);
+ ret = -errno;
+ goto out;
+ }
+ if (S_ISDIR(s.st_mode)) {
+ ret = of_overlay_apply_dir(root, dir, true);
+ goto out;
+ }
+
+ /* Assume a FIT image if of_overlay_path points to a file */
+ ret = of_overlay_global_fixup_fit(root, dir, s.st_size);
+
+out:
+ free(dir);
return ret;
}
@@ -505,13 +616,13 @@ int of_overlay_register_filter(struct of_overlay_filter *filter)
/**
* of_overlay_filter_pattern - A filter that matches on the filename or
- * an overlay
+ * FIT config-node name of an overlay
* @f: The filter
- * @pattern: The filename of the overlay
+ * @pattern: The filename or FIT config-node name of the overlay
*
- * This filter matches when the filename matches one of the patterns given
- * in global.of.overlay.filepattern. global.of.overlay.filepattern shall
- * contain a space separated list of wildcard patterns.
+ * This filter matches when the filename or FIT config-node name matches one of
+ * the patterns given in global.of.overlay.pattern. global.of.overlay.pattern
+ * shall contain a space separated list of wildcard patterns.
*
* @return: True when the overlay shall be applied, false otherwise.
*/
@@ -632,6 +743,6 @@ static int of_overlay_init(void)
device_initcall(of_overlay_init);
BAREBOX_MAGICVAR(global.of.overlay.compatible, "space separated list of compatibles an overlay must match");
-BAREBOX_MAGICVAR(global.of.overlay.pattern, "space separated list of filepatterns an overlay must match");
-BAREBOX_MAGICVAR(global.of.overlay.path, "Path to look for dt overlays");
+BAREBOX_MAGICVAR(global.of.overlay.pattern, "space separated list of filename or fit config-node name patterns an overlay must match");
+BAREBOX_MAGICVAR(global.of.overlay.path, "Path to look for dt overlays or a path to a FIT image");
BAREBOX_MAGICVAR(global.of.overlay.filter, "space separated list of filters");
--
2.39.5
next prev parent reply other threads:[~2025-08-20 10:30 UTC|newest]
Thread overview: 19+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-08-20 9:48 [PATCH v6 00/12] Add " Marco Felsch
2025-08-20 9:48 ` [PATCH v6 01/12] FIT: fix missing free in fit_open error path Marco Felsch
2025-08-20 9:48 ` [PATCH v6 02/12] FIT: fit_open_configuration: add match function support Marco Felsch
2025-08-20 9:48 ` [PATCH v6 03/12] of: overlay: make the pattern match function more generic Marco Felsch
2025-08-20 9:48 ` [PATCH v6 04/12] of: overlay: make search dir " Marco Felsch
2025-08-20 9:48 ` [PATCH v6 05/12] of: overlay: refactor of_overlay_global_fixup Marco Felsch
2025-08-20 9:48 ` [PATCH v6 06/12] FIT: make fit_config_verify_signature public Marco Felsch
2025-08-20 9:48 ` Marco Felsch [this message]
2025-08-20 9:48 ` [PATCH v6 08/12] of: overlay: replace filename with an more unique name Marco Felsch
2025-08-20 9:48 ` [PATCH v6 09/12] of: overlay: add more debugging prints to of_overlay_matches_filter Marco Felsch
2025-08-20 9:48 ` [PATCH v6 10/12] FIT: fit_open: canonicalize provided filename Marco Felsch
2025-08-20 9:48 ` [PATCH v6 11/12] FIT: fit_open: save the filename Marco Felsch
2025-08-20 9:48 ` [PATCH v6 12/12] FIT: add support to cache opened fit images Marco Felsch
2025-08-20 11:59 ` Ahmad Fatoum
2025-08-20 14:51 ` Marco Felsch
2025-08-20 20:41 ` Marco Felsch
2025-08-20 12:00 ` Sascha Hauer
2025-08-20 14:47 ` Marco Felsch
2025-08-20 11:54 ` [PATCH v6 00/12] Add FIT image overlay support Sascha Hauer
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20250820-v2024-05-0-topic-fit-overlay-v6-7-9d1b3bab2ee2@pengutronix.de \
--to=m.felsch@pengutronix.de \
--cc=barebox@lists.infradead.org \
--cc=s.hauer@pengutronix.de \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox