xref: /openbmc/u-boot/common/fdt_support.c (revision a4670f8e)
1 /*
2  * (C) Copyright 2007
3  * Gerald Van Baren, Custom IDEAS, vanbaren@cideas.com
4  *
5  * Copyright 2010-2011 Freescale Semiconductor, Inc.
6  *
7  * SPDX-License-Identifier:	GPL-2.0+
8  */
9 
10 #include <common.h>
11 #include <inttypes.h>
12 #include <stdio_dev.h>
13 #include <linux/ctype.h>
14 #include <linux/types.h>
15 #include <asm/global_data.h>
16 #include <libfdt.h>
17 #include <fdt_support.h>
18 #include <exports.h>
19 #include <fdtdec.h>
20 
21 /**
22  * fdt_getprop_u32_default_node - Return a node's property or a default
23  *
24  * @fdt: ptr to device tree
25  * @off: offset of node
26  * @cell: cell offset in property
27  * @prop: property name
28  * @dflt: default value if the property isn't found
29  *
30  * Convenience function to return a node's property or a default value if
31  * the property doesn't exist.
32  */
33 u32 fdt_getprop_u32_default_node(const void *fdt, int off, int cell,
34 				const char *prop, const u32 dflt)
35 {
36 	const fdt32_t *val;
37 	int len;
38 
39 	val = fdt_getprop(fdt, off, prop, &len);
40 
41 	/* Check if property exists */
42 	if (!val)
43 		return dflt;
44 
45 	/* Check if property is long enough */
46 	if (len < ((cell + 1) * sizeof(uint32_t)))
47 		return dflt;
48 
49 	return fdt32_to_cpu(*val);
50 }
51 
52 /**
53  * fdt_getprop_u32_default - Find a node and return it's property or a default
54  *
55  * @fdt: ptr to device tree
56  * @path: path of node
57  * @prop: property name
58  * @dflt: default value if the property isn't found
59  *
60  * Convenience function to find a node and return it's property or a
61  * default value if it doesn't exist.
62  */
63 u32 fdt_getprop_u32_default(const void *fdt, const char *path,
64 				const char *prop, const u32 dflt)
65 {
66 	int off;
67 
68 	off = fdt_path_offset(fdt, path);
69 	if (off < 0)
70 		return dflt;
71 
72 	return fdt_getprop_u32_default_node(fdt, off, 0, prop, dflt);
73 }
74 
75 /**
76  * fdt_find_and_setprop: Find a node and set it's property
77  *
78  * @fdt: ptr to device tree
79  * @node: path of node
80  * @prop: property name
81  * @val: ptr to new value
82  * @len: length of new property value
83  * @create: flag to create the property if it doesn't exist
84  *
85  * Convenience function to directly set a property given the path to the node.
86  */
87 int fdt_find_and_setprop(void *fdt, const char *node, const char *prop,
88 			 const void *val, int len, int create)
89 {
90 	int nodeoff = fdt_path_offset(fdt, node);
91 
92 	if (nodeoff < 0)
93 		return nodeoff;
94 
95 	if ((!create) && (fdt_get_property(fdt, nodeoff, prop, NULL) == NULL))
96 		return 0; /* create flag not set; so exit quietly */
97 
98 	return fdt_setprop(fdt, nodeoff, prop, val, len);
99 }
100 
101 /**
102  * fdt_find_or_add_subnode() - find or possibly add a subnode of a given node
103  *
104  * @fdt: pointer to the device tree blob
105  * @parentoffset: structure block offset of a node
106  * @name: name of the subnode to locate
107  *
108  * fdt_subnode_offset() finds a subnode of the node with a given name.
109  * If the subnode does not exist, it will be created.
110  */
111 int fdt_find_or_add_subnode(void *fdt, int parentoffset, const char *name)
112 {
113 	int offset;
114 
115 	offset = fdt_subnode_offset(fdt, parentoffset, name);
116 
117 	if (offset == -FDT_ERR_NOTFOUND)
118 		offset = fdt_add_subnode(fdt, parentoffset, name);
119 
120 	if (offset < 0)
121 		printf("%s: %s: %s\n", __func__, name, fdt_strerror(offset));
122 
123 	return offset;
124 }
125 
126 /* rename to CONFIG_OF_STDOUT_PATH ? */
127 #if defined(OF_STDOUT_PATH)
128 static int fdt_fixup_stdout(void *fdt, int chosenoff)
129 {
130 	return fdt_setprop(fdt, chosenoff, "linux,stdout-path",
131 			      OF_STDOUT_PATH, strlen(OF_STDOUT_PATH) + 1);
132 }
133 #elif defined(CONFIG_OF_STDOUT_VIA_ALIAS) && defined(CONFIG_CONS_INDEX)
134 static int fdt_fixup_stdout(void *fdt, int chosenoff)
135 {
136 	int err;
137 	int aliasoff;
138 	char sername[9] = { 0 };
139 	const void *path;
140 	int len;
141 	char tmp[256]; /* long enough */
142 
143 	sprintf(sername, "serial%d", CONFIG_CONS_INDEX - 1);
144 
145 	aliasoff = fdt_path_offset(fdt, "/aliases");
146 	if (aliasoff < 0) {
147 		err = aliasoff;
148 		goto noalias;
149 	}
150 
151 	path = fdt_getprop(fdt, aliasoff, sername, &len);
152 	if (!path) {
153 		err = len;
154 		goto noalias;
155 	}
156 
157 	/* fdt_setprop may break "path" so we copy it to tmp buffer */
158 	memcpy(tmp, path, len);
159 
160 	err = fdt_setprop(fdt, chosenoff, "linux,stdout-path", tmp, len);
161 	if (err < 0)
162 		printf("WARNING: could not set linux,stdout-path %s.\n",
163 		       fdt_strerror(err));
164 
165 	return err;
166 
167 noalias:
168 	printf("WARNING: %s: could not read %s alias: %s\n",
169 	       __func__, sername, fdt_strerror(err));
170 
171 	return 0;
172 }
173 #else
174 static int fdt_fixup_stdout(void *fdt, int chosenoff)
175 {
176 	return 0;
177 }
178 #endif
179 
180 static inline int fdt_setprop_uxx(void *fdt, int nodeoffset, const char *name,
181 				  uint64_t val, int is_u64)
182 {
183 	if (is_u64)
184 		return fdt_setprop_u64(fdt, nodeoffset, name, val);
185 	else
186 		return fdt_setprop_u32(fdt, nodeoffset, name, (uint32_t)val);
187 }
188 
189 int fdt_root(void *fdt)
190 {
191 	char *serial;
192 	int err;
193 
194 	err = fdt_check_header(fdt);
195 	if (err < 0) {
196 		printf("fdt_root: %s\n", fdt_strerror(err));
197 		return err;
198 	}
199 
200 	serial = env_get("serial#");
201 	if (serial) {
202 		err = fdt_setprop(fdt, 0, "serial-number", serial,
203 				  strlen(serial) + 1);
204 
205 		if (err < 0) {
206 			printf("WARNING: could not set serial-number %s.\n",
207 			       fdt_strerror(err));
208 			return err;
209 		}
210 	}
211 
212 	return 0;
213 }
214 
215 int fdt_initrd(void *fdt, ulong initrd_start, ulong initrd_end)
216 {
217 	int   nodeoffset;
218 	int   err, j, total;
219 	int is_u64;
220 	uint64_t addr, size;
221 
222 	/* just return if the size of initrd is zero */
223 	if (initrd_start == initrd_end)
224 		return 0;
225 
226 	/* find or create "/chosen" node. */
227 	nodeoffset = fdt_find_or_add_subnode(fdt, 0, "chosen");
228 	if (nodeoffset < 0)
229 		return nodeoffset;
230 
231 	total = fdt_num_mem_rsv(fdt);
232 
233 	/*
234 	 * Look for an existing entry and update it.  If we don't find
235 	 * the entry, we will j be the next available slot.
236 	 */
237 	for (j = 0; j < total; j++) {
238 		err = fdt_get_mem_rsv(fdt, j, &addr, &size);
239 		if (addr == initrd_start) {
240 			fdt_del_mem_rsv(fdt, j);
241 			break;
242 		}
243 	}
244 
245 	err = fdt_add_mem_rsv(fdt, initrd_start, initrd_end - initrd_start);
246 	if (err < 0) {
247 		printf("fdt_initrd: %s\n", fdt_strerror(err));
248 		return err;
249 	}
250 
251 	is_u64 = (fdt_address_cells(fdt, 0) == 2);
252 
253 	err = fdt_setprop_uxx(fdt, nodeoffset, "linux,initrd-start",
254 			      (uint64_t)initrd_start, is_u64);
255 
256 	if (err < 0) {
257 		printf("WARNING: could not set linux,initrd-start %s.\n",
258 		       fdt_strerror(err));
259 		return err;
260 	}
261 
262 	err = fdt_setprop_uxx(fdt, nodeoffset, "linux,initrd-end",
263 			      (uint64_t)initrd_end, is_u64);
264 
265 	if (err < 0) {
266 		printf("WARNING: could not set linux,initrd-end %s.\n",
267 		       fdt_strerror(err));
268 
269 		return err;
270 	}
271 
272 	return 0;
273 }
274 
275 int fdt_chosen(void *fdt)
276 {
277 	int   nodeoffset;
278 	int   err;
279 	char  *str;		/* used to set string properties */
280 
281 	err = fdt_check_header(fdt);
282 	if (err < 0) {
283 		printf("fdt_chosen: %s\n", fdt_strerror(err));
284 		return err;
285 	}
286 
287 	/* find or create "/chosen" node. */
288 	nodeoffset = fdt_find_or_add_subnode(fdt, 0, "chosen");
289 	if (nodeoffset < 0)
290 		return nodeoffset;
291 
292 	str = env_get("bootargs");
293 	if (str) {
294 		err = fdt_setprop(fdt, nodeoffset, "bootargs", str,
295 				  strlen(str) + 1);
296 		if (err < 0) {
297 			printf("WARNING: could not set bootargs %s.\n",
298 			       fdt_strerror(err));
299 			return err;
300 		}
301 	}
302 
303 	return fdt_fixup_stdout(fdt, nodeoffset);
304 }
305 
306 void do_fixup_by_path(void *fdt, const char *path, const char *prop,
307 		      const void *val, int len, int create)
308 {
309 #if defined(DEBUG)
310 	int i;
311 	debug("Updating property '%s/%s' = ", path, prop);
312 	for (i = 0; i < len; i++)
313 		debug(" %.2x", *(u8*)(val+i));
314 	debug("\n");
315 #endif
316 	int rc = fdt_find_and_setprop(fdt, path, prop, val, len, create);
317 	if (rc)
318 		printf("Unable to update property %s:%s, err=%s\n",
319 			path, prop, fdt_strerror(rc));
320 }
321 
322 void do_fixup_by_path_u32(void *fdt, const char *path, const char *prop,
323 			  u32 val, int create)
324 {
325 	fdt32_t tmp = cpu_to_fdt32(val);
326 	do_fixup_by_path(fdt, path, prop, &tmp, sizeof(tmp), create);
327 }
328 
329 void do_fixup_by_prop(void *fdt,
330 		      const char *pname, const void *pval, int plen,
331 		      const char *prop, const void *val, int len,
332 		      int create)
333 {
334 	int off;
335 #if defined(DEBUG)
336 	int i;
337 	debug("Updating property '%s' = ", prop);
338 	for (i = 0; i < len; i++)
339 		debug(" %.2x", *(u8*)(val+i));
340 	debug("\n");
341 #endif
342 	off = fdt_node_offset_by_prop_value(fdt, -1, pname, pval, plen);
343 	while (off != -FDT_ERR_NOTFOUND) {
344 		if (create || (fdt_get_property(fdt, off, prop, NULL) != NULL))
345 			fdt_setprop(fdt, off, prop, val, len);
346 		off = fdt_node_offset_by_prop_value(fdt, off, pname, pval, plen);
347 	}
348 }
349 
350 void do_fixup_by_prop_u32(void *fdt,
351 			  const char *pname, const void *pval, int plen,
352 			  const char *prop, u32 val, int create)
353 {
354 	fdt32_t tmp = cpu_to_fdt32(val);
355 	do_fixup_by_prop(fdt, pname, pval, plen, prop, &tmp, 4, create);
356 }
357 
358 void do_fixup_by_compat(void *fdt, const char *compat,
359 			const char *prop, const void *val, int len, int create)
360 {
361 	int off = -1;
362 #if defined(DEBUG)
363 	int i;
364 	debug("Updating property '%s' = ", prop);
365 	for (i = 0; i < len; i++)
366 		debug(" %.2x", *(u8*)(val+i));
367 	debug("\n");
368 #endif
369 	off = fdt_node_offset_by_compatible(fdt, -1, compat);
370 	while (off != -FDT_ERR_NOTFOUND) {
371 		if (create || (fdt_get_property(fdt, off, prop, NULL) != NULL))
372 			fdt_setprop(fdt, off, prop, val, len);
373 		off = fdt_node_offset_by_compatible(fdt, off, compat);
374 	}
375 }
376 
377 void do_fixup_by_compat_u32(void *fdt, const char *compat,
378 			    const char *prop, u32 val, int create)
379 {
380 	fdt32_t tmp = cpu_to_fdt32(val);
381 	do_fixup_by_compat(fdt, compat, prop, &tmp, 4, create);
382 }
383 
384 #ifdef CONFIG_ARCH_FIXUP_FDT_MEMORY
385 /*
386  * fdt_pack_reg - pack address and size array into the "reg"-suitable stream
387  */
388 static int fdt_pack_reg(const void *fdt, void *buf, u64 *address, u64 *size,
389 			int n)
390 {
391 	int i;
392 	int address_cells = fdt_address_cells(fdt, 0);
393 	int size_cells = fdt_size_cells(fdt, 0);
394 	char *p = buf;
395 
396 	for (i = 0; i < n; i++) {
397 		if (address_cells == 2)
398 			*(fdt64_t *)p = cpu_to_fdt64(address[i]);
399 		else
400 			*(fdt32_t *)p = cpu_to_fdt32(address[i]);
401 		p += 4 * address_cells;
402 
403 		if (size_cells == 2)
404 			*(fdt64_t *)p = cpu_to_fdt64(size[i]);
405 		else
406 			*(fdt32_t *)p = cpu_to_fdt32(size[i]);
407 		p += 4 * size_cells;
408 	}
409 
410 	return p - (char *)buf;
411 }
412 
413 #ifdef CONFIG_NR_DRAM_BANKS
414 #define MEMORY_BANKS_MAX CONFIG_NR_DRAM_BANKS
415 #else
416 #define MEMORY_BANKS_MAX 4
417 #endif
418 int fdt_fixup_memory_banks(void *blob, u64 start[], u64 size[], int banks)
419 {
420 	int err, nodeoffset;
421 	int len;
422 	u8 tmp[MEMORY_BANKS_MAX * 16]; /* Up to 64-bit address + 64-bit size */
423 
424 	if (banks > MEMORY_BANKS_MAX) {
425 		printf("%s: num banks %d exceeds hardcoded limit %d."
426 		       " Recompile with higher MEMORY_BANKS_MAX?\n",
427 		       __FUNCTION__, banks, MEMORY_BANKS_MAX);
428 		return -1;
429 	}
430 
431 	err = fdt_check_header(blob);
432 	if (err < 0) {
433 		printf("%s: %s\n", __FUNCTION__, fdt_strerror(err));
434 		return err;
435 	}
436 
437 	/* find or create "/memory" node. */
438 	nodeoffset = fdt_find_or_add_subnode(blob, 0, "memory");
439 	if (nodeoffset < 0)
440 			return nodeoffset;
441 
442 	err = fdt_setprop(blob, nodeoffset, "device_type", "memory",
443 			sizeof("memory"));
444 	if (err < 0) {
445 		printf("WARNING: could not set %s %s.\n", "device_type",
446 				fdt_strerror(err));
447 		return err;
448 	}
449 
450 	if (!banks)
451 		return 0;
452 
453 	len = fdt_pack_reg(blob, tmp, start, size, banks);
454 
455 	err = fdt_setprop(blob, nodeoffset, "reg", tmp, len);
456 	if (err < 0) {
457 		printf("WARNING: could not set %s %s.\n",
458 				"reg", fdt_strerror(err));
459 		return err;
460 	}
461 	return 0;
462 }
463 #endif
464 
465 int fdt_fixup_memory(void *blob, u64 start, u64 size)
466 {
467 	return fdt_fixup_memory_banks(blob, &start, &size, 1);
468 }
469 
470 void fdt_fixup_ethernet(void *fdt)
471 {
472 	int i, j, prop;
473 	char *tmp, *end;
474 	char mac[16];
475 	const char *path;
476 	unsigned char mac_addr[ARP_HLEN];
477 	int offset;
478 
479 	if (fdt_path_offset(fdt, "/aliases") < 0)
480 		return;
481 
482 	/* Cycle through all aliases */
483 	for (prop = 0; ; prop++) {
484 		const char *name;
485 
486 		/* FDT might have been edited, recompute the offset */
487 		offset = fdt_first_property_offset(fdt,
488 			fdt_path_offset(fdt, "/aliases"));
489 		/* Select property number 'prop' */
490 		for (i = 0; i < prop; i++)
491 			offset = fdt_next_property_offset(fdt, offset);
492 
493 		if (offset < 0)
494 			break;
495 
496 		path = fdt_getprop_by_offset(fdt, offset, &name, NULL);
497 		if (!strncmp(name, "ethernet", 8)) {
498 			/* Treat plain "ethernet" same as "ethernet0". */
499 			if (!strcmp(name, "ethernet"))
500 				i = 0;
501 			else
502 				i = trailing_strtol(name);
503 
504 			if (i != -1) {
505 				if (i == 0)
506 					strcpy(mac, "ethaddr");
507 				else
508 					sprintf(mac, "eth%daddr", i);
509 			} else {
510 				continue;
511 			}
512 			tmp = env_get(mac);
513 			if (!tmp)
514 				continue;
515 
516 			for (j = 0; j < 6; j++) {
517 				mac_addr[j] = tmp ?
518 					      simple_strtoul(tmp, &end, 16) : 0;
519 				if (tmp)
520 					tmp = (*end) ? end + 1 : end;
521 			}
522 
523 			do_fixup_by_path(fdt, path, "mac-address",
524 					 &mac_addr, 6, 0);
525 			do_fixup_by_path(fdt, path, "local-mac-address",
526 					 &mac_addr, 6, 1);
527 		}
528 	}
529 }
530 
531 /* Resize the fdt to its actual size + a bit of padding */
532 int fdt_shrink_to_minimum(void *blob, uint extrasize)
533 {
534 	int i;
535 	uint64_t addr, size;
536 	int total, ret;
537 	uint actualsize;
538 
539 	if (!blob)
540 		return 0;
541 
542 	total = fdt_num_mem_rsv(blob);
543 	for (i = 0; i < total; i++) {
544 		fdt_get_mem_rsv(blob, i, &addr, &size);
545 		if (addr == (uintptr_t)blob) {
546 			fdt_del_mem_rsv(blob, i);
547 			break;
548 		}
549 	}
550 
551 	/*
552 	 * Calculate the actual size of the fdt
553 	 * plus the size needed for 5 fdt_add_mem_rsv, one
554 	 * for the fdt itself and 4 for a possible initrd
555 	 * ((initrd-start + initrd-end) * 2 (name & value))
556 	 */
557 	actualsize = fdt_off_dt_strings(blob) +
558 		fdt_size_dt_strings(blob) + 5 * sizeof(struct fdt_reserve_entry);
559 
560 	actualsize += extrasize;
561 	/* Make it so the fdt ends on a page boundary */
562 	actualsize = ALIGN(actualsize + ((uintptr_t)blob & 0xfff), 0x1000);
563 	actualsize = actualsize - ((uintptr_t)blob & 0xfff);
564 
565 	/* Change the fdt header to reflect the correct size */
566 	fdt_set_totalsize(blob, actualsize);
567 
568 	/* Add the new reservation */
569 	ret = fdt_add_mem_rsv(blob, (uintptr_t)blob, actualsize);
570 	if (ret < 0)
571 		return ret;
572 
573 	return actualsize;
574 }
575 
576 #ifdef CONFIG_PCI
577 #define CONFIG_SYS_PCI_NR_INBOUND_WIN 4
578 
579 #define FDT_PCI_PREFETCH	(0x40000000)
580 #define FDT_PCI_MEM32		(0x02000000)
581 #define FDT_PCI_IO		(0x01000000)
582 #define FDT_PCI_MEM64		(0x03000000)
583 
584 int fdt_pci_dma_ranges(void *blob, int phb_off, struct pci_controller *hose) {
585 
586 	int addrcell, sizecell, len, r;
587 	u32 *dma_range;
588 	/* sized based on pci addr cells, size-cells, & address-cells */
589 	u32 dma_ranges[(3 + 2 + 2) * CONFIG_SYS_PCI_NR_INBOUND_WIN];
590 
591 	addrcell = fdt_getprop_u32_default(blob, "/", "#address-cells", 1);
592 	sizecell = fdt_getprop_u32_default(blob, "/", "#size-cells", 1);
593 
594 	dma_range = &dma_ranges[0];
595 	for (r = 0; r < hose->region_count; r++) {
596 		u64 bus_start, phys_start, size;
597 
598 		/* skip if !PCI_REGION_SYS_MEMORY */
599 		if (!(hose->regions[r].flags & PCI_REGION_SYS_MEMORY))
600 			continue;
601 
602 		bus_start = (u64)hose->regions[r].bus_start;
603 		phys_start = (u64)hose->regions[r].phys_start;
604 		size = (u64)hose->regions[r].size;
605 
606 		dma_range[0] = 0;
607 		if (size >= 0x100000000ull)
608 			dma_range[0] |= FDT_PCI_MEM64;
609 		else
610 			dma_range[0] |= FDT_PCI_MEM32;
611 		if (hose->regions[r].flags & PCI_REGION_PREFETCH)
612 			dma_range[0] |= FDT_PCI_PREFETCH;
613 #ifdef CONFIG_SYS_PCI_64BIT
614 		dma_range[1] = bus_start >> 32;
615 #else
616 		dma_range[1] = 0;
617 #endif
618 		dma_range[2] = bus_start & 0xffffffff;
619 
620 		if (addrcell == 2) {
621 			dma_range[3] = phys_start >> 32;
622 			dma_range[4] = phys_start & 0xffffffff;
623 		} else {
624 			dma_range[3] = phys_start & 0xffffffff;
625 		}
626 
627 		if (sizecell == 2) {
628 			dma_range[3 + addrcell + 0] = size >> 32;
629 			dma_range[3 + addrcell + 1] = size & 0xffffffff;
630 		} else {
631 			dma_range[3 + addrcell + 0] = size & 0xffffffff;
632 		}
633 
634 		dma_range += (3 + addrcell + sizecell);
635 	}
636 
637 	len = dma_range - &dma_ranges[0];
638 	if (len)
639 		fdt_setprop(blob, phb_off, "dma-ranges", &dma_ranges[0], len*4);
640 
641 	return 0;
642 }
643 #endif
644 
645 int fdt_increase_size(void *fdt, int add_len)
646 {
647 	int newlen;
648 
649 	newlen = fdt_totalsize(fdt) + add_len;
650 
651 	/* Open in place with a new len */
652 	return fdt_open_into(fdt, fdt, newlen);
653 }
654 
655 #ifdef CONFIG_FDT_FIXUP_PARTITIONS
656 #include <jffs2/load_kernel.h>
657 #include <mtd_node.h>
658 
659 struct reg_cell {
660 	unsigned int r0;
661 	unsigned int r1;
662 };
663 
664 int fdt_del_subnodes(const void *blob, int parent_offset)
665 {
666 	int off, ndepth;
667 	int ret;
668 
669 	for (ndepth = 0, off = fdt_next_node(blob, parent_offset, &ndepth);
670 	     (off >= 0) && (ndepth > 0);
671 	     off = fdt_next_node(blob, off, &ndepth)) {
672 		if (ndepth == 1) {
673 			debug("delete %s: offset: %x\n",
674 				fdt_get_name(blob, off, 0), off);
675 			ret = fdt_del_node((void *)blob, off);
676 			if (ret < 0) {
677 				printf("Can't delete node: %s\n",
678 					fdt_strerror(ret));
679 				return ret;
680 			} else {
681 				ndepth = 0;
682 				off = parent_offset;
683 			}
684 		}
685 	}
686 	return 0;
687 }
688 
689 int fdt_del_partitions(void *blob, int parent_offset)
690 {
691 	const void *prop;
692 	int ndepth = 0;
693 	int off;
694 	int ret;
695 
696 	off = fdt_next_node(blob, parent_offset, &ndepth);
697 	if (off > 0 && ndepth == 1) {
698 		prop = fdt_getprop(blob, off, "label", NULL);
699 		if (prop == NULL) {
700 			/*
701 			 * Could not find label property, nand {}; node?
702 			 * Check subnode, delete partitions there if any.
703 			 */
704 			return fdt_del_partitions(blob, off);
705 		} else {
706 			ret = fdt_del_subnodes(blob, parent_offset);
707 			if (ret < 0) {
708 				printf("Can't remove subnodes: %s\n",
709 					fdt_strerror(ret));
710 				return ret;
711 			}
712 		}
713 	}
714 	return 0;
715 }
716 
717 int fdt_node_set_part_info(void *blob, int parent_offset,
718 			   struct mtd_device *dev)
719 {
720 	struct list_head *pentry;
721 	struct part_info *part;
722 	struct reg_cell cell;
723 	int off, ndepth = 0;
724 	int part_num, ret;
725 	char buf[64];
726 
727 	ret = fdt_del_partitions(blob, parent_offset);
728 	if (ret < 0)
729 		return ret;
730 
731 	/*
732 	 * Check if it is nand {}; subnode, adjust
733 	 * the offset in this case
734 	 */
735 	off = fdt_next_node(blob, parent_offset, &ndepth);
736 	if (off > 0 && ndepth == 1)
737 		parent_offset = off;
738 
739 	part_num = 0;
740 	list_for_each_prev(pentry, &dev->parts) {
741 		int newoff;
742 
743 		part = list_entry(pentry, struct part_info, link);
744 
745 		debug("%2d: %-20s0x%08llx\t0x%08llx\t%d\n",
746 			part_num, part->name, part->size,
747 			part->offset, part->mask_flags);
748 
749 		sprintf(buf, "partition@%llx", part->offset);
750 add_sub:
751 		ret = fdt_add_subnode(blob, parent_offset, buf);
752 		if (ret == -FDT_ERR_NOSPACE) {
753 			ret = fdt_increase_size(blob, 512);
754 			if (!ret)
755 				goto add_sub;
756 			else
757 				goto err_size;
758 		} else if (ret < 0) {
759 			printf("Can't add partition node: %s\n",
760 				fdt_strerror(ret));
761 			return ret;
762 		}
763 		newoff = ret;
764 
765 		/* Check MTD_WRITEABLE_CMD flag */
766 		if (part->mask_flags & 1) {
767 add_ro:
768 			ret = fdt_setprop(blob, newoff, "read_only", NULL, 0);
769 			if (ret == -FDT_ERR_NOSPACE) {
770 				ret = fdt_increase_size(blob, 512);
771 				if (!ret)
772 					goto add_ro;
773 				else
774 					goto err_size;
775 			} else if (ret < 0)
776 				goto err_prop;
777 		}
778 
779 		cell.r0 = cpu_to_fdt32(part->offset);
780 		cell.r1 = cpu_to_fdt32(part->size);
781 add_reg:
782 		ret = fdt_setprop(blob, newoff, "reg", &cell, sizeof(cell));
783 		if (ret == -FDT_ERR_NOSPACE) {
784 			ret = fdt_increase_size(blob, 512);
785 			if (!ret)
786 				goto add_reg;
787 			else
788 				goto err_size;
789 		} else if (ret < 0)
790 			goto err_prop;
791 
792 add_label:
793 		ret = fdt_setprop_string(blob, newoff, "label", part->name);
794 		if (ret == -FDT_ERR_NOSPACE) {
795 			ret = fdt_increase_size(blob, 512);
796 			if (!ret)
797 				goto add_label;
798 			else
799 				goto err_size;
800 		} else if (ret < 0)
801 			goto err_prop;
802 
803 		part_num++;
804 	}
805 	return 0;
806 err_size:
807 	printf("Can't increase blob size: %s\n", fdt_strerror(ret));
808 	return ret;
809 err_prop:
810 	printf("Can't add property: %s\n", fdt_strerror(ret));
811 	return ret;
812 }
813 
814 /*
815  * Update partitions in nor/nand nodes using info from
816  * mtdparts environment variable. The nodes to update are
817  * specified by node_info structure which contains mtd device
818  * type and compatible string: E. g. the board code in
819  * ft_board_setup() could use:
820  *
821  *	struct node_info nodes[] = {
822  *		{ "fsl,mpc5121-nfc",    MTD_DEV_TYPE_NAND, },
823  *		{ "cfi-flash",          MTD_DEV_TYPE_NOR,  },
824  *	};
825  *
826  *	fdt_fixup_mtdparts(blob, nodes, ARRAY_SIZE(nodes));
827  */
828 void fdt_fixup_mtdparts(void *blob, void *node_info, int node_info_size)
829 {
830 	struct node_info *ni = node_info;
831 	struct mtd_device *dev;
832 	int i, idx;
833 	int noff;
834 
835 	if (mtdparts_init() != 0)
836 		return;
837 
838 	for (i = 0; i < node_info_size; i++) {
839 		idx = 0;
840 		noff = fdt_node_offset_by_compatible(blob, -1, ni[i].compat);
841 		while (noff != -FDT_ERR_NOTFOUND) {
842 			debug("%s: %s, mtd dev type %d\n",
843 				fdt_get_name(blob, noff, 0),
844 				ni[i].compat, ni[i].type);
845 			dev = device_find(ni[i].type, idx++);
846 			if (dev) {
847 				if (fdt_node_set_part_info(blob, noff, dev))
848 					return; /* return on error */
849 			}
850 
851 			/* Jump to next flash node */
852 			noff = fdt_node_offset_by_compatible(blob, noff,
853 							     ni[i].compat);
854 		}
855 	}
856 }
857 #endif
858 
859 void fdt_del_node_and_alias(void *blob, const char *alias)
860 {
861 	int off = fdt_path_offset(blob, alias);
862 
863 	if (off < 0)
864 		return;
865 
866 	fdt_del_node(blob, off);
867 
868 	off = fdt_path_offset(blob, "/aliases");
869 	fdt_delprop(blob, off, alias);
870 }
871 
872 /* Max address size we deal with */
873 #define OF_MAX_ADDR_CELLS	4
874 #define OF_BAD_ADDR	FDT_ADDR_T_NONE
875 #define OF_CHECK_COUNTS(na, ns)	((na) > 0 && (na) <= OF_MAX_ADDR_CELLS && \
876 			(ns) > 0)
877 
878 /* Debug utility */
879 #ifdef DEBUG
880 static void of_dump_addr(const char *s, const fdt32_t *addr, int na)
881 {
882 	printf("%s", s);
883 	while(na--)
884 		printf(" %08x", *(addr++));
885 	printf("\n");
886 }
887 #else
888 static void of_dump_addr(const char *s, const fdt32_t *addr, int na) { }
889 #endif
890 
891 /**
892  * struct of_bus - Callbacks for bus specific translators
893  * @name:	A string used to identify this bus in debug output.
894  * @addresses:	The name of the DT property from which addresses are
895  *		to be read, typically "reg".
896  * @match:	Return non-zero if the node whose parent is at
897  *		parentoffset in the FDT blob corresponds to a bus
898  *		of this type, otherwise return zero. If NULL a match
899  *		is assumed.
900  * @count_cells:Count how many cells (be32 values) a node whose parent
901  *		is at parentoffset in the FDT blob will require to
902  *		represent its address (written to *addrc) & size
903  *		(written to *sizec).
904  * @map:	Map the address addr from the address space of this
905  *		bus to that of its parent, making use of the ranges
906  *		read from DT to an array at range. na and ns are the
907  *		number of cells (be32 values) used to hold and address
908  *		or size, respectively, for this bus. pna is the number
909  *		of cells used to hold an address for the parent bus.
910  *		Returns the address in the address space of the parent
911  *		bus.
912  * @translate:	Update the value of the address cells at addr within an
913  *		FDT by adding offset to it. na specifies the number of
914  *		cells used to hold the address being translated. Returns
915  *		zero on success, non-zero on error.
916  *
917  * Each bus type will include a struct of_bus in the of_busses array,
918  * providing implementations of some or all of the functions used to
919  * match the bus & handle address translation for its children.
920  */
921 struct of_bus {
922 	const char	*name;
923 	const char	*addresses;
924 	int		(*match)(const void *blob, int parentoffset);
925 	void		(*count_cells)(const void *blob, int parentoffset,
926 				int *addrc, int *sizec);
927 	u64		(*map)(fdt32_t *addr, const fdt32_t *range,
928 				int na, int ns, int pna);
929 	int		(*translate)(fdt32_t *addr, u64 offset, int na);
930 };
931 
932 /* Default translator (generic bus) */
933 void fdt_support_default_count_cells(const void *blob, int parentoffset,
934 					int *addrc, int *sizec)
935 {
936 	const fdt32_t *prop;
937 
938 	if (addrc)
939 		*addrc = fdt_address_cells(blob, parentoffset);
940 
941 	if (sizec) {
942 		prop = fdt_getprop(blob, parentoffset, "#size-cells", NULL);
943 		if (prop)
944 			*sizec = be32_to_cpup(prop);
945 		else
946 			*sizec = 1;
947 	}
948 }
949 
950 static u64 of_bus_default_map(fdt32_t *addr, const fdt32_t *range,
951 		int na, int ns, int pna)
952 {
953 	u64 cp, s, da;
954 
955 	cp = fdt_read_number(range, na);
956 	s  = fdt_read_number(range + na + pna, ns);
957 	da = fdt_read_number(addr, na);
958 
959 	debug("OF: default map, cp=%" PRIu64 ", s=%" PRIu64
960 	      ", da=%" PRIu64 "\n", cp, s, da);
961 
962 	if (da < cp || da >= (cp + s))
963 		return OF_BAD_ADDR;
964 	return da - cp;
965 }
966 
967 static int of_bus_default_translate(fdt32_t *addr, u64 offset, int na)
968 {
969 	u64 a = fdt_read_number(addr, na);
970 	memset(addr, 0, na * 4);
971 	a += offset;
972 	if (na > 1)
973 		addr[na - 2] = cpu_to_fdt32(a >> 32);
974 	addr[na - 1] = cpu_to_fdt32(a & 0xffffffffu);
975 
976 	return 0;
977 }
978 
979 #ifdef CONFIG_OF_ISA_BUS
980 
981 /* ISA bus translator */
982 static int of_bus_isa_match(const void *blob, int parentoffset)
983 {
984 	const char *name;
985 
986 	name = fdt_get_name(blob, parentoffset, NULL);
987 	if (!name)
988 		return 0;
989 
990 	return !strcmp(name, "isa");
991 }
992 
993 static void of_bus_isa_count_cells(const void *blob, int parentoffset,
994 				   int *addrc, int *sizec)
995 {
996 	if (addrc)
997 		*addrc = 2;
998 	if (sizec)
999 		*sizec = 1;
1000 }
1001 
1002 static u64 of_bus_isa_map(fdt32_t *addr, const fdt32_t *range,
1003 			  int na, int ns, int pna)
1004 {
1005 	u64 cp, s, da;
1006 
1007 	/* Check address type match */
1008 	if ((addr[0] ^ range[0]) & cpu_to_be32(1))
1009 		return OF_BAD_ADDR;
1010 
1011 	cp = fdt_read_number(range + 1, na - 1);
1012 	s  = fdt_read_number(range + na + pna, ns);
1013 	da = fdt_read_number(addr + 1, na - 1);
1014 
1015 	debug("OF: ISA map, cp=%" PRIu64 ", s=%" PRIu64
1016 	      ", da=%" PRIu64 "\n", cp, s, da);
1017 
1018 	if (da < cp || da >= (cp + s))
1019 		return OF_BAD_ADDR;
1020 	return da - cp;
1021 }
1022 
1023 static int of_bus_isa_translate(fdt32_t *addr, u64 offset, int na)
1024 {
1025 	return of_bus_default_translate(addr + 1, offset, na - 1);
1026 }
1027 
1028 #endif /* CONFIG_OF_ISA_BUS */
1029 
1030 /* Array of bus specific translators */
1031 static struct of_bus of_busses[] = {
1032 #ifdef CONFIG_OF_ISA_BUS
1033 	/* ISA */
1034 	{
1035 		.name = "isa",
1036 		.addresses = "reg",
1037 		.match = of_bus_isa_match,
1038 		.count_cells = of_bus_isa_count_cells,
1039 		.map = of_bus_isa_map,
1040 		.translate = of_bus_isa_translate,
1041 	},
1042 #endif /* CONFIG_OF_ISA_BUS */
1043 	/* Default */
1044 	{
1045 		.name = "default",
1046 		.addresses = "reg",
1047 		.count_cells = fdt_support_default_count_cells,
1048 		.map = of_bus_default_map,
1049 		.translate = of_bus_default_translate,
1050 	},
1051 };
1052 
1053 static struct of_bus *of_match_bus(const void *blob, int parentoffset)
1054 {
1055 	struct of_bus *bus;
1056 
1057 	if (ARRAY_SIZE(of_busses) == 1)
1058 		return of_busses;
1059 
1060 	for (bus = of_busses; bus; bus++) {
1061 		if (!bus->match || bus->match(blob, parentoffset))
1062 			return bus;
1063 	}
1064 
1065 	/*
1066 	 * We should always have matched the default bus at least, since
1067 	 * it has a NULL match field. If we didn't then it somehow isn't
1068 	 * in the of_busses array or something equally catastrophic has
1069 	 * gone wrong.
1070 	 */
1071 	assert(0);
1072 	return NULL;
1073 }
1074 
1075 static int of_translate_one(const void *blob, int parent, struct of_bus *bus,
1076 			    struct of_bus *pbus, fdt32_t *addr,
1077 			    int na, int ns, int pna, const char *rprop)
1078 {
1079 	const fdt32_t *ranges;
1080 	int rlen;
1081 	int rone;
1082 	u64 offset = OF_BAD_ADDR;
1083 
1084 	/* Normally, an absence of a "ranges" property means we are
1085 	 * crossing a non-translatable boundary, and thus the addresses
1086 	 * below the current not cannot be converted to CPU physical ones.
1087 	 * Unfortunately, while this is very clear in the spec, it's not
1088 	 * what Apple understood, and they do have things like /uni-n or
1089 	 * /ht nodes with no "ranges" property and a lot of perfectly
1090 	 * useable mapped devices below them. Thus we treat the absence of
1091 	 * "ranges" as equivalent to an empty "ranges" property which means
1092 	 * a 1:1 translation at that level. It's up to the caller not to try
1093 	 * to translate addresses that aren't supposed to be translated in
1094 	 * the first place. --BenH.
1095 	 */
1096 	ranges = fdt_getprop(blob, parent, rprop, &rlen);
1097 	if (ranges == NULL || rlen == 0) {
1098 		offset = fdt_read_number(addr, na);
1099 		memset(addr, 0, pna * 4);
1100 		debug("OF: no ranges, 1:1 translation\n");
1101 		goto finish;
1102 	}
1103 
1104 	debug("OF: walking ranges...\n");
1105 
1106 	/* Now walk through the ranges */
1107 	rlen /= 4;
1108 	rone = na + pna + ns;
1109 	for (; rlen >= rone; rlen -= rone, ranges += rone) {
1110 		offset = bus->map(addr, ranges, na, ns, pna);
1111 		if (offset != OF_BAD_ADDR)
1112 			break;
1113 	}
1114 	if (offset == OF_BAD_ADDR) {
1115 		debug("OF: not found !\n");
1116 		return 1;
1117 	}
1118 	memcpy(addr, ranges + na, 4 * pna);
1119 
1120  finish:
1121 	of_dump_addr("OF: parent translation for:", addr, pna);
1122 	debug("OF: with offset: %" PRIu64 "\n", offset);
1123 
1124 	/* Translate it into parent bus space */
1125 	return pbus->translate(addr, offset, pna);
1126 }
1127 
1128 /*
1129  * Translate an address from the device-tree into a CPU physical address,
1130  * this walks up the tree and applies the various bus mappings on the
1131  * way.
1132  *
1133  * Note: We consider that crossing any level with #size-cells == 0 to mean
1134  * that translation is impossible (that is we are not dealing with a value
1135  * that can be mapped to a cpu physical address). This is not really specified
1136  * that way, but this is traditionally the way IBM at least do things
1137  */
1138 static u64 __of_translate_address(const void *blob, int node_offset,
1139 				  const fdt32_t *in_addr, const char *rprop)
1140 {
1141 	int parent;
1142 	struct of_bus *bus, *pbus;
1143 	fdt32_t addr[OF_MAX_ADDR_CELLS];
1144 	int na, ns, pna, pns;
1145 	u64 result = OF_BAD_ADDR;
1146 
1147 	debug("OF: ** translation for device %s **\n",
1148 		fdt_get_name(blob, node_offset, NULL));
1149 
1150 	/* Get parent & match bus type */
1151 	parent = fdt_parent_offset(blob, node_offset);
1152 	if (parent < 0)
1153 		goto bail;
1154 	bus = of_match_bus(blob, parent);
1155 
1156 	/* Cound address cells & copy address locally */
1157 	bus->count_cells(blob, parent, &na, &ns);
1158 	if (!OF_CHECK_COUNTS(na, ns)) {
1159 		printf("%s: Bad cell count for %s\n", __FUNCTION__,
1160 		       fdt_get_name(blob, node_offset, NULL));
1161 		goto bail;
1162 	}
1163 	memcpy(addr, in_addr, na * 4);
1164 
1165 	debug("OF: bus is %s (na=%d, ns=%d) on %s\n",
1166 	    bus->name, na, ns, fdt_get_name(blob, parent, NULL));
1167 	of_dump_addr("OF: translating address:", addr, na);
1168 
1169 	/* Translate */
1170 	for (;;) {
1171 		/* Switch to parent bus */
1172 		node_offset = parent;
1173 		parent = fdt_parent_offset(blob, node_offset);
1174 
1175 		/* If root, we have finished */
1176 		if (parent < 0) {
1177 			debug("OF: reached root node\n");
1178 			result = fdt_read_number(addr, na);
1179 			break;
1180 		}
1181 
1182 		/* Get new parent bus and counts */
1183 		pbus = of_match_bus(blob, parent);
1184 		pbus->count_cells(blob, parent, &pna, &pns);
1185 		if (!OF_CHECK_COUNTS(pna, pns)) {
1186 			printf("%s: Bad cell count for %s\n", __FUNCTION__,
1187 				fdt_get_name(blob, node_offset, NULL));
1188 			break;
1189 		}
1190 
1191 		debug("OF: parent bus is %s (na=%d, ns=%d) on %s\n",
1192 		    pbus->name, pna, pns, fdt_get_name(blob, parent, NULL));
1193 
1194 		/* Apply bus translation */
1195 		if (of_translate_one(blob, node_offset, bus, pbus,
1196 					addr, na, ns, pna, rprop))
1197 			break;
1198 
1199 		/* Complete the move up one level */
1200 		na = pna;
1201 		ns = pns;
1202 		bus = pbus;
1203 
1204 		of_dump_addr("OF: one level translation:", addr, na);
1205 	}
1206  bail:
1207 
1208 	return result;
1209 }
1210 
1211 u64 fdt_translate_address(const void *blob, int node_offset,
1212 			  const fdt32_t *in_addr)
1213 {
1214 	return __of_translate_address(blob, node_offset, in_addr, "ranges");
1215 }
1216 
1217 /**
1218  * fdt_node_offset_by_compat_reg: Find a node that matches compatiable and
1219  * who's reg property matches a physical cpu address
1220  *
1221  * @blob: ptr to device tree
1222  * @compat: compatiable string to match
1223  * @compat_off: property name
1224  *
1225  */
1226 int fdt_node_offset_by_compat_reg(void *blob, const char *compat,
1227 					phys_addr_t compat_off)
1228 {
1229 	int len, off = fdt_node_offset_by_compatible(blob, -1, compat);
1230 	while (off != -FDT_ERR_NOTFOUND) {
1231 		const fdt32_t *reg = fdt_getprop(blob, off, "reg", &len);
1232 		if (reg) {
1233 			if (compat_off == fdt_translate_address(blob, off, reg))
1234 				return off;
1235 		}
1236 		off = fdt_node_offset_by_compatible(blob, off, compat);
1237 	}
1238 
1239 	return -FDT_ERR_NOTFOUND;
1240 }
1241 
1242 /**
1243  * fdt_alloc_phandle: Return next free phandle value
1244  *
1245  * @blob: ptr to device tree
1246  */
1247 int fdt_alloc_phandle(void *blob)
1248 {
1249 	int offset;
1250 	uint32_t phandle = 0;
1251 
1252 	for (offset = fdt_next_node(blob, -1, NULL); offset >= 0;
1253 	     offset = fdt_next_node(blob, offset, NULL)) {
1254 		phandle = max(phandle, fdt_get_phandle(blob, offset));
1255 	}
1256 
1257 	return phandle + 1;
1258 }
1259 
1260 /*
1261  * fdt_set_phandle: Create a phandle property for the given node
1262  *
1263  * @fdt: ptr to device tree
1264  * @nodeoffset: node to update
1265  * @phandle: phandle value to set (must be unique)
1266  */
1267 int fdt_set_phandle(void *fdt, int nodeoffset, uint32_t phandle)
1268 {
1269 	int ret;
1270 
1271 #ifdef DEBUG
1272 	int off = fdt_node_offset_by_phandle(fdt, phandle);
1273 
1274 	if ((off >= 0) && (off != nodeoffset)) {
1275 		char buf[64];
1276 
1277 		fdt_get_path(fdt, nodeoffset, buf, sizeof(buf));
1278 		printf("Trying to update node %s with phandle %u ",
1279 		       buf, phandle);
1280 
1281 		fdt_get_path(fdt, off, buf, sizeof(buf));
1282 		printf("that already exists in node %s.\n", buf);
1283 		return -FDT_ERR_BADPHANDLE;
1284 	}
1285 #endif
1286 
1287 	ret = fdt_setprop_cell(fdt, nodeoffset, "phandle", phandle);
1288 	if (ret < 0)
1289 		return ret;
1290 
1291 	/*
1292 	 * For now, also set the deprecated "linux,phandle" property, so that we
1293 	 * don't break older kernels.
1294 	 */
1295 	ret = fdt_setprop_cell(fdt, nodeoffset, "linux,phandle", phandle);
1296 
1297 	return ret;
1298 }
1299 
1300 /*
1301  * fdt_create_phandle: Create a phandle property for the given node
1302  *
1303  * @fdt: ptr to device tree
1304  * @nodeoffset: node to update
1305  */
1306 unsigned int fdt_create_phandle(void *fdt, int nodeoffset)
1307 {
1308 	/* see if there is a phandle already */
1309 	int phandle = fdt_get_phandle(fdt, nodeoffset);
1310 
1311 	/* if we got 0, means no phandle so create one */
1312 	if (phandle == 0) {
1313 		int ret;
1314 
1315 		phandle = fdt_alloc_phandle(fdt);
1316 		ret = fdt_set_phandle(fdt, nodeoffset, phandle);
1317 		if (ret < 0) {
1318 			printf("Can't set phandle %u: %s\n", phandle,
1319 			       fdt_strerror(ret));
1320 			return 0;
1321 		}
1322 	}
1323 
1324 	return phandle;
1325 }
1326 
1327 /*
1328  * fdt_set_node_status: Set status for the given node
1329  *
1330  * @fdt: ptr to device tree
1331  * @nodeoffset: node to update
1332  * @status: FDT_STATUS_OKAY, FDT_STATUS_DISABLED,
1333  *	    FDT_STATUS_FAIL, FDT_STATUS_FAIL_ERROR_CODE
1334  * @error_code: optional, only used if status is FDT_STATUS_FAIL_ERROR_CODE
1335  */
1336 int fdt_set_node_status(void *fdt, int nodeoffset,
1337 			enum fdt_status status, unsigned int error_code)
1338 {
1339 	char buf[16];
1340 	int ret = 0;
1341 
1342 	if (nodeoffset < 0)
1343 		return nodeoffset;
1344 
1345 	switch (status) {
1346 	case FDT_STATUS_OKAY:
1347 		ret = fdt_setprop_string(fdt, nodeoffset, "status", "okay");
1348 		break;
1349 	case FDT_STATUS_DISABLED:
1350 		ret = fdt_setprop_string(fdt, nodeoffset, "status", "disabled");
1351 		break;
1352 	case FDT_STATUS_FAIL:
1353 		ret = fdt_setprop_string(fdt, nodeoffset, "status", "fail");
1354 		break;
1355 	case FDT_STATUS_FAIL_ERROR_CODE:
1356 		sprintf(buf, "fail-%d", error_code);
1357 		ret = fdt_setprop_string(fdt, nodeoffset, "status", buf);
1358 		break;
1359 	default:
1360 		printf("Invalid fdt status: %x\n", status);
1361 		ret = -1;
1362 		break;
1363 	}
1364 
1365 	return ret;
1366 }
1367 
1368 /*
1369  * fdt_set_status_by_alias: Set status for the given node given an alias
1370  *
1371  * @fdt: ptr to device tree
1372  * @alias: alias of node to update
1373  * @status: FDT_STATUS_OKAY, FDT_STATUS_DISABLED,
1374  *	    FDT_STATUS_FAIL, FDT_STATUS_FAIL_ERROR_CODE
1375  * @error_code: optional, only used if status is FDT_STATUS_FAIL_ERROR_CODE
1376  */
1377 int fdt_set_status_by_alias(void *fdt, const char* alias,
1378 			    enum fdt_status status, unsigned int error_code)
1379 {
1380 	int offset = fdt_path_offset(fdt, alias);
1381 
1382 	return fdt_set_node_status(fdt, offset, status, error_code);
1383 }
1384 
1385 #if defined(CONFIG_VIDEO) || defined(CONFIG_LCD)
1386 int fdt_add_edid(void *blob, const char *compat, unsigned char *edid_buf)
1387 {
1388 	int noff;
1389 	int ret;
1390 
1391 	noff = fdt_node_offset_by_compatible(blob, -1, compat);
1392 	if (noff != -FDT_ERR_NOTFOUND) {
1393 		debug("%s: %s\n", fdt_get_name(blob, noff, 0), compat);
1394 add_edid:
1395 		ret = fdt_setprop(blob, noff, "edid", edid_buf, 128);
1396 		if (ret == -FDT_ERR_NOSPACE) {
1397 			ret = fdt_increase_size(blob, 512);
1398 			if (!ret)
1399 				goto add_edid;
1400 			else
1401 				goto err_size;
1402 		} else if (ret < 0) {
1403 			printf("Can't add property: %s\n", fdt_strerror(ret));
1404 			return ret;
1405 		}
1406 	}
1407 	return 0;
1408 err_size:
1409 	printf("Can't increase blob size: %s\n", fdt_strerror(ret));
1410 	return ret;
1411 }
1412 #endif
1413 
1414 /*
1415  * Verify the physical address of device tree node for a given alias
1416  *
1417  * This function locates the device tree node of a given alias, and then
1418  * verifies that the physical address of that device matches the given
1419  * parameter.  It displays a message if there is a mismatch.
1420  *
1421  * Returns 1 on success, 0 on failure
1422  */
1423 int fdt_verify_alias_address(void *fdt, int anode, const char *alias, u64 addr)
1424 {
1425 	const char *path;
1426 	const fdt32_t *reg;
1427 	int node, len;
1428 	u64 dt_addr;
1429 
1430 	path = fdt_getprop(fdt, anode, alias, NULL);
1431 	if (!path) {
1432 		/* If there's no such alias, then it's not a failure */
1433 		return 1;
1434 	}
1435 
1436 	node = fdt_path_offset(fdt, path);
1437 	if (node < 0) {
1438 		printf("Warning: device tree alias '%s' points to invalid "
1439 		       "node %s.\n", alias, path);
1440 		return 0;
1441 	}
1442 
1443 	reg = fdt_getprop(fdt, node, "reg", &len);
1444 	if (!reg) {
1445 		printf("Warning: device tree node '%s' has no address.\n",
1446 		       path);
1447 		return 0;
1448 	}
1449 
1450 	dt_addr = fdt_translate_address(fdt, node, reg);
1451 	if (addr != dt_addr) {
1452 		printf("Warning: U-Boot configured device %s at address %"
1453 		       PRIx64 ",\n but the device tree has it address %"
1454 		       PRIx64 ".\n", alias, addr, dt_addr);
1455 		return 0;
1456 	}
1457 
1458 	return 1;
1459 }
1460 
1461 /*
1462  * Returns the base address of an SOC or PCI node
1463  */
1464 u64 fdt_get_base_address(const void *fdt, int node)
1465 {
1466 	int size;
1467 	const fdt32_t *prop;
1468 
1469 	prop = fdt_getprop(fdt, node, "reg", &size);
1470 
1471 	return prop ? fdt_translate_address(fdt, node, prop) : 0;
1472 }
1473 
1474 /*
1475  * Read a property of size <prop_len>. Currently only supports 1 or 2 cells.
1476  */
1477 static int fdt_read_prop(const fdt32_t *prop, int prop_len, int cell_off,
1478 			 uint64_t *val, int cells)
1479 {
1480 	const fdt32_t *prop32 = &prop[cell_off];
1481 	const fdt64_t *prop64 = (const fdt64_t *)&prop[cell_off];
1482 
1483 	if ((cell_off + cells) > prop_len)
1484 		return -FDT_ERR_NOSPACE;
1485 
1486 	switch (cells) {
1487 	case 1:
1488 		*val = fdt32_to_cpu(*prop32);
1489 		break;
1490 	case 2:
1491 		*val = fdt64_to_cpu(*prop64);
1492 		break;
1493 	default:
1494 		return -FDT_ERR_NOSPACE;
1495 	}
1496 
1497 	return 0;
1498 }
1499 
1500 /**
1501  * fdt_read_range - Read a node's n'th range property
1502  *
1503  * @fdt: ptr to device tree
1504  * @node: offset of node
1505  * @n: range index
1506  * @child_addr: pointer to storage for the "child address" field
1507  * @addr: pointer to storage for the CPU view translated physical start
1508  * @len: pointer to storage for the range length
1509  *
1510  * Convenience function that reads and interprets a specific range out of
1511  * a number of the "ranges" property array.
1512  */
1513 int fdt_read_range(void *fdt, int node, int n, uint64_t *child_addr,
1514 		   uint64_t *addr, uint64_t *len)
1515 {
1516 	int pnode = fdt_parent_offset(fdt, node);
1517 	const fdt32_t *ranges;
1518 	int pacells;
1519 	int acells;
1520 	int scells;
1521 	int ranges_len;
1522 	int cell = 0;
1523 	int r = 0;
1524 
1525 	/*
1526 	 * The "ranges" property is an array of
1527 	 * { <child address> <parent address> <size in child address space> }
1528 	 *
1529 	 * All 3 elements can span a diffent number of cells. Fetch their size.
1530 	 */
1531 	pacells = fdt_getprop_u32_default_node(fdt, pnode, 0, "#address-cells", 1);
1532 	acells = fdt_getprop_u32_default_node(fdt, node, 0, "#address-cells", 1);
1533 	scells = fdt_getprop_u32_default_node(fdt, node, 0, "#size-cells", 1);
1534 
1535 	/* Now try to get the ranges property */
1536 	ranges = fdt_getprop(fdt, node, "ranges", &ranges_len);
1537 	if (!ranges)
1538 		return -FDT_ERR_NOTFOUND;
1539 	ranges_len /= sizeof(uint32_t);
1540 
1541 	/* Jump to the n'th entry */
1542 	cell = n * (pacells + acells + scells);
1543 
1544 	/* Read <child address> */
1545 	if (child_addr) {
1546 		r = fdt_read_prop(ranges, ranges_len, cell, child_addr,
1547 				  acells);
1548 		if (r)
1549 			return r;
1550 	}
1551 	cell += acells;
1552 
1553 	/* Read <parent address> */
1554 	if (addr)
1555 		*addr = fdt_translate_address(fdt, node, ranges + cell);
1556 	cell += pacells;
1557 
1558 	/* Read <size in child address space> */
1559 	if (len) {
1560 		r = fdt_read_prop(ranges, ranges_len, cell, len, scells);
1561 		if (r)
1562 			return r;
1563 	}
1564 
1565 	return 0;
1566 }
1567 
1568 /**
1569  * fdt_setup_simplefb_node - Fill and enable a simplefb node
1570  *
1571  * @fdt: ptr to device tree
1572  * @node: offset of the simplefb node
1573  * @base_address: framebuffer base address
1574  * @width: width in pixels
1575  * @height: height in pixels
1576  * @stride: bytes per line
1577  * @format: pixel format string
1578  *
1579  * Convenience function to fill and enable a simplefb node.
1580  */
1581 int fdt_setup_simplefb_node(void *fdt, int node, u64 base_address, u32 width,
1582 			    u32 height, u32 stride, const char *format)
1583 {
1584 	char name[32];
1585 	fdt32_t cells[4];
1586 	int i, addrc, sizec, ret;
1587 
1588 	fdt_support_default_count_cells(fdt, fdt_parent_offset(fdt, node),
1589 					&addrc, &sizec);
1590 	i = 0;
1591 	if (addrc == 2)
1592 		cells[i++] = cpu_to_fdt32(base_address >> 32);
1593 	cells[i++] = cpu_to_fdt32(base_address);
1594 	if (sizec == 2)
1595 		cells[i++] = 0;
1596 	cells[i++] = cpu_to_fdt32(height * stride);
1597 
1598 	ret = fdt_setprop(fdt, node, "reg", cells, sizeof(cells[0]) * i);
1599 	if (ret < 0)
1600 		return ret;
1601 
1602 	snprintf(name, sizeof(name), "framebuffer@%" PRIx64, base_address);
1603 	ret = fdt_set_name(fdt, node, name);
1604 	if (ret < 0)
1605 		return ret;
1606 
1607 	ret = fdt_setprop_u32(fdt, node, "width", width);
1608 	if (ret < 0)
1609 		return ret;
1610 
1611 	ret = fdt_setprop_u32(fdt, node, "height", height);
1612 	if (ret < 0)
1613 		return ret;
1614 
1615 	ret = fdt_setprop_u32(fdt, node, "stride", stride);
1616 	if (ret < 0)
1617 		return ret;
1618 
1619 	ret = fdt_setprop_string(fdt, node, "format", format);
1620 	if (ret < 0)
1621 		return ret;
1622 
1623 	ret = fdt_setprop_string(fdt, node, "status", "okay");
1624 	if (ret < 0)
1625 		return ret;
1626 
1627 	return 0;
1628 }
1629 
1630 /*
1631  * Update native-mode in display-timings from display environment variable.
1632  * The node to update are specified by path.
1633  */
1634 int fdt_fixup_display(void *blob, const char *path, const char *display)
1635 {
1636 	int off, toff;
1637 
1638 	if (!display || !path)
1639 		return -FDT_ERR_NOTFOUND;
1640 
1641 	toff = fdt_path_offset(blob, path);
1642 	if (toff >= 0)
1643 		toff = fdt_subnode_offset(blob, toff, "display-timings");
1644 	if (toff < 0)
1645 		return toff;
1646 
1647 	for (off = fdt_first_subnode(blob, toff);
1648 	     off >= 0;
1649 	     off = fdt_next_subnode(blob, off)) {
1650 		uint32_t h = fdt_get_phandle(blob, off);
1651 		debug("%s:0x%x\n", fdt_get_name(blob, off, NULL),
1652 		      fdt32_to_cpu(h));
1653 		if (strcasecmp(fdt_get_name(blob, off, NULL), display) == 0)
1654 			return fdt_setprop_u32(blob, toff, "native-mode", h);
1655 	}
1656 	return toff;
1657 }
1658 
1659 #ifdef CONFIG_OF_LIBFDT_OVERLAY
1660 /**
1661  * fdt_overlay_apply_verbose - Apply an overlay with verbose error reporting
1662  *
1663  * @fdt: ptr to device tree
1664  * @fdto: ptr to device tree overlay
1665  *
1666  * Convenience function to apply an overlay and display helpful messages
1667  * in the case of an error
1668  */
1669 int fdt_overlay_apply_verbose(void *fdt, void *fdto)
1670 {
1671 	int err;
1672 	bool has_symbols;
1673 
1674 	err = fdt_path_offset(fdt, "/__symbols__");
1675 	has_symbols = err >= 0;
1676 
1677 	err = fdt_overlay_apply(fdt, fdto);
1678 	if (err < 0) {
1679 		printf("failed on fdt_overlay_apply(): %s\n",
1680 				fdt_strerror(err));
1681 		if (!has_symbols) {
1682 			printf("base fdt does did not have a /__symbols__ node\n");
1683 			printf("make sure you've compiled with -@\n");
1684 		}
1685 	}
1686 	return err;
1687 }
1688 #endif
1689