1 // SPDX-License-Identifier: GPL-2.0+
3 * Copyright (c) 2011 The Chromium OS Authors.
13 #include <dm/of_extra.h>
17 #include <fdt_support.h>
20 #include <linux/libfdt.h>
22 #include <asm/sections.h>
23 #include <linux/ctype.h>
24 #include <linux/lzo.h>
26 DECLARE_GLOBAL_DATA_PTR;
29 * Here are the type we know about. One day we might allow drivers to
30 * register. For now we just put them here. The COMPAT macro allows us to
31 * turn this into a sparse list later, and keeps the ID with the name.
33 * NOTE: This list is basically a TODO list for things that need to be
34 * converted to driver model. So don't add new things here unless there is a
35 * good reason why driver-model conversion is infeasible. Examples include
36 * things which are used before driver model is available.
38 #define COMPAT(id, name) name
39 static const char * const compat_names[COMPAT_COUNT] = {
40 COMPAT(UNKNOWN, "<none>"),
41 COMPAT(NVIDIA_TEGRA20_EMC, "nvidia,tegra20-emc"),
42 COMPAT(NVIDIA_TEGRA20_EMC_TABLE, "nvidia,tegra20-emc-table"),
43 COMPAT(NVIDIA_TEGRA20_NAND, "nvidia,tegra20-nand"),
44 COMPAT(NVIDIA_TEGRA124_XUSB_PADCTL, "nvidia,tegra124-xusb-padctl"),
45 COMPAT(NVIDIA_TEGRA210_XUSB_PADCTL, "nvidia,tegra210-xusb-padctl"),
46 COMPAT(SMSC_LAN9215, "smsc,lan9215"),
47 COMPAT(SAMSUNG_EXYNOS5_SROMC, "samsung,exynos-sromc"),
48 COMPAT(SAMSUNG_EXYNOS_USB_PHY, "samsung,exynos-usb-phy"),
49 COMPAT(SAMSUNG_EXYNOS5_USB3_PHY, "samsung,exynos5250-usb3-phy"),
50 COMPAT(SAMSUNG_EXYNOS_TMU, "samsung,exynos-tmu"),
51 COMPAT(SAMSUNG_EXYNOS_MIPI_DSI, "samsung,exynos-mipi-dsi"),
52 COMPAT(SAMSUNG_EXYNOS_DWMMC, "samsung,exynos-dwmmc"),
53 COMPAT(GENERIC_SPI_FLASH, "jedec,spi-nor"),
54 COMPAT(SAMSUNG_EXYNOS_SYSMMU, "samsung,sysmmu-v3.3"),
55 COMPAT(INTEL_MICROCODE, "intel,microcode"),
56 COMPAT(INTEL_QRK_MRC, "intel,quark-mrc"),
57 COMPAT(ALTERA_SOCFPGA_DWMAC, "altr,socfpga-stmmac"),
58 COMPAT(ALTERA_SOCFPGA_DWMMC, "altr,socfpga-dw-mshc"),
59 COMPAT(ALTERA_SOCFPGA_DWC2USB, "snps,dwc2"),
60 COMPAT(INTEL_BAYTRAIL_FSP, "intel,baytrail-fsp"),
61 COMPAT(INTEL_BAYTRAIL_FSP_MDP, "intel,baytrail-fsp-mdp"),
62 COMPAT(INTEL_IVYBRIDGE_FSP, "intel,ivybridge-fsp"),
63 COMPAT(COMPAT_SUNXI_NAND, "allwinner,sun4i-a10-nand"),
64 COMPAT(ALTERA_SOCFPGA_CLK, "altr,clk-mgr"),
65 COMPAT(ALTERA_SOCFPGA_PINCTRL_SINGLE, "pinctrl-single"),
66 COMPAT(ALTERA_SOCFPGA_H2F_BRG, "altr,socfpga-hps2fpga-bridge"),
67 COMPAT(ALTERA_SOCFPGA_LWH2F_BRG, "altr,socfpga-lwhps2fpga-bridge"),
68 COMPAT(ALTERA_SOCFPGA_F2H_BRG, "altr,socfpga-fpga2hps-bridge"),
69 COMPAT(ALTERA_SOCFPGA_F2SDR0, "altr,socfpga-fpga2sdram0-bridge"),
70 COMPAT(ALTERA_SOCFPGA_F2SDR1, "altr,socfpga-fpga2sdram1-bridge"),
71 COMPAT(ALTERA_SOCFPGA_F2SDR2, "altr,socfpga-fpga2sdram2-bridge"),
72 COMPAT(ALTERA_SOCFPGA_FPGA0, "altr,socfpga-a10-fpga-mgr"),
73 COMPAT(ALTERA_SOCFPGA_NOC, "altr,socfpga-a10-noc"),
74 COMPAT(ALTERA_SOCFPGA_CLK_INIT, "altr,socfpga-a10-clk-init")
77 const char *fdtdec_get_compatible(enum fdt_compat_id id)
79 /* We allow reading of the 'unknown' ID for testing purposes */
80 assert(id >= 0 && id < COMPAT_COUNT);
81 return compat_names[id];
84 fdt_addr_t fdtdec_get_addr_size_fixed(const void *blob, int node,
85 const char *prop_name, int index, int na,
86 int ns, fdt_size_t *sizep,
89 const fdt32_t *prop, *prop_end;
90 const fdt32_t *prop_addr, *prop_size, *prop_after_size;
94 debug("%s: %s: ", __func__, prop_name);
96 prop = fdt_getprop(blob, node, prop_name, &len);
98 debug("(not found)\n");
99 return FDT_ADDR_T_NONE;
101 prop_end = prop + (len / sizeof(*prop));
103 prop_addr = prop + (index * (na + ns));
104 prop_size = prop_addr + na;
105 prop_after_size = prop_size + ns;
106 if (prop_after_size > prop_end) {
107 debug("(not enough data: expected >= %d cells, got %d cells)\n",
108 (u32)(prop_after_size - prop), ((u32)(prop_end - prop)));
109 return FDT_ADDR_T_NONE;
112 #if CONFIG_IS_ENABLED(OF_TRANSLATE)
114 addr = fdt_translate_address(blob, node, prop_addr);
117 addr = fdtdec_get_number(prop_addr, na);
120 *sizep = fdtdec_get_number(prop_size, ns);
121 debug("addr=%08llx, size=%llx\n", (unsigned long long)addr,
122 (unsigned long long)*sizep);
124 debug("addr=%08llx\n", (unsigned long long)addr);
130 fdt_addr_t fdtdec_get_addr_size_auto_parent(const void *blob, int parent,
131 int node, const char *prop_name,
132 int index, fdt_size_t *sizep,
137 debug("%s: ", __func__);
139 na = fdt_address_cells(blob, parent);
141 debug("(bad #address-cells)\n");
142 return FDT_ADDR_T_NONE;
145 ns = fdt_size_cells(blob, parent);
147 debug("(bad #size-cells)\n");
148 return FDT_ADDR_T_NONE;
151 debug("na=%d, ns=%d, ", na, ns);
153 return fdtdec_get_addr_size_fixed(blob, node, prop_name, index, na,
154 ns, sizep, translate);
157 fdt_addr_t fdtdec_get_addr_size_auto_noparent(const void *blob, int node,
158 const char *prop_name, int index,
164 debug("%s: ", __func__);
166 parent = fdt_parent_offset(blob, node);
168 debug("(no parent found)\n");
169 return FDT_ADDR_T_NONE;
172 return fdtdec_get_addr_size_auto_parent(blob, parent, node, prop_name,
173 index, sizep, translate);
176 fdt_addr_t fdtdec_get_addr_size(const void *blob, int node,
177 const char *prop_name, fdt_size_t *sizep)
179 int ns = sizep ? (sizeof(fdt_size_t) / sizeof(fdt32_t)) : 0;
181 return fdtdec_get_addr_size_fixed(blob, node, prop_name, 0,
182 sizeof(fdt_addr_t) / sizeof(fdt32_t),
186 fdt_addr_t fdtdec_get_addr(const void *blob, int node, const char *prop_name)
188 return fdtdec_get_addr_size(blob, node, prop_name, NULL);
191 #if CONFIG_IS_ENABLED(PCI) && defined(CONFIG_DM_PCI)
192 int fdtdec_get_pci_vendev(const void *blob, int node, u16 *vendor, u16 *device)
194 const char *list, *end;
197 list = fdt_getprop(blob, node, "compatible", &len);
204 if (len >= strlen("pciVVVV,DDDD")) {
205 char *s = strstr(list, "pci");
208 * check if the string is something like pciVVVV,DDDD.RR
209 * or just pciVVVV,DDDD
211 if (s && s[7] == ',' &&
212 (s[12] == '.' || s[12] == 0)) {
214 *vendor = simple_strtol(s, NULL, 16);
217 *device = simple_strtol(s, NULL, 16);
228 int fdtdec_get_pci_bar32(const struct udevice *dev, struct fdt_pci_addr *addr,
233 /* extract the bar number from fdt_pci_addr */
234 barnum = addr->phys_hi & 0xff;
235 if (barnum < PCI_BASE_ADDRESS_0 || barnum > PCI_CARDBUS_CIS)
238 barnum = (barnum - PCI_BASE_ADDRESS_0) / 4;
239 *bar = dm_pci_read_bar32(dev, barnum);
245 uint64_t fdtdec_get_uint64(const void *blob, int node, const char *prop_name,
246 uint64_t default_val)
248 const unaligned_fdt64_t *cell64;
251 cell64 = fdt_getprop(blob, node, prop_name, &length);
252 if (!cell64 || length < sizeof(*cell64))
255 return fdt64_to_cpu(*cell64);
258 int fdtdec_get_is_enabled(const void *blob, int node)
263 * It should say "okay", so only allow that. Some fdts use "ok" but
264 * this is a bug. Please fix your device tree source file. See here
267 * http://www.mail-archive.com/u-boot@lists.denx.de/msg71598.html
269 cell = fdt_getprop(blob, node, "status", NULL);
271 return strcmp(cell, "okay") == 0;
275 enum fdt_compat_id fdtdec_lookup(const void *blob, int node)
277 enum fdt_compat_id id;
279 /* Search our drivers */
280 for (id = COMPAT_UNKNOWN; id < COMPAT_COUNT; id++)
281 if (fdt_node_check_compatible(blob, node,
282 compat_names[id]) == 0)
284 return COMPAT_UNKNOWN;
287 int fdtdec_next_compatible(const void *blob, int node, enum fdt_compat_id id)
289 return fdt_node_offset_by_compatible(blob, node, compat_names[id]);
292 int fdtdec_next_compatible_subnode(const void *blob, int node,
293 enum fdt_compat_id id, int *depthp)
296 node = fdt_next_node(blob, node, depthp);
297 } while (*depthp > 1);
299 /* If this is a direct subnode, and compatible, return it */
300 if (*depthp == 1 && 0 == fdt_node_check_compatible(
301 blob, node, compat_names[id]))
304 return -FDT_ERR_NOTFOUND;
307 int fdtdec_next_alias(const void *blob, const char *name, enum fdt_compat_id id,
310 #define MAX_STR_LEN 20
311 char str[MAX_STR_LEN + 20];
314 /* snprintf() is not available */
315 assert(strlen(name) < MAX_STR_LEN);
316 sprintf(str, "%.*s%d", MAX_STR_LEN, name, *upto);
317 node = fdt_path_offset(blob, str);
320 err = fdt_node_check_compatible(blob, node, compat_names[id]);
324 return -FDT_ERR_NOTFOUND;
329 int fdtdec_find_aliases_for_id(const void *blob, const char *name,
330 enum fdt_compat_id id, int *node_list,
333 memset(node_list, '\0', sizeof(*node_list) * maxcount);
335 return fdtdec_add_aliases_for_id(blob, name, id, node_list, maxcount);
338 /* TODO: Can we tighten this code up a little? */
339 int fdtdec_add_aliases_for_id(const void *blob, const char *name,
340 enum fdt_compat_id id, int *node_list,
343 int name_len = strlen(name);
351 /* find the alias node if present */
352 alias_node = fdt_path_offset(blob, "/aliases");
355 * start with nothing, and we can assume that the root node can't
358 memset(nodes, '\0', sizeof(nodes));
360 /* First find all the compatible nodes */
361 for (node = count = 0; node >= 0 && count < maxcount;) {
362 node = fdtdec_next_compatible(blob, node, id);
364 nodes[count++] = node;
367 debug("%s: warning: maxcount exceeded with alias '%s'\n",
370 /* Now find all the aliases */
371 for (offset = fdt_first_property_offset(blob, alias_node);
373 offset = fdt_next_property_offset(blob, offset)) {
374 const struct fdt_property *prop;
380 prop = fdt_get_property_by_offset(blob, offset, NULL);
381 path = fdt_string(blob, fdt32_to_cpu(prop->nameoff));
382 if (prop->len && 0 == strncmp(path, name, name_len))
383 node = fdt_path_offset(blob, prop->data);
387 /* Get the alias number */
388 number = simple_strtoul(path + name_len, NULL, 10);
389 if (number < 0 || number >= maxcount) {
390 debug("%s: warning: alias '%s' is out of range\n",
395 /* Make sure the node we found is actually in our list! */
397 for (j = 0; j < count; j++)
398 if (nodes[j] == node) {
404 debug("%s: warning: alias '%s' points to a node "
405 "'%s' that is missing or is not compatible "
406 " with '%s'\n", __func__, path,
407 fdt_get_name(blob, node, NULL),
413 * Add this node to our list in the right place, and mark
416 if (fdtdec_get_is_enabled(blob, node)) {
417 if (node_list[number]) {
418 debug("%s: warning: alias '%s' requires that "
419 "a node be placed in the list in a "
420 "position which is already filled by "
421 "node '%s'\n", __func__, path,
422 fdt_get_name(blob, node, NULL));
425 node_list[number] = node;
426 if (number >= num_found)
427 num_found = number + 1;
432 /* Add any nodes not mentioned by an alias */
433 for (i = j = 0; i < maxcount; i++) {
435 for (; j < maxcount; j++)
437 fdtdec_get_is_enabled(blob, nodes[j]))
440 /* Have we run out of nodes to add? */
444 assert(!node_list[i]);
445 node_list[i] = nodes[j++];
454 int fdtdec_get_alias_seq(const void *blob, const char *base, int offset,
457 int base_len = strlen(base);
458 const char *find_name;
463 find_name = fdt_get_name(blob, offset, &find_namelen);
464 debug("Looking for '%s' at %d, name %s\n", base, offset, find_name);
466 aliases = fdt_path_offset(blob, "/aliases");
467 for (prop_offset = fdt_first_property_offset(blob, aliases);
469 prop_offset = fdt_next_property_offset(blob, prop_offset)) {
475 prop = fdt_getprop_by_offset(blob, prop_offset, &name, &len);
476 debug(" - %s, %s\n", name, prop);
477 if (len < find_namelen || *prop != '/' || prop[len - 1] ||
478 strncmp(name, base, base_len))
481 slash = strrchr(prop, '/');
482 if (strcmp(slash + 1, find_name))
484 val = trailing_strtol(name);
487 debug("Found seq %d\n", *seqp);
492 debug("Not found\n");
496 int fdtdec_get_alias_highest_id(const void *blob, const char *base)
498 int base_len = strlen(base);
503 debug("Looking for highest alias id for '%s'\n", base);
505 aliases = fdt_path_offset(blob, "/aliases");
506 for (prop_offset = fdt_first_property_offset(blob, aliases);
508 prop_offset = fdt_next_property_offset(blob, prop_offset)) {
513 prop = fdt_getprop_by_offset(blob, prop_offset, &name, &len);
514 debug(" - %s, %s\n", name, prop);
515 if (*prop != '/' || prop[len - 1] ||
516 strncmp(name, base, base_len))
519 val = trailing_strtol(name);
521 debug("Found seq %d\n", val);
529 const char *fdtdec_get_chosen_prop(const void *blob, const char *name)
535 chosen_node = fdt_path_offset(blob, "/chosen");
536 return fdt_getprop(blob, chosen_node, name, NULL);
539 int fdtdec_get_chosen_node(const void *blob, const char *name)
543 prop = fdtdec_get_chosen_prop(blob, name);
545 return -FDT_ERR_NOTFOUND;
546 return fdt_path_offset(blob, prop);
549 int fdtdec_check_fdt(void)
552 * We must have an FDT, but we cannot panic() yet since the console
553 * is not ready. So for now, just assert(). Boards which need an early
554 * FDT (prior to console ready) will need to make their own
555 * arrangements and do their own checks.
557 assert(!fdtdec_prepare_fdt());
562 * This function is a little odd in that it accesses global data. At some
563 * point if the architecture board.c files merge this will make more sense.
564 * Even now, it is common code.
566 int fdtdec_prepare_fdt(void)
568 if (!gd->fdt_blob || ((uintptr_t)gd->fdt_blob & 3) ||
569 fdt_check_header(gd->fdt_blob)) {
570 #ifdef CONFIG_SPL_BUILD
571 puts("Missing DTB\n");
573 puts("No valid device tree binary found - please append one to U-Boot binary, use u-boot-dtb.bin or define CONFIG_OF_EMBED. For sandbox, use -d <file.dtb>\n");
576 printf("fdt_blob=%p\n", gd->fdt_blob);
577 print_buffer((ulong)gd->fdt_blob, gd->fdt_blob, 4,
587 int fdtdec_lookup_phandle(const void *blob, int node, const char *prop_name)
592 debug("%s: %s\n", __func__, prop_name);
593 phandle = fdt_getprop(blob, node, prop_name, NULL);
595 return -FDT_ERR_NOTFOUND;
597 lookup = fdt_node_offset_by_phandle(blob, fdt32_to_cpu(*phandle));
602 * Look up a property in a node and check that it has a minimum length.
604 * @param blob FDT blob
605 * @param node node to examine
606 * @param prop_name name of property to find
607 * @param min_len minimum property length in bytes
608 * @param err 0 if ok, or -FDT_ERR_NOTFOUND if the property is not
609 found, or -FDT_ERR_BADLAYOUT if not enough data
610 * @return pointer to cell, which is only valid if err == 0
612 static const void *get_prop_check_min_len(const void *blob, int node,
613 const char *prop_name, int min_len,
619 debug("%s: %s\n", __func__, prop_name);
620 cell = fdt_getprop(blob, node, prop_name, &len);
622 *err = -FDT_ERR_NOTFOUND;
623 else if (len < min_len)
624 *err = -FDT_ERR_BADLAYOUT;
630 int fdtdec_get_int_array(const void *blob, int node, const char *prop_name,
631 u32 *array, int count)
636 debug("%s: %s\n", __func__, prop_name);
637 cell = get_prop_check_min_len(blob, node, prop_name,
638 sizeof(u32) * count, &err);
642 for (i = 0; i < count; i++)
643 array[i] = fdt32_to_cpu(cell[i]);
648 int fdtdec_get_int_array_count(const void *blob, int node,
649 const char *prop_name, u32 *array, int count)
655 debug("%s: %s\n", __func__, prop_name);
656 cell = fdt_getprop(blob, node, prop_name, &len);
658 return -FDT_ERR_NOTFOUND;
659 elems = len / sizeof(u32);
662 for (i = 0; i < count; i++)
663 array[i] = fdt32_to_cpu(cell[i]);
668 const u32 *fdtdec_locate_array(const void *blob, int node,
669 const char *prop_name, int count)
674 cell = get_prop_check_min_len(blob, node, prop_name,
675 sizeof(u32) * count, &err);
676 return err ? NULL : cell;
679 int fdtdec_get_bool(const void *blob, int node, const char *prop_name)
684 debug("%s: %s\n", __func__, prop_name);
685 cell = fdt_getprop(blob, node, prop_name, &len);
689 int fdtdec_parse_phandle_with_args(const void *blob, int src_node,
690 const char *list_name,
691 const char *cells_name,
692 int cell_count, int index,
693 struct fdtdec_phandle_args *out_args)
695 const __be32 *list, *list_end;
696 int rc = 0, size, cur_index = 0;
701 /* Retrieve the phandle list property */
702 list = fdt_getprop(blob, src_node, list_name, &size);
705 list_end = list + size / sizeof(*list);
707 /* Loop over the phandles until all the requested entry is found */
708 while (list < list_end) {
713 * If phandle is 0, then it is an empty entry with no
714 * arguments. Skip forward to the next entry.
716 phandle = be32_to_cpup(list++);
719 * Find the provider node and parse the #*-cells
720 * property to determine the argument length.
722 * This is not needed if the cell count is hard-coded
723 * (i.e. cells_name not set, but cell_count is set),
724 * except when we're going to return the found node
727 if (cells_name || cur_index == index) {
728 node = fdt_node_offset_by_phandle(blob,
731 debug("%s: could not find phandle\n",
732 fdt_get_name(blob, src_node,
739 count = fdtdec_get_int(blob, node, cells_name,
742 debug("%s: could not get %s for %s\n",
743 fdt_get_name(blob, src_node,
746 fdt_get_name(blob, node,
755 * Make sure that the arguments actually fit in the
756 * remaining property data length
758 if (list + count > list_end) {
759 debug("%s: arguments longer than property\n",
760 fdt_get_name(blob, src_node, NULL));
766 * All of the error cases above bail out of the loop, so at
767 * this point, the parsing is successful. If the requested
768 * index matches, then fill the out_args structure and return,
769 * or return -ENOENT for an empty entry.
772 if (cur_index == index) {
779 if (count > MAX_PHANDLE_ARGS) {
780 debug("%s: too many arguments %d\n",
781 fdt_get_name(blob, src_node,
783 count = MAX_PHANDLE_ARGS;
785 out_args->node = node;
786 out_args->args_count = count;
787 for (i = 0; i < count; i++) {
789 be32_to_cpup(list++);
793 /* Found it! return success */
803 * Result will be one of:
804 * -ENOENT : index is for empty phandle
805 * -EINVAL : parsing error on data
806 * [1..n] : Number of phandle (count mode; when index = -1)
808 rc = index < 0 ? cur_index : -ENOENT;
813 int fdtdec_get_byte_array(const void *blob, int node, const char *prop_name,
814 u8 *array, int count)
819 cell = get_prop_check_min_len(blob, node, prop_name, count, &err);
821 memcpy(array, cell, count);
825 const u8 *fdtdec_locate_byte_array(const void *blob, int node,
826 const char *prop_name, int count)
831 cell = get_prop_check_min_len(blob, node, prop_name, count, &err);
837 int fdtdec_get_config_int(const void *blob, const char *prop_name,
842 debug("%s: %s\n", __func__, prop_name);
843 config_node = fdt_path_offset(blob, "/config");
846 return fdtdec_get_int(blob, config_node, prop_name, default_val);
849 int fdtdec_get_config_bool(const void *blob, const char *prop_name)
854 debug("%s: %s\n", __func__, prop_name);
855 config_node = fdt_path_offset(blob, "/config");
858 prop = fdt_get_property(blob, config_node, prop_name, NULL);
863 char *fdtdec_get_config_string(const void *blob, const char *prop_name)
869 debug("%s: %s\n", __func__, prop_name);
870 nodeoffset = fdt_path_offset(blob, "/config");
874 nodep = fdt_getprop(blob, nodeoffset, prop_name, &len);
878 return (char *)nodep;
881 u64 fdtdec_get_number(const fdt32_t *ptr, unsigned int cells)
886 number = (number << 32) | fdt32_to_cpu(*ptr++);
891 int fdt_get_resource(const void *fdt, int node, const char *property,
892 unsigned int index, struct fdt_resource *res)
894 const fdt32_t *ptr, *end;
895 int na, ns, len, parent;
898 parent = fdt_parent_offset(fdt, node);
902 na = fdt_address_cells(fdt, parent);
903 ns = fdt_size_cells(fdt, parent);
905 ptr = fdt_getprop(fdt, node, property, &len);
909 end = ptr + len / sizeof(*ptr);
911 while (ptr + na + ns <= end) {
913 res->start = fdtdec_get_number(ptr, na);
914 res->end = res->start;
915 res->end += fdtdec_get_number(&ptr[na], ns) - 1;
923 return -FDT_ERR_NOTFOUND;
926 int fdt_get_named_resource(const void *fdt, int node, const char *property,
927 const char *prop_names, const char *name,
928 struct fdt_resource *res)
932 index = fdt_stringlist_search(fdt, node, prop_names, name);
936 return fdt_get_resource(fdt, node, property, index, res);
939 static int decode_timing_property(const void *blob, int node, const char *name,
940 struct timing_entry *result)
945 prop = fdt_getprop(blob, node, name, &length);
947 debug("%s: could not find property %s\n",
948 fdt_get_name(blob, node, NULL), name);
952 if (length == sizeof(u32)) {
953 result->typ = fdtdec_get_int(blob, node, name, 0);
954 result->min = result->typ;
955 result->max = result->typ;
957 ret = fdtdec_get_int_array(blob, node, name, &result->min, 3);
963 int fdtdec_decode_display_timing(const void *blob, int parent, int index,
964 struct display_timing *dt)
966 int i, node, timings_node;
970 timings_node = fdt_subnode_offset(blob, parent, "display-timings");
971 if (timings_node < 0)
974 for (i = 0, node = fdt_first_subnode(blob, timings_node);
975 node > 0 && i != index;
976 node = fdt_next_subnode(blob, node))
982 memset(dt, 0, sizeof(*dt));
984 ret |= decode_timing_property(blob, node, "hback-porch",
986 ret |= decode_timing_property(blob, node, "hfront-porch",
988 ret |= decode_timing_property(blob, node, "hactive", &dt->hactive);
989 ret |= decode_timing_property(blob, node, "hsync-len", &dt->hsync_len);
990 ret |= decode_timing_property(blob, node, "vback-porch",
992 ret |= decode_timing_property(blob, node, "vfront-porch",
994 ret |= decode_timing_property(blob, node, "vactive", &dt->vactive);
995 ret |= decode_timing_property(blob, node, "vsync-len", &dt->vsync_len);
996 ret |= decode_timing_property(blob, node, "clock-frequency",
1000 val = fdtdec_get_int(blob, node, "vsync-active", -1);
1002 dt->flags |= val ? DISPLAY_FLAGS_VSYNC_HIGH :
1003 DISPLAY_FLAGS_VSYNC_LOW;
1005 val = fdtdec_get_int(blob, node, "hsync-active", -1);
1007 dt->flags |= val ? DISPLAY_FLAGS_HSYNC_HIGH :
1008 DISPLAY_FLAGS_HSYNC_LOW;
1010 val = fdtdec_get_int(blob, node, "de-active", -1);
1012 dt->flags |= val ? DISPLAY_FLAGS_DE_HIGH :
1013 DISPLAY_FLAGS_DE_LOW;
1015 val = fdtdec_get_int(blob, node, "pixelclk-active", -1);
1017 dt->flags |= val ? DISPLAY_FLAGS_PIXDATA_POSEDGE :
1018 DISPLAY_FLAGS_PIXDATA_NEGEDGE;
1021 if (fdtdec_get_bool(blob, node, "interlaced"))
1022 dt->flags |= DISPLAY_FLAGS_INTERLACED;
1023 if (fdtdec_get_bool(blob, node, "doublescan"))
1024 dt->flags |= DISPLAY_FLAGS_DOUBLESCAN;
1025 if (fdtdec_get_bool(blob, node, "doubleclk"))
1026 dt->flags |= DISPLAY_FLAGS_DOUBLECLK;
1031 int fdtdec_setup_mem_size_base_fdt(const void *blob)
1034 struct fdt_resource res;
1036 mem = fdt_path_offset(blob, "/memory");
1038 debug("%s: Missing /memory node\n", __func__);
1042 ret = fdt_get_resource(blob, mem, "reg", 0, &res);
1044 debug("%s: Unable to decode first memory bank\n", __func__);
1048 gd->ram_size = (phys_size_t)(res.end - res.start + 1);
1049 gd->ram_base = (unsigned long)res.start;
1050 debug("%s: Initial DRAM size %llx\n", __func__,
1051 (unsigned long long)gd->ram_size);
1056 int fdtdec_setup_mem_size_base(void)
1058 return fdtdec_setup_mem_size_base_fdt(gd->fdt_blob);
1061 #if defined(CONFIG_NR_DRAM_BANKS)
1063 static int get_next_memory_node(const void *blob, int mem)
1066 mem = fdt_node_offset_by_prop_value(blob, mem,
1067 "device_type", "memory", 7);
1068 } while (!fdtdec_get_is_enabled(blob, mem));
1073 int fdtdec_setup_memory_banksize_fdt(const void *blob)
1075 int bank, ret, mem, reg = 0;
1076 struct fdt_resource res;
1078 mem = get_next_memory_node(blob, -1);
1080 debug("%s: Missing /memory node\n", __func__);
1084 for (bank = 0; bank < CONFIG_NR_DRAM_BANKS; bank++) {
1085 ret = fdt_get_resource(blob, mem, "reg", reg++, &res);
1086 if (ret == -FDT_ERR_NOTFOUND) {
1088 mem = get_next_memory_node(blob, mem);
1089 if (mem == -FDT_ERR_NOTFOUND)
1092 ret = fdt_get_resource(blob, mem, "reg", reg++, &res);
1093 if (ret == -FDT_ERR_NOTFOUND)
1100 gd->bd->bi_dram[bank].start = (phys_addr_t)res.start;
1101 gd->bd->bi_dram[bank].size =
1102 (phys_size_t)(res.end - res.start + 1);
1104 debug("%s: DRAM Bank #%d: start = 0x%llx, size = 0x%llx\n",
1106 (unsigned long long)gd->bd->bi_dram[bank].start,
1107 (unsigned long long)gd->bd->bi_dram[bank].size);
1113 int fdtdec_setup_memory_banksize(void)
1115 return fdtdec_setup_memory_banksize_fdt(gd->fdt_blob);
1120 #if CONFIG_IS_ENABLED(MULTI_DTB_FIT)
1121 # if CONFIG_IS_ENABLED(MULTI_DTB_FIT_GZIP) ||\
1122 CONFIG_IS_ENABLED(MULTI_DTB_FIT_LZO)
1123 static int uncompress_blob(const void *src, ulong sz_src, void **dstp)
1125 size_t sz_out = CONFIG_VAL(MULTI_DTB_FIT_UNCOMPRESS_SZ);
1126 bool gzip = 0, lzo = 0;
1127 ulong sz_in = sz_src;
1131 if (CONFIG_IS_ENABLED(GZIP))
1132 if (gzip_parse_header(src, sz_in) >= 0)
1134 if (CONFIG_IS_ENABLED(LZO))
1135 if (!gzip && lzop_is_valid_header(src))
1142 if (CONFIG_IS_ENABLED(MULTI_DTB_FIT_DYN_ALLOC)) {
1143 dst = malloc(sz_out);
1145 puts("uncompress_blob: Unable to allocate memory\n");
1149 # if CONFIG_IS_ENABLED(MULTI_DTB_FIT_USER_DEFINED_AREA)
1150 dst = (void *)CONFIG_VAL(MULTI_DTB_FIT_USER_DEF_ADDR);
1156 if (CONFIG_IS_ENABLED(GZIP) && gzip)
1157 rc = gunzip(dst, sz_out, (u8 *)src, &sz_in);
1158 else if (CONFIG_IS_ENABLED(LZO) && lzo)
1159 rc = lzop_decompress(src, sz_in, dst, &sz_out);
1164 /* not a valid compressed blob */
1165 puts("uncompress_blob: Unable to uncompress\n");
1166 if (CONFIG_IS_ENABLED(MULTI_DTB_FIT_DYN_ALLOC))
1174 static int uncompress_blob(const void *src, ulong sz_src, void **dstp)
1176 *dstp = (void *)src;
1182 #if defined(CONFIG_OF_BOARD) || defined(CONFIG_OF_SEPARATE)
1184 * For CONFIG_OF_SEPARATE, the board may optionally implement this to
1185 * provide and/or fixup the fdt.
1187 __weak void *board_fdt_blob_setup(void)
1189 void *fdt_blob = NULL;
1190 #ifdef CONFIG_SPL_BUILD
1191 /* FDT is at end of BSS unless it is in a different memory region */
1192 if (IS_ENABLED(CONFIG_SPL_SEPARATE_BSS))
1193 fdt_blob = (ulong *)&_image_binary_end;
1195 fdt_blob = (ulong *)&__bss_end;
1197 /* FDT is at end of image */
1198 fdt_blob = (ulong *)&_end;
1204 int fdtdec_set_ethernet_mac_address(void *fdt, const u8 *mac, size_t size)
1209 if (!is_valid_ethaddr(mac))
1212 path = fdt_get_alias(fdt, "ethernet");
1216 debug("ethernet alias found: %s\n", path);
1218 offset = fdt_path_offset(fdt, path);
1220 debug("ethernet alias points to absent node %s\n", path);
1224 err = fdt_setprop_inplace(fdt, offset, "local-mac-address", mac, size);
1228 debug("MAC address: %pM\n", mac);
1233 static int fdtdec_init_reserved_memory(void *blob)
1235 int na, ns, node, err;
1238 /* inherit #address-cells and #size-cells from the root node */
1239 na = fdt_address_cells(blob, 0);
1240 ns = fdt_size_cells(blob, 0);
1242 node = fdt_add_subnode(blob, 0, "reserved-memory");
1246 err = fdt_setprop(blob, node, "ranges", NULL, 0);
1250 value = cpu_to_fdt32(ns);
1252 err = fdt_setprop(blob, node, "#size-cells", &value, sizeof(value));
1256 value = cpu_to_fdt32(na);
1258 err = fdt_setprop(blob, node, "#address-cells", &value, sizeof(value));
1265 int fdtdec_add_reserved_memory(void *blob, const char *basename,
1266 const struct fdt_memory *carveout,
1269 fdt32_t cells[4] = {}, *ptr = cells;
1270 uint32_t upper, lower, phandle;
1271 int parent, node, na, ns, err;
1275 /* create an empty /reserved-memory node if one doesn't exist */
1276 parent = fdt_path_offset(blob, "/reserved-memory");
1278 parent = fdtdec_init_reserved_memory(blob);
1283 /* only 1 or 2 #address-cells and #size-cells are supported */
1284 na = fdt_address_cells(blob, parent);
1285 if (na < 1 || na > 2)
1286 return -FDT_ERR_BADNCELLS;
1288 ns = fdt_size_cells(blob, parent);
1289 if (ns < 1 || ns > 2)
1290 return -FDT_ERR_BADNCELLS;
1292 /* find a matching node and return the phandle to that */
1293 fdt_for_each_subnode(node, blob, parent) {
1294 const char *name = fdt_get_name(blob, node, NULL);
1295 phys_addr_t addr, size;
1297 addr = fdtdec_get_addr_size(blob, node, "reg", &size);
1298 if (addr == FDT_ADDR_T_NONE) {
1299 debug("failed to read address/size for %s\n", name);
1303 if (addr == carveout->start && (addr + size - 1) ==
1306 *phandlep = fdt_get_phandle(blob, node);
1312 * Unpack the start address and generate the name of the new node
1313 * base on the basename and the unit-address.
1315 upper = upper_32_bits(carveout->start);
1316 lower = lower_32_bits(carveout->start);
1318 if (na > 1 && upper > 0)
1319 snprintf(name, sizeof(name), "%s@%x,%x", basename, upper,
1323 debug("address %08x:%08x exceeds addressable space\n",
1325 return -FDT_ERR_BADVALUE;
1328 snprintf(name, sizeof(name), "%s@%x", basename, lower);
1331 node = fdt_add_subnode(blob, parent, name);
1336 err = fdt_generate_phandle(blob, &phandle);
1340 err = fdtdec_set_phandle(blob, node, phandle);
1345 /* store one or two address cells */
1347 *ptr++ = cpu_to_fdt32(upper);
1349 *ptr++ = cpu_to_fdt32(lower);
1351 /* store one or two size cells */
1352 size = carveout->end - carveout->start + 1;
1353 upper = upper_32_bits(size);
1354 lower = lower_32_bits(size);
1357 *ptr++ = cpu_to_fdt32(upper);
1359 *ptr++ = cpu_to_fdt32(lower);
1361 err = fdt_setprop(blob, node, "reg", cells, (na + ns) * sizeof(*cells));
1365 /* return the phandle for the new node for the caller to use */
1367 *phandlep = phandle;
1372 int fdtdec_get_carveout(const void *blob, const char *node, const char *name,
1373 unsigned int index, struct fdt_memory *carveout)
1375 const fdt32_t *prop;
1380 offset = fdt_path_offset(blob, node);
1384 prop = fdt_getprop(blob, offset, name, &len);
1386 debug("failed to get %s for %s\n", name, node);
1387 return -FDT_ERR_NOTFOUND;
1390 if ((len % sizeof(phandle)) != 0) {
1391 debug("invalid phandle property\n");
1392 return -FDT_ERR_BADPHANDLE;
1395 if (len < (sizeof(phandle) * (index + 1))) {
1396 debug("invalid phandle index\n");
1397 return -FDT_ERR_BADPHANDLE;
1400 phandle = fdt32_to_cpu(prop[index]);
1402 offset = fdt_node_offset_by_phandle(blob, phandle);
1404 debug("failed to find node for phandle %u\n", phandle);
1408 carveout->start = fdtdec_get_addr_size_auto_noparent(blob, offset,
1411 if (carveout->start == FDT_ADDR_T_NONE) {
1412 debug("failed to read address/size from \"reg\" property\n");
1413 return -FDT_ERR_NOTFOUND;
1416 carveout->end = carveout->start + size - 1;
1421 int fdtdec_set_carveout(void *blob, const char *node, const char *prop_name,
1422 unsigned int index, const char *name,
1423 const struct fdt_memory *carveout)
1426 int err, offset, len;
1430 err = fdtdec_add_reserved_memory(blob, name, carveout, &phandle);
1432 debug("failed to add reserved memory: %d\n", err);
1436 offset = fdt_path_offset(blob, node);
1438 debug("failed to find offset for node %s: %d\n", node, offset);
1442 value = cpu_to_fdt32(phandle);
1444 if (!fdt_getprop(blob, offset, prop_name, &len)) {
1445 if (len == -FDT_ERR_NOTFOUND)
1451 if ((index + 1) * sizeof(value) > len) {
1452 err = fdt_setprop_placeholder(blob, offset, prop_name,
1453 (index + 1) * sizeof(value),
1456 debug("failed to resize reserved memory property: %s\n",
1462 err = fdt_setprop_inplace_namelen_partial(blob, offset, prop_name,
1464 index * sizeof(value),
1465 &value, sizeof(value));
1467 debug("failed to update %s property for node %s: %s\n",
1468 prop_name, node, fdt_strerror(err));
1475 int fdtdec_setup(void)
1477 #if CONFIG_IS_ENABLED(OF_CONTROL)
1478 # if CONFIG_IS_ENABLED(MULTI_DTB_FIT)
1481 # ifdef CONFIG_OF_EMBED
1482 /* Get a pointer to the FDT */
1483 # ifdef CONFIG_SPL_BUILD
1484 gd->fdt_blob = __dtb_dt_spl_begin;
1486 gd->fdt_blob = __dtb_dt_begin;
1488 # elif defined(CONFIG_OF_BOARD) || defined(CONFIG_OF_SEPARATE)
1489 /* Allow the board to override the fdt address. */
1490 gd->fdt_blob = board_fdt_blob_setup();
1491 # elif defined(CONFIG_OF_HOSTFILE)
1492 if (sandbox_read_fdt_from_file()) {
1493 puts("Failed to read control FDT\n");
1496 # elif defined(CONFIG_OF_PRIOR_STAGE)
1497 gd->fdt_blob = (void *)prior_stage_fdt_address;
1499 # ifndef CONFIG_SPL_BUILD
1500 /* Allow the early environment to override the fdt address */
1501 gd->fdt_blob = map_sysmem
1502 (env_get_ulong("fdtcontroladdr", 16,
1503 (unsigned long)map_to_sysmem(gd->fdt_blob)), 0);
1506 # if CONFIG_IS_ENABLED(MULTI_DTB_FIT)
1508 * Try and uncompress the blob.
1509 * Unfortunately there is no way to know how big the input blob really
1510 * is. So let us set the maximum input size arbitrarily high. 16MB
1511 * ought to be more than enough for packed DTBs.
1513 if (uncompress_blob(gd->fdt_blob, 0x1000000, &fdt_blob) == 0)
1514 gd->fdt_blob = fdt_blob;
1517 * Check if blob is a FIT images containings DTBs.
1518 * If so, pick the most relevant
1520 fdt_blob = locate_dtb_in_fit(gd->fdt_blob);
1522 gd->multi_dtb_fit = gd->fdt_blob;
1523 gd->fdt_blob = fdt_blob;
1529 return fdtdec_prepare_fdt();
1532 #if CONFIG_IS_ENABLED(MULTI_DTB_FIT)
1533 int fdtdec_resetup(int *rescan)
1538 * If the current DTB is part of a compressed FIT image,
1539 * try to locate the best match from the uncompressed
1540 * FIT image stillpresent there. Save the time and space
1541 * required to uncompress it again.
1543 if (gd->multi_dtb_fit) {
1544 fdt_blob = locate_dtb_in_fit(gd->multi_dtb_fit);
1546 if (fdt_blob == gd->fdt_blob) {
1548 * The best match did not change. no need to tear down
1549 * the DM and rescan the fdt.
1556 gd->fdt_blob = fdt_blob;
1557 return fdtdec_prepare_fdt();
1561 * If multi_dtb_fit is NULL, it means that blob appended to u-boot is
1562 * not a FIT image containings DTB, but a single DTB. There is no need
1563 * to teard down DM and rescan the DT in this case.
1570 #ifdef CONFIG_NR_DRAM_BANKS
1571 int fdtdec_decode_ram_size(const void *blob, const char *area, int board_id,
1572 phys_addr_t *basep, phys_size_t *sizep, bd_t *bd)
1574 int addr_cells, size_cells;
1575 const u32 *cell, *end;
1576 u64 total_size, size, addr;
1582 debug("%s: board_id=%d\n", __func__, board_id);
1585 node = fdt_path_offset(blob, area);
1587 debug("No %s node found\n", area);
1591 cell = fdt_getprop(blob, node, "reg", &len);
1593 debug("No reg property found\n");
1597 addr_cells = fdt_address_cells(blob, node);
1598 size_cells = fdt_size_cells(blob, node);
1600 /* Check the board id and mask */
1601 for (child = fdt_first_subnode(blob, node);
1603 child = fdt_next_subnode(blob, child)) {
1604 int match_mask, match_value;
1606 match_mask = fdtdec_get_int(blob, child, "match-mask", -1);
1607 match_value = fdtdec_get_int(blob, child, "match-value", -1);
1609 if (match_value >= 0 &&
1610 ((board_id & match_mask) == match_value)) {
1611 /* Found matching mask */
1612 debug("Found matching mask %d\n", match_mask);
1614 cell = fdt_getprop(blob, node, "reg", &len);
1616 debug("No memory-banks property found\n");
1622 /* Note: if no matching subnode was found we use the parent node */
1625 memset(bd->bi_dram, '\0', sizeof(bd->bi_dram[0]) *
1626 CONFIG_NR_DRAM_BANKS);
1629 auto_size = fdtdec_get_bool(blob, node, "auto-size");
1632 end = cell + len / 4 - addr_cells - size_cells;
1633 debug("cell at %p, end %p\n", cell, end);
1634 for (bank = 0; bank < CONFIG_NR_DRAM_BANKS; bank++) {
1638 if (addr_cells == 2)
1639 addr += (u64)fdt32_to_cpu(*cell++) << 32UL;
1640 addr += fdt32_to_cpu(*cell++);
1642 bd->bi_dram[bank].start = addr;
1644 *basep = (phys_addr_t)addr;
1647 if (size_cells == 2)
1648 size += (u64)fdt32_to_cpu(*cell++) << 32UL;
1649 size += fdt32_to_cpu(*cell++);
1654 debug("Auto-sizing %llx, size %llx: ", addr, size);
1655 new_size = get_ram_size((long *)(uintptr_t)addr, size);
1656 if (new_size == size) {
1659 debug("sized to %llx\n", new_size);
1665 bd->bi_dram[bank].size = size;
1669 debug("Memory size %llu\n", total_size);
1671 *sizep = (phys_size_t)total_size;
1675 #endif /* CONFIG_NR_DRAM_BANKS */
1677 #endif /* !USE_HOSTCC */