1 // SPDX-License-Identifier: GPL-2.0+
3 * Copyright (c) 2017 Google, Inc
4 * Written by Simon Glass <sjg@chromium.org>
10 #include <fdt_support.h>
12 #include <linux/libfdt.h>
13 #include <dm/of_access.h>
14 #include <dm/of_addr.h>
15 #include <dm/ofnode.h>
16 #include <linux/err.h>
17 #include <linux/ioport.h>
19 int ofnode_read_u32(ofnode node, const char *propname, u32 *outp)
21 return ofnode_read_u32_index(node, propname, 0, outp);
24 u32 ofnode_read_u32_default(ofnode node, const char *propname, u32 def)
26 assert(ofnode_valid(node));
27 ofnode_read_u32_index(node, propname, 0, &def);
32 int ofnode_read_u32_index(ofnode node, const char *propname, int index,
38 assert(ofnode_valid(node));
39 debug("%s: %s: ", __func__, propname);
41 if (ofnode_is_np(node))
42 return of_read_u32_index(ofnode_to_np(node), propname, index,
45 cell = fdt_getprop(gd->fdt_blob, ofnode_to_offset(node), propname,
48 debug("(not found)\n");
52 if (len < (sizeof(int) * (index + 1))) {
53 debug("(not large enough)\n");
57 *outp = fdt32_to_cpu(cell[index]);
58 debug("%#x (%d)\n", *outp, *outp);
63 u32 ofnode_read_u32_index_default(ofnode node, const char *propname, int index,
66 assert(ofnode_valid(node));
67 ofnode_read_u32_index(node, propname, index, &def);
72 int ofnode_read_s32_default(ofnode node, const char *propname, s32 def)
74 assert(ofnode_valid(node));
75 ofnode_read_u32(node, propname, (u32 *)&def);
80 int ofnode_read_u64(ofnode node, const char *propname, u64 *outp)
82 const unaligned_fdt64_t *cell;
85 assert(ofnode_valid(node));
86 debug("%s: %s: ", __func__, propname);
88 if (ofnode_is_np(node))
89 return of_read_u64(ofnode_to_np(node), propname, outp);
91 cell = fdt_getprop(gd->fdt_blob, ofnode_to_offset(node), propname,
93 if (!cell || len < sizeof(*cell)) {
94 debug("(not found)\n");
97 *outp = fdt64_to_cpu(cell[0]);
98 debug("%#llx (%lld)\n", (unsigned long long)*outp,
99 (unsigned long long)*outp);
104 u64 ofnode_read_u64_default(ofnode node, const char *propname, u64 def)
106 assert(ofnode_valid(node));
107 ofnode_read_u64(node, propname, &def);
112 bool ofnode_read_bool(ofnode node, const char *propname)
116 assert(ofnode_valid(node));
117 debug("%s: %s: ", __func__, propname);
119 prop = ofnode_get_property(node, propname, NULL);
121 debug("%s\n", prop ? "true" : "false");
123 return prop ? true : false;
126 const void *ofnode_read_prop(ofnode node, const char *propname, int *sizep)
128 const char *val = NULL;
131 assert(ofnode_valid(node));
132 debug("%s: %s: ", __func__, propname);
134 if (ofnode_is_np(node)) {
135 struct property *prop = of_find_property(
136 ofnode_to_np(node), propname, &len);
143 val = fdt_getprop(gd->fdt_blob, ofnode_to_offset(node),
147 debug("<not found>\n");
149 *sizep = -FDT_ERR_NOTFOUND;
158 const char *ofnode_read_string(ofnode node, const char *propname)
163 str = ofnode_read_prop(node, propname, &len);
167 if (strnlen(str, len) >= len) {
168 debug("<invalid>\n");
176 int ofnode_read_size(ofnode node, const char *propname)
180 if (!ofnode_read_prop(node, propname, &len))
186 ofnode ofnode_find_subnode(ofnode node, const char *subnode_name)
190 assert(ofnode_valid(node));
191 debug("%s: %s: ", __func__, subnode_name);
193 if (ofnode_is_np(node)) {
194 const struct device_node *np = ofnode_to_np(node);
196 for (np = np->child; np; np = np->sibling) {
197 if (!strcmp(subnode_name, np->name))
200 subnode = np_to_ofnode(np);
202 int ooffset = fdt_subnode_offset(gd->fdt_blob,
203 ofnode_to_offset(node), subnode_name);
204 subnode = offset_to_ofnode(ooffset);
206 debug("%s\n", ofnode_valid(subnode) ?
207 ofnode_get_name(subnode) : "<none>");
212 int ofnode_read_u32_array(ofnode node, const char *propname,
213 u32 *out_values, size_t sz)
215 assert(ofnode_valid(node));
216 debug("%s: %s: ", __func__, propname);
218 if (ofnode_is_np(node)) {
219 return of_read_u32_array(ofnode_to_np(node), propname,
222 return fdtdec_get_int_array(gd->fdt_blob,
223 ofnode_to_offset(node), propname,
228 ofnode ofnode_first_subnode(ofnode node)
230 assert(ofnode_valid(node));
231 if (ofnode_is_np(node))
232 return np_to_ofnode(node.np->child);
234 return offset_to_ofnode(
235 fdt_first_subnode(gd->fdt_blob, ofnode_to_offset(node)));
238 ofnode ofnode_next_subnode(ofnode node)
240 assert(ofnode_valid(node));
241 if (ofnode_is_np(node))
242 return np_to_ofnode(node.np->sibling);
244 return offset_to_ofnode(
245 fdt_next_subnode(gd->fdt_blob, ofnode_to_offset(node)));
248 ofnode ofnode_get_parent(ofnode node)
252 assert(ofnode_valid(node));
253 if (ofnode_is_np(node))
254 parent = np_to_ofnode(of_get_parent(ofnode_to_np(node)));
256 parent.of_offset = fdt_parent_offset(gd->fdt_blob,
257 ofnode_to_offset(node));
262 const char *ofnode_get_name(ofnode node)
264 if (!ofnode_valid(node)) {
265 debug("%s node not valid\n", __func__);
269 if (ofnode_is_np(node))
270 return strrchr(node.np->full_name, '/') + 1;
272 return fdt_get_name(gd->fdt_blob, ofnode_to_offset(node), NULL);
275 ofnode ofnode_get_by_phandle(uint phandle)
279 if (of_live_active())
280 node = np_to_ofnode(of_find_node_by_phandle(phandle));
282 node.of_offset = fdt_node_offset_by_phandle(gd->fdt_blob,
288 fdt_addr_t ofnode_get_addr_size_index(ofnode node, int index, fdt_size_t *size)
292 if (ofnode_is_np(node)) {
293 const __be32 *prop_val;
297 prop_val = of_get_address(ofnode_to_np(node), index, &size64,
300 return FDT_ADDR_T_NONE;
304 ns = of_n_size_cells(ofnode_to_np(node));
306 if (IS_ENABLED(CONFIG_OF_TRANSLATE) && ns > 0) {
307 return of_translate_address(ofnode_to_np(node), prop_val);
309 na = of_n_addr_cells(ofnode_to_np(node));
310 return of_read_number(prop_val, na);
313 na = ofnode_read_simple_addr_cells(ofnode_get_parent(node));
314 ns = ofnode_read_simple_size_cells(ofnode_get_parent(node));
315 return fdtdec_get_addr_size_fixed(gd->fdt_blob,
316 ofnode_to_offset(node), "reg",
317 index, na, ns, size, true);
320 return FDT_ADDR_T_NONE;
323 fdt_addr_t ofnode_get_addr_index(ofnode node, int index)
327 return ofnode_get_addr_size_index(node, index, &size);
330 fdt_addr_t ofnode_get_addr(ofnode node)
332 return ofnode_get_addr_index(node, 0);
335 int ofnode_stringlist_search(ofnode node, const char *property,
338 if (ofnode_is_np(node)) {
339 return of_property_match_string(ofnode_to_np(node),
344 ret = fdt_stringlist_search(gd->fdt_blob,
345 ofnode_to_offset(node), property,
347 if (ret == -FDT_ERR_NOTFOUND)
356 int ofnode_read_string_index(ofnode node, const char *property, int index,
359 if (ofnode_is_np(node)) {
360 return of_property_read_string_index(ofnode_to_np(node),
361 property, index, outp);
365 *outp = fdt_stringlist_get(gd->fdt_blob, ofnode_to_offset(node),
366 property, index, &len);
373 int ofnode_read_string_count(ofnode node, const char *property)
375 if (ofnode_is_np(node)) {
376 return of_property_count_strings(ofnode_to_np(node), property);
378 return fdt_stringlist_count(gd->fdt_blob,
379 ofnode_to_offset(node), property);
383 static void ofnode_from_fdtdec_phandle_args(struct fdtdec_phandle_args *in,
384 struct ofnode_phandle_args *out)
386 assert(OF_MAX_PHANDLE_ARGS == MAX_PHANDLE_ARGS);
387 out->node = offset_to_ofnode(in->node);
388 out->args_count = in->args_count;
389 memcpy(out->args, in->args, sizeof(out->args));
392 static void ofnode_from_of_phandle_args(struct of_phandle_args *in,
393 struct ofnode_phandle_args *out)
395 assert(OF_MAX_PHANDLE_ARGS == MAX_PHANDLE_ARGS);
396 out->node = np_to_ofnode(in->np);
397 out->args_count = in->args_count;
398 memcpy(out->args, in->args, sizeof(out->args));
401 int ofnode_parse_phandle_with_args(ofnode node, const char *list_name,
402 const char *cells_name, int cell_count,
404 struct ofnode_phandle_args *out_args)
406 if (ofnode_is_np(node)) {
407 struct of_phandle_args args;
410 ret = of_parse_phandle_with_args(ofnode_to_np(node),
411 list_name, cells_name, index,
415 ofnode_from_of_phandle_args(&args, out_args);
417 struct fdtdec_phandle_args args;
420 ret = fdtdec_parse_phandle_with_args(gd->fdt_blob,
421 ofnode_to_offset(node),
422 list_name, cells_name,
423 cell_count, index, &args);
426 ofnode_from_fdtdec_phandle_args(&args, out_args);
432 int ofnode_count_phandle_with_args(ofnode node, const char *list_name,
433 const char *cells_name)
435 if (ofnode_is_np(node))
436 return of_count_phandle_with_args(ofnode_to_np(node),
437 list_name, cells_name);
439 return fdtdec_parse_phandle_with_args(gd->fdt_blob,
440 ofnode_to_offset(node), list_name, cells_name,
444 ofnode ofnode_path(const char *path)
446 if (of_live_active())
447 return np_to_ofnode(of_find_node_by_path(path));
449 return offset_to_ofnode(fdt_path_offset(gd->fdt_blob, path));
452 const void *ofnode_read_chosen_prop(const char *propname, int *sizep)
456 chosen_node = ofnode_path("/chosen");
458 return ofnode_read_prop(chosen_node, propname, sizep);
461 const char *ofnode_read_chosen_string(const char *propname)
463 return ofnode_read_chosen_prop(propname, NULL);
466 ofnode ofnode_get_chosen_node(const char *name)
470 prop = ofnode_read_chosen_prop(name, NULL);
472 return ofnode_null();
474 return ofnode_path(prop);
477 int ofnode_get_child_count(ofnode parent)
482 ofnode_for_each_subnode(child, parent)
488 static int decode_timing_property(ofnode node, const char *name,
489 struct timing_entry *result)
493 length = ofnode_read_size(node, name);
495 debug("%s: could not find property %s\n",
496 ofnode_get_name(node), name);
500 if (length == sizeof(u32)) {
501 result->typ = ofnode_read_u32_default(node, name, 0);
502 result->min = result->typ;
503 result->max = result->typ;
505 ret = ofnode_read_u32_array(node, name, &result->min, 3);
511 int ofnode_decode_display_timing(ofnode parent, int index,
512 struct display_timing *dt)
515 ofnode timings, node;
519 timings = ofnode_find_subnode(parent, "display-timings");
520 if (!ofnode_valid(timings))
524 ofnode_for_each_subnode(node, timings) {
529 if (!ofnode_valid(node))
532 memset(dt, 0, sizeof(*dt));
534 ret |= decode_timing_property(node, "hback-porch", &dt->hback_porch);
535 ret |= decode_timing_property(node, "hfront-porch", &dt->hfront_porch);
536 ret |= decode_timing_property(node, "hactive", &dt->hactive);
537 ret |= decode_timing_property(node, "hsync-len", &dt->hsync_len);
538 ret |= decode_timing_property(node, "vback-porch", &dt->vback_porch);
539 ret |= decode_timing_property(node, "vfront-porch", &dt->vfront_porch);
540 ret |= decode_timing_property(node, "vactive", &dt->vactive);
541 ret |= decode_timing_property(node, "vsync-len", &dt->vsync_len);
542 ret |= decode_timing_property(node, "clock-frequency", &dt->pixelclock);
545 val = ofnode_read_u32_default(node, "vsync-active", -1);
547 dt->flags |= val ? DISPLAY_FLAGS_VSYNC_HIGH :
548 DISPLAY_FLAGS_VSYNC_LOW;
550 val = ofnode_read_u32_default(node, "hsync-active", -1);
552 dt->flags |= val ? DISPLAY_FLAGS_HSYNC_HIGH :
553 DISPLAY_FLAGS_HSYNC_LOW;
555 val = ofnode_read_u32_default(node, "de-active", -1);
557 dt->flags |= val ? DISPLAY_FLAGS_DE_HIGH :
558 DISPLAY_FLAGS_DE_LOW;
560 val = ofnode_read_u32_default(node, "pixelclk-active", -1);
562 dt->flags |= val ? DISPLAY_FLAGS_PIXDATA_POSEDGE :
563 DISPLAY_FLAGS_PIXDATA_NEGEDGE;
566 if (ofnode_read_bool(node, "interlaced"))
567 dt->flags |= DISPLAY_FLAGS_INTERLACED;
568 if (ofnode_read_bool(node, "doublescan"))
569 dt->flags |= DISPLAY_FLAGS_DOUBLESCAN;
570 if (ofnode_read_bool(node, "doubleclk"))
571 dt->flags |= DISPLAY_FLAGS_DOUBLECLK;
576 const void *ofnode_get_property(ofnode node, const char *propname, int *lenp)
578 if (ofnode_is_np(node))
579 return of_get_property(ofnode_to_np(node), propname, lenp);
581 return fdt_getprop(gd->fdt_blob, ofnode_to_offset(node),
585 int ofnode_get_first_property(ofnode node, struct ofprop *prop)
589 if (ofnode_is_np(node)) {
590 prop->prop = of_get_first_property(ofnode_to_np(prop->node));
592 return -FDT_ERR_NOTFOUND;
595 fdt_first_property_offset(gd->fdt_blob,
596 ofnode_to_offset(prop->node));
597 if (prop->offset < 0)
604 int ofnode_get_next_property(struct ofprop *prop)
606 if (ofnode_is_np(prop->node)) {
607 prop->prop = of_get_next_property(ofnode_to_np(prop->node),
610 return -FDT_ERR_NOTFOUND;
612 prop->offset = fdt_next_property_offset(gd->fdt_blob,
614 if (prop->offset < 0)
621 const void *ofnode_get_property_by_prop(const struct ofprop *prop,
622 const char **propname, int *lenp)
624 if (ofnode_is_np(prop->node))
625 return of_get_property_by_prop(ofnode_to_np(prop->node),
626 prop->prop, propname, lenp);
628 return fdt_getprop_by_offset(gd->fdt_blob,
633 bool ofnode_is_available(ofnode node)
635 if (ofnode_is_np(node))
636 return of_device_is_available(ofnode_to_np(node));
638 return fdtdec_get_is_enabled(gd->fdt_blob,
639 ofnode_to_offset(node));
642 fdt_addr_t ofnode_get_addr_size(ofnode node, const char *property,
645 if (ofnode_is_np(node)) {
648 const struct device_node *np = ofnode_to_np(node);
649 const __be32 *prop = of_get_property(np, property, &psize);
652 return FDT_ADDR_T_NONE;
653 na = of_n_addr_cells(np);
654 ns = of_n_size_cells(np);
655 *sizep = of_read_number(prop + na, ns);
657 if (CONFIG_IS_ENABLED(OF_TRANSLATE) && ns > 0)
658 return of_translate_address(np, prop);
660 return of_read_number(prop, na);
662 return fdtdec_get_addr_size(gd->fdt_blob,
663 ofnode_to_offset(node), property,
668 const uint8_t *ofnode_read_u8_array_ptr(ofnode node, const char *propname,
671 if (ofnode_is_np(node)) {
672 const struct device_node *np = ofnode_to_np(node);
674 const __be32 *prop = of_get_property(np, propname, &psize);
676 if (!prop || sz != psize)
678 return (uint8_t *)prop;
681 return fdtdec_locate_byte_array(gd->fdt_blob,
682 ofnode_to_offset(node), propname, sz);
686 int ofnode_read_pci_addr(ofnode node, enum fdt_pci_space type,
687 const char *propname, struct fdt_pci_addr *addr)
693 debug("%s: %s: ", __func__, propname);
696 * If we follow the pci bus bindings strictly, we should check
697 * the value of the node's parent node's #address-cells and
698 * #size-cells. They need to be 3 and 2 accordingly. However,
699 * for simplicity we skip the check here.
701 cell = ofnode_get_property(node, propname, &len);
705 if ((len % FDT_PCI_REG_SIZE) == 0) {
706 int num = len / FDT_PCI_REG_SIZE;
709 for (i = 0; i < num; i++) {
710 debug("pci address #%d: %08lx %08lx %08lx\n", i,
711 (ulong)fdt32_to_cpu(cell[0]),
712 (ulong)fdt32_to_cpu(cell[1]),
713 (ulong)fdt32_to_cpu(cell[2]));
714 if ((fdt32_to_cpu(*cell) & type) == type) {
715 addr->phys_hi = fdt32_to_cpu(cell[0]);
716 addr->phys_mid = fdt32_to_cpu(cell[1]);
717 addr->phys_lo = fdt32_to_cpu(cell[2]);
721 cell += (FDT_PCI_ADDR_CELLS +
736 debug("(not found)\n");
740 int ofnode_read_pci_vendev(ofnode node, u16 *vendor, u16 *device)
742 const char *list, *end;
745 list = ofnode_get_property(node, "compatible", &len);
752 if (len >= strlen("pciVVVV,DDDD")) {
753 char *s = strstr(list, "pci");
756 * check if the string is something like pciVVVV,DDDD.RR
757 * or just pciVVVV,DDDD
759 if (s && s[7] == ',' &&
760 (s[12] == '.' || s[12] == 0)) {
762 *vendor = simple_strtol(s, NULL, 16);
765 *device = simple_strtol(s, NULL, 16);
776 int ofnode_read_addr_cells(ofnode node)
778 if (ofnode_is_np(node))
779 return of_n_addr_cells(ofnode_to_np(node));
780 else /* NOTE: this call should walk up the parent stack */
781 return fdt_address_cells(gd->fdt_blob, ofnode_to_offset(node));
784 int ofnode_read_size_cells(ofnode node)
786 if (ofnode_is_np(node))
787 return of_n_size_cells(ofnode_to_np(node));
788 else /* NOTE: this call should walk up the parent stack */
789 return fdt_size_cells(gd->fdt_blob, ofnode_to_offset(node));
792 int ofnode_read_simple_addr_cells(ofnode node)
794 if (ofnode_is_np(node))
795 return of_simple_addr_cells(ofnode_to_np(node));
797 return fdt_address_cells(gd->fdt_blob, ofnode_to_offset(node));
800 int ofnode_read_simple_size_cells(ofnode node)
802 if (ofnode_is_np(node))
803 return of_simple_size_cells(ofnode_to_np(node));
805 return fdt_size_cells(gd->fdt_blob, ofnode_to_offset(node));
808 bool ofnode_pre_reloc(ofnode node)
810 #if defined(CONFIG_SPL_BUILD) || defined(CONFIG_TPL_BUILD)
811 /* for SPL and TPL the remaining nodes after the fdtgrep 1st pass
812 * had property dm-pre-reloc or u-boot,dm-spl/tpl.
813 * They are removed in final dtb (fdtgrep 2nd pass)
817 if (ofnode_read_bool(node, "u-boot,dm-pre-reloc"))
819 if (ofnode_read_bool(node, "u-boot,dm-pre-proper"))
823 * In regular builds individual spl and tpl handling both
824 * count as handled pre-relocation for later second init.
826 if (ofnode_read_bool(node, "u-boot,dm-spl") ||
827 ofnode_read_bool(node, "u-boot,dm-tpl"))
834 int ofnode_read_resource(ofnode node, uint index, struct resource *res)
836 if (ofnode_is_np(node)) {
837 return of_address_to_resource(ofnode_to_np(node), index, res);
839 struct fdt_resource fres;
842 ret = fdt_get_resource(gd->fdt_blob, ofnode_to_offset(node),
843 "reg", index, &fres);
846 memset(res, '\0', sizeof(*res));
847 res->start = fres.start;
854 int ofnode_read_resource_byname(ofnode node, const char *name,
855 struct resource *res)
859 index = ofnode_stringlist_search(node, "reg-names", name);
863 return ofnode_read_resource(node, index, res);
866 u64 ofnode_translate_address(ofnode node, const fdt32_t *in_addr)
868 if (ofnode_is_np(node))
869 return of_translate_address(ofnode_to_np(node), in_addr);
871 return fdt_translate_address(gd->fdt_blob, ofnode_to_offset(node), in_addr);
874 u64 ofnode_translate_dma_address(ofnode node, const fdt32_t *in_addr)
876 if (ofnode_is_np(node))
877 return of_translate_dma_address(ofnode_to_np(node), in_addr);
879 return fdt_translate_dma_address(gd->fdt_blob, ofnode_to_offset(node), in_addr);
882 int ofnode_device_is_compatible(ofnode node, const char *compat)
884 if (ofnode_is_np(node))
885 return of_device_is_compatible(ofnode_to_np(node), compat,
888 return !fdt_node_check_compatible(gd->fdt_blob,
889 ofnode_to_offset(node),
893 ofnode ofnode_by_compatible(ofnode from, const char *compat)
895 if (of_live_active()) {
896 return np_to_ofnode(of_find_compatible_node(
897 (struct device_node *)ofnode_to_np(from), NULL,
900 return offset_to_ofnode(fdt_node_offset_by_compatible(
901 gd->fdt_blob, ofnode_to_offset(from), compat));
905 ofnode ofnode_by_prop_value(ofnode from, const char *propname,
906 const void *propval, int proplen)
908 if (of_live_active()) {
909 return np_to_ofnode(of_find_node_by_prop_value(
910 (struct device_node *)ofnode_to_np(from), propname,
913 return offset_to_ofnode(fdt_node_offset_by_prop_value(
914 gd->fdt_blob, ofnode_to_offset(from),
915 propname, propval, proplen));
919 int ofnode_write_prop(ofnode node, const char *propname, int len,
922 const struct device_node *np = ofnode_to_np(node);
924 struct property *pp_last = NULL;
925 struct property *new;
927 if (!of_live_active())
933 for (pp = np->properties; pp; pp = pp->next) {
934 if (strcmp(pp->name, propname) == 0) {
935 /* Property exists -> change value */
936 pp->value = (void *)value;
946 /* Property does not exist -> append new property */
947 new = malloc(sizeof(struct property));
951 new->name = strdup(propname);
957 new->value = (void *)value;
966 int ofnode_write_string(ofnode node, const char *propname, const char *value)
968 if (!of_live_active())
971 assert(ofnode_valid(node));
973 debug("%s: %s = %s", __func__, propname, value);
975 return ofnode_write_prop(node, propname, strlen(value) + 1, value);
978 int ofnode_set_enabled(ofnode node, bool value)
980 if (!of_live_active())
983 assert(ofnode_valid(node));
986 return ofnode_write_string(node, "status", "okay");
988 return ofnode_write_string(node, "status", "disabled");