xref: /openbmc/u-boot/lib/fdtdec.c (revision 3ac83935)
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 <errno.h>
9 #include <serial.h>
10 #include <libfdt.h>
11 #include <fdtdec.h>
12 #include <linux/ctype.h>
13 
14 #include <asm/gpio.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_USB, "nvidia,tegra20-ehci"),
27 	COMPAT(NVIDIA_TEGRA30_USB, "nvidia,tegra30-ehci"),
28 	COMPAT(NVIDIA_TEGRA114_USB, "nvidia,tegra114-ehci"),
29 	COMPAT(NVIDIA_TEGRA114_I2C, "nvidia,tegra114-i2c"),
30 	COMPAT(NVIDIA_TEGRA20_I2C, "nvidia,tegra20-i2c"),
31 	COMPAT(NVIDIA_TEGRA20_DVC, "nvidia,tegra20-i2c-dvc"),
32 	COMPAT(NVIDIA_TEGRA20_EMC, "nvidia,tegra20-emc"),
33 	COMPAT(NVIDIA_TEGRA20_EMC_TABLE, "nvidia,tegra20-emc-table"),
34 	COMPAT(NVIDIA_TEGRA20_KBC, "nvidia,tegra20-kbc"),
35 	COMPAT(NVIDIA_TEGRA20_NAND, "nvidia,tegra20-nand"),
36 	COMPAT(NVIDIA_TEGRA20_PWM, "nvidia,tegra20-pwm"),
37 	COMPAT(NVIDIA_TEGRA20_DC, "nvidia,tegra20-dc"),
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_TEGRA20_SFLASH, "nvidia,tegra20-sflash"),
42 	COMPAT(NVIDIA_TEGRA20_SLINK, "nvidia,tegra20-slink"),
43 	COMPAT(NVIDIA_TEGRA114_SPI, "nvidia,tegra114-spi"),
44 	COMPAT(SMSC_LAN9215, "smsc,lan9215"),
45 	COMPAT(SAMSUNG_EXYNOS5_SROMC, "samsung,exynos-sromc"),
46 	COMPAT(SAMSUNG_S3C2440_I2C, "samsung,s3c2440-i2c"),
47 	COMPAT(SAMSUNG_EXYNOS5_SOUND, "samsung,exynos-sound"),
48 	COMPAT(WOLFSON_WM8994_CODEC, "wolfson,wm8994-codec"),
49 	COMPAT(SAMSUNG_EXYNOS_SPI, "samsung,exynos-spi"),
50 	COMPAT(GOOGLE_CROS_EC, "google,cros-ec"),
51 	COMPAT(GOOGLE_CROS_EC_KEYB, "google,cros-ec-keyb"),
52 	COMPAT(SAMSUNG_EXYNOS_EHCI, "samsung,exynos-ehci"),
53 	COMPAT(SAMSUNG_EXYNOS5_XHCI, "samsung,exynos5250-xhci"),
54 	COMPAT(SAMSUNG_EXYNOS_USB_PHY, "samsung,exynos-usb-phy"),
55 	COMPAT(SAMSUNG_EXYNOS5_USB3_PHY, "samsung,exynos5250-usb3-phy"),
56 	COMPAT(SAMSUNG_EXYNOS_TMU, "samsung,exynos-tmu"),
57 	COMPAT(SAMSUNG_EXYNOS_FIMD, "samsung,exynos-fimd"),
58 	COMPAT(SAMSUNG_EXYNOS_MIPI_DSI, "samsung,exynos-mipi-dsi"),
59 	COMPAT(SAMSUNG_EXYNOS5_DP, "samsung,exynos5-dp"),
60 	COMPAT(SAMSUNG_EXYNOS_DWMMC, "samsung,exynos-dwmmc"),
61 	COMPAT(SAMSUNG_EXYNOS_MMC, "samsung,exynos-mmc"),
62 	COMPAT(SAMSUNG_EXYNOS_SERIAL, "samsung,exynos4210-uart"),
63 	COMPAT(MAXIM_MAX77686_PMIC, "maxim,max77686_pmic"),
64 	COMPAT(GENERIC_SPI_FLASH, "spi-flash"),
65 	COMPAT(MAXIM_98095_CODEC, "maxim,max98095-codec"),
66 	COMPAT(INFINEON_SLB9635_TPM, "infineon,slb9635-tpm"),
67 	COMPAT(INFINEON_SLB9645_TPM, "infineon,slb9645-tpm"),
68 	COMPAT(SAMSUNG_EXYNOS5_I2C, "samsung,exynos5-hsi2c"),
69 	COMPAT(SANDBOX_HOST_EMULATION, "sandbox,host-emulation"),
70 	COMPAT(SANDBOX_LCD_SDL, "sandbox,lcd-sdl"),
71 	COMPAT(TI_TPS65090, "ti,tps65090"),
72 	COMPAT(COMPAT_NXP_PTN3460, "nxp,ptn3460"),
73 	COMPAT(SAMSUNG_EXYNOS_SYSMMU, "samsung,sysmmu-v3.3"),
74 	COMPAT(PARADE_PS8625, "parade,ps8625"),
75 	COMPAT(COMPAT_INTEL_LPC, "intel,lpc"),
76 	COMPAT(INTEL_MICROCODE, "intel,microcode"),
77 	COMPAT(MEMORY_SPD, "memory-spd"),
78 	COMPAT(INTEL_PANTHERPOINT_AHCI, "intel,pantherpoint-ahci"),
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(const void *blob, int node,
89 		const char *prop_name, fdt_size_t *sizep)
90 {
91 	const fdt_addr_t *cell;
92 	int len;
93 
94 	debug("%s: %s: ", __func__, prop_name);
95 	cell = fdt_getprop(blob, node, prop_name, &len);
96 	if (cell && ((!sizep && len == sizeof(fdt_addr_t)) ||
97 		     len == sizeof(fdt_addr_t) * 2)) {
98 		fdt_addr_t addr = fdt_addr_to_cpu(*cell);
99 		if (sizep) {
100 			const fdt_size_t *size;
101 
102 			size = (fdt_size_t *)((char *)cell +
103 					sizeof(fdt_addr_t));
104 			*sizep = fdt_size_to_cpu(*size);
105 			debug("addr=%08lx, size=%08x\n",
106 			      (ulong)addr, *sizep);
107 		} else {
108 			debug("%08lx\n", (ulong)addr);
109 		}
110 		return addr;
111 	}
112 	debug("(not found)\n");
113 	return FDT_ADDR_T_NONE;
114 }
115 
116 fdt_addr_t fdtdec_get_addr(const void *blob, int node,
117 		const char *prop_name)
118 {
119 	return fdtdec_get_addr_size(blob, node, prop_name, NULL);
120 }
121 
122 uint64_t fdtdec_get_uint64(const void *blob, int node, const char *prop_name,
123 		uint64_t default_val)
124 {
125 	const uint64_t *cell64;
126 	int length;
127 
128 	cell64 = fdt_getprop(blob, node, prop_name, &length);
129 	if (!cell64 || length < sizeof(*cell64))
130 		return default_val;
131 
132 	return fdt64_to_cpu(*cell64);
133 }
134 
135 int fdtdec_get_is_enabled(const void *blob, int node)
136 {
137 	const char *cell;
138 
139 	/*
140 	 * It should say "okay", so only allow that. Some fdts use "ok" but
141 	 * this is a bug. Please fix your device tree source file. See here
142 	 * for discussion:
143 	 *
144 	 * http://www.mail-archive.com/u-boot@lists.denx.de/msg71598.html
145 	 */
146 	cell = fdt_getprop(blob, node, "status", NULL);
147 	if (cell)
148 		return 0 == strcmp(cell, "okay");
149 	return 1;
150 }
151 
152 enum fdt_compat_id fdtdec_lookup(const void *blob, int node)
153 {
154 	enum fdt_compat_id id;
155 
156 	/* Search our drivers */
157 	for (id = COMPAT_UNKNOWN; id < COMPAT_COUNT; id++)
158 		if (0 == fdt_node_check_compatible(blob, node,
159 				compat_names[id]))
160 			return id;
161 	return COMPAT_UNKNOWN;
162 }
163 
164 int fdtdec_next_compatible(const void *blob, int node,
165 		enum fdt_compat_id id)
166 {
167 	return fdt_node_offset_by_compatible(blob, node, compat_names[id]);
168 }
169 
170 int fdtdec_next_compatible_subnode(const void *blob, int node,
171 		enum fdt_compat_id id, int *depthp)
172 {
173 	do {
174 		node = fdt_next_node(blob, node, depthp);
175 	} while (*depthp > 1);
176 
177 	/* If this is a direct subnode, and compatible, return it */
178 	if (*depthp == 1 && 0 == fdt_node_check_compatible(
179 						blob, node, compat_names[id]))
180 		return node;
181 
182 	return -FDT_ERR_NOTFOUND;
183 }
184 
185 int fdtdec_next_alias(const void *blob, const char *name,
186 		enum fdt_compat_id id, int *upto)
187 {
188 #define MAX_STR_LEN 20
189 	char str[MAX_STR_LEN + 20];
190 	int node, err;
191 
192 	/* snprintf() is not available */
193 	assert(strlen(name) < MAX_STR_LEN);
194 	sprintf(str, "%.*s%d", MAX_STR_LEN, name, *upto);
195 	node = fdt_path_offset(blob, str);
196 	if (node < 0)
197 		return node;
198 	err = fdt_node_check_compatible(blob, node, compat_names[id]);
199 	if (err < 0)
200 		return err;
201 	if (err)
202 		return -FDT_ERR_NOTFOUND;
203 	(*upto)++;
204 	return node;
205 }
206 
207 int fdtdec_find_aliases_for_id(const void *blob, const char *name,
208 			enum fdt_compat_id id, int *node_list, int maxcount)
209 {
210 	memset(node_list, '\0', sizeof(*node_list) * maxcount);
211 
212 	return fdtdec_add_aliases_for_id(blob, name, id, node_list, maxcount);
213 }
214 
215 /* TODO: Can we tighten this code up a little? */
216 int fdtdec_add_aliases_for_id(const void *blob, const char *name,
217 			enum fdt_compat_id id, int *node_list, int maxcount)
218 {
219 	int name_len = strlen(name);
220 	int nodes[maxcount];
221 	int num_found = 0;
222 	int offset, node;
223 	int alias_node;
224 	int count;
225 	int i, j;
226 
227 	/* find the alias node if present */
228 	alias_node = fdt_path_offset(blob, "/aliases");
229 
230 	/*
231 	 * start with nothing, and we can assume that the root node can't
232 	 * match
233 	 */
234 	memset(nodes, '\0', sizeof(nodes));
235 
236 	/* First find all the compatible nodes */
237 	for (node = count = 0; node >= 0 && count < maxcount;) {
238 		node = fdtdec_next_compatible(blob, node, id);
239 		if (node >= 0)
240 			nodes[count++] = node;
241 	}
242 	if (node >= 0)
243 		debug("%s: warning: maxcount exceeded with alias '%s'\n",
244 		       __func__, name);
245 
246 	/* Now find all the aliases */
247 	for (offset = fdt_first_property_offset(blob, alias_node);
248 			offset > 0;
249 			offset = fdt_next_property_offset(blob, offset)) {
250 		const struct fdt_property *prop;
251 		const char *path;
252 		int number;
253 		int found;
254 
255 		node = 0;
256 		prop = fdt_get_property_by_offset(blob, offset, NULL);
257 		path = fdt_string(blob, fdt32_to_cpu(prop->nameoff));
258 		if (prop->len && 0 == strncmp(path, name, name_len))
259 			node = fdt_path_offset(blob, prop->data);
260 		if (node <= 0)
261 			continue;
262 
263 		/* Get the alias number */
264 		number = simple_strtoul(path + name_len, NULL, 10);
265 		if (number < 0 || number >= maxcount) {
266 			debug("%s: warning: alias '%s' is out of range\n",
267 			       __func__, path);
268 			continue;
269 		}
270 
271 		/* Make sure the node we found is actually in our list! */
272 		found = -1;
273 		for (j = 0; j < count; j++)
274 			if (nodes[j] == node) {
275 				found = j;
276 				break;
277 			}
278 
279 		if (found == -1) {
280 			debug("%s: warning: alias '%s' points to a node "
281 				"'%s' that is missing or is not compatible "
282 				" with '%s'\n", __func__, path,
283 				fdt_get_name(blob, node, NULL),
284 			       compat_names[id]);
285 			continue;
286 		}
287 
288 		/*
289 		 * Add this node to our list in the right place, and mark
290 		 * it as done.
291 		 */
292 		if (fdtdec_get_is_enabled(blob, node)) {
293 			if (node_list[number]) {
294 				debug("%s: warning: alias '%s' requires that "
295 				      "a node be placed in the list in a "
296 				      "position which is already filled by "
297 				      "node '%s'\n", __func__, path,
298 				      fdt_get_name(blob, node, NULL));
299 				continue;
300 			}
301 			node_list[number] = node;
302 			if (number >= num_found)
303 				num_found = number + 1;
304 		}
305 		nodes[found] = 0;
306 	}
307 
308 	/* Add any nodes not mentioned by an alias */
309 	for (i = j = 0; i < maxcount; i++) {
310 		if (!node_list[i]) {
311 			for (; j < maxcount; j++)
312 				if (nodes[j] &&
313 					fdtdec_get_is_enabled(blob, nodes[j]))
314 					break;
315 
316 			/* Have we run out of nodes to add? */
317 			if (j == maxcount)
318 				break;
319 
320 			assert(!node_list[i]);
321 			node_list[i] = nodes[j++];
322 			if (i >= num_found)
323 				num_found = i + 1;
324 		}
325 	}
326 
327 	return num_found;
328 }
329 
330 int fdtdec_get_alias_seq(const void *blob, const char *base, int offset,
331 			 int *seqp)
332 {
333 	int base_len = strlen(base);
334 	const char *find_name;
335 	int find_namelen;
336 	int prop_offset;
337 	int aliases;
338 
339 	find_name = fdt_get_name(blob, offset, &find_namelen);
340 	debug("Looking for '%s' at %d, name %s\n", base, offset, find_name);
341 
342 	aliases = fdt_path_offset(blob, "/aliases");
343 	for (prop_offset = fdt_first_property_offset(blob, aliases);
344 	     prop_offset > 0;
345 	     prop_offset = fdt_next_property_offset(blob, prop_offset)) {
346 		const char *prop;
347 		const char *name;
348 		const char *slash;
349 		const char *p;
350 		int len;
351 
352 		prop = fdt_getprop_by_offset(blob, prop_offset, &name, &len);
353 		debug("   - %s, %s\n", name, prop);
354 		if (len < find_namelen || *prop != '/' || prop[len - 1] ||
355 		    strncmp(name, base, base_len))
356 			continue;
357 
358 		slash = strrchr(prop, '/');
359 		if (strcmp(slash + 1, find_name))
360 			continue;
361 		for (p = name + strlen(name) - 1; p > name; p--) {
362 			if (!isdigit(*p)) {
363 				*seqp = simple_strtoul(p + 1, NULL, 10);
364 				debug("Found seq %d\n", *seqp);
365 				return 0;
366 			}
367 		}
368 	}
369 
370 	debug("Not found\n");
371 	return -ENOENT;
372 }
373 
374 int fdtdec_get_alias_node(const void *blob, const char *name)
375 {
376 	const char *prop;
377 	int alias_node;
378 	int len;
379 
380 	if (!blob)
381 		return -FDT_ERR_NOTFOUND;
382 	alias_node = fdt_path_offset(blob, "/aliases");
383 	prop = fdt_getprop(blob, alias_node, name, &len);
384 	if (!prop)
385 		return -FDT_ERR_NOTFOUND;
386 	return fdt_path_offset(blob, prop);
387 }
388 
389 int fdtdec_get_chosen_node(const void *blob, const char *name)
390 {
391 	const char *prop;
392 	int chosen_node;
393 	int len;
394 
395 	if (!blob)
396 		return -FDT_ERR_NOTFOUND;
397 	chosen_node = fdt_path_offset(blob, "/chosen");
398 	prop = fdt_getprop(blob, chosen_node, name, &len);
399 	if (!prop)
400 		return -FDT_ERR_NOTFOUND;
401 	return fdt_path_offset(blob, prop);
402 }
403 
404 int fdtdec_check_fdt(void)
405 {
406 	/*
407 	 * We must have an FDT, but we cannot panic() yet since the console
408 	 * is not ready. So for now, just assert(). Boards which need an early
409 	 * FDT (prior to console ready) will need to make their own
410 	 * arrangements and do their own checks.
411 	 */
412 	assert(!fdtdec_prepare_fdt());
413 	return 0;
414 }
415 
416 /*
417  * This function is a little odd in that it accesses global data. At some
418  * point if the architecture board.c files merge this will make more sense.
419  * Even now, it is common code.
420  */
421 int fdtdec_prepare_fdt(void)
422 {
423 	if (!gd->fdt_blob || ((uintptr_t)gd->fdt_blob & 3) ||
424 	    fdt_check_header(gd->fdt_blob)) {
425 		printf("No valid FDT found - please append one to U-Boot "
426 			"binary, use u-boot-dtb.bin or define "
427 			"CONFIG_OF_EMBED. For sandbox, use -d <file.dtb>\n");
428 		return -1;
429 	}
430 	return 0;
431 }
432 
433 int fdtdec_lookup_phandle(const void *blob, int node, const char *prop_name)
434 {
435 	const u32 *phandle;
436 	int lookup;
437 
438 	debug("%s: %s\n", __func__, prop_name);
439 	phandle = fdt_getprop(blob, node, prop_name, NULL);
440 	if (!phandle)
441 		return -FDT_ERR_NOTFOUND;
442 
443 	lookup = fdt_node_offset_by_phandle(blob, fdt32_to_cpu(*phandle));
444 	return lookup;
445 }
446 
447 /**
448  * Look up a property in a node and check that it has a minimum length.
449  *
450  * @param blob		FDT blob
451  * @param node		node to examine
452  * @param prop_name	name of property to find
453  * @param min_len	minimum property length in bytes
454  * @param err		0 if ok, or -FDT_ERR_NOTFOUND if the property is not
455 			found, or -FDT_ERR_BADLAYOUT if not enough data
456  * @return pointer to cell, which is only valid if err == 0
457  */
458 static const void *get_prop_check_min_len(const void *blob, int node,
459 		const char *prop_name, int min_len, int *err)
460 {
461 	const void *cell;
462 	int len;
463 
464 	debug("%s: %s\n", __func__, prop_name);
465 	cell = fdt_getprop(blob, node, prop_name, &len);
466 	if (!cell)
467 		*err = -FDT_ERR_NOTFOUND;
468 	else if (len < min_len)
469 		*err = -FDT_ERR_BADLAYOUT;
470 	else
471 		*err = 0;
472 	return cell;
473 }
474 
475 int fdtdec_get_int_array(const void *blob, int node, const char *prop_name,
476 		u32 *array, int count)
477 {
478 	const u32 *cell;
479 	int i, err = 0;
480 
481 	debug("%s: %s\n", __func__, prop_name);
482 	cell = get_prop_check_min_len(blob, node, prop_name,
483 				      sizeof(u32) * count, &err);
484 	if (!err) {
485 		for (i = 0; i < count; i++)
486 			array[i] = fdt32_to_cpu(cell[i]);
487 	}
488 	return err;
489 }
490 
491 int fdtdec_get_int_array_count(const void *blob, int node,
492 			       const char *prop_name, u32 *array, int count)
493 {
494 	const u32 *cell;
495 	int len, elems;
496 	int i;
497 
498 	debug("%s: %s\n", __func__, prop_name);
499 	cell = fdt_getprop(blob, node, prop_name, &len);
500 	if (!cell)
501 		return -FDT_ERR_NOTFOUND;
502 	elems = len / sizeof(u32);
503 	if (count > elems)
504 		count = elems;
505 	for (i = 0; i < count; i++)
506 		array[i] = fdt32_to_cpu(cell[i]);
507 
508 	return count;
509 }
510 
511 const u32 *fdtdec_locate_array(const void *blob, int node,
512 			       const char *prop_name, int count)
513 {
514 	const u32 *cell;
515 	int err;
516 
517 	cell = get_prop_check_min_len(blob, node, prop_name,
518 				      sizeof(u32) * count, &err);
519 	return err ? NULL : cell;
520 }
521 
522 int fdtdec_get_bool(const void *blob, int node, const char *prop_name)
523 {
524 	const s32 *cell;
525 	int len;
526 
527 	debug("%s: %s\n", __func__, prop_name);
528 	cell = fdt_getprop(blob, node, prop_name, &len);
529 	return cell != NULL;
530 }
531 
532 /**
533  * Decode a list of GPIOs from an FDT. This creates a list of GPIOs with no
534  * terminating item.
535  *
536  * @param blob		FDT blob to use
537  * @param node		Node to look at
538  * @param prop_name	Node property name
539  * @param gpio		Array of gpio elements to fill from FDT. This will be
540  *			untouched if either 0 or an error is returned
541  * @param max_count	Maximum number of elements allowed
542  * @return number of GPIOs read if ok, -FDT_ERR_BADLAYOUT if max_count would
543  * be exceeded, or -FDT_ERR_NOTFOUND if the property is missing.
544  */
545 int fdtdec_decode_gpios(const void *blob, int node, const char *prop_name,
546 		struct fdt_gpio_state *gpio, int max_count)
547 {
548 	const struct fdt_property *prop;
549 	const u32 *cell;
550 	const char *name;
551 	int len, i;
552 
553 	debug("%s: %s\n", __func__, prop_name);
554 	assert(max_count > 0);
555 	prop = fdt_get_property(blob, node, prop_name, &len);
556 	if (!prop) {
557 		debug("%s: property '%s' missing\n", __func__, prop_name);
558 		return -FDT_ERR_NOTFOUND;
559 	}
560 
561 	/* We will use the name to tag the GPIO */
562 	name = fdt_string(blob, fdt32_to_cpu(prop->nameoff));
563 	cell = (u32 *)prop->data;
564 	len /= sizeof(u32) * 3;		/* 3 cells per GPIO record */
565 	if (len > max_count) {
566 		debug(" %s: too many GPIOs / cells for "
567 			"property '%s'\n", __func__, prop_name);
568 		return -FDT_ERR_BADLAYOUT;
569 	}
570 
571 	/* Read out the GPIO data from the cells */
572 	for (i = 0; i < len; i++, cell += 3) {
573 		gpio[i].gpio = fdt32_to_cpu(cell[1]);
574 		gpio[i].flags = fdt32_to_cpu(cell[2]);
575 		gpio[i].name = name;
576 	}
577 
578 	return len;
579 }
580 
581 int fdtdec_decode_gpio(const void *blob, int node, const char *prop_name,
582 		struct fdt_gpio_state *gpio)
583 {
584 	int err;
585 
586 	debug("%s: %s\n", __func__, prop_name);
587 	gpio->gpio = FDT_GPIO_NONE;
588 	gpio->name = NULL;
589 	err = fdtdec_decode_gpios(blob, node, prop_name, gpio, 1);
590 	return err == 1 ? 0 : err;
591 }
592 
593 int fdtdec_get_gpio(struct fdt_gpio_state *gpio)
594 {
595 	int val;
596 
597 	if (!fdt_gpio_isvalid(gpio))
598 		return -1;
599 
600 	val = gpio_get_value(gpio->gpio);
601 	return gpio->flags & FDT_GPIO_ACTIVE_LOW ? val ^ 1 : val;
602 }
603 
604 int fdtdec_set_gpio(struct fdt_gpio_state *gpio, int val)
605 {
606 	if (!fdt_gpio_isvalid(gpio))
607 		return -1;
608 
609 	val = gpio->flags & FDT_GPIO_ACTIVE_LOW ? val ^ 1 : val;
610 	return gpio_set_value(gpio->gpio, val);
611 }
612 
613 int fdtdec_setup_gpio(struct fdt_gpio_state *gpio)
614 {
615 	/*
616 	 * Return success if there is no GPIO defined. This is used for
617 	 * optional GPIOs)
618 	 */
619 	if (!fdt_gpio_isvalid(gpio))
620 		return 0;
621 
622 	if (gpio_request(gpio->gpio, gpio->name))
623 		return -1;
624 	return 0;
625 }
626 
627 int fdtdec_get_byte_array(const void *blob, int node, const char *prop_name,
628 		u8 *array, int count)
629 {
630 	const u8 *cell;
631 	int err;
632 
633 	cell = get_prop_check_min_len(blob, node, prop_name, count, &err);
634 	if (!err)
635 		memcpy(array, cell, count);
636 	return err;
637 }
638 
639 const u8 *fdtdec_locate_byte_array(const void *blob, int node,
640 			     const char *prop_name, int count)
641 {
642 	const u8 *cell;
643 	int err;
644 
645 	cell = get_prop_check_min_len(blob, node, prop_name, count, &err);
646 	if (err)
647 		return NULL;
648 	return cell;
649 }
650 
651 int fdtdec_get_config_int(const void *blob, const char *prop_name,
652 		int default_val)
653 {
654 	int config_node;
655 
656 	debug("%s: %s\n", __func__, prop_name);
657 	config_node = fdt_path_offset(blob, "/config");
658 	if (config_node < 0)
659 		return default_val;
660 	return fdtdec_get_int(blob, config_node, prop_name, default_val);
661 }
662 
663 int fdtdec_get_config_bool(const void *blob, const char *prop_name)
664 {
665 	int config_node;
666 	const void *prop;
667 
668 	debug("%s: %s\n", __func__, prop_name);
669 	config_node = fdt_path_offset(blob, "/config");
670 	if (config_node < 0)
671 		return 0;
672 	prop = fdt_get_property(blob, config_node, prop_name, NULL);
673 
674 	return prop != NULL;
675 }
676 
677 char *fdtdec_get_config_string(const void *blob, const char *prop_name)
678 {
679 	const char *nodep;
680 	int nodeoffset;
681 	int len;
682 
683 	debug("%s: %s\n", __func__, prop_name);
684 	nodeoffset = fdt_path_offset(blob, "/config");
685 	if (nodeoffset < 0)
686 		return NULL;
687 
688 	nodep = fdt_getprop(blob, nodeoffset, prop_name, &len);
689 	if (!nodep)
690 		return NULL;
691 
692 	return (char *)nodep;
693 }
694 
695 int fdtdec_decode_region(const void *blob, int node,
696 		const char *prop_name, void **ptrp, size_t *size)
697 {
698 	const fdt_addr_t *cell;
699 	int len;
700 
701 	debug("%s: %s\n", __func__, prop_name);
702 	cell = fdt_getprop(blob, node, prop_name, &len);
703 	if (!cell || (len != sizeof(fdt_addr_t) * 2))
704 		return -1;
705 
706 	*ptrp = map_sysmem(fdt_addr_to_cpu(*cell), *size);
707 	*size = fdt_size_to_cpu(cell[1]);
708 	debug("%s: size=%zx\n", __func__, *size);
709 	return 0;
710 }
711 
712 /**
713  * Read a flash entry from the fdt
714  *
715  * @param blob		FDT blob
716  * @param node		Offset of node to read
717  * @param name		Name of node being read
718  * @param entry		Place to put offset and size of this node
719  * @return 0 if ok, -ve on error
720  */
721 int fdtdec_read_fmap_entry(const void *blob, int node, const char *name,
722 			   struct fmap_entry *entry)
723 {
724 	u32 reg[2];
725 
726 	if (fdtdec_get_int_array(blob, node, "reg", reg, 2)) {
727 		debug("Node '%s' has bad/missing 'reg' property\n", name);
728 		return -FDT_ERR_NOTFOUND;
729 	}
730 	entry->offset = reg[0];
731 	entry->length = reg[1];
732 
733 	return 0;
734 }
735 
736 static u64 fdtdec_get_number(const fdt32_t *ptr, unsigned int cells)
737 {
738 	u64 number = 0;
739 
740 	while (cells--)
741 		number = (number << 32) | fdt32_to_cpu(*ptr++);
742 
743 	return number;
744 }
745 
746 int fdt_get_resource(const void *fdt, int node, const char *property,
747 		     unsigned int index, struct fdt_resource *res)
748 {
749 	const fdt32_t *ptr, *end;
750 	int na, ns, len, parent;
751 	unsigned int i = 0;
752 
753 	parent = fdt_parent_offset(fdt, node);
754 	if (parent < 0)
755 		return parent;
756 
757 	na = fdt_address_cells(fdt, parent);
758 	ns = fdt_size_cells(fdt, parent);
759 
760 	ptr = fdt_getprop(fdt, node, property, &len);
761 	if (!ptr)
762 		return len;
763 
764 	end = ptr + len / sizeof(*ptr);
765 
766 	while (ptr + na + ns <= end) {
767 		if (i == index) {
768 			res->start = res->end = fdtdec_get_number(ptr, na);
769 			res->end += fdtdec_get_number(&ptr[na], ns) - 1;
770 			return 0;
771 		}
772 
773 		ptr += na + ns;
774 		i++;
775 	}
776 
777 	return -FDT_ERR_NOTFOUND;
778 }
779 
780 int fdt_get_named_resource(const void *fdt, int node, const char *property,
781 			   const char *prop_names, const char *name,
782 			   struct fdt_resource *res)
783 {
784 	int index;
785 
786 	index = fdt_find_string(fdt, node, prop_names, name);
787 	if (index < 0)
788 		return index;
789 
790 	return fdt_get_resource(fdt, node, property, index, res);
791 }
792 
793 int fdtdec_pci_get_bdf(const void *fdt, int node, int *bdf)
794 {
795 	const fdt32_t *prop;
796 	int len;
797 
798 	prop = fdt_getprop(fdt, node, "reg", &len);
799 	if (!prop)
800 		return len;
801 
802 	*bdf = fdt32_to_cpu(*prop) & 0xffffff;
803 
804 	return 0;
805 }
806 #endif
807