xref: /openbmc/u-boot/lib/fdtdec.c (revision 33b78476)
1 /*
2  * Copyright (c) 2011 The Chromium OS Authors.
3  * SPDX-License-Identifier:	GPL-2.0+
4  */
5 
6 #ifndef USE_HOSTCC
7 #include <common.h>
8 #include <dm.h>
9 #include <errno.h>
10 #include <serial.h>
11 #include <libfdt.h>
12 #include <fdt_support.h>
13 #include <fdtdec.h>
14 #include <asm/sections.h>
15 #include <linux/ctype.h>
16 
17 DECLARE_GLOBAL_DATA_PTR;
18 
19 /*
20  * Here are the type we know about. One day we might allow drivers to
21  * register. For now we just put them here. The COMPAT macro allows us to
22  * turn this into a sparse list later, and keeps the ID with the name.
23  *
24  * NOTE: This list is basically a TODO list for things that need to be
25  * converted to driver model. So don't add new things here unless there is a
26  * good reason why driver-model conversion is infeasible. Examples include
27  * things which are used before driver model is available.
28  */
29 #define COMPAT(id, name) name
30 static const char * const compat_names[COMPAT_COUNT] = {
31 	COMPAT(UNKNOWN, "<none>"),
32 	COMPAT(NVIDIA_TEGRA20_EMC, "nvidia,tegra20-emc"),
33 	COMPAT(NVIDIA_TEGRA20_EMC_TABLE, "nvidia,tegra20-emc-table"),
34 	COMPAT(NVIDIA_TEGRA20_NAND, "nvidia,tegra20-nand"),
35 	COMPAT(NVIDIA_TEGRA124_PMC, "nvidia,tegra124-pmc"),
36 	COMPAT(NVIDIA_TEGRA186_SDMMC, "nvidia,tegra186-sdhci"),
37 	COMPAT(NVIDIA_TEGRA210_SDMMC, "nvidia,tegra210-sdhci"),
38 	COMPAT(NVIDIA_TEGRA124_SDMMC, "nvidia,tegra124-sdhci"),
39 	COMPAT(NVIDIA_TEGRA30_SDMMC, "nvidia,tegra30-sdhci"),
40 	COMPAT(NVIDIA_TEGRA20_SDMMC, "nvidia,tegra20-sdhci"),
41 	COMPAT(NVIDIA_TEGRA124_XUSB_PADCTL, "nvidia,tegra124-xusb-padctl"),
42 	COMPAT(NVIDIA_TEGRA210_XUSB_PADCTL, "nvidia,tegra210-xusb-padctl"),
43 	COMPAT(SMSC_LAN9215, "smsc,lan9215"),
44 	COMPAT(SAMSUNG_EXYNOS5_SROMC, "samsung,exynos-sromc"),
45 	COMPAT(SAMSUNG_S3C2440_I2C, "samsung,s3c2440-i2c"),
46 	COMPAT(SAMSUNG_EXYNOS5_SOUND, "samsung,exynos-sound"),
47 	COMPAT(WOLFSON_WM8994_CODEC, "wolfson,wm8994-codec"),
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(SAMSUNG_EXYNOS_MMC, "samsung,exynos-mmc"),
54 	COMPAT(MAXIM_MAX77686_PMIC, "maxim,max77686"),
55 	COMPAT(GENERIC_SPI_FLASH, "spi-flash"),
56 	COMPAT(MAXIM_98095_CODEC, "maxim,max98095-codec"),
57 	COMPAT(SAMSUNG_EXYNOS5_I2C, "samsung,exynos5-hsi2c"),
58 	COMPAT(SAMSUNG_EXYNOS_SYSMMU, "samsung,sysmmu-v3.3"),
59 	COMPAT(INTEL_MICROCODE, "intel,microcode"),
60 	COMPAT(AMS_AS3722, "ams,as3722"),
61 	COMPAT(INTEL_QRK_MRC, "intel,quark-mrc"),
62 	COMPAT(ALTERA_SOCFPGA_DWMAC, "altr,socfpga-stmmac"),
63 	COMPAT(ALTERA_SOCFPGA_DWMMC, "altr,socfpga-dw-mshc"),
64 	COMPAT(ALTERA_SOCFPGA_DWC2USB, "snps,dwc2"),
65 	COMPAT(INTEL_BAYTRAIL_FSP, "intel,baytrail-fsp"),
66 	COMPAT(INTEL_BAYTRAIL_FSP_MDP, "intel,baytrail-fsp-mdp"),
67 	COMPAT(INTEL_IVYBRIDGE_FSP, "intel,ivybridge-fsp"),
68 	COMPAT(COMPAT_SUNXI_NAND, "allwinner,sun4i-a10-nand"),
69 	COMPAT(ALTERA_SOCFPGA_CLK, "altr,clk-mgr"),
70 	COMPAT(ALTERA_SOCFPGA_PINCTRL_SINGLE, "pinctrl-single"),
71 	COMPAT(ALTERA_SOCFPGA_H2F_BRG, "altr,socfpga-hps2fpga-bridge"),
72 	COMPAT(ALTERA_SOCFPGA_LWH2F_BRG, "altr,socfpga-lwhps2fpga-bridge"),
73 	COMPAT(ALTERA_SOCFPGA_F2H_BRG, "altr,socfpga-fpga2hps-bridge"),
74 	COMPAT(ALTERA_SOCFPGA_F2SDR0, "altr,socfpga-fpga2sdram0-bridge"),
75 	COMPAT(ALTERA_SOCFPGA_F2SDR1, "altr,socfpga-fpga2sdram1-bridge"),
76 	COMPAT(ALTERA_SOCFPGA_F2SDR2, "altr,socfpga-fpga2sdram2-bridge"),
77 };
78 
79 const char *fdtdec_get_compatible(enum fdt_compat_id id)
80 {
81 	/* We allow reading of the 'unknown' ID for testing purposes */
82 	assert(id >= 0 && id < COMPAT_COUNT);
83 	return compat_names[id];
84 }
85 
86 fdt_addr_t fdtdec_get_addr_size_fixed(const void *blob, int node,
87 		const char *prop_name, int index, int na, int ns,
88 		fdt_size_t *sizep, bool translate)
89 {
90 	const fdt32_t *prop, *prop_end;
91 	const fdt32_t *prop_addr, *prop_size, *prop_after_size;
92 	int len;
93 	fdt_addr_t addr;
94 
95 	debug("%s: %s: ", __func__, prop_name);
96 
97 	if (na > (sizeof(fdt_addr_t) / sizeof(fdt32_t))) {
98 		debug("(na too large for fdt_addr_t type)\n");
99 		return FDT_ADDR_T_NONE;
100 	}
101 
102 	if (ns > (sizeof(fdt_size_t) / sizeof(fdt32_t))) {
103 		debug("(ns too large for fdt_size_t type)\n");
104 		return FDT_ADDR_T_NONE;
105 	}
106 
107 	prop = fdt_getprop(blob, node, prop_name, &len);
108 	if (!prop) {
109 		debug("(not found)\n");
110 		return FDT_ADDR_T_NONE;
111 	}
112 	prop_end = prop + (len / sizeof(*prop));
113 
114 	prop_addr = prop + (index * (na + ns));
115 	prop_size = prop_addr + na;
116 	prop_after_size = prop_size + ns;
117 	if (prop_after_size > prop_end) {
118 		debug("(not enough data: expected >= %d cells, got %d cells)\n",
119 		      (u32)(prop_after_size - prop), ((u32)(prop_end - prop)));
120 		return FDT_ADDR_T_NONE;
121 	}
122 
123 #if CONFIG_IS_ENABLED(OF_TRANSLATE)
124 	if (translate)
125 		addr = fdt_translate_address(blob, node, prop_addr);
126 	else
127 #endif
128 		addr = fdtdec_get_number(prop_addr, na);
129 
130 	if (sizep) {
131 		*sizep = fdtdec_get_number(prop_size, ns);
132 		debug("addr=%08llx, size=%llx\n", (unsigned long long)addr,
133 		      (unsigned long long)*sizep);
134 	} else {
135 		debug("addr=%08llx\n", (unsigned long long)addr);
136 	}
137 
138 	return addr;
139 }
140 
141 fdt_addr_t fdtdec_get_addr_size_auto_parent(const void *blob, int parent,
142 		int node, const char *prop_name, int index, fdt_size_t *sizep,
143 		bool translate)
144 {
145 	int na, ns;
146 
147 	debug("%s: ", __func__);
148 
149 	na = fdt_address_cells(blob, parent);
150 	if (na < 1) {
151 		debug("(bad #address-cells)\n");
152 		return FDT_ADDR_T_NONE;
153 	}
154 
155 	ns = fdt_size_cells(blob, parent);
156 	if (ns < 0) {
157 		debug("(bad #size-cells)\n");
158 		return FDT_ADDR_T_NONE;
159 	}
160 
161 	debug("na=%d, ns=%d, ", na, ns);
162 
163 	return fdtdec_get_addr_size_fixed(blob, node, prop_name, index, na,
164 					  ns, sizep, translate);
165 }
166 
167 fdt_addr_t fdtdec_get_addr_size_auto_noparent(const void *blob, int node,
168 		const char *prop_name, int index, fdt_size_t *sizep,
169 		bool translate)
170 {
171 	int parent;
172 
173 	debug("%s: ", __func__);
174 
175 	parent = fdt_parent_offset(blob, node);
176 	if (parent < 0) {
177 		debug("(no parent found)\n");
178 		return FDT_ADDR_T_NONE;
179 	}
180 
181 	return fdtdec_get_addr_size_auto_parent(blob, parent, node, prop_name,
182 						index, sizep, translate);
183 }
184 
185 fdt_addr_t fdtdec_get_addr_size(const void *blob, int node,
186 		const char *prop_name, fdt_size_t *sizep)
187 {
188 	int ns = sizep ? (sizeof(fdt_size_t) / sizeof(fdt32_t)) : 0;
189 
190 	return fdtdec_get_addr_size_fixed(blob, node, prop_name, 0,
191 					  sizeof(fdt_addr_t) / sizeof(fdt32_t),
192 					  ns, sizep, false);
193 }
194 
195 fdt_addr_t fdtdec_get_addr(const void *blob, int node,
196 		const char *prop_name)
197 {
198 	return fdtdec_get_addr_size(blob, node, prop_name, NULL);
199 }
200 
201 #if defined(CONFIG_PCI) && defined(CONFIG_DM_PCI)
202 int fdtdec_get_pci_addr(const void *blob, int node, enum fdt_pci_space type,
203 		const char *prop_name, struct fdt_pci_addr *addr)
204 {
205 	const u32 *cell;
206 	int len;
207 	int ret = -ENOENT;
208 
209 	debug("%s: %s: ", __func__, prop_name);
210 
211 	/*
212 	 * If we follow the pci bus bindings strictly, we should check
213 	 * the value of the node's parent node's #address-cells and
214 	 * #size-cells. They need to be 3 and 2 accordingly. However,
215 	 * for simplicity we skip the check here.
216 	 */
217 	cell = fdt_getprop(blob, node, prop_name, &len);
218 	if (!cell)
219 		goto fail;
220 
221 	if ((len % FDT_PCI_REG_SIZE) == 0) {
222 		int num = len / FDT_PCI_REG_SIZE;
223 		int i;
224 
225 		for (i = 0; i < num; i++) {
226 			debug("pci address #%d: %08lx %08lx %08lx\n", i,
227 			      (ulong)fdt32_to_cpu(cell[0]),
228 			      (ulong)fdt32_to_cpu(cell[1]),
229 			      (ulong)fdt32_to_cpu(cell[2]));
230 			if ((fdt32_to_cpu(*cell) & type) == type) {
231 				addr->phys_hi = fdt32_to_cpu(cell[0]);
232 				addr->phys_mid = fdt32_to_cpu(cell[1]);
233 				addr->phys_lo = fdt32_to_cpu(cell[1]);
234 				break;
235 			} else {
236 				cell += (FDT_PCI_ADDR_CELLS +
237 					 FDT_PCI_SIZE_CELLS);
238 			}
239 		}
240 
241 		if (i == num) {
242 			ret = -ENXIO;
243 			goto fail;
244 		}
245 
246 		return 0;
247 	} else {
248 		ret = -EINVAL;
249 	}
250 
251 fail:
252 	debug("(not found)\n");
253 	return ret;
254 }
255 
256 int fdtdec_get_pci_vendev(const void *blob, int node, u16 *vendor, u16 *device)
257 {
258 	const char *list, *end;
259 	int len;
260 
261 	list = fdt_getprop(blob, node, "compatible", &len);
262 	if (!list)
263 		return -ENOENT;
264 
265 	end = list + len;
266 	while (list < end) {
267 		char *s;
268 
269 		len = strlen(list);
270 		if (len >= strlen("pciVVVV,DDDD")) {
271 			s = strstr(list, "pci");
272 
273 			/*
274 			 * check if the string is something like pciVVVV,DDDD.RR
275 			 * or just pciVVVV,DDDD
276 			 */
277 			if (s && s[7] == ',' &&
278 			    (s[12] == '.' || s[12] == 0)) {
279 				s += 3;
280 				*vendor = simple_strtol(s, NULL, 16);
281 
282 				s += 5;
283 				*device = simple_strtol(s, NULL, 16);
284 
285 				return 0;
286 			}
287 		}
288 		list += (len + 1);
289 	}
290 
291 	return -ENOENT;
292 }
293 
294 int fdtdec_get_pci_bar32(struct udevice *dev, struct fdt_pci_addr *addr,
295 			 u32 *bar)
296 {
297 	int barnum;
298 
299 	/* extract the bar number from fdt_pci_addr */
300 	barnum = addr->phys_hi & 0xff;
301 	if ((barnum < PCI_BASE_ADDRESS_0) || (barnum > PCI_CARDBUS_CIS))
302 		return -EINVAL;
303 
304 	barnum = (barnum - PCI_BASE_ADDRESS_0) / 4;
305 	*bar = dm_pci_read_bar32(dev, barnum);
306 
307 	return 0;
308 }
309 #endif
310 
311 uint64_t fdtdec_get_uint64(const void *blob, int node, const char *prop_name,
312 		uint64_t default_val)
313 {
314 	const uint64_t *cell64;
315 	int length;
316 
317 	cell64 = fdt_getprop(blob, node, prop_name, &length);
318 	if (!cell64 || length < sizeof(*cell64))
319 		return default_val;
320 
321 	return fdt64_to_cpu(*cell64);
322 }
323 
324 int fdtdec_get_is_enabled(const void *blob, int node)
325 {
326 	const char *cell;
327 
328 	/*
329 	 * It should say "okay", so only allow that. Some fdts use "ok" but
330 	 * this is a bug. Please fix your device tree source file. See here
331 	 * for discussion:
332 	 *
333 	 * http://www.mail-archive.com/u-boot@lists.denx.de/msg71598.html
334 	 */
335 	cell = fdt_getprop(blob, node, "status", NULL);
336 	if (cell)
337 		return 0 == strcmp(cell, "okay");
338 	return 1;
339 }
340 
341 enum fdt_compat_id fdtdec_lookup(const void *blob, int node)
342 {
343 	enum fdt_compat_id id;
344 
345 	/* Search our drivers */
346 	for (id = COMPAT_UNKNOWN; id < COMPAT_COUNT; id++)
347 		if (0 == fdt_node_check_compatible(blob, node,
348 				compat_names[id]))
349 			return id;
350 	return COMPAT_UNKNOWN;
351 }
352 
353 int fdtdec_next_compatible(const void *blob, int node,
354 		enum fdt_compat_id id)
355 {
356 	return fdt_node_offset_by_compatible(blob, node, compat_names[id]);
357 }
358 
359 int fdtdec_next_compatible_subnode(const void *blob, int node,
360 		enum fdt_compat_id id, int *depthp)
361 {
362 	do {
363 		node = fdt_next_node(blob, node, depthp);
364 	} while (*depthp > 1);
365 
366 	/* If this is a direct subnode, and compatible, return it */
367 	if (*depthp == 1 && 0 == fdt_node_check_compatible(
368 						blob, node, compat_names[id]))
369 		return node;
370 
371 	return -FDT_ERR_NOTFOUND;
372 }
373 
374 int fdtdec_next_alias(const void *blob, const char *name,
375 		enum fdt_compat_id id, int *upto)
376 {
377 #define MAX_STR_LEN 20
378 	char str[MAX_STR_LEN + 20];
379 	int node, err;
380 
381 	/* snprintf() is not available */
382 	assert(strlen(name) < MAX_STR_LEN);
383 	sprintf(str, "%.*s%d", MAX_STR_LEN, name, *upto);
384 	node = fdt_path_offset(blob, str);
385 	if (node < 0)
386 		return node;
387 	err = fdt_node_check_compatible(blob, node, compat_names[id]);
388 	if (err < 0)
389 		return err;
390 	if (err)
391 		return -FDT_ERR_NOTFOUND;
392 	(*upto)++;
393 	return node;
394 }
395 
396 int fdtdec_find_aliases_for_id(const void *blob, const char *name,
397 			enum fdt_compat_id id, int *node_list, int maxcount)
398 {
399 	memset(node_list, '\0', sizeof(*node_list) * maxcount);
400 
401 	return fdtdec_add_aliases_for_id(blob, name, id, node_list, maxcount);
402 }
403 
404 /* TODO: Can we tighten this code up a little? */
405 int fdtdec_add_aliases_for_id(const void *blob, const char *name,
406 			enum fdt_compat_id id, int *node_list, int maxcount)
407 {
408 	int name_len = strlen(name);
409 	int nodes[maxcount];
410 	int num_found = 0;
411 	int offset, node;
412 	int alias_node;
413 	int count;
414 	int i, j;
415 
416 	/* find the alias node if present */
417 	alias_node = fdt_path_offset(blob, "/aliases");
418 
419 	/*
420 	 * start with nothing, and we can assume that the root node can't
421 	 * match
422 	 */
423 	memset(nodes, '\0', sizeof(nodes));
424 
425 	/* First find all the compatible nodes */
426 	for (node = count = 0; node >= 0 && count < maxcount;) {
427 		node = fdtdec_next_compatible(blob, node, id);
428 		if (node >= 0)
429 			nodes[count++] = node;
430 	}
431 	if (node >= 0)
432 		debug("%s: warning: maxcount exceeded with alias '%s'\n",
433 		       __func__, name);
434 
435 	/* Now find all the aliases */
436 	for (offset = fdt_first_property_offset(blob, alias_node);
437 			offset > 0;
438 			offset = fdt_next_property_offset(blob, offset)) {
439 		const struct fdt_property *prop;
440 		const char *path;
441 		int number;
442 		int found;
443 
444 		node = 0;
445 		prop = fdt_get_property_by_offset(blob, offset, NULL);
446 		path = fdt_string(blob, fdt32_to_cpu(prop->nameoff));
447 		if (prop->len && 0 == strncmp(path, name, name_len))
448 			node = fdt_path_offset(blob, prop->data);
449 		if (node <= 0)
450 			continue;
451 
452 		/* Get the alias number */
453 		number = simple_strtoul(path + name_len, NULL, 10);
454 		if (number < 0 || number >= maxcount) {
455 			debug("%s: warning: alias '%s' is out of range\n",
456 			       __func__, path);
457 			continue;
458 		}
459 
460 		/* Make sure the node we found is actually in our list! */
461 		found = -1;
462 		for (j = 0; j < count; j++)
463 			if (nodes[j] == node) {
464 				found = j;
465 				break;
466 			}
467 
468 		if (found == -1) {
469 			debug("%s: warning: alias '%s' points to a node "
470 				"'%s' that is missing or is not compatible "
471 				" with '%s'\n", __func__, path,
472 				fdt_get_name(blob, node, NULL),
473 			       compat_names[id]);
474 			continue;
475 		}
476 
477 		/*
478 		 * Add this node to our list in the right place, and mark
479 		 * it as done.
480 		 */
481 		if (fdtdec_get_is_enabled(blob, node)) {
482 			if (node_list[number]) {
483 				debug("%s: warning: alias '%s' requires that "
484 				      "a node be placed in the list in a "
485 				      "position which is already filled by "
486 				      "node '%s'\n", __func__, path,
487 				      fdt_get_name(blob, node, NULL));
488 				continue;
489 			}
490 			node_list[number] = node;
491 			if (number >= num_found)
492 				num_found = number + 1;
493 		}
494 		nodes[found] = 0;
495 	}
496 
497 	/* Add any nodes not mentioned by an alias */
498 	for (i = j = 0; i < maxcount; i++) {
499 		if (!node_list[i]) {
500 			for (; j < maxcount; j++)
501 				if (nodes[j] &&
502 					fdtdec_get_is_enabled(blob, nodes[j]))
503 					break;
504 
505 			/* Have we run out of nodes to add? */
506 			if (j == maxcount)
507 				break;
508 
509 			assert(!node_list[i]);
510 			node_list[i] = nodes[j++];
511 			if (i >= num_found)
512 				num_found = i + 1;
513 		}
514 	}
515 
516 	return num_found;
517 }
518 
519 int fdtdec_get_alias_seq(const void *blob, const char *base, int offset,
520 			 int *seqp)
521 {
522 	int base_len = strlen(base);
523 	const char *find_name;
524 	int find_namelen;
525 	int prop_offset;
526 	int aliases;
527 
528 	find_name = fdt_get_name(blob, offset, &find_namelen);
529 	debug("Looking for '%s' at %d, name %s\n", base, offset, find_name);
530 
531 	aliases = fdt_path_offset(blob, "/aliases");
532 	for (prop_offset = fdt_first_property_offset(blob, aliases);
533 	     prop_offset > 0;
534 	     prop_offset = fdt_next_property_offset(blob, prop_offset)) {
535 		const char *prop;
536 		const char *name;
537 		const char *slash;
538 		int len, val;
539 
540 		prop = fdt_getprop_by_offset(blob, prop_offset, &name, &len);
541 		debug("   - %s, %s\n", name, prop);
542 		if (len < find_namelen || *prop != '/' || prop[len - 1] ||
543 		    strncmp(name, base, base_len))
544 			continue;
545 
546 		slash = strrchr(prop, '/');
547 		if (strcmp(slash + 1, find_name))
548 			continue;
549 		val = trailing_strtol(name);
550 		if (val != -1) {
551 			*seqp = val;
552 			debug("Found seq %d\n", *seqp);
553 			return 0;
554 		}
555 	}
556 
557 	debug("Not found\n");
558 	return -ENOENT;
559 }
560 
561 const char *fdtdec_get_chosen_prop(const void *blob, const char *name)
562 {
563 	int chosen_node;
564 
565 	if (!blob)
566 		return NULL;
567 	chosen_node = fdt_path_offset(blob, "/chosen");
568 	return fdt_getprop(blob, chosen_node, name, NULL);
569 }
570 
571 int fdtdec_get_chosen_node(const void *blob, const char *name)
572 {
573 	const char *prop;
574 
575 	prop = fdtdec_get_chosen_prop(blob, name);
576 	if (!prop)
577 		return -FDT_ERR_NOTFOUND;
578 	return fdt_path_offset(blob, prop);
579 }
580 
581 int fdtdec_check_fdt(void)
582 {
583 	/*
584 	 * We must have an FDT, but we cannot panic() yet since the console
585 	 * is not ready. So for now, just assert(). Boards which need an early
586 	 * FDT (prior to console ready) will need to make their own
587 	 * arrangements and do their own checks.
588 	 */
589 	assert(!fdtdec_prepare_fdt());
590 	return 0;
591 }
592 
593 /*
594  * This function is a little odd in that it accesses global data. At some
595  * point if the architecture board.c files merge this will make more sense.
596  * Even now, it is common code.
597  */
598 int fdtdec_prepare_fdt(void)
599 {
600 	if (!gd->fdt_blob || ((uintptr_t)gd->fdt_blob & 3) ||
601 	    fdt_check_header(gd->fdt_blob)) {
602 #ifdef CONFIG_SPL_BUILD
603 		puts("Missing DTB\n");
604 #else
605 		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");
606 # ifdef DEBUG
607 		if (gd->fdt_blob) {
608 			printf("fdt_blob=%p\n", gd->fdt_blob);
609 			print_buffer((ulong)gd->fdt_blob, gd->fdt_blob, 4,
610 				     32, 0);
611 		}
612 # endif
613 #endif
614 		return -1;
615 	}
616 	return 0;
617 }
618 
619 int fdtdec_lookup_phandle(const void *blob, int node, const char *prop_name)
620 {
621 	const u32 *phandle;
622 	int lookup;
623 
624 	debug("%s: %s\n", __func__, prop_name);
625 	phandle = fdt_getprop(blob, node, prop_name, NULL);
626 	if (!phandle)
627 		return -FDT_ERR_NOTFOUND;
628 
629 	lookup = fdt_node_offset_by_phandle(blob, fdt32_to_cpu(*phandle));
630 	return lookup;
631 }
632 
633 /**
634  * Look up a property in a node and check that it has a minimum length.
635  *
636  * @param blob		FDT blob
637  * @param node		node to examine
638  * @param prop_name	name of property to find
639  * @param min_len	minimum property length in bytes
640  * @param err		0 if ok, or -FDT_ERR_NOTFOUND if the property is not
641 			found, or -FDT_ERR_BADLAYOUT if not enough data
642  * @return pointer to cell, which is only valid if err == 0
643  */
644 static const void *get_prop_check_min_len(const void *blob, int node,
645 		const char *prop_name, int min_len, int *err)
646 {
647 	const void *cell;
648 	int len;
649 
650 	debug("%s: %s\n", __func__, prop_name);
651 	cell = fdt_getprop(blob, node, prop_name, &len);
652 	if (!cell)
653 		*err = -FDT_ERR_NOTFOUND;
654 	else if (len < min_len)
655 		*err = -FDT_ERR_BADLAYOUT;
656 	else
657 		*err = 0;
658 	return cell;
659 }
660 
661 int fdtdec_get_int_array(const void *blob, int node, const char *prop_name,
662 		u32 *array, int count)
663 {
664 	const u32 *cell;
665 	int i, err = 0;
666 
667 	debug("%s: %s\n", __func__, prop_name);
668 	cell = get_prop_check_min_len(blob, node, prop_name,
669 				      sizeof(u32) * count, &err);
670 	if (!err) {
671 		for (i = 0; i < count; i++)
672 			array[i] = fdt32_to_cpu(cell[i]);
673 	}
674 	return err;
675 }
676 
677 int fdtdec_get_int_array_count(const void *blob, int node,
678 			       const char *prop_name, u32 *array, int count)
679 {
680 	const u32 *cell;
681 	int len, elems;
682 	int i;
683 
684 	debug("%s: %s\n", __func__, prop_name);
685 	cell = fdt_getprop(blob, node, prop_name, &len);
686 	if (!cell)
687 		return -FDT_ERR_NOTFOUND;
688 	elems = len / sizeof(u32);
689 	if (count > elems)
690 		count = elems;
691 	for (i = 0; i < count; i++)
692 		array[i] = fdt32_to_cpu(cell[i]);
693 
694 	return count;
695 }
696 
697 const u32 *fdtdec_locate_array(const void *blob, int node,
698 			       const char *prop_name, int count)
699 {
700 	const u32 *cell;
701 	int err;
702 
703 	cell = get_prop_check_min_len(blob, node, prop_name,
704 				      sizeof(u32) * count, &err);
705 	return err ? NULL : cell;
706 }
707 
708 int fdtdec_get_bool(const void *blob, int node, const char *prop_name)
709 {
710 	const s32 *cell;
711 	int len;
712 
713 	debug("%s: %s\n", __func__, prop_name);
714 	cell = fdt_getprop(blob, node, prop_name, &len);
715 	return cell != NULL;
716 }
717 
718 int fdtdec_parse_phandle_with_args(const void *blob, int src_node,
719 				   const char *list_name,
720 				   const char *cells_name,
721 				   int cell_count, int index,
722 				   struct fdtdec_phandle_args *out_args)
723 {
724 	const __be32 *list, *list_end;
725 	int rc = 0, size, cur_index = 0;
726 	uint32_t count = 0;
727 	int node = -1;
728 	int phandle;
729 
730 	/* Retrieve the phandle list property */
731 	list = fdt_getprop(blob, src_node, list_name, &size);
732 	if (!list)
733 		return -ENOENT;
734 	list_end = list + size / sizeof(*list);
735 
736 	/* Loop over the phandles until all the requested entry is found */
737 	while (list < list_end) {
738 		rc = -EINVAL;
739 		count = 0;
740 
741 		/*
742 		 * If phandle is 0, then it is an empty entry with no
743 		 * arguments.  Skip forward to the next entry.
744 		 */
745 		phandle = be32_to_cpup(list++);
746 		if (phandle) {
747 			/*
748 			 * Find the provider node and parse the #*-cells
749 			 * property to determine the argument length.
750 			 *
751 			 * This is not needed if the cell count is hard-coded
752 			 * (i.e. cells_name not set, but cell_count is set),
753 			 * except when we're going to return the found node
754 			 * below.
755 			 */
756 			if (cells_name || cur_index == index) {
757 				node = fdt_node_offset_by_phandle(blob,
758 								  phandle);
759 				if (!node) {
760 					debug("%s: could not find phandle\n",
761 					      fdt_get_name(blob, src_node,
762 							   NULL));
763 					goto err;
764 				}
765 			}
766 
767 			if (cells_name) {
768 				count = fdtdec_get_int(blob, node, cells_name,
769 						       -1);
770 				if (count == -1) {
771 					debug("%s: could not get %s for %s\n",
772 					      fdt_get_name(blob, src_node,
773 							   NULL),
774 					      cells_name,
775 					      fdt_get_name(blob, node,
776 							   NULL));
777 					goto err;
778 				}
779 			} else {
780 				count = cell_count;
781 			}
782 
783 			/*
784 			 * Make sure that the arguments actually fit in the
785 			 * remaining property data length
786 			 */
787 			if (list + count > list_end) {
788 				debug("%s: arguments longer than property\n",
789 				      fdt_get_name(blob, src_node, NULL));
790 				goto err;
791 			}
792 		}
793 
794 		/*
795 		 * All of the error cases above bail out of the loop, so at
796 		 * this point, the parsing is successful. If the requested
797 		 * index matches, then fill the out_args structure and return,
798 		 * or return -ENOENT for an empty entry.
799 		 */
800 		rc = -ENOENT;
801 		if (cur_index == index) {
802 			if (!phandle)
803 				goto err;
804 
805 			if (out_args) {
806 				int i;
807 
808 				if (count > MAX_PHANDLE_ARGS) {
809 					debug("%s: too many arguments %d\n",
810 					      fdt_get_name(blob, src_node,
811 							   NULL), count);
812 					count = MAX_PHANDLE_ARGS;
813 				}
814 				out_args->node = node;
815 				out_args->args_count = count;
816 				for (i = 0; i < count; i++) {
817 					out_args->args[i] =
818 							be32_to_cpup(list++);
819 				}
820 			}
821 
822 			/* Found it! return success */
823 			return 0;
824 		}
825 
826 		node = -1;
827 		list += count;
828 		cur_index++;
829 	}
830 
831 	/*
832 	 * Result will be one of:
833 	 * -ENOENT : index is for empty phandle
834 	 * -EINVAL : parsing error on data
835 	 * [1..n]  : Number of phandle (count mode; when index = -1)
836 	 */
837 	rc = index < 0 ? cur_index : -ENOENT;
838  err:
839 	return rc;
840 }
841 
842 int fdtdec_get_child_count(const void *blob, int node)
843 {
844 	int subnode;
845 	int num = 0;
846 
847 	fdt_for_each_subnode(subnode, blob, node)
848 		num++;
849 
850 	return num;
851 }
852 
853 int fdtdec_get_byte_array(const void *blob, int node, const char *prop_name,
854 		u8 *array, int count)
855 {
856 	const u8 *cell;
857 	int err;
858 
859 	cell = get_prop_check_min_len(blob, node, prop_name, count, &err);
860 	if (!err)
861 		memcpy(array, cell, count);
862 	return err;
863 }
864 
865 const u8 *fdtdec_locate_byte_array(const void *blob, int node,
866 			     const char *prop_name, int count)
867 {
868 	const u8 *cell;
869 	int err;
870 
871 	cell = get_prop_check_min_len(blob, node, prop_name, count, &err);
872 	if (err)
873 		return NULL;
874 	return cell;
875 }
876 
877 int fdtdec_get_config_int(const void *blob, const char *prop_name,
878 		int default_val)
879 {
880 	int config_node;
881 
882 	debug("%s: %s\n", __func__, prop_name);
883 	config_node = fdt_path_offset(blob, "/config");
884 	if (config_node < 0)
885 		return default_val;
886 	return fdtdec_get_int(blob, config_node, prop_name, default_val);
887 }
888 
889 int fdtdec_get_config_bool(const void *blob, const char *prop_name)
890 {
891 	int config_node;
892 	const void *prop;
893 
894 	debug("%s: %s\n", __func__, prop_name);
895 	config_node = fdt_path_offset(blob, "/config");
896 	if (config_node < 0)
897 		return 0;
898 	prop = fdt_get_property(blob, config_node, prop_name, NULL);
899 
900 	return prop != NULL;
901 }
902 
903 char *fdtdec_get_config_string(const void *blob, const char *prop_name)
904 {
905 	const char *nodep;
906 	int nodeoffset;
907 	int len;
908 
909 	debug("%s: %s\n", __func__, prop_name);
910 	nodeoffset = fdt_path_offset(blob, "/config");
911 	if (nodeoffset < 0)
912 		return NULL;
913 
914 	nodep = fdt_getprop(blob, nodeoffset, prop_name, &len);
915 	if (!nodep)
916 		return NULL;
917 
918 	return (char *)nodep;
919 }
920 
921 int fdtdec_decode_region(const void *blob, int node, const char *prop_name,
922 			 fdt_addr_t *basep, fdt_size_t *sizep)
923 {
924 	const fdt_addr_t *cell;
925 	int len;
926 
927 	debug("%s: %s: %s\n", __func__, fdt_get_name(blob, node, NULL),
928 	      prop_name);
929 	cell = fdt_getprop(blob, node, prop_name, &len);
930 	if (!cell || (len < sizeof(fdt_addr_t) * 2)) {
931 		debug("cell=%p, len=%d\n", cell, len);
932 		return -1;
933 	}
934 
935 	*basep = fdt_addr_to_cpu(*cell);
936 	*sizep = fdt_size_to_cpu(cell[1]);
937 	debug("%s: base=%08lx, size=%lx\n", __func__, (ulong)*basep,
938 	      (ulong)*sizep);
939 
940 	return 0;
941 }
942 
943 /**
944  * Read a flash entry from the fdt
945  *
946  * @param blob		FDT blob
947  * @param node		Offset of node to read
948  * @param name		Name of node being read
949  * @param entry		Place to put offset and size of this node
950  * @return 0 if ok, -ve on error
951  */
952 int fdtdec_read_fmap_entry(const void *blob, int node, const char *name,
953 			   struct fmap_entry *entry)
954 {
955 	const char *prop;
956 	u32 reg[2];
957 
958 	if (fdtdec_get_int_array(blob, node, "reg", reg, 2)) {
959 		debug("Node '%s' has bad/missing 'reg' property\n", name);
960 		return -FDT_ERR_NOTFOUND;
961 	}
962 	entry->offset = reg[0];
963 	entry->length = reg[1];
964 	entry->used = fdtdec_get_int(blob, node, "used", entry->length);
965 	prop = fdt_getprop(blob, node, "compress", NULL);
966 	entry->compress_algo = prop && !strcmp(prop, "lzo") ?
967 		FMAP_COMPRESS_LZO : FMAP_COMPRESS_NONE;
968 	prop = fdt_getprop(blob, node, "hash", &entry->hash_size);
969 	entry->hash_algo = prop ? FMAP_HASH_SHA256 : FMAP_HASH_NONE;
970 	entry->hash = (uint8_t *)prop;
971 
972 	return 0;
973 }
974 
975 u64 fdtdec_get_number(const fdt32_t *ptr, unsigned int cells)
976 {
977 	u64 number = 0;
978 
979 	while (cells--)
980 		number = (number << 32) | fdt32_to_cpu(*ptr++);
981 
982 	return number;
983 }
984 
985 int fdt_get_resource(const void *fdt, int node, const char *property,
986 		     unsigned int index, struct fdt_resource *res)
987 {
988 	const fdt32_t *ptr, *end;
989 	int na, ns, len, parent;
990 	unsigned int i = 0;
991 
992 	parent = fdt_parent_offset(fdt, node);
993 	if (parent < 0)
994 		return parent;
995 
996 	na = fdt_address_cells(fdt, parent);
997 	ns = fdt_size_cells(fdt, parent);
998 
999 	ptr = fdt_getprop(fdt, node, property, &len);
1000 	if (!ptr)
1001 		return len;
1002 
1003 	end = ptr + len / sizeof(*ptr);
1004 
1005 	while (ptr + na + ns <= end) {
1006 		if (i == index) {
1007 			res->start = res->end = fdtdec_get_number(ptr, na);
1008 			res->end += fdtdec_get_number(&ptr[na], ns) - 1;
1009 			return 0;
1010 		}
1011 
1012 		ptr += na + ns;
1013 		i++;
1014 	}
1015 
1016 	return -FDT_ERR_NOTFOUND;
1017 }
1018 
1019 int fdt_get_named_resource(const void *fdt, int node, const char *property,
1020 			   const char *prop_names, const char *name,
1021 			   struct fdt_resource *res)
1022 {
1023 	int index;
1024 
1025 	index = fdt_stringlist_search(fdt, node, prop_names, name);
1026 	if (index < 0)
1027 		return index;
1028 
1029 	return fdt_get_resource(fdt, node, property, index, res);
1030 }
1031 
1032 int fdtdec_decode_memory_region(const void *blob, int config_node,
1033 				const char *mem_type, const char *suffix,
1034 				fdt_addr_t *basep, fdt_size_t *sizep)
1035 {
1036 	char prop_name[50];
1037 	const char *mem;
1038 	fdt_size_t size, offset_size;
1039 	fdt_addr_t base, offset;
1040 	int node;
1041 
1042 	if (config_node == -1) {
1043 		config_node = fdt_path_offset(blob, "/config");
1044 		if (config_node < 0) {
1045 			debug("%s: Cannot find /config node\n", __func__);
1046 			return -ENOENT;
1047 		}
1048 	}
1049 	if (!suffix)
1050 		suffix = "";
1051 
1052 	snprintf(prop_name, sizeof(prop_name), "%s-memory%s", mem_type,
1053 		 suffix);
1054 	mem = fdt_getprop(blob, config_node, prop_name, NULL);
1055 	if (!mem) {
1056 		debug("%s: No memory type for '%s', using /memory\n", __func__,
1057 		      prop_name);
1058 		mem = "/memory";
1059 	}
1060 
1061 	node = fdt_path_offset(blob, mem);
1062 	if (node < 0) {
1063 		debug("%s: Failed to find node '%s': %s\n", __func__, mem,
1064 		      fdt_strerror(node));
1065 		return -ENOENT;
1066 	}
1067 
1068 	/*
1069 	 * Not strictly correct - the memory may have multiple banks. We just
1070 	 * use the first
1071 	 */
1072 	if (fdtdec_decode_region(blob, node, "reg", &base, &size)) {
1073 		debug("%s: Failed to decode memory region %s\n", __func__,
1074 		      mem);
1075 		return -EINVAL;
1076 	}
1077 
1078 	snprintf(prop_name, sizeof(prop_name), "%s-offset%s", mem_type,
1079 		 suffix);
1080 	if (fdtdec_decode_region(blob, config_node, prop_name, &offset,
1081 				 &offset_size)) {
1082 		debug("%s: Failed to decode memory region '%s'\n", __func__,
1083 		      prop_name);
1084 		return -EINVAL;
1085 	}
1086 
1087 	*basep = base + offset;
1088 	*sizep = offset_size;
1089 
1090 	return 0;
1091 }
1092 
1093 static int decode_timing_property(const void *blob, int node, const char *name,
1094 				  struct timing_entry *result)
1095 {
1096 	int length, ret = 0;
1097 	const u32 *prop;
1098 
1099 	prop = fdt_getprop(blob, node, name, &length);
1100 	if (!prop) {
1101 		debug("%s: could not find property %s\n",
1102 		      fdt_get_name(blob, node, NULL), name);
1103 		return length;
1104 	}
1105 
1106 	if (length == sizeof(u32)) {
1107 		result->typ = fdtdec_get_int(blob, node, name, 0);
1108 		result->min = result->typ;
1109 		result->max = result->typ;
1110 	} else {
1111 		ret = fdtdec_get_int_array(blob, node, name, &result->min, 3);
1112 	}
1113 
1114 	return ret;
1115 }
1116 
1117 int fdtdec_decode_display_timing(const void *blob, int parent, int index,
1118 				 struct display_timing *dt)
1119 {
1120 	int i, node, timings_node;
1121 	u32 val = 0;
1122 	int ret = 0;
1123 
1124 	timings_node = fdt_subnode_offset(blob, parent, "display-timings");
1125 	if (timings_node < 0)
1126 		return timings_node;
1127 
1128 	for (i = 0, node = fdt_first_subnode(blob, timings_node);
1129 	     node > 0 && i != index;
1130 	     node = fdt_next_subnode(blob, node))
1131 		i++;
1132 
1133 	if (node < 0)
1134 		return node;
1135 
1136 	memset(dt, 0, sizeof(*dt));
1137 
1138 	ret |= decode_timing_property(blob, node, "hback-porch",
1139 				      &dt->hback_porch);
1140 	ret |= decode_timing_property(blob, node, "hfront-porch",
1141 				      &dt->hfront_porch);
1142 	ret |= decode_timing_property(blob, node, "hactive", &dt->hactive);
1143 	ret |= decode_timing_property(blob, node, "hsync-len", &dt->hsync_len);
1144 	ret |= decode_timing_property(blob, node, "vback-porch",
1145 				      &dt->vback_porch);
1146 	ret |= decode_timing_property(blob, node, "vfront-porch",
1147 				      &dt->vfront_porch);
1148 	ret |= decode_timing_property(blob, node, "vactive", &dt->vactive);
1149 	ret |= decode_timing_property(blob, node, "vsync-len", &dt->vsync_len);
1150 	ret |= decode_timing_property(blob, node, "clock-frequency",
1151 				      &dt->pixelclock);
1152 
1153 	dt->flags = 0;
1154 	val = fdtdec_get_int(blob, node, "vsync-active", -1);
1155 	if (val != -1) {
1156 		dt->flags |= val ? DISPLAY_FLAGS_VSYNC_HIGH :
1157 				DISPLAY_FLAGS_VSYNC_LOW;
1158 	}
1159 	val = fdtdec_get_int(blob, node, "hsync-active", -1);
1160 	if (val != -1) {
1161 		dt->flags |= val ? DISPLAY_FLAGS_HSYNC_HIGH :
1162 				DISPLAY_FLAGS_HSYNC_LOW;
1163 	}
1164 	val = fdtdec_get_int(blob, node, "de-active", -1);
1165 	if (val != -1) {
1166 		dt->flags |= val ? DISPLAY_FLAGS_DE_HIGH :
1167 				DISPLAY_FLAGS_DE_LOW;
1168 	}
1169 	val = fdtdec_get_int(blob, node, "pixelclk-active", -1);
1170 	if (val != -1) {
1171 		dt->flags |= val ? DISPLAY_FLAGS_PIXDATA_POSEDGE :
1172 				DISPLAY_FLAGS_PIXDATA_NEGEDGE;
1173 	}
1174 
1175 	if (fdtdec_get_bool(blob, node, "interlaced"))
1176 		dt->flags |= DISPLAY_FLAGS_INTERLACED;
1177 	if (fdtdec_get_bool(blob, node, "doublescan"))
1178 		dt->flags |= DISPLAY_FLAGS_DOUBLESCAN;
1179 	if (fdtdec_get_bool(blob, node, "doubleclk"))
1180 		dt->flags |= DISPLAY_FLAGS_DOUBLECLK;
1181 
1182 	return ret;
1183 }
1184 
1185 int fdtdec_setup_memory_size(void)
1186 {
1187 	int ret, mem;
1188 	struct fdt_resource res;
1189 
1190 	mem = fdt_path_offset(gd->fdt_blob, "/memory");
1191 	if (mem < 0) {
1192 		debug("%s: Missing /memory node\n", __func__);
1193 		return -EINVAL;
1194 	}
1195 
1196 	ret = fdt_get_resource(gd->fdt_blob, mem, "reg", 0, &res);
1197 	if (ret != 0) {
1198 		debug("%s: Unable to decode first memory bank\n", __func__);
1199 		return -EINVAL;
1200 	}
1201 
1202 	gd->ram_size = (phys_size_t)(res.end - res.start + 1);
1203 	debug("%s: Initial DRAM size %llx\n", __func__, (u64)gd->ram_size);
1204 
1205 	return 0;
1206 }
1207 
1208 #if defined(CONFIG_NR_DRAM_BANKS)
1209 int fdtdec_setup_memory_banksize(void)
1210 {
1211 	int bank, ret, mem;
1212 	struct fdt_resource res;
1213 
1214 	mem = fdt_path_offset(gd->fdt_blob, "/memory");
1215 	if (mem < 0) {
1216 		debug("%s: Missing /memory node\n", __func__);
1217 		return -EINVAL;
1218 	}
1219 
1220 	for (bank = 0; bank < CONFIG_NR_DRAM_BANKS; bank++) {
1221 		ret = fdt_get_resource(gd->fdt_blob, mem, "reg", bank, &res);
1222 		if (ret == -FDT_ERR_NOTFOUND)
1223 			break;
1224 		if (ret != 0)
1225 			return -EINVAL;
1226 
1227 		gd->bd->bi_dram[bank].start = (phys_addr_t)res.start;
1228 		gd->bd->bi_dram[bank].size =
1229 			(phys_size_t)(res.end - res.start + 1);
1230 
1231 		debug("%s: DRAM Bank #%d: start = 0x%llx, size = 0x%llx\n",
1232 		      __func__, bank,
1233 		      (unsigned long long)gd->bd->bi_dram[bank].start,
1234 		      (unsigned long long)gd->bd->bi_dram[bank].size);
1235 	}
1236 
1237 	return 0;
1238 }
1239 #endif
1240 
1241 int fdtdec_setup(void)
1242 {
1243 #if CONFIG_IS_ENABLED(OF_CONTROL)
1244 # ifdef CONFIG_OF_EMBED
1245 	/* Get a pointer to the FDT */
1246 	gd->fdt_blob = __dtb_dt_begin;
1247 # elif defined CONFIG_OF_SEPARATE
1248 #  ifdef CONFIG_SPL_BUILD
1249 	/* FDT is at end of BSS unless it is in a different memory region */
1250 	if (IS_ENABLED(CONFIG_SPL_SEPARATE_BSS))
1251 		gd->fdt_blob = (ulong *)&_image_binary_end;
1252 	else
1253 		gd->fdt_blob = (ulong *)&__bss_end;
1254 #  else
1255 	/* FDT is at end of image */
1256 	gd->fdt_blob = (ulong *)&_end;
1257 #  endif
1258 # elif defined(CONFIG_OF_BOARD)
1259 	/* Allow the board to override the fdt address. */
1260 	gd->fdt_blob = board_fdt_blob_setup();
1261 # elif defined(CONFIG_OF_HOSTFILE)
1262 	if (sandbox_read_fdt_from_file()) {
1263 		puts("Failed to read control FDT\n");
1264 		return -1;
1265 	}
1266 # endif
1267 # ifndef CONFIG_SPL_BUILD
1268 	/* Allow the early environment to override the fdt address */
1269 	gd->fdt_blob = (void *)getenv_ulong("fdtcontroladdr", 16,
1270 						(uintptr_t)gd->fdt_blob);
1271 # endif
1272 #endif
1273 	return fdtdec_prepare_fdt();
1274 }
1275 
1276 #endif /* !USE_HOSTCC */
1277