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