3 * Gerald Van Baren, Custom IDEAS, vanbaren@cideas.com
5 * Copyright 2010-2011 Freescale Semiconductor, Inc.
7 * SPDX-License-Identifier: GPL-2.0+
12 #include <stdio_dev.h>
13 #include <linux/ctype.h>
14 #include <linux/types.h>
15 #include <asm/global_data.h>
17 #include <fdt_support.h>
22 * fdt_getprop_u32_default_node - Return a node's property or a default
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
30 * Convenience function to return a node's property or a default value if
31 * the property doesn't exist.
33 u32
fdt_getprop_u32_default_node(const void *fdt
, int off
, int cell
,
34 const char *prop
, const u32 dflt
)
39 val
= fdt_getprop(fdt
, off
, prop
, &len
);
41 /* Check if property exists */
45 /* Check if property is long enough */
46 if (len
< ((cell
+ 1) * sizeof(uint32_t)))
49 return fdt32_to_cpu(*val
);
53 * fdt_getprop_u32_default - Find a node and return it's property or a default
55 * @fdt: ptr to device tree
57 * @prop: property name
58 * @dflt: default value if the property isn't found
60 * Convenience function to find a node and return it's property or a
61 * default value if it doesn't exist.
63 u32
fdt_getprop_u32_default(const void *fdt
, const char *path
,
64 const char *prop
, const u32 dflt
)
68 off
= fdt_path_offset(fdt
, path
);
72 return fdt_getprop_u32_default_node(fdt
, off
, 0, prop
, dflt
);
76 * fdt_find_and_setprop: Find a node and set it's property
78 * @fdt: ptr to device tree
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
85 * Convenience function to directly set a property given the path to the node.
87 int fdt_find_and_setprop(void *fdt
, const char *node
, const char *prop
,
88 const void *val
, int len
, int create
)
90 int nodeoff
= fdt_path_offset(fdt
, node
);
95 if ((!create
) && (fdt_get_property(fdt
, nodeoff
, prop
, NULL
) == NULL
))
96 return 0; /* create flag not set; so exit quietly */
98 return fdt_setprop(fdt
, nodeoff
, prop
, val
, len
);
102 * fdt_find_or_add_subnode() - find or possibly add a subnode of a given node
104 * @fdt: pointer to the device tree blob
105 * @parentoffset: structure block offset of a node
106 * @name: name of the subnode to locate
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.
111 int fdt_find_or_add_subnode(void *fdt
, int parentoffset
, const char *name
)
115 offset
= fdt_subnode_offset(fdt
, parentoffset
, name
);
117 if (offset
== -FDT_ERR_NOTFOUND
)
118 offset
= fdt_add_subnode(fdt
, parentoffset
, name
);
121 printf("%s: %s: %s\n", __func__
, name
, fdt_strerror(offset
));
126 /* rename to CONFIG_OF_STDOUT_PATH ? */
127 #if defined(OF_STDOUT_PATH)
128 static int fdt_fixup_stdout(void *fdt
, int chosenoff
)
130 return fdt_setprop(fdt
, chosenoff
, "linux,stdout-path",
131 OF_STDOUT_PATH
, strlen(OF_STDOUT_PATH
) + 1);
133 #elif defined(CONFIG_OF_STDOUT_VIA_ALIAS) && defined(CONFIG_CONS_INDEX)
134 static int fdt_fixup_stdout(void *fdt
, int chosenoff
)
138 char sername
[9] = { 0 };
141 char tmp
[256]; /* long enough */
143 sprintf(sername
, "serial%d", CONFIG_CONS_INDEX
- 1);
145 aliasoff
= fdt_path_offset(fdt
, "/aliases");
151 path
= fdt_getprop(fdt
, aliasoff
, sername
, &len
);
157 /* fdt_setprop may break "path" so we copy it to tmp buffer */
158 memcpy(tmp
, path
, len
);
160 err
= fdt_setprop(fdt
, chosenoff
, "linux,stdout-path", tmp
, len
);
162 printf("WARNING: could not set linux,stdout-path %s.\n",
168 printf("WARNING: %s: could not read %s alias: %s\n",
169 __func__
, sername
, fdt_strerror(err
));
174 static int fdt_fixup_stdout(void *fdt
, int chosenoff
)
180 static inline int fdt_setprop_uxx(void *fdt
, int nodeoffset
, const char *name
,
181 uint64_t val
, int is_u64
)
184 return fdt_setprop_u64(fdt
, nodeoffset
, name
, val
);
186 return fdt_setprop_u32(fdt
, nodeoffset
, name
, (uint32_t)val
);
189 int fdt_root(void *fdt
)
194 err
= fdt_check_header(fdt
);
196 printf("fdt_root: %s\n", fdt_strerror(err
));
200 serial
= env_get("serial#");
202 err
= fdt_setprop(fdt
, 0, "serial-number", serial
,
206 printf("WARNING: could not set serial-number %s.\n",
215 int fdt_initrd(void *fdt
, ulong initrd_start
, ulong initrd_end
)
222 /* just return if the size of initrd is zero */
223 if (initrd_start
== initrd_end
)
226 /* find or create "/chosen" node. */
227 nodeoffset
= fdt_find_or_add_subnode(fdt
, 0, "chosen");
231 total
= fdt_num_mem_rsv(fdt
);
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.
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
);
245 err
= fdt_add_mem_rsv(fdt
, initrd_start
, initrd_end
- initrd_start
);
247 printf("fdt_initrd: %s\n", fdt_strerror(err
));
251 is_u64
= (fdt_address_cells(fdt
, 0) == 2);
253 err
= fdt_setprop_uxx(fdt
, nodeoffset
, "linux,initrd-start",
254 (uint64_t)initrd_start
, is_u64
);
257 printf("WARNING: could not set linux,initrd-start %s.\n",
262 err
= fdt_setprop_uxx(fdt
, nodeoffset
, "linux,initrd-end",
263 (uint64_t)initrd_end
, is_u64
);
266 printf("WARNING: could not set linux,initrd-end %s.\n",
275 int fdt_chosen(void *fdt
)
279 char *str
; /* used to set string properties */
281 err
= fdt_check_header(fdt
);
283 printf("fdt_chosen: %s\n", fdt_strerror(err
));
287 /* find or create "/chosen" node. */
288 nodeoffset
= fdt_find_or_add_subnode(fdt
, 0, "chosen");
292 str
= env_get("bootargs");
294 err
= fdt_setprop(fdt
, nodeoffset
, "bootargs", str
,
297 printf("WARNING: could not set bootargs %s.\n",
303 return fdt_fixup_stdout(fdt
, nodeoffset
);
306 void do_fixup_by_path(void *fdt
, const char *path
, const char *prop
,
307 const void *val
, int len
, int create
)
311 debug("Updating property '%s/%s' = ", path
, prop
);
312 for (i
= 0; i
< len
; i
++)
313 debug(" %.2x", *(u8
*)(val
+i
));
316 int rc
= fdt_find_and_setprop(fdt
, path
, prop
, val
, len
, create
);
318 printf("Unable to update property %s:%s, err=%s\n",
319 path
, prop
, fdt_strerror(rc
));
322 void do_fixup_by_path_u32(void *fdt
, const char *path
, const char *prop
,
325 fdt32_t tmp
= cpu_to_fdt32(val
);
326 do_fixup_by_path(fdt
, path
, prop
, &tmp
, sizeof(tmp
), create
);
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
,
337 debug("Updating property '%s' = ", prop
);
338 for (i
= 0; i
< len
; i
++)
339 debug(" %.2x", *(u8
*)(val
+i
));
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
);
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
)
354 fdt32_t tmp
= cpu_to_fdt32(val
);
355 do_fixup_by_prop(fdt
, pname
, pval
, plen
, prop
, &tmp
, 4, create
);
358 void do_fixup_by_compat(void *fdt
, const char *compat
,
359 const char *prop
, const void *val
, int len
, int create
)
364 debug("Updating property '%s' = ", prop
);
365 for (i
= 0; i
< len
; i
++)
366 debug(" %.2x", *(u8
*)(val
+i
));
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
);
377 void do_fixup_by_compat_u32(void *fdt
, const char *compat
,
378 const char *prop
, u32 val
, int create
)
380 fdt32_t tmp
= cpu_to_fdt32(val
);
381 do_fixup_by_compat(fdt
, compat
, prop
, &tmp
, 4, create
);
384 #ifdef CONFIG_ARCH_FIXUP_FDT_MEMORY
386 * fdt_pack_reg - pack address and size array into the "reg"-suitable stream
388 static int fdt_pack_reg(const void *fdt
, void *buf
, u64
*address
, u64
*size
,
392 int address_cells
= fdt_address_cells(fdt
, 0);
393 int size_cells
= fdt_size_cells(fdt
, 0);
396 for (i
= 0; i
< n
; i
++) {
397 if (address_cells
== 2)
398 *(fdt64_t
*)p
= cpu_to_fdt64(address
[i
]);
400 *(fdt32_t
*)p
= cpu_to_fdt32(address
[i
]);
401 p
+= 4 * address_cells
;
404 *(fdt64_t
*)p
= cpu_to_fdt64(size
[i
]);
406 *(fdt32_t
*)p
= cpu_to_fdt32(size
[i
]);
410 return p
- (char *)buf
;
413 int fdt_record_loadable(void *blob
, u32 index
, const char *name
,
414 uintptr_t load_addr
, u32 size
, uintptr_t entry_point
,
415 const char *type
, const char *os
)
419 err
= fdt_check_header(blob
);
421 printf("%s: %s\n", __func__
, fdt_strerror(err
));
425 /* find or create "/fit-images" node */
426 node
= fdt_find_or_add_subnode(blob
, 0, "fit-images");
430 /* find or create "/fit-images/<name>" node */
431 node
= fdt_find_or_add_subnode(blob
, node
, name
);
436 * We record these as 32bit entities, possibly truncating addresses.
437 * However, spl_fit.c is not 64bit safe either: i.e. we should not
438 * have an issue here.
440 fdt_setprop_u32(blob
, node
, "load-addr", load_addr
);
441 if (entry_point
!= -1)
442 fdt_setprop_u32(blob
, node
, "entry-point", entry_point
);
443 fdt_setprop_u32(blob
, node
, "size", size
);
445 fdt_setprop_string(blob
, node
, "type", type
);
447 fdt_setprop_string(blob
, node
, "os", os
);
452 #ifdef CONFIG_NR_DRAM_BANKS
453 #define MEMORY_BANKS_MAX CONFIG_NR_DRAM_BANKS
455 #define MEMORY_BANKS_MAX 4
457 int fdt_fixup_memory_banks(void *blob
, u64 start
[], u64 size
[], int banks
)
461 u8 tmp
[MEMORY_BANKS_MAX
* 16]; /* Up to 64-bit address + 64-bit size */
463 if (banks
> MEMORY_BANKS_MAX
) {
464 printf("%s: num banks %d exceeds hardcoded limit %d."
465 " Recompile with higher MEMORY_BANKS_MAX?\n",
466 __FUNCTION__
, banks
, MEMORY_BANKS_MAX
);
470 err
= fdt_check_header(blob
);
472 printf("%s: %s\n", __FUNCTION__
, fdt_strerror(err
));
476 /* find or create "/memory" node. */
477 nodeoffset
= fdt_find_or_add_subnode(blob
, 0, "memory");
481 err
= fdt_setprop(blob
, nodeoffset
, "device_type", "memory",
484 printf("WARNING: could not set %s %s.\n", "device_type",
492 len
= fdt_pack_reg(blob
, tmp
, start
, size
, banks
);
494 err
= fdt_setprop(blob
, nodeoffset
, "reg", tmp
, len
);
496 printf("WARNING: could not set %s %s.\n",
497 "reg", fdt_strerror(err
));
504 int fdt_fixup_memory(void *blob
, u64 start
, u64 size
)
506 return fdt_fixup_memory_banks(blob
, &start
, &size
, 1);
509 void fdt_fixup_ethernet(void *fdt
)
515 unsigned char mac_addr
[ARP_HLEN
];
518 if (fdt_path_offset(fdt
, "/aliases") < 0)
521 /* Cycle through all aliases */
522 for (prop
= 0; ; prop
++) {
525 /* FDT might have been edited, recompute the offset */
526 offset
= fdt_first_property_offset(fdt
,
527 fdt_path_offset(fdt
, "/aliases"));
528 /* Select property number 'prop' */
529 for (i
= 0; i
< prop
; i
++)
530 offset
= fdt_next_property_offset(fdt
, offset
);
535 path
= fdt_getprop_by_offset(fdt
, offset
, &name
, NULL
);
536 if (!strncmp(name
, "ethernet", 8)) {
537 /* Treat plain "ethernet" same as "ethernet0". */
538 if (!strcmp(name
, "ethernet"))
541 i
= trailing_strtol(name
);
545 strcpy(mac
, "ethaddr");
547 sprintf(mac
, "eth%daddr", i
);
555 for (j
= 0; j
< 6; j
++) {
557 simple_strtoul(tmp
, &end
, 16) : 0;
559 tmp
= (*end
) ? end
+ 1 : end
;
562 do_fixup_by_path(fdt
, path
, "mac-address",
564 do_fixup_by_path(fdt
, path
, "local-mac-address",
570 /* Resize the fdt to its actual size + a bit of padding */
571 int fdt_shrink_to_minimum(void *blob
, uint extrasize
)
581 total
= fdt_num_mem_rsv(blob
);
582 for (i
= 0; i
< total
; i
++) {
583 fdt_get_mem_rsv(blob
, i
, &addr
, &size
);
584 if (addr
== (uintptr_t)blob
) {
585 fdt_del_mem_rsv(blob
, i
);
591 * Calculate the actual size of the fdt
592 * plus the size needed for 5 fdt_add_mem_rsv, one
593 * for the fdt itself and 4 for a possible initrd
594 * ((initrd-start + initrd-end) * 2 (name & value))
596 actualsize
= fdt_off_dt_strings(blob
) +
597 fdt_size_dt_strings(blob
) + 5 * sizeof(struct fdt_reserve_entry
);
599 actualsize
+= extrasize
;
600 /* Make it so the fdt ends on a page boundary */
601 actualsize
= ALIGN(actualsize
+ ((uintptr_t)blob
& 0xfff), 0x1000);
602 actualsize
= actualsize
- ((uintptr_t)blob
& 0xfff);
604 /* Change the fdt header to reflect the correct size */
605 fdt_set_totalsize(blob
, actualsize
);
607 /* Add the new reservation */
608 ret
= fdt_add_mem_rsv(blob
, (uintptr_t)blob
, actualsize
);
616 #define CONFIG_SYS_PCI_NR_INBOUND_WIN 4
618 #define FDT_PCI_PREFETCH (0x40000000)
619 #define FDT_PCI_MEM32 (0x02000000)
620 #define FDT_PCI_IO (0x01000000)
621 #define FDT_PCI_MEM64 (0x03000000)
623 int fdt_pci_dma_ranges(void *blob
, int phb_off
, struct pci_controller
*hose
) {
625 int addrcell
, sizecell
, len
, r
;
627 /* sized based on pci addr cells, size-cells, & address-cells */
628 u32 dma_ranges
[(3 + 2 + 2) * CONFIG_SYS_PCI_NR_INBOUND_WIN
];
630 addrcell
= fdt_getprop_u32_default(blob
, "/", "#address-cells", 1);
631 sizecell
= fdt_getprop_u32_default(blob
, "/", "#size-cells", 1);
633 dma_range
= &dma_ranges
[0];
634 for (r
= 0; r
< hose
->region_count
; r
++) {
635 u64 bus_start
, phys_start
, size
;
637 /* skip if !PCI_REGION_SYS_MEMORY */
638 if (!(hose
->regions
[r
].flags
& PCI_REGION_SYS_MEMORY
))
641 bus_start
= (u64
)hose
->regions
[r
].bus_start
;
642 phys_start
= (u64
)hose
->regions
[r
].phys_start
;
643 size
= (u64
)hose
->regions
[r
].size
;
646 if (size
>= 0x100000000ull
)
647 dma_range
[0] |= FDT_PCI_MEM64
;
649 dma_range
[0] |= FDT_PCI_MEM32
;
650 if (hose
->regions
[r
].flags
& PCI_REGION_PREFETCH
)
651 dma_range
[0] |= FDT_PCI_PREFETCH
;
652 #ifdef CONFIG_SYS_PCI_64BIT
653 dma_range
[1] = bus_start
>> 32;
657 dma_range
[2] = bus_start
& 0xffffffff;
660 dma_range
[3] = phys_start
>> 32;
661 dma_range
[4] = phys_start
& 0xffffffff;
663 dma_range
[3] = phys_start
& 0xffffffff;
667 dma_range
[3 + addrcell
+ 0] = size
>> 32;
668 dma_range
[3 + addrcell
+ 1] = size
& 0xffffffff;
670 dma_range
[3 + addrcell
+ 0] = size
& 0xffffffff;
673 dma_range
+= (3 + addrcell
+ sizecell
);
676 len
= dma_range
- &dma_ranges
[0];
678 fdt_setprop(blob
, phb_off
, "dma-ranges", &dma_ranges
[0], len
*4);
684 int fdt_increase_size(void *fdt
, int add_len
)
688 newlen
= fdt_totalsize(fdt
) + add_len
;
690 /* Open in place with a new len */
691 return fdt_open_into(fdt
, fdt
, newlen
);
694 #ifdef CONFIG_FDT_FIXUP_PARTITIONS
695 #include <jffs2/load_kernel.h>
696 #include <mtd_node.h>
703 int fdt_del_subnodes(const void *blob
, int parent_offset
)
708 for (ndepth
= 0, off
= fdt_next_node(blob
, parent_offset
, &ndepth
);
709 (off
>= 0) && (ndepth
> 0);
710 off
= fdt_next_node(blob
, off
, &ndepth
)) {
712 debug("delete %s: offset: %x\n",
713 fdt_get_name(blob
, off
, 0), off
);
714 ret
= fdt_del_node((void *)blob
, off
);
716 printf("Can't delete node: %s\n",
728 int fdt_del_partitions(void *blob
, int parent_offset
)
735 off
= fdt_next_node(blob
, parent_offset
, &ndepth
);
736 if (off
> 0 && ndepth
== 1) {
737 prop
= fdt_getprop(blob
, off
, "label", NULL
);
740 * Could not find label property, nand {}; node?
741 * Check subnode, delete partitions there if any.
743 return fdt_del_partitions(blob
, off
);
745 ret
= fdt_del_subnodes(blob
, parent_offset
);
747 printf("Can't remove subnodes: %s\n",
756 int fdt_node_set_part_info(void *blob
, int parent_offset
,
757 struct mtd_device
*dev
)
759 struct list_head
*pentry
;
760 struct part_info
*part
;
761 struct reg_cell cell
;
766 ret
= fdt_del_partitions(blob
, parent_offset
);
771 * Check if it is nand {}; subnode, adjust
772 * the offset in this case
774 off
= fdt_next_node(blob
, parent_offset
, &ndepth
);
775 if (off
> 0 && ndepth
== 1)
779 list_for_each_prev(pentry
, &dev
->parts
) {
782 part
= list_entry(pentry
, struct part_info
, link
);
784 debug("%2d: %-20s0x%08llx\t0x%08llx\t%d\n",
785 part_num
, part
->name
, part
->size
,
786 part
->offset
, part
->mask_flags
);
788 sprintf(buf
, "partition@%llx", part
->offset
);
790 ret
= fdt_add_subnode(blob
, parent_offset
, buf
);
791 if (ret
== -FDT_ERR_NOSPACE
) {
792 ret
= fdt_increase_size(blob
, 512);
797 } else if (ret
< 0) {
798 printf("Can't add partition node: %s\n",
804 /* Check MTD_WRITEABLE_CMD flag */
805 if (part
->mask_flags
& 1) {
807 ret
= fdt_setprop(blob
, newoff
, "read_only", NULL
, 0);
808 if (ret
== -FDT_ERR_NOSPACE
) {
809 ret
= fdt_increase_size(blob
, 512);
818 cell
.r0
= cpu_to_fdt32(part
->offset
);
819 cell
.r1
= cpu_to_fdt32(part
->size
);
821 ret
= fdt_setprop(blob
, newoff
, "reg", &cell
, sizeof(cell
));
822 if (ret
== -FDT_ERR_NOSPACE
) {
823 ret
= fdt_increase_size(blob
, 512);
832 ret
= fdt_setprop_string(blob
, newoff
, "label", part
->name
);
833 if (ret
== -FDT_ERR_NOSPACE
) {
834 ret
= fdt_increase_size(blob
, 512);
846 printf("Can't increase blob size: %s\n", fdt_strerror(ret
));
849 printf("Can't add property: %s\n", fdt_strerror(ret
));
854 * Update partitions in nor/nand nodes using info from
855 * mtdparts environment variable. The nodes to update are
856 * specified by node_info structure which contains mtd device
857 * type and compatible string: E. g. the board code in
858 * ft_board_setup() could use:
860 * struct node_info nodes[] = {
861 * { "fsl,mpc5121-nfc", MTD_DEV_TYPE_NAND, },
862 * { "cfi-flash", MTD_DEV_TYPE_NOR, },
865 * fdt_fixup_mtdparts(blob, nodes, ARRAY_SIZE(nodes));
867 void fdt_fixup_mtdparts(void *blob
, void *node_info
, int node_info_size
)
869 struct node_info
*ni
= node_info
;
870 struct mtd_device
*dev
;
874 if (mtdparts_init() != 0)
877 for (i
= 0; i
< node_info_size
; i
++) {
879 noff
= fdt_node_offset_by_compatible(blob
, -1, ni
[i
].compat
);
880 while (noff
!= -FDT_ERR_NOTFOUND
) {
881 debug("%s: %s, mtd dev type %d\n",
882 fdt_get_name(blob
, noff
, 0),
883 ni
[i
].compat
, ni
[i
].type
);
884 dev
= device_find(ni
[i
].type
, idx
++);
886 if (fdt_node_set_part_info(blob
, noff
, dev
))
887 return; /* return on error */
890 /* Jump to next flash node */
891 noff
= fdt_node_offset_by_compatible(blob
, noff
,
898 void fdt_del_node_and_alias(void *blob
, const char *alias
)
900 int off
= fdt_path_offset(blob
, alias
);
905 fdt_del_node(blob
, off
);
907 off
= fdt_path_offset(blob
, "/aliases");
908 fdt_delprop(blob
, off
, alias
);
911 /* Max address size we deal with */
912 #define OF_MAX_ADDR_CELLS 4
913 #define OF_BAD_ADDR FDT_ADDR_T_NONE
914 #define OF_CHECK_COUNTS(na, ns) ((na) > 0 && (na) <= OF_MAX_ADDR_CELLS && \
919 static void of_dump_addr(const char *s
, const fdt32_t
*addr
, int na
)
923 printf(" %08x", *(addr
++));
927 static void of_dump_addr(const char *s
, const fdt32_t
*addr
, int na
) { }
931 * struct of_bus - Callbacks for bus specific translators
932 * @name: A string used to identify this bus in debug output.
933 * @addresses: The name of the DT property from which addresses are
934 * to be read, typically "reg".
935 * @match: Return non-zero if the node whose parent is at
936 * parentoffset in the FDT blob corresponds to a bus
937 * of this type, otherwise return zero. If NULL a match
939 * @count_cells:Count how many cells (be32 values) a node whose parent
940 * is at parentoffset in the FDT blob will require to
941 * represent its address (written to *addrc) & size
942 * (written to *sizec).
943 * @map: Map the address addr from the address space of this
944 * bus to that of its parent, making use of the ranges
945 * read from DT to an array at range. na and ns are the
946 * number of cells (be32 values) used to hold and address
947 * or size, respectively, for this bus. pna is the number
948 * of cells used to hold an address for the parent bus.
949 * Returns the address in the address space of the parent
951 * @translate: Update the value of the address cells at addr within an
952 * FDT by adding offset to it. na specifies the number of
953 * cells used to hold the address being translated. Returns
954 * zero on success, non-zero on error.
956 * Each bus type will include a struct of_bus in the of_busses array,
957 * providing implementations of some or all of the functions used to
958 * match the bus & handle address translation for its children.
962 const char *addresses
;
963 int (*match
)(const void *blob
, int parentoffset
);
964 void (*count_cells
)(const void *blob
, int parentoffset
,
965 int *addrc
, int *sizec
);
966 u64 (*map
)(fdt32_t
*addr
, const fdt32_t
*range
,
967 int na
, int ns
, int pna
);
968 int (*translate
)(fdt32_t
*addr
, u64 offset
, int na
);
971 /* Default translator (generic bus) */
972 void fdt_support_default_count_cells(const void *blob
, int parentoffset
,
973 int *addrc
, int *sizec
)
978 *addrc
= fdt_address_cells(blob
, parentoffset
);
981 prop
= fdt_getprop(blob
, parentoffset
, "#size-cells", NULL
);
983 *sizec
= be32_to_cpup(prop
);
989 static u64
of_bus_default_map(fdt32_t
*addr
, const fdt32_t
*range
,
990 int na
, int ns
, int pna
)
994 cp
= fdt_read_number(range
, na
);
995 s
= fdt_read_number(range
+ na
+ pna
, ns
);
996 da
= fdt_read_number(addr
, na
);
998 debug("OF: default map, cp=%" PRIu64
", s=%" PRIu64
999 ", da=%" PRIu64
"\n", cp
, s
, da
);
1001 if (da
< cp
|| da
>= (cp
+ s
))
1006 static int of_bus_default_translate(fdt32_t
*addr
, u64 offset
, int na
)
1008 u64 a
= fdt_read_number(addr
, na
);
1009 memset(addr
, 0, na
* 4);
1012 addr
[na
- 2] = cpu_to_fdt32(a
>> 32);
1013 addr
[na
- 1] = cpu_to_fdt32(a
& 0xffffffffu
);
1018 #ifdef CONFIG_OF_ISA_BUS
1020 /* ISA bus translator */
1021 static int of_bus_isa_match(const void *blob
, int parentoffset
)
1025 name
= fdt_get_name(blob
, parentoffset
, NULL
);
1029 return !strcmp(name
, "isa");
1032 static void of_bus_isa_count_cells(const void *blob
, int parentoffset
,
1033 int *addrc
, int *sizec
)
1041 static u64
of_bus_isa_map(fdt32_t
*addr
, const fdt32_t
*range
,
1042 int na
, int ns
, int pna
)
1046 /* Check address type match */
1047 if ((addr
[0] ^ range
[0]) & cpu_to_be32(1))
1050 cp
= fdt_read_number(range
+ 1, na
- 1);
1051 s
= fdt_read_number(range
+ na
+ pna
, ns
);
1052 da
= fdt_read_number(addr
+ 1, na
- 1);
1054 debug("OF: ISA map, cp=%" PRIu64
", s=%" PRIu64
1055 ", da=%" PRIu64
"\n", cp
, s
, da
);
1057 if (da
< cp
|| da
>= (cp
+ s
))
1062 static int of_bus_isa_translate(fdt32_t
*addr
, u64 offset
, int na
)
1064 return of_bus_default_translate(addr
+ 1, offset
, na
- 1);
1067 #endif /* CONFIG_OF_ISA_BUS */
1069 /* Array of bus specific translators */
1070 static struct of_bus of_busses
[] = {
1071 #ifdef CONFIG_OF_ISA_BUS
1076 .match
= of_bus_isa_match
,
1077 .count_cells
= of_bus_isa_count_cells
,
1078 .map
= of_bus_isa_map
,
1079 .translate
= of_bus_isa_translate
,
1081 #endif /* CONFIG_OF_ISA_BUS */
1086 .count_cells
= fdt_support_default_count_cells
,
1087 .map
= of_bus_default_map
,
1088 .translate
= of_bus_default_translate
,
1092 static struct of_bus
*of_match_bus(const void *blob
, int parentoffset
)
1096 if (ARRAY_SIZE(of_busses
) == 1)
1099 for (bus
= of_busses
; bus
; bus
++) {
1100 if (!bus
->match
|| bus
->match(blob
, parentoffset
))
1105 * We should always have matched the default bus at least, since
1106 * it has a NULL match field. If we didn't then it somehow isn't
1107 * in the of_busses array or something equally catastrophic has
1114 static int of_translate_one(const void *blob
, int parent
, struct of_bus
*bus
,
1115 struct of_bus
*pbus
, fdt32_t
*addr
,
1116 int na
, int ns
, int pna
, const char *rprop
)
1118 const fdt32_t
*ranges
;
1121 u64 offset
= OF_BAD_ADDR
;
1123 /* Normally, an absence of a "ranges" property means we are
1124 * crossing a non-translatable boundary, and thus the addresses
1125 * below the current not cannot be converted to CPU physical ones.
1126 * Unfortunately, while this is very clear in the spec, it's not
1127 * what Apple understood, and they do have things like /uni-n or
1128 * /ht nodes with no "ranges" property and a lot of perfectly
1129 * useable mapped devices below them. Thus we treat the absence of
1130 * "ranges" as equivalent to an empty "ranges" property which means
1131 * a 1:1 translation at that level. It's up to the caller not to try
1132 * to translate addresses that aren't supposed to be translated in
1133 * the first place. --BenH.
1135 ranges
= fdt_getprop(blob
, parent
, rprop
, &rlen
);
1136 if (ranges
== NULL
|| rlen
== 0) {
1137 offset
= fdt_read_number(addr
, na
);
1138 memset(addr
, 0, pna
* 4);
1139 debug("OF: no ranges, 1:1 translation\n");
1143 debug("OF: walking ranges...\n");
1145 /* Now walk through the ranges */
1147 rone
= na
+ pna
+ ns
;
1148 for (; rlen
>= rone
; rlen
-= rone
, ranges
+= rone
) {
1149 offset
= bus
->map(addr
, ranges
, na
, ns
, pna
);
1150 if (offset
!= OF_BAD_ADDR
)
1153 if (offset
== OF_BAD_ADDR
) {
1154 debug("OF: not found !\n");
1157 memcpy(addr
, ranges
+ na
, 4 * pna
);
1160 of_dump_addr("OF: parent translation for:", addr
, pna
);
1161 debug("OF: with offset: %" PRIu64
"\n", offset
);
1163 /* Translate it into parent bus space */
1164 return pbus
->translate(addr
, offset
, pna
);
1168 * Translate an address from the device-tree into a CPU physical address,
1169 * this walks up the tree and applies the various bus mappings on the
1172 * Note: We consider that crossing any level with #size-cells == 0 to mean
1173 * that translation is impossible (that is we are not dealing with a value
1174 * that can be mapped to a cpu physical address). This is not really specified
1175 * that way, but this is traditionally the way IBM at least do things
1177 static u64
__of_translate_address(const void *blob
, int node_offset
,
1178 const fdt32_t
*in_addr
, const char *rprop
)
1181 struct of_bus
*bus
, *pbus
;
1182 fdt32_t addr
[OF_MAX_ADDR_CELLS
];
1183 int na
, ns
, pna
, pns
;
1184 u64 result
= OF_BAD_ADDR
;
1186 debug("OF: ** translation for device %s **\n",
1187 fdt_get_name(blob
, node_offset
, NULL
));
1189 /* Get parent & match bus type */
1190 parent
= fdt_parent_offset(blob
, node_offset
);
1193 bus
= of_match_bus(blob
, parent
);
1195 /* Cound address cells & copy address locally */
1196 bus
->count_cells(blob
, parent
, &na
, &ns
);
1197 if (!OF_CHECK_COUNTS(na
, ns
)) {
1198 printf("%s: Bad cell count for %s\n", __FUNCTION__
,
1199 fdt_get_name(blob
, node_offset
, NULL
));
1202 memcpy(addr
, in_addr
, na
* 4);
1204 debug("OF: bus is %s (na=%d, ns=%d) on %s\n",
1205 bus
->name
, na
, ns
, fdt_get_name(blob
, parent
, NULL
));
1206 of_dump_addr("OF: translating address:", addr
, na
);
1210 /* Switch to parent bus */
1211 node_offset
= parent
;
1212 parent
= fdt_parent_offset(blob
, node_offset
);
1214 /* If root, we have finished */
1216 debug("OF: reached root node\n");
1217 result
= fdt_read_number(addr
, na
);
1221 /* Get new parent bus and counts */
1222 pbus
= of_match_bus(blob
, parent
);
1223 pbus
->count_cells(blob
, parent
, &pna
, &pns
);
1224 if (!OF_CHECK_COUNTS(pna
, pns
)) {
1225 printf("%s: Bad cell count for %s\n", __FUNCTION__
,
1226 fdt_get_name(blob
, node_offset
, NULL
));
1230 debug("OF: parent bus is %s (na=%d, ns=%d) on %s\n",
1231 pbus
->name
, pna
, pns
, fdt_get_name(blob
, parent
, NULL
));
1233 /* Apply bus translation */
1234 if (of_translate_one(blob
, node_offset
, bus
, pbus
,
1235 addr
, na
, ns
, pna
, rprop
))
1238 /* Complete the move up one level */
1243 of_dump_addr("OF: one level translation:", addr
, na
);
1250 u64
fdt_translate_address(const void *blob
, int node_offset
,
1251 const fdt32_t
*in_addr
)
1253 return __of_translate_address(blob
, node_offset
, in_addr
, "ranges");
1257 * fdt_node_offset_by_compat_reg: Find a node that matches compatiable and
1258 * who's reg property matches a physical cpu address
1260 * @blob: ptr to device tree
1261 * @compat: compatiable string to match
1262 * @compat_off: property name
1265 int fdt_node_offset_by_compat_reg(void *blob
, const char *compat
,
1266 phys_addr_t compat_off
)
1268 int len
, off
= fdt_node_offset_by_compatible(blob
, -1, compat
);
1269 while (off
!= -FDT_ERR_NOTFOUND
) {
1270 const fdt32_t
*reg
= fdt_getprop(blob
, off
, "reg", &len
);
1272 if (compat_off
== fdt_translate_address(blob
, off
, reg
))
1275 off
= fdt_node_offset_by_compatible(blob
, off
, compat
);
1278 return -FDT_ERR_NOTFOUND
;
1282 * fdt_alloc_phandle: Return next free phandle value
1284 * @blob: ptr to device tree
1286 int fdt_alloc_phandle(void *blob
)
1289 uint32_t phandle
= 0;
1291 for (offset
= fdt_next_node(blob
, -1, NULL
); offset
>= 0;
1292 offset
= fdt_next_node(blob
, offset
, NULL
)) {
1293 phandle
= max(phandle
, fdt_get_phandle(blob
, offset
));
1300 * fdt_set_phandle: Create a phandle property for the given node
1302 * @fdt: ptr to device tree
1303 * @nodeoffset: node to update
1304 * @phandle: phandle value to set (must be unique)
1306 int fdt_set_phandle(void *fdt
, int nodeoffset
, uint32_t phandle
)
1311 int off
= fdt_node_offset_by_phandle(fdt
, phandle
);
1313 if ((off
>= 0) && (off
!= nodeoffset
)) {
1316 fdt_get_path(fdt
, nodeoffset
, buf
, sizeof(buf
));
1317 printf("Trying to update node %s with phandle %u ",
1320 fdt_get_path(fdt
, off
, buf
, sizeof(buf
));
1321 printf("that already exists in node %s.\n", buf
);
1322 return -FDT_ERR_BADPHANDLE
;
1326 ret
= fdt_setprop_cell(fdt
, nodeoffset
, "phandle", phandle
);
1331 * For now, also set the deprecated "linux,phandle" property, so that we
1332 * don't break older kernels.
1334 ret
= fdt_setprop_cell(fdt
, nodeoffset
, "linux,phandle", phandle
);
1340 * fdt_create_phandle: Create a phandle property for the given node
1342 * @fdt: ptr to device tree
1343 * @nodeoffset: node to update
1345 unsigned int fdt_create_phandle(void *fdt
, int nodeoffset
)
1347 /* see if there is a phandle already */
1348 int phandle
= fdt_get_phandle(fdt
, nodeoffset
);
1350 /* if we got 0, means no phandle so create one */
1354 phandle
= fdt_alloc_phandle(fdt
);
1355 ret
= fdt_set_phandle(fdt
, nodeoffset
, phandle
);
1357 printf("Can't set phandle %u: %s\n", phandle
,
1367 * fdt_set_node_status: Set status for the given node
1369 * @fdt: ptr to device tree
1370 * @nodeoffset: node to update
1371 * @status: FDT_STATUS_OKAY, FDT_STATUS_DISABLED,
1372 * FDT_STATUS_FAIL, FDT_STATUS_FAIL_ERROR_CODE
1373 * @error_code: optional, only used if status is FDT_STATUS_FAIL_ERROR_CODE
1375 int fdt_set_node_status(void *fdt
, int nodeoffset
,
1376 enum fdt_status status
, unsigned int error_code
)
1385 case FDT_STATUS_OKAY
:
1386 ret
= fdt_setprop_string(fdt
, nodeoffset
, "status", "okay");
1388 case FDT_STATUS_DISABLED
:
1389 ret
= fdt_setprop_string(fdt
, nodeoffset
, "status", "disabled");
1391 case FDT_STATUS_FAIL
:
1392 ret
= fdt_setprop_string(fdt
, nodeoffset
, "status", "fail");
1394 case FDT_STATUS_FAIL_ERROR_CODE
:
1395 sprintf(buf
, "fail-%d", error_code
);
1396 ret
= fdt_setprop_string(fdt
, nodeoffset
, "status", buf
);
1399 printf("Invalid fdt status: %x\n", status
);
1408 * fdt_set_status_by_alias: Set status for the given node given an alias
1410 * @fdt: ptr to device tree
1411 * @alias: alias of node to update
1412 * @status: FDT_STATUS_OKAY, FDT_STATUS_DISABLED,
1413 * FDT_STATUS_FAIL, FDT_STATUS_FAIL_ERROR_CODE
1414 * @error_code: optional, only used if status is FDT_STATUS_FAIL_ERROR_CODE
1416 int fdt_set_status_by_alias(void *fdt
, const char* alias
,
1417 enum fdt_status status
, unsigned int error_code
)
1419 int offset
= fdt_path_offset(fdt
, alias
);
1421 return fdt_set_node_status(fdt
, offset
, status
, error_code
);
1424 #if defined(CONFIG_VIDEO) || defined(CONFIG_LCD)
1425 int fdt_add_edid(void *blob
, const char *compat
, unsigned char *edid_buf
)
1430 noff
= fdt_node_offset_by_compatible(blob
, -1, compat
);
1431 if (noff
!= -FDT_ERR_NOTFOUND
) {
1432 debug("%s: %s\n", fdt_get_name(blob
, noff
, 0), compat
);
1434 ret
= fdt_setprop(blob
, noff
, "edid", edid_buf
, 128);
1435 if (ret
== -FDT_ERR_NOSPACE
) {
1436 ret
= fdt_increase_size(blob
, 512);
1441 } else if (ret
< 0) {
1442 printf("Can't add property: %s\n", fdt_strerror(ret
));
1448 printf("Can't increase blob size: %s\n", fdt_strerror(ret
));
1454 * Verify the physical address of device tree node for a given alias
1456 * This function locates the device tree node of a given alias, and then
1457 * verifies that the physical address of that device matches the given
1458 * parameter. It displays a message if there is a mismatch.
1460 * Returns 1 on success, 0 on failure
1462 int fdt_verify_alias_address(void *fdt
, int anode
, const char *alias
, u64 addr
)
1469 path
= fdt_getprop(fdt
, anode
, alias
, NULL
);
1471 /* If there's no such alias, then it's not a failure */
1475 node
= fdt_path_offset(fdt
, path
);
1477 printf("Warning: device tree alias '%s' points to invalid "
1478 "node %s.\n", alias
, path
);
1482 reg
= fdt_getprop(fdt
, node
, "reg", &len
);
1484 printf("Warning: device tree node '%s' has no address.\n",
1489 dt_addr
= fdt_translate_address(fdt
, node
, reg
);
1490 if (addr
!= dt_addr
) {
1491 printf("Warning: U-Boot configured device %s at address %"
1492 PRIx64
",\n but the device tree has it address %"
1493 PRIx64
".\n", alias
, addr
, dt_addr
);
1501 * Returns the base address of an SOC or PCI node
1503 u64
fdt_get_base_address(const void *fdt
, int node
)
1506 const fdt32_t
*prop
;
1508 prop
= fdt_getprop(fdt
, node
, "reg", &size
);
1510 return prop
? fdt_translate_address(fdt
, node
, prop
) : 0;
1514 * Read a property of size <prop_len>. Currently only supports 1 or 2 cells.
1516 static int fdt_read_prop(const fdt32_t
*prop
, int prop_len
, int cell_off
,
1517 uint64_t *val
, int cells
)
1519 const fdt32_t
*prop32
= &prop
[cell_off
];
1520 const fdt64_t
*prop64
= (const fdt64_t
*)&prop
[cell_off
];
1522 if ((cell_off
+ cells
) > prop_len
)
1523 return -FDT_ERR_NOSPACE
;
1527 *val
= fdt32_to_cpu(*prop32
);
1530 *val
= fdt64_to_cpu(*prop64
);
1533 return -FDT_ERR_NOSPACE
;
1540 * fdt_read_range - Read a node's n'th range property
1542 * @fdt: ptr to device tree
1543 * @node: offset of node
1545 * @child_addr: pointer to storage for the "child address" field
1546 * @addr: pointer to storage for the CPU view translated physical start
1547 * @len: pointer to storage for the range length
1549 * Convenience function that reads and interprets a specific range out of
1550 * a number of the "ranges" property array.
1552 int fdt_read_range(void *fdt
, int node
, int n
, uint64_t *child_addr
,
1553 uint64_t *addr
, uint64_t *len
)
1555 int pnode
= fdt_parent_offset(fdt
, node
);
1556 const fdt32_t
*ranges
;
1565 * The "ranges" property is an array of
1566 * { <child address> <parent address> <size in child address space> }
1568 * All 3 elements can span a diffent number of cells. Fetch their size.
1570 pacells
= fdt_getprop_u32_default_node(fdt
, pnode
, 0, "#address-cells", 1);
1571 acells
= fdt_getprop_u32_default_node(fdt
, node
, 0, "#address-cells", 1);
1572 scells
= fdt_getprop_u32_default_node(fdt
, node
, 0, "#size-cells", 1);
1574 /* Now try to get the ranges property */
1575 ranges
= fdt_getprop(fdt
, node
, "ranges", &ranges_len
);
1577 return -FDT_ERR_NOTFOUND
;
1578 ranges_len
/= sizeof(uint32_t);
1580 /* Jump to the n'th entry */
1581 cell
= n
* (pacells
+ acells
+ scells
);
1583 /* Read <child address> */
1585 r
= fdt_read_prop(ranges
, ranges_len
, cell
, child_addr
,
1592 /* Read <parent address> */
1594 *addr
= fdt_translate_address(fdt
, node
, ranges
+ cell
);
1597 /* Read <size in child address space> */
1599 r
= fdt_read_prop(ranges
, ranges_len
, cell
, len
, scells
);
1608 * fdt_setup_simplefb_node - Fill and enable a simplefb node
1610 * @fdt: ptr to device tree
1611 * @node: offset of the simplefb node
1612 * @base_address: framebuffer base address
1613 * @width: width in pixels
1614 * @height: height in pixels
1615 * @stride: bytes per line
1616 * @format: pixel format string
1618 * Convenience function to fill and enable a simplefb node.
1620 int fdt_setup_simplefb_node(void *fdt
, int node
, u64 base_address
, u32 width
,
1621 u32 height
, u32 stride
, const char *format
)
1625 int i
, addrc
, sizec
, ret
;
1627 fdt_support_default_count_cells(fdt
, fdt_parent_offset(fdt
, node
),
1631 cells
[i
++] = cpu_to_fdt32(base_address
>> 32);
1632 cells
[i
++] = cpu_to_fdt32(base_address
);
1635 cells
[i
++] = cpu_to_fdt32(height
* stride
);
1637 ret
= fdt_setprop(fdt
, node
, "reg", cells
, sizeof(cells
[0]) * i
);
1641 snprintf(name
, sizeof(name
), "framebuffer@%" PRIx64
, base_address
);
1642 ret
= fdt_set_name(fdt
, node
, name
);
1646 ret
= fdt_setprop_u32(fdt
, node
, "width", width
);
1650 ret
= fdt_setprop_u32(fdt
, node
, "height", height
);
1654 ret
= fdt_setprop_u32(fdt
, node
, "stride", stride
);
1658 ret
= fdt_setprop_string(fdt
, node
, "format", format
);
1662 ret
= fdt_setprop_string(fdt
, node
, "status", "okay");
1670 * Update native-mode in display-timings from display environment variable.
1671 * The node to update are specified by path.
1673 int fdt_fixup_display(void *blob
, const char *path
, const char *display
)
1677 if (!display
|| !path
)
1678 return -FDT_ERR_NOTFOUND
;
1680 toff
= fdt_path_offset(blob
, path
);
1682 toff
= fdt_subnode_offset(blob
, toff
, "display-timings");
1686 for (off
= fdt_first_subnode(blob
, toff
);
1688 off
= fdt_next_subnode(blob
, off
)) {
1689 uint32_t h
= fdt_get_phandle(blob
, off
);
1690 debug("%s:0x%x\n", fdt_get_name(blob
, off
, NULL
),
1692 if (strcasecmp(fdt_get_name(blob
, off
, NULL
), display
) == 0)
1693 return fdt_setprop_u32(blob
, toff
, "native-mode", h
);
1698 #ifdef CONFIG_OF_LIBFDT_OVERLAY
1700 * fdt_overlay_apply_verbose - Apply an overlay with verbose error reporting
1702 * @fdt: ptr to device tree
1703 * @fdto: ptr to device tree overlay
1705 * Convenience function to apply an overlay and display helpful messages
1706 * in the case of an error
1708 int fdt_overlay_apply_verbose(void *fdt
, void *fdto
)
1713 err
= fdt_path_offset(fdt
, "/__symbols__");
1714 has_symbols
= err
>= 0;
1716 err
= fdt_overlay_apply(fdt
, fdto
);
1718 printf("failed on fdt_overlay_apply(): %s\n",
1721 printf("base fdt does did not have a /__symbols__ node\n");
1722 printf("make sure you've compiled with -@\n");