summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--include/sbi_utils/fdt/fdt_driver.h59
-rw-r--r--lib/utils/fdt/fdt_driver.c80
-rw-r--r--lib/utils/fdt/objects.mk1
3 files changed, 140 insertions, 0 deletions
diff --git a/include/sbi_utils/fdt/fdt_driver.h b/include/sbi_utils/fdt/fdt_driver.h
new file mode 100644
index 0000000..f6fd26f
--- /dev/null
+++ b/include/sbi_utils/fdt/fdt_driver.h
@@ -0,0 +1,59 @@
+/*
+ * SPDX-License-Identifier: BSD-2-Clause
+ *
+ * fdt_driver.h - Generic support for initializing drivers from DT nodes.
+ *
+ * Copyright (c) 2024 SiFive
+ */
+
+#ifndef __FDT_DRIVER_H__
+#define __FDT_DRIVER_H__
+
+#include <sbi_utils/fdt/fdt_helper.h>
+
+struct fdt_driver {
+ const struct fdt_match *match_table;
+ int (*init)(const void *fdt, int nodeoff,
+ const struct fdt_match *match);
+};
+
+/**
+ * Initialize a driver instance for a specific DT node
+ *
+ * @param fdt devicetree blob
+ * @param nodeoff offset of a node in the devicetree blob
+ * @param drivers NULL-terminated array of drivers to match against this node
+ *
+ * @return 0 if a driver was matched and successfully initialized or a negative
+ * error code on failure
+ */
+int fdt_driver_init_by_offset(const void *fdt, int nodeoff,
+ const struct fdt_driver *const *drivers);
+
+/**
+ * Initialize a driver instance for each DT node that matches any of the
+ * provided drivers
+ *
+ * @param fdt devicetree blob
+ * @param drivers NULL-terminated array of drivers to match against each node
+ *
+ * @return 0 if drivers for all matches (if any) were successfully initialized
+ * or a negative error code on failure
+ */
+int fdt_driver_init_all(const void *fdt,
+ const struct fdt_driver *const *drivers);
+
+/**
+ * Initialize a driver instance for the first DT node that matches any of the
+ * provided drivers
+ *
+ * @param fdt devicetree blob
+ * @param drivers NULL-terminated array of drivers to match against each node
+ *
+ * @return 0 if a driver was matched and successfully initialized or a negative
+ * error code on failure
+ */
+int fdt_driver_init_one(const void *fdt,
+ const struct fdt_driver *const *drivers);
+
+#endif /* __FDT_DRIVER_H__ */
diff --git a/lib/utils/fdt/fdt_driver.c b/lib/utils/fdt/fdt_driver.c
new file mode 100644
index 0000000..586ea8a
--- /dev/null
+++ b/lib/utils/fdt/fdt_driver.c
@@ -0,0 +1,80 @@
+/*
+ * SPDX-License-Identifier: BSD-2-Clause
+ *
+ * Copyright (c) 2024 SiFive
+ */
+
+#include <libfdt.h>
+#include <sbi/sbi_console.h>
+#include <sbi/sbi_error.h>
+#include <sbi_utils/fdt/fdt_driver.h>
+#include <sbi_utils/fdt/fdt_helper.h>
+
+int fdt_driver_init_by_offset(const void *fdt, int nodeoff,
+ const struct fdt_driver *const *drivers)
+{
+ const struct fdt_driver *driver;
+ const struct fdt_match *match;
+ const void *prop;
+ int len, rc;
+
+ if (!fdt_node_is_enabled(fdt, nodeoff))
+ return SBI_ENODEV;
+
+ prop = fdt_getprop(fdt, nodeoff, "compatible", &len);
+ if (!prop)
+ return SBI_ENODEV;
+
+ while ((driver = *drivers++)) {
+ for (match = driver->match_table; match->compatible; match++) {
+ if (!fdt_stringlist_contains(prop, len, match->compatible))
+ continue;
+
+ rc = driver->init(fdt, nodeoff, match);
+ if (rc < 0) {
+ const char *name;
+
+ name = fdt_get_name(fdt, nodeoff, NULL);
+ sbi_printf("%s: %s (%s) init failed: %d\n",
+ __func__, name, match->compatible, rc);
+ }
+
+ return rc;
+ }
+ }
+
+ return SBI_ENODEV;
+}
+
+static int fdt_driver_init_scan(const void *fdt,
+ const struct fdt_driver *const *drivers,
+ bool one)
+{
+ int nodeoff, rc;
+
+ for (nodeoff = fdt_next_node(fdt, -1, NULL);
+ nodeoff >= 0;
+ nodeoff = fdt_next_node(fdt, nodeoff, NULL)) {
+ rc = fdt_driver_init_by_offset(fdt, nodeoff, drivers);
+ if (rc == SBI_ENODEV)
+ continue;
+ if (rc < 0)
+ return rc;
+ if (one)
+ return 0;
+ }
+
+ return one ? SBI_ENODEV : 0;
+}
+
+int fdt_driver_init_all(const void *fdt,
+ const struct fdt_driver *const *drivers)
+{
+ return fdt_driver_init_scan(fdt, drivers, false);
+}
+
+int fdt_driver_init_one(const void *fdt,
+ const struct fdt_driver *const *drivers)
+{
+ return fdt_driver_init_scan(fdt, drivers, true);
+}
diff --git a/lib/utils/fdt/objects.mk b/lib/utils/fdt/objects.mk
index 5cede81..1a2298b 100644
--- a/lib/utils/fdt/objects.mk
+++ b/lib/utils/fdt/objects.mk
@@ -7,4 +7,5 @@
libsbiutils-objs-$(CONFIG_FDT_DOMAIN) += fdt/fdt_domain.o
libsbiutils-objs-$(CONFIG_FDT_PMU) += fdt/fdt_pmu.o
libsbiutils-objs-$(CONFIG_FDT) += fdt/fdt_helper.o
+libsbiutils-objs-$(CONFIG_FDT) += fdt/fdt_driver.o
libsbiutils-objs-$(CONFIG_FDT) += fdt/fdt_fixup.o