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 = getenv("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 = getenv("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);
385 * fdt_pack_reg - pack address and size array into the "reg"-suitable stream
387 static int fdt_pack_reg(const void *fdt, void *buf, u64 *address, u64 *size,
391 int address_cells = fdt_address_cells(fdt, 0);
392 int size_cells = fdt_size_cells(fdt, 0);
395 for (i = 0; i < n; i++) {
396 if (address_cells == 2)
397 *(fdt64_t *)p = cpu_to_fdt64(address[i]);
399 *(fdt32_t *)p = cpu_to_fdt32(address[i]);
400 p += 4 * address_cells;
403 *(fdt64_t *)p = cpu_to_fdt64(size[i]);
405 *(fdt32_t *)p = cpu_to_fdt32(size[i]);
409 return p - (char *)buf;
412 #ifdef CONFIG_NR_DRAM_BANKS
413 #define MEMORY_BANKS_MAX CONFIG_NR_DRAM_BANKS
415 #define MEMORY_BANKS_MAX 4
417 int fdt_fixup_memory_banks(void *blob, u64 start[], u64 size[], int banks)
421 u8 tmp[MEMORY_BANKS_MAX * 16]; /* Up to 64-bit address + 64-bit size */
423 if (banks > MEMORY_BANKS_MAX) {
424 printf("%s: num banks %d exceeds hardcoded limit %d."
425 " Recompile with higher MEMORY_BANKS_MAX?\n",
426 __FUNCTION__, banks, MEMORY_BANKS_MAX);
430 err = fdt_check_header(blob);
432 printf("%s: %s\n", __FUNCTION__, fdt_strerror(err));
436 /* find or create "/memory" node. */
437 nodeoffset = fdt_find_or_add_subnode(blob, 0, "memory");
441 err = fdt_setprop(blob, nodeoffset, "device_type", "memory",
444 printf("WARNING: could not set %s %s.\n", "device_type",
452 len = fdt_pack_reg(blob, tmp, start, size, banks);
454 err = fdt_setprop(blob, nodeoffset, "reg", tmp, len);
456 printf("WARNING: could not set %s %s.\n",
457 "reg", fdt_strerror(err));
463 int fdt_fixup_memory(void *blob, u64 start, u64 size)
465 return fdt_fixup_memory_banks(blob, &start, &size, 1);
468 void fdt_fixup_ethernet(void *fdt)
474 unsigned char mac_addr[6];
477 node = fdt_path_offset(fdt, "/aliases");
481 for (offset = fdt_first_property_offset(fdt, node);
483 offset = fdt_next_property_offset(fdt, offset)) {
485 int len = strlen("ethernet");
487 path = fdt_getprop_by_offset(fdt, offset, &name, NULL);
488 if (!strncmp(name, "ethernet", len)) {
489 i = trailing_strtol(name);
492 strcpy(mac, "ethaddr");
494 sprintf(mac, "eth%daddr", i);
502 for (j = 0; j < 6; j++) {
504 simple_strtoul(tmp, &end, 16) : 0;
506 tmp = (*end) ? end + 1 : end;
509 do_fixup_by_path(fdt, path, "mac-address",
511 do_fixup_by_path(fdt, path, "local-mac-address",
517 /* Resize the fdt to its actual size + a bit of padding */
518 int fdt_shrink_to_minimum(void *blob)
528 total = fdt_num_mem_rsv(blob);
529 for (i = 0; i < total; i++) {
530 fdt_get_mem_rsv(blob, i, &addr, &size);
531 if (addr == (uintptr_t)blob) {
532 fdt_del_mem_rsv(blob, i);
538 * Calculate the actual size of the fdt
539 * plus the size needed for 5 fdt_add_mem_rsv, one
540 * for the fdt itself and 4 for a possible initrd
541 * ((initrd-start + initrd-end) * 2 (name & value))
543 actualsize = fdt_off_dt_strings(blob) +
544 fdt_size_dt_strings(blob) + 5 * sizeof(struct fdt_reserve_entry);
546 /* Make it so the fdt ends on a page boundary */
547 actualsize = ALIGN(actualsize + ((uintptr_t)blob & 0xfff), 0x1000);
548 actualsize = actualsize - ((uintptr_t)blob & 0xfff);
550 /* Change the fdt header to reflect the correct size */
551 fdt_set_totalsize(blob, actualsize);
553 /* Add the new reservation */
554 ret = fdt_add_mem_rsv(blob, (uintptr_t)blob, actualsize);
562 #define CONFIG_SYS_PCI_NR_INBOUND_WIN 4
564 #define FDT_PCI_PREFETCH (0x40000000)
565 #define FDT_PCI_MEM32 (0x02000000)
566 #define FDT_PCI_IO (0x01000000)
567 #define FDT_PCI_MEM64 (0x03000000)
569 int fdt_pci_dma_ranges(void *blob, int phb_off, struct pci_controller *hose) {
571 int addrcell, sizecell, len, r;
573 /* sized based on pci addr cells, size-cells, & address-cells */
574 u32 dma_ranges[(3 + 2 + 2) * CONFIG_SYS_PCI_NR_INBOUND_WIN];
576 addrcell = fdt_getprop_u32_default(blob, "/", "#address-cells", 1);
577 sizecell = fdt_getprop_u32_default(blob, "/", "#size-cells", 1);
579 dma_range = &dma_ranges[0];
580 for (r = 0; r < hose->region_count; r++) {
581 u64 bus_start, phys_start, size;
583 /* skip if !PCI_REGION_SYS_MEMORY */
584 if (!(hose->regions[r].flags & PCI_REGION_SYS_MEMORY))
587 bus_start = (u64)hose->regions[r].bus_start;
588 phys_start = (u64)hose->regions[r].phys_start;
589 size = (u64)hose->regions[r].size;
592 if (size >= 0x100000000ull)
593 dma_range[0] |= FDT_PCI_MEM64;
595 dma_range[0] |= FDT_PCI_MEM32;
596 if (hose->regions[r].flags & PCI_REGION_PREFETCH)
597 dma_range[0] |= FDT_PCI_PREFETCH;
598 #ifdef CONFIG_SYS_PCI_64BIT
599 dma_range[1] = bus_start >> 32;
603 dma_range[2] = bus_start & 0xffffffff;
606 dma_range[3] = phys_start >> 32;
607 dma_range[4] = phys_start & 0xffffffff;
609 dma_range[3] = phys_start & 0xffffffff;
613 dma_range[3 + addrcell + 0] = size >> 32;
614 dma_range[3 + addrcell + 1] = size & 0xffffffff;
616 dma_range[3 + addrcell + 0] = size & 0xffffffff;
619 dma_range += (3 + addrcell + sizecell);
622 len = dma_range - &dma_ranges[0];
624 fdt_setprop(blob, phb_off, "dma-ranges", &dma_ranges[0], len*4);
630 #ifdef CONFIG_FDT_FIXUP_NOR_FLASH_SIZE
632 * Provide a weak default function to return the flash bank size.
633 * There might be multiple non-identical flash chips connected to one
634 * chip-select, so we need to pass an index as well.
636 u32 __flash_get_bank_size(int cs, int idx)
638 extern flash_info_t flash_info[];
641 * As default, a simple 1:1 mapping is provided. Boards with
642 * a different mapping need to supply a board specific mapping
645 return flash_info[cs].size;
647 u32 flash_get_bank_size(int cs, int idx)
648 __attribute__((weak, alias("__flash_get_bank_size")));
651 * This function can be used to update the size in the "reg" property
652 * of all NOR FLASH device nodes. This is necessary for boards with
653 * non-fixed NOR FLASH sizes.
655 int fdt_fixup_nor_flash_size(void *blob)
657 char compat[][16] = { "cfi-flash", "jedec-flash" };
660 struct fdt_property *prop;
664 for (i = 0; i < 2; i++) {
665 off = fdt_node_offset_by_compatible(blob, -1, compat[i]);
666 while (off != -FDT_ERR_NOTFOUND) {
670 * Found one compatible node, so fixup the size
671 * int its reg properties
673 prop = fdt_get_property_w(blob, off, "reg", &len);
675 int tuple_size = 3 * sizeof(reg);
678 * There might be multiple reg-tuples,
679 * so loop through them all
681 reg = reg2 = (u32 *)&prop->data[0];
682 for (idx = 0; idx < (len / tuple_size); idx++) {
684 * Update size in reg property
686 reg[2] = flash_get_bank_size(reg[0],
690 * Point to next reg tuple
695 fdt_setprop(blob, off, "reg", reg2, len);
698 /* Move to next compatible node */
699 off = fdt_node_offset_by_compatible(blob, off,
708 int fdt_increase_size(void *fdt, int add_len)
712 newlen = fdt_totalsize(fdt) + add_len;
714 /* Open in place with a new len */
715 return fdt_open_into(fdt, fdt, newlen);
718 #ifdef CONFIG_FDT_FIXUP_PARTITIONS
719 #include <jffs2/load_kernel.h>
720 #include <mtd_node.h>
727 int fdt_del_subnodes(const void *blob, int parent_offset)
732 for (ndepth = 0, off = fdt_next_node(blob, parent_offset, &ndepth);
733 (off >= 0) && (ndepth > 0);
734 off = fdt_next_node(blob, off, &ndepth)) {
736 debug("delete %s: offset: %x\n",
737 fdt_get_name(blob, off, 0), off);
738 ret = fdt_del_node((void *)blob, off);
740 printf("Can't delete node: %s\n",
752 int fdt_del_partitions(void *blob, int parent_offset)
759 off = fdt_next_node(blob, parent_offset, &ndepth);
760 if (off > 0 && ndepth == 1) {
761 prop = fdt_getprop(blob, off, "label", NULL);
764 * Could not find label property, nand {}; node?
765 * Check subnode, delete partitions there if any.
767 return fdt_del_partitions(blob, off);
769 ret = fdt_del_subnodes(blob, parent_offset);
771 printf("Can't remove subnodes: %s\n",
780 int fdt_node_set_part_info(void *blob, int parent_offset,
781 struct mtd_device *dev)
783 struct list_head *pentry;
784 struct part_info *part;
785 struct reg_cell cell;
790 ret = fdt_del_partitions(blob, parent_offset);
795 * Check if it is nand {}; subnode, adjust
796 * the offset in this case
798 off = fdt_next_node(blob, parent_offset, &ndepth);
799 if (off > 0 && ndepth == 1)
803 list_for_each_prev(pentry, &dev->parts) {
806 part = list_entry(pentry, struct part_info, link);
808 debug("%2d: %-20s0x%08llx\t0x%08llx\t%d\n",
809 part_num, part->name, part->size,
810 part->offset, part->mask_flags);
812 sprintf(buf, "partition@%llx", part->offset);
814 ret = fdt_add_subnode(blob, parent_offset, buf);
815 if (ret == -FDT_ERR_NOSPACE) {
816 ret = fdt_increase_size(blob, 512);
821 } else if (ret < 0) {
822 printf("Can't add partition node: %s\n",
828 /* Check MTD_WRITEABLE_CMD flag */
829 if (part->mask_flags & 1) {
831 ret = fdt_setprop(blob, newoff, "read_only", NULL, 0);
832 if (ret == -FDT_ERR_NOSPACE) {
833 ret = fdt_increase_size(blob, 512);
842 cell.r0 = cpu_to_fdt32(part->offset);
843 cell.r1 = cpu_to_fdt32(part->size);
845 ret = fdt_setprop(blob, newoff, "reg", &cell, sizeof(cell));
846 if (ret == -FDT_ERR_NOSPACE) {
847 ret = fdt_increase_size(blob, 512);
856 ret = fdt_setprop_string(blob, newoff, "label", part->name);
857 if (ret == -FDT_ERR_NOSPACE) {
858 ret = fdt_increase_size(blob, 512);
870 printf("Can't increase blob size: %s\n", fdt_strerror(ret));
873 printf("Can't add property: %s\n", fdt_strerror(ret));
878 * Update partitions in nor/nand nodes using info from
879 * mtdparts environment variable. The nodes to update are
880 * specified by node_info structure which contains mtd device
881 * type and compatible string: E. g. the board code in
882 * ft_board_setup() could use:
884 * struct node_info nodes[] = {
885 * { "fsl,mpc5121-nfc", MTD_DEV_TYPE_NAND, },
886 * { "cfi-flash", MTD_DEV_TYPE_NOR, },
889 * fdt_fixup_mtdparts(blob, nodes, ARRAY_SIZE(nodes));
891 void fdt_fixup_mtdparts(void *blob, void *node_info, int node_info_size)
893 struct node_info *ni = node_info;
894 struct mtd_device *dev;
899 parts = getenv("mtdparts");
903 if (mtdparts_init() != 0)
906 for (i = 0; i < node_info_size; i++) {
908 noff = fdt_node_offset_by_compatible(blob, -1, ni[i].compat);
909 while (noff != -FDT_ERR_NOTFOUND) {
910 debug("%s: %s, mtd dev type %d\n",
911 fdt_get_name(blob, noff, 0),
912 ni[i].compat, ni[i].type);
913 dev = device_find(ni[i].type, idx++);
915 if (fdt_node_set_part_info(blob, noff, dev))
916 return; /* return on error */
919 /* Jump to next flash node */
920 noff = fdt_node_offset_by_compatible(blob, noff,
927 void fdt_del_node_and_alias(void *blob, const char *alias)
929 int off = fdt_path_offset(blob, alias);
934 fdt_del_node(blob, off);
936 off = fdt_path_offset(blob, "/aliases");
937 fdt_delprop(blob, off, alias);
940 /* Max address size we deal with */
941 #define OF_MAX_ADDR_CELLS 4
942 #define OF_BAD_ADDR FDT_ADDR_T_NONE
943 #define OF_CHECK_COUNTS(na) ((na) > 0 && (na) <= OF_MAX_ADDR_CELLS)
947 static void of_dump_addr(const char *s, const fdt32_t *addr, int na)
951 printf(" %08x", *(addr++));
955 static void of_dump_addr(const char *s, const fdt32_t *addr, int na) { }
958 /* Callbacks for bus specific translators */
961 const char *addresses;
962 void (*count_cells)(void *blob, int parentoffset,
963 int *addrc, int *sizec);
964 u64 (*map)(fdt32_t *addr, const fdt32_t *range,
965 int na, int ns, int pna);
966 int (*translate)(fdt32_t *addr, u64 offset, int na);
969 /* Default translator (generic bus) */
970 void of_bus_default_count_cells(void *blob, int parentoffset,
971 int *addrc, int *sizec)
976 *addrc = fdt_address_cells(blob, parentoffset);
979 prop = fdt_getprop(blob, parentoffset, "#size-cells", NULL);
981 *sizec = be32_to_cpup(prop);
987 static u64 of_bus_default_map(fdt32_t *addr, const fdt32_t *range,
988 int na, int ns, int pna)
992 cp = of_read_number(range, na);
993 s = of_read_number(range + na + pna, ns);
994 da = of_read_number(addr, na);
996 debug("OF: default map, cp=%" PRIu64 ", s=%" PRIu64
997 ", da=%" PRIu64 "\n", cp, s, da);
999 if (da < cp || da >= (cp + s))
1004 static int of_bus_default_translate(fdt32_t *addr, u64 offset, int na)
1006 u64 a = of_read_number(addr, na);
1007 memset(addr, 0, na * 4);
1010 addr[na - 2] = cpu_to_fdt32(a >> 32);
1011 addr[na - 1] = cpu_to_fdt32(a & 0xffffffffu);
1016 /* Array of bus specific translators */
1017 static struct of_bus of_busses[] = {
1022 .count_cells = of_bus_default_count_cells,
1023 .map = of_bus_default_map,
1024 .translate = of_bus_default_translate,
1028 static int of_translate_one(void * blob, int parent, struct of_bus *bus,
1029 struct of_bus *pbus, fdt32_t *addr,
1030 int na, int ns, int pna, const char *rprop)
1032 const fdt32_t *ranges;
1035 u64 offset = OF_BAD_ADDR;
1037 /* Normally, an absence of a "ranges" property means we are
1038 * crossing a non-translatable boundary, and thus the addresses
1039 * below the current not cannot be converted to CPU physical ones.
1040 * Unfortunately, while this is very clear in the spec, it's not
1041 * what Apple understood, and they do have things like /uni-n or
1042 * /ht nodes with no "ranges" property and a lot of perfectly
1043 * useable mapped devices below them. Thus we treat the absence of
1044 * "ranges" as equivalent to an empty "ranges" property which means
1045 * a 1:1 translation at that level. It's up to the caller not to try
1046 * to translate addresses that aren't supposed to be translated in
1047 * the first place. --BenH.
1049 ranges = fdt_getprop(blob, parent, rprop, &rlen);
1050 if (ranges == NULL || rlen == 0) {
1051 offset = of_read_number(addr, na);
1052 memset(addr, 0, pna * 4);
1053 debug("OF: no ranges, 1:1 translation\n");
1057 debug("OF: walking ranges...\n");
1059 /* Now walk through the ranges */
1061 rone = na + pna + ns;
1062 for (; rlen >= rone; rlen -= rone, ranges += rone) {
1063 offset = bus->map(addr, ranges, na, ns, pna);
1064 if (offset != OF_BAD_ADDR)
1067 if (offset == OF_BAD_ADDR) {
1068 debug("OF: not found !\n");
1071 memcpy(addr, ranges + na, 4 * pna);
1074 of_dump_addr("OF: parent translation for:", addr, pna);
1075 debug("OF: with offset: %" PRIu64 "\n", offset);
1077 /* Translate it into parent bus space */
1078 return pbus->translate(addr, offset, pna);
1082 * Translate an address from the device-tree into a CPU physical address,
1083 * this walks up the tree and applies the various bus mappings on the
1086 * Note: We consider that crossing any level with #size-cells == 0 to mean
1087 * that translation is impossible (that is we are not dealing with a value
1088 * that can be mapped to a cpu physical address). This is not really specified
1089 * that way, but this is traditionally the way IBM at least do things
1091 static u64 __of_translate_address(void *blob, int node_offset, const fdt32_t *in_addr,
1095 struct of_bus *bus, *pbus;
1096 fdt32_t addr[OF_MAX_ADDR_CELLS];
1097 int na, ns, pna, pns;
1098 u64 result = OF_BAD_ADDR;
1100 debug("OF: ** translation for device %s **\n",
1101 fdt_get_name(blob, node_offset, NULL));
1103 /* Get parent & match bus type */
1104 parent = fdt_parent_offset(blob, node_offset);
1107 bus = &of_busses[0];
1109 /* Cound address cells & copy address locally */
1110 bus->count_cells(blob, parent, &na, &ns);
1111 if (!OF_CHECK_COUNTS(na)) {
1112 printf("%s: Bad cell count for %s\n", __FUNCTION__,
1113 fdt_get_name(blob, node_offset, NULL));
1116 memcpy(addr, in_addr, na * 4);
1118 debug("OF: bus is %s (na=%d, ns=%d) on %s\n",
1119 bus->name, na, ns, fdt_get_name(blob, parent, NULL));
1120 of_dump_addr("OF: translating address:", addr, na);
1124 /* Switch to parent bus */
1125 node_offset = parent;
1126 parent = fdt_parent_offset(blob, node_offset);
1128 /* If root, we have finished */
1130 debug("OF: reached root node\n");
1131 result = of_read_number(addr, na);
1135 /* Get new parent bus and counts */
1136 pbus = &of_busses[0];
1137 pbus->count_cells(blob, parent, &pna, &pns);
1138 if (!OF_CHECK_COUNTS(pna)) {
1139 printf("%s: Bad cell count for %s\n", __FUNCTION__,
1140 fdt_get_name(blob, node_offset, NULL));
1144 debug("OF: parent bus is %s (na=%d, ns=%d) on %s\n",
1145 pbus->name, pna, pns, fdt_get_name(blob, parent, NULL));
1147 /* Apply bus translation */
1148 if (of_translate_one(blob, node_offset, bus, pbus,
1149 addr, na, ns, pna, rprop))
1152 /* Complete the move up one level */
1157 of_dump_addr("OF: one level translation:", addr, na);
1164 u64 fdt_translate_address(void *blob, int node_offset, const fdt32_t *in_addr)
1166 return __of_translate_address(blob, node_offset, in_addr, "ranges");
1170 * fdt_node_offset_by_compat_reg: Find a node that matches compatiable and
1171 * who's reg property matches a physical cpu address
1173 * @blob: ptr to device tree
1174 * @compat: compatiable string to match
1175 * @compat_off: property name
1178 int fdt_node_offset_by_compat_reg(void *blob, const char *compat,
1179 phys_addr_t compat_off)
1181 int len, off = fdt_node_offset_by_compatible(blob, -1, compat);
1182 while (off != -FDT_ERR_NOTFOUND) {
1183 const fdt32_t *reg = fdt_getprop(blob, off, "reg", &len);
1185 if (compat_off == fdt_translate_address(blob, off, reg))
1188 off = fdt_node_offset_by_compatible(blob, off, compat);
1191 return -FDT_ERR_NOTFOUND;
1195 * fdt_alloc_phandle: Return next free phandle value
1197 * @blob: ptr to device tree
1199 int fdt_alloc_phandle(void *blob)
1202 uint32_t phandle = 0;
1204 for (offset = fdt_next_node(blob, -1, NULL); offset >= 0;
1205 offset = fdt_next_node(blob, offset, NULL)) {
1206 phandle = max(phandle, fdt_get_phandle(blob, offset));
1213 * fdt_set_phandle: Create a phandle property for the given node
1215 * @fdt: ptr to device tree
1216 * @nodeoffset: node to update
1217 * @phandle: phandle value to set (must be unique)
1219 int fdt_set_phandle(void *fdt, int nodeoffset, uint32_t phandle)
1224 int off = fdt_node_offset_by_phandle(fdt, phandle);
1226 if ((off >= 0) && (off != nodeoffset)) {
1229 fdt_get_path(fdt, nodeoffset, buf, sizeof(buf));
1230 printf("Trying to update node %s with phandle %u ",
1233 fdt_get_path(fdt, off, buf, sizeof(buf));
1234 printf("that already exists in node %s.\n", buf);
1235 return -FDT_ERR_BADPHANDLE;
1239 ret = fdt_setprop_cell(fdt, nodeoffset, "phandle", phandle);
1244 * For now, also set the deprecated "linux,phandle" property, so that we
1245 * don't break older kernels.
1247 ret = fdt_setprop_cell(fdt, nodeoffset, "linux,phandle", phandle);
1253 * fdt_create_phandle: Create a phandle property for the given node
1255 * @fdt: ptr to device tree
1256 * @nodeoffset: node to update
1258 unsigned int fdt_create_phandle(void *fdt, int nodeoffset)
1260 /* see if there is a phandle already */
1261 int phandle = fdt_get_phandle(fdt, nodeoffset);
1263 /* if we got 0, means no phandle so create one */
1267 phandle = fdt_alloc_phandle(fdt);
1268 ret = fdt_set_phandle(fdt, nodeoffset, phandle);
1270 printf("Can't set phandle %u: %s\n", phandle,
1280 * fdt_set_node_status: Set status for the given node
1282 * @fdt: ptr to device tree
1283 * @nodeoffset: node to update
1284 * @status: FDT_STATUS_OKAY, FDT_STATUS_DISABLED,
1285 * FDT_STATUS_FAIL, FDT_STATUS_FAIL_ERROR_CODE
1286 * @error_code: optional, only used if status is FDT_STATUS_FAIL_ERROR_CODE
1288 int fdt_set_node_status(void *fdt, int nodeoffset,
1289 enum fdt_status status, unsigned int error_code)
1298 case FDT_STATUS_OKAY:
1299 ret = fdt_setprop_string(fdt, nodeoffset, "status", "okay");
1301 case FDT_STATUS_DISABLED:
1302 ret = fdt_setprop_string(fdt, nodeoffset, "status", "disabled");
1304 case FDT_STATUS_FAIL:
1305 ret = fdt_setprop_string(fdt, nodeoffset, "status", "fail");
1307 case FDT_STATUS_FAIL_ERROR_CODE:
1308 sprintf(buf, "fail-%d", error_code);
1309 ret = fdt_setprop_string(fdt, nodeoffset, "status", buf);
1312 printf("Invalid fdt status: %x\n", status);
1321 * fdt_set_status_by_alias: Set status for the given node given an alias
1323 * @fdt: ptr to device tree
1324 * @alias: alias of node to update
1325 * @status: FDT_STATUS_OKAY, FDT_STATUS_DISABLED,
1326 * FDT_STATUS_FAIL, FDT_STATUS_FAIL_ERROR_CODE
1327 * @error_code: optional, only used if status is FDT_STATUS_FAIL_ERROR_CODE
1329 int fdt_set_status_by_alias(void *fdt, const char* alias,
1330 enum fdt_status status, unsigned int error_code)
1332 int offset = fdt_path_offset(fdt, alias);
1334 return fdt_set_node_status(fdt, offset, status, error_code);
1337 #if defined(CONFIG_VIDEO) || defined(CONFIG_LCD)
1338 int fdt_add_edid(void *blob, const char *compat, unsigned char *edid_buf)
1343 noff = fdt_node_offset_by_compatible(blob, -1, compat);
1344 if (noff != -FDT_ERR_NOTFOUND) {
1345 debug("%s: %s\n", fdt_get_name(blob, noff, 0), compat);
1347 ret = fdt_setprop(blob, noff, "edid", edid_buf, 128);
1348 if (ret == -FDT_ERR_NOSPACE) {
1349 ret = fdt_increase_size(blob, 512);
1354 } else if (ret < 0) {
1355 printf("Can't add property: %s\n", fdt_strerror(ret));
1361 printf("Can't increase blob size: %s\n", fdt_strerror(ret));
1367 * Verify the physical address of device tree node for a given alias
1369 * This function locates the device tree node of a given alias, and then
1370 * verifies that the physical address of that device matches the given
1371 * parameter. It displays a message if there is a mismatch.
1373 * Returns 1 on success, 0 on failure
1375 int fdt_verify_alias_address(void *fdt, int anode, const char *alias, u64 addr)
1382 path = fdt_getprop(fdt, anode, alias, NULL);
1384 /* If there's no such alias, then it's not a failure */
1388 node = fdt_path_offset(fdt, path);
1390 printf("Warning: device tree alias '%s' points to invalid "
1391 "node %s.\n", alias, path);
1395 reg = fdt_getprop(fdt, node, "reg", &len);
1397 printf("Warning: device tree node '%s' has no address.\n",
1402 dt_addr = fdt_translate_address(fdt, node, reg);
1403 if (addr != dt_addr) {
1404 printf("Warning: U-Boot configured device %s at address %"
1405 PRIx64 ",\n but the device tree has it address %"
1406 PRIx64 ".\n", alias, addr, dt_addr);
1414 * Returns the base address of an SOC or PCI node
1416 u64 fdt_get_base_address(void *fdt, int node)
1420 const fdt32_t *prop;
1422 naddr = fdt_address_cells(fdt, node);
1424 prop = fdt_getprop(fdt, node, "ranges", &size);
1426 return prop ? fdt_translate_address(fdt, node, prop + naddr) : 0;
1430 * Read a property of size <prop_len>. Currently only supports 1 or 2 cells.
1432 static int fdt_read_prop(const fdt32_t *prop, int prop_len, int cell_off,
1433 uint64_t *val, int cells)
1435 const fdt32_t *prop32 = &prop[cell_off];
1436 const fdt64_t *prop64 = (const fdt64_t *)&prop[cell_off];
1438 if ((cell_off + cells) > prop_len)
1439 return -FDT_ERR_NOSPACE;
1443 *val = fdt32_to_cpu(*prop32);
1446 *val = fdt64_to_cpu(*prop64);
1449 return -FDT_ERR_NOSPACE;
1456 * fdt_read_range - Read a node's n'th range property
1458 * @fdt: ptr to device tree
1459 * @node: offset of node
1461 * @child_addr: pointer to storage for the "child address" field
1462 * @addr: pointer to storage for the CPU view translated physical start
1463 * @len: pointer to storage for the range length
1465 * Convenience function that reads and interprets a specific range out of
1466 * a number of the "ranges" property array.
1468 int fdt_read_range(void *fdt, int node, int n, uint64_t *child_addr,
1469 uint64_t *addr, uint64_t *len)
1471 int pnode = fdt_parent_offset(fdt, node);
1472 const fdt32_t *ranges;
1481 * The "ranges" property is an array of
1482 * { <child address> <parent address> <size in child address space> }
1484 * All 3 elements can span a diffent number of cells. Fetch their size.
1486 pacells = fdt_getprop_u32_default_node(fdt, pnode, 0, "#address-cells", 1);
1487 acells = fdt_getprop_u32_default_node(fdt, node, 0, "#address-cells", 1);
1488 scells = fdt_getprop_u32_default_node(fdt, node, 0, "#size-cells", 1);
1490 /* Now try to get the ranges property */
1491 ranges = fdt_getprop(fdt, node, "ranges", &ranges_len);
1493 return -FDT_ERR_NOTFOUND;
1494 ranges_len /= sizeof(uint32_t);
1496 /* Jump to the n'th entry */
1497 cell = n * (pacells + acells + scells);
1499 /* Read <child address> */
1501 r = fdt_read_prop(ranges, ranges_len, cell, child_addr,
1508 /* Read <parent address> */
1510 *addr = fdt_translate_address(fdt, node, ranges + cell);
1513 /* Read <size in child address space> */
1515 r = fdt_read_prop(ranges, ranges_len, cell, len, scells);
1524 * fdt_setup_simplefb_node - Fill and enable a simplefb node
1526 * @fdt: ptr to device tree
1527 * @node: offset of the simplefb node
1528 * @base_address: framebuffer base address
1529 * @width: width in pixels
1530 * @height: height in pixels
1531 * @stride: bytes per line
1532 * @format: pixel format string
1534 * Convenience function to fill and enable a simplefb node.
1536 int fdt_setup_simplefb_node(void *fdt, int node, u64 base_address, u32 width,
1537 u32 height, u32 stride, const char *format)
1541 int i, addrc, sizec, ret;
1543 of_bus_default_count_cells(fdt, fdt_parent_offset(fdt, node),
1547 cells[i++] = cpu_to_fdt32(base_address >> 32);
1548 cells[i++] = cpu_to_fdt32(base_address);
1551 cells[i++] = cpu_to_fdt32(height * stride);
1553 ret = fdt_setprop(fdt, node, "reg", cells, sizeof(cells[0]) * i);
1557 snprintf(name, sizeof(name), "framebuffer@%" PRIx64, base_address);
1558 ret = fdt_set_name(fdt, node, name);
1562 ret = fdt_setprop_u32(fdt, node, "width", width);
1566 ret = fdt_setprop_u32(fdt, node, "height", height);
1570 ret = fdt_setprop_u32(fdt, node, "stride", stride);
1574 ret = fdt_setprop_string(fdt, node, "format", format);
1578 ret = fdt_setprop_string(fdt, node, "status", "okay");
1586 * Update native-mode in display-timings from display environment variable.
1587 * The node to update are specified by path.
1589 int fdt_fixup_display(void *blob, const char *path, const char *display)
1593 if (!display || !path)
1594 return -FDT_ERR_NOTFOUND;
1596 toff = fdt_path_offset(blob, path);
1598 toff = fdt_subnode_offset(blob, toff, "display-timings");
1602 for (off = fdt_first_subnode(blob, toff);
1604 off = fdt_next_subnode(blob, off)) {
1605 uint32_t h = fdt_get_phandle(blob, off);
1606 debug("%s:0x%x\n", fdt_get_name(blob, off, NULL),
1608 if (strcasecmp(fdt_get_name(blob, off, NULL), display) == 0)
1609 return fdt_setprop_u32(blob, toff, "native-mode", h);