1 // SPDX-License-Identifier: GPL-2.0
3 * Functions for working with the Flattened Device Tree data format
5 * Copyright 2009 Benjamin Herrenschmidt, IBM Corp
6 * benh@kernel.crashing.org
9 #define pr_fmt(fmt) "OF: fdt: " fmt
11 #include <linux/acpi.h>
12 #include <linux/crash_dump.h>
13 #include <linux/crc32.h>
14 #include <linux/kernel.h>
15 #include <linux/initrd.h>
16 #include <linux/memblock.h>
17 #include <linux/mutex.h>
19 #include <linux/of_fdt.h>
20 #include <linux/sizes.h>
21 #include <linux/string.h>
22 #include <linux/errno.h>
23 #include <linux/slab.h>
24 #include <linux/libfdt.h>
25 #include <linux/debugfs.h>
26 #include <linux/serial_core.h>
27 #include <linux/sysfs.h>
28 #include <linux/random.h>
30 #include <asm/setup.h> /* for COMMAND_LINE_SIZE */
33 #include "of_private.h"
36 * __dtb_empty_root_begin[] and __dtb_empty_root_end[] magically created by
37 * cmd_wrap_S_dtb in scripts/Makefile.dtbs
39 extern uint8_t __dtb_empty_root_begin
[];
40 extern uint8_t __dtb_empty_root_end
[];
43 * of_fdt_limit_memory - limit the number of regions in the /memory node
44 * @limit: maximum entries
46 * Adjust the flattened device tree to have at most 'limit' number of
47 * memory entries in the /memory node. This function may be called
48 * any time after initial_boot_param is set.
50 void __init
of_fdt_limit_memory(int limit
)
55 int cell_size
= sizeof(uint32_t)*(dt_root_addr_cells
+ dt_root_size_cells
);
57 memory
= fdt_path_offset(initial_boot_params
, "/memory");
59 val
= fdt_getprop(initial_boot_params
, memory
, "reg", &len
);
60 if (len
> limit
*cell_size
) {
61 len
= limit
*cell_size
;
62 pr_debug("Limiting number of entries to %d\n", limit
);
63 fdt_setprop(initial_boot_params
, memory
, "reg", val
,
69 bool of_fdt_device_is_available(const void *blob
, unsigned long node
)
71 const char *status
= fdt_getprop(blob
, node
, "status", NULL
);
76 if (!strcmp(status
, "ok") || !strcmp(status
, "okay"))
82 static void *unflatten_dt_alloc(void **mem
, unsigned long size
,
87 *mem
= PTR_ALIGN(*mem
, align
);
94 static void populate_properties(const void *blob
,
97 struct device_node
*np
,
101 struct property
*pp
, **pprev
= NULL
;
103 bool has_name
= false;
105 pprev
= &np
->properties
;
106 for (cur
= fdt_first_property_offset(blob
, offset
);
108 cur
= fdt_next_property_offset(blob
, cur
)) {
113 val
= fdt_getprop_by_offset(blob
, cur
, &pname
, &sz
);
115 pr_warn("Cannot locate property at 0x%x\n", cur
);
120 pr_warn("Cannot find property name at 0x%x\n", cur
);
124 if (!strcmp(pname
, "name"))
127 pp
= unflatten_dt_alloc(mem
, sizeof(struct property
),
128 __alignof__(struct property
));
132 /* We accept flattened tree phandles either in
133 * ePAPR-style "phandle" properties, or the
134 * legacy "linux,phandle" properties. If both
135 * appear and have different values, things
136 * will get weird. Don't do that.
138 if (!strcmp(pname
, "phandle") ||
139 !strcmp(pname
, "linux,phandle")) {
141 np
->phandle
= be32_to_cpup(val
);
144 /* And we process the "ibm,phandle" property
145 * used in pSeries dynamic device tree
148 if (!strcmp(pname
, "ibm,phandle"))
149 np
->phandle
= be32_to_cpup(val
);
151 pp
->name
= (char *)pname
;
153 pp
->value
= (__be32
*)val
;
158 /* With version 0x10 we may not have the name property,
159 * recreate it here from the unit name if absent
162 const char *p
= nodename
, *ps
= p
, *pa
= NULL
;
168 else if ((*p
) == '/')
176 pp
= unflatten_dt_alloc(mem
, sizeof(struct property
) + len
,
177 __alignof__(struct property
));
183 memcpy(pp
->value
, ps
, len
- 1);
184 ((char *)pp
->value
)[len
- 1] = 0;
185 pr_debug("fixed up name for %s -> %s\n",
186 nodename
, (char *)pp
->value
);
191 static int populate_node(const void *blob
,
194 struct device_node
*dad
,
195 struct device_node
**pnp
,
198 struct device_node
*np
;
202 pathp
= fdt_get_name(blob
, offset
, &len
);
210 np
= unflatten_dt_alloc(mem
, sizeof(struct device_node
) + len
,
211 __alignof__(struct device_node
));
215 np
->full_name
= fn
= ((char *)np
) + sizeof(*np
);
217 memcpy(fn
, pathp
, len
);
221 np
->sibling
= dad
->child
;
226 populate_properties(blob
, offset
, mem
, np
, pathp
, dryrun
);
228 np
->name
= of_get_property(np
, "name", NULL
);
237 static void reverse_nodes(struct device_node
*parent
)
239 struct device_node
*child
, *next
;
242 child
= parent
->child
;
244 reverse_nodes(child
);
246 child
= child
->sibling
;
249 /* Reverse the nodes in the child list */
250 child
= parent
->child
;
251 parent
->child
= NULL
;
253 next
= child
->sibling
;
255 child
->sibling
= parent
->child
;
256 parent
->child
= child
;
262 * unflatten_dt_nodes - Alloc and populate a device_node from the flat tree
263 * @blob: The parent device tree blob
264 * @mem: Memory chunk to use for allocating device nodes and properties
265 * @dad: Parent struct device_node
266 * @nodepp: The device_node tree created by the call
268 * Return: The size of unflattened device tree or error code
270 static int unflatten_dt_nodes(const void *blob
,
272 struct device_node
*dad
,
273 struct device_node
**nodepp
)
275 struct device_node
*root
;
276 int offset
= 0, depth
= 0, initial_depth
= 0;
277 #define FDT_MAX_DEPTH 64
278 struct device_node
*nps
[FDT_MAX_DEPTH
];
287 * We're unflattening device sub-tree if @dad is valid. There are
288 * possibly multiple nodes in the first level of depth. We need
289 * set @depth to 1 to make fdt_next_node() happy as it bails
290 * immediately when negative @depth is found. Otherwise, the device
291 * nodes except the first one won't be unflattened successfully.
294 depth
= initial_depth
= 1;
300 offset
>= 0 && depth
>= initial_depth
;
301 offset
= fdt_next_node(blob
, offset
, &depth
)) {
302 if (WARN_ON_ONCE(depth
>= FDT_MAX_DEPTH
- 1))
305 if (!IS_ENABLED(CONFIG_OF_KOBJ
) &&
306 !of_fdt_device_is_available(blob
, offset
))
309 ret
= populate_node(blob
, offset
, &mem
, nps
[depth
],
310 &nps
[depth
+1], dryrun
);
314 if (!dryrun
&& nodepp
&& !*nodepp
)
315 *nodepp
= nps
[depth
+1];
316 if (!dryrun
&& !root
)
320 if (offset
< 0 && offset
!= -FDT_ERR_NOTFOUND
) {
321 pr_err("Error %d processing FDT\n", offset
);
326 * Reverse the child list. Some drivers assumes node order matches .dts
336 * __unflatten_device_tree - create tree of device_nodes from flat blob
337 * @blob: The blob to expand
338 * @dad: Parent device node
339 * @mynodes: The device_node tree created by the call
340 * @dt_alloc: An allocator that provides a virtual address to memory
341 * for the resulting tree
342 * @detached: if true set OF_DETACHED on @mynodes
344 * unflattens a device-tree, creating the tree of struct device_node. It also
345 * fills the "name" and "type" pointers of the nodes so the normal device-tree
346 * walking functions can be used.
348 * Return: NULL on failure or the memory chunk containing the unflattened
349 * device tree on success.
351 void *__unflatten_device_tree(const void *blob
,
352 struct device_node
*dad
,
353 struct device_node
**mynodes
,
354 void *(*dt_alloc
)(u64 size
, u64 align
),
364 pr_debug(" -> unflatten_device_tree()\n");
367 pr_debug("No device tree pointer\n");
371 pr_debug("Unflattening device tree:\n");
372 pr_debug("magic: %08x\n", fdt_magic(blob
));
373 pr_debug("size: %08x\n", fdt_totalsize(blob
));
374 pr_debug("version: %08x\n", fdt_version(blob
));
376 if (fdt_check_header(blob
)) {
377 pr_err("Invalid device tree blob header\n");
381 /* First pass, scan for size */
382 size
= unflatten_dt_nodes(blob
, NULL
, dad
, NULL
);
386 size
= ALIGN(size
, 4);
387 pr_debug(" size is %d, allocating...\n", size
);
389 /* Allocate memory for the expanded device tree */
390 mem
= dt_alloc(size
+ 4, __alignof__(struct device_node
));
394 memset(mem
, 0, size
);
396 *(__be32
*)(mem
+ size
) = cpu_to_be32(0xdeadbeef);
398 pr_debug(" unflattening %p...\n", mem
);
400 /* Second pass, do actual unflattening */
401 ret
= unflatten_dt_nodes(blob
, mem
, dad
, mynodes
);
403 if (be32_to_cpup(mem
+ size
) != 0xdeadbeef)
404 pr_warn("End of tree marker overwritten: %08x\n",
405 be32_to_cpup(mem
+ size
));
410 if (detached
&& mynodes
&& *mynodes
) {
411 of_node_set_flag(*mynodes
, OF_DETACHED
);
412 pr_debug("unflattened tree is detached\n");
415 pr_debug(" <- unflatten_device_tree()\n");
419 static void *kernel_tree_alloc(u64 size
, u64 align
)
421 return kzalloc(size
, GFP_KERNEL
);
424 static DEFINE_MUTEX(of_fdt_unflatten_mutex
);
427 * of_fdt_unflatten_tree - create tree of device_nodes from flat blob
428 * @blob: Flat device tree blob
429 * @dad: Parent device node
430 * @mynodes: The device tree created by the call
432 * unflattens the device-tree passed by the firmware, creating the
433 * tree of struct device_node. It also fills the "name" and "type"
434 * pointers of the nodes so the normal device-tree walking functions
437 * Return: NULL on failure or the memory chunk containing the unflattened
438 * device tree on success.
440 void *of_fdt_unflatten_tree(const unsigned long *blob
,
441 struct device_node
*dad
,
442 struct device_node
**mynodes
)
446 mutex_lock(&of_fdt_unflatten_mutex
);
447 mem
= __unflatten_device_tree(blob
, dad
, mynodes
, &kernel_tree_alloc
,
449 mutex_unlock(&of_fdt_unflatten_mutex
);
453 EXPORT_SYMBOL_GPL(of_fdt_unflatten_tree
);
455 /* Everything below here references initial_boot_params directly. */
456 int __initdata dt_root_addr_cells
;
457 int __initdata dt_root_size_cells
;
459 void *initial_boot_params __ro_after_init
;
460 phys_addr_t initial_boot_params_pa __ro_after_init
;
462 #ifdef CONFIG_OF_EARLY_FLATTREE
464 static u32 of_fdt_crc32
;
467 * fdt_reserve_elfcorehdr() - reserves memory for elf core header
469 * This function reserves the memory occupied by an elf core header
470 * described in the device tree. This region contains all the
471 * information about primary kernel's core image and is used by a dump
472 * capture kernel to access the system memory on primary kernel.
474 static void __init
fdt_reserve_elfcorehdr(void)
476 if (!IS_ENABLED(CONFIG_CRASH_DUMP
) || !elfcorehdr_size
)
479 if (memblock_is_region_reserved(elfcorehdr_addr
, elfcorehdr_size
)) {
480 pr_warn("elfcorehdr is overlapped\n");
484 memblock_reserve(elfcorehdr_addr
, elfcorehdr_size
);
486 pr_info("Reserving %llu KiB of memory at 0x%llx for elfcorehdr\n",
487 elfcorehdr_size
>> 10, elfcorehdr_addr
);
491 * early_init_fdt_scan_reserved_mem() - create reserved memory regions
493 * This function grabs memory from early allocator for device exclusive use
494 * defined in device tree structures. It should be called by arch specific code
495 * once the early allocator (i.e. memblock) has been fully activated.
497 void __init
early_init_fdt_scan_reserved_mem(void)
502 if (!initial_boot_params
)
505 fdt_scan_reserved_mem();
506 fdt_reserve_elfcorehdr();
508 /* Process header /memreserve/ fields */
510 fdt_get_mem_rsv(initial_boot_params
, n
, &base
, &size
);
513 memblock_reserve(base
, size
);
518 * early_init_fdt_reserve_self() - reserve the memory used by the FDT blob
520 void __init
early_init_fdt_reserve_self(void)
522 if (!initial_boot_params
)
525 /* Reserve the dtb region */
526 memblock_reserve(__pa(initial_boot_params
),
527 fdt_totalsize(initial_boot_params
));
531 * of_scan_flat_dt - scan flattened tree blob and call callback on each.
532 * @it: callback function
533 * @data: context data pointer
535 * This function is used to scan the flattened device-tree, it is
536 * used to extract the memory information at boot before we can
539 int __init
of_scan_flat_dt(int (*it
)(unsigned long node
,
540 const char *uname
, int depth
,
544 const void *blob
= initial_boot_params
;
546 int offset
, rc
= 0, depth
= -1;
551 for (offset
= fdt_next_node(blob
, -1, &depth
);
552 offset
>= 0 && depth
>= 0 && !rc
;
553 offset
= fdt_next_node(blob
, offset
, &depth
)) {
555 pathp
= fdt_get_name(blob
, offset
, NULL
);
556 rc
= it(offset
, pathp
, depth
, data
);
562 * of_scan_flat_dt_subnodes - scan sub-nodes of a node call callback on each.
563 * @parent: parent node
564 * @it: callback function
565 * @data: context data pointer
567 * This function is used to scan sub-nodes of a node.
569 int __init
of_scan_flat_dt_subnodes(unsigned long parent
,
570 int (*it
)(unsigned long node
,
575 const void *blob
= initial_boot_params
;
578 fdt_for_each_subnode(node
, blob
, parent
) {
582 pathp
= fdt_get_name(blob
, node
, NULL
);
583 rc
= it(node
, pathp
, data
);
591 * of_get_flat_dt_subnode_by_name - get the subnode by given name
593 * @node: the parent node
594 * @uname: the name of subnode
595 * @return offset of the subnode, or -FDT_ERR_NOTFOUND if there is none
598 int __init
of_get_flat_dt_subnode_by_name(unsigned long node
, const char *uname
)
600 return fdt_subnode_offset(initial_boot_params
, node
, uname
);
604 * of_get_flat_dt_root - find the root node in the flat blob
606 unsigned long __init
of_get_flat_dt_root(void)
612 * of_get_flat_dt_prop - Given a node in the flat blob, return the property ptr
614 * This function can be used within scan_flattened_dt callback to get
615 * access to properties
617 const void *__init
of_get_flat_dt_prop(unsigned long node
, const char *name
,
620 return fdt_getprop(initial_boot_params
, node
, name
, size
);
624 * of_fdt_is_compatible - Return true if given node from the given blob has
625 * compat in its compatible list
626 * @blob: A device tree blob
627 * @node: node to test
628 * @compat: compatible string to compare with compatible list.
630 * Return: a non-zero value on match with smaller values returned for more
631 * specific compatible values.
633 static int of_fdt_is_compatible(const void *blob
,
634 unsigned long node
, const char *compat
)
638 unsigned long l
, score
= 0;
640 cp
= fdt_getprop(blob
, node
, "compatible", &cplen
);
645 if (of_compat_cmp(cp
, compat
, strlen(compat
)) == 0)
656 * of_flat_dt_is_compatible - Return true if given node has compat in compatible list
657 * @node: node to test
658 * @compat: compatible string to compare with compatible list.
660 int __init
of_flat_dt_is_compatible(unsigned long node
, const char *compat
)
662 return of_fdt_is_compatible(initial_boot_params
, node
, compat
);
666 * of_flat_dt_match - Return true if node matches a list of compatible values
668 static int __init
of_flat_dt_match(unsigned long node
, const char *const *compat
)
670 unsigned int tmp
, score
= 0;
676 tmp
= of_fdt_is_compatible(initial_boot_params
, node
, *compat
);
677 if (tmp
&& (score
== 0 || (tmp
< score
)))
686 * of_get_flat_dt_phandle - Given a node in the flat blob, return the phandle
688 uint32_t __init
of_get_flat_dt_phandle(unsigned long node
)
690 return fdt_get_phandle(initial_boot_params
, node
);
693 const char * __init
of_flat_dt_get_machine_name(void)
696 unsigned long dt_root
= of_get_flat_dt_root();
698 name
= of_get_flat_dt_prop(dt_root
, "model", NULL
);
700 name
= of_get_flat_dt_prop(dt_root
, "compatible", NULL
);
705 * of_flat_dt_match_machine - Iterate match tables to find matching machine.
707 * @default_match: A machine specific ptr to return in case of no match.
708 * @get_next_compat: callback function to return next compatible match table.
710 * Iterate through machine match tables to find the best match for the machine
711 * compatible string in the FDT.
713 const void * __init
of_flat_dt_match_machine(const void *default_match
,
714 const void * (*get_next_compat
)(const char * const**))
716 const void *data
= NULL
;
717 const void *best_data
= default_match
;
718 const char *const *compat
;
719 unsigned long dt_root
;
720 unsigned int best_score
= ~1, score
= 0;
722 dt_root
= of_get_flat_dt_root();
723 while ((data
= get_next_compat(&compat
))) {
724 score
= of_flat_dt_match(dt_root
, compat
);
725 if (score
> 0 && score
< best_score
) {
734 pr_err("\n unrecognized device tree list:\n[ ");
736 prop
= of_get_flat_dt_prop(dt_root
, "compatible", &size
);
739 printk("'%s' ", prop
);
740 size
-= strlen(prop
) + 1;
741 prop
+= strlen(prop
) + 1;
748 pr_info("Machine model: %s\n", of_flat_dt_get_machine_name());
753 static void __early_init_dt_declare_initrd(unsigned long start
,
757 * __va() is not yet available this early on some platforms. In that
758 * case, the platform uses phys_initrd_start/phys_initrd_size instead
759 * and does the VA conversion itself.
761 if (!IS_ENABLED(CONFIG_ARM64
) &&
762 !(IS_ENABLED(CONFIG_RISCV
) && IS_ENABLED(CONFIG_64BIT
))) {
763 initrd_start
= (unsigned long)__va(start
);
764 initrd_end
= (unsigned long)__va(end
);
765 initrd_below_start_ok
= 1;
770 * early_init_dt_check_for_initrd - Decode initrd location from flat tree
771 * @node: reference to node containing initrd location ('chosen')
773 static void __init
early_init_dt_check_for_initrd(unsigned long node
)
779 if (!IS_ENABLED(CONFIG_BLK_DEV_INITRD
))
782 pr_debug("Looking for initrd properties... ");
784 prop
= of_get_flat_dt_prop(node
, "linux,initrd-start", &len
);
787 start
= of_read_number(prop
, len
/4);
789 prop
= of_get_flat_dt_prop(node
, "linux,initrd-end", &len
);
792 end
= of_read_number(prop
, len
/4);
796 __early_init_dt_declare_initrd(start
, end
);
797 phys_initrd_start
= start
;
798 phys_initrd_size
= end
- start
;
800 pr_debug("initrd_start=0x%llx initrd_end=0x%llx\n", start
, end
);
804 * early_init_dt_check_for_elfcorehdr - Decode elfcorehdr location from flat
806 * @node: reference to node containing elfcorehdr location ('chosen')
808 static void __init
early_init_dt_check_for_elfcorehdr(unsigned long node
)
813 if (!IS_ENABLED(CONFIG_CRASH_DUMP
))
816 pr_debug("Looking for elfcorehdr property... ");
818 prop
= of_get_flat_dt_prop(node
, "linux,elfcorehdr", &len
);
819 if (!prop
|| (len
< (dt_root_addr_cells
+ dt_root_size_cells
)))
822 elfcorehdr_addr
= dt_mem_next_cell(dt_root_addr_cells
, &prop
);
823 elfcorehdr_size
= dt_mem_next_cell(dt_root_size_cells
, &prop
);
825 pr_debug("elfcorehdr_start=0x%llx elfcorehdr_size=0x%llx\n",
826 elfcorehdr_addr
, elfcorehdr_size
);
829 static unsigned long chosen_node_offset
= -FDT_ERR_NOTFOUND
;
832 * The main usage of linux,usable-memory-range is for crash dump kernel.
833 * Originally, the number of usable-memory regions is one. Now there may
834 * be two regions, low region and high region.
835 * To make compatibility with existing user-space and older kdump, the low
836 * region is always the last range of linux,usable-memory-range if exist.
838 #define MAX_USABLE_RANGES 2
841 * early_init_dt_check_for_usable_mem_range - Decode usable memory range
842 * location from flat tree
844 void __init
early_init_dt_check_for_usable_mem_range(void)
846 struct memblock_region rgn
[MAX_USABLE_RANGES
] = {0};
847 const __be32
*prop
, *endp
;
849 unsigned long node
= chosen_node_offset
;
854 pr_debug("Looking for usable-memory-range property... ");
856 prop
= of_get_flat_dt_prop(node
, "linux,usable-memory-range", &len
);
857 if (!prop
|| (len
% (dt_root_addr_cells
+ dt_root_size_cells
)))
860 endp
= prop
+ (len
/ sizeof(__be32
));
861 for (i
= 0; i
< MAX_USABLE_RANGES
&& prop
< endp
; i
++) {
862 rgn
[i
].base
= dt_mem_next_cell(dt_root_addr_cells
, &prop
);
863 rgn
[i
].size
= dt_mem_next_cell(dt_root_size_cells
, &prop
);
865 pr_debug("cap_mem_regions[%d]: base=%pa, size=%pa\n",
866 i
, &rgn
[i
].base
, &rgn
[i
].size
);
869 memblock_cap_memory_range(rgn
[0].base
, rgn
[0].size
);
870 for (i
= 1; i
< MAX_USABLE_RANGES
&& rgn
[i
].size
; i
++)
871 memblock_add(rgn
[i
].base
, rgn
[i
].size
);
874 #ifdef CONFIG_SERIAL_EARLYCON
876 int __init
early_init_dt_scan_chosen_stdout(void)
879 const char *p
, *q
, *options
= NULL
;
881 const struct earlycon_id
*match
;
882 const void *fdt
= initial_boot_params
;
885 offset
= fdt_path_offset(fdt
, "/chosen");
887 offset
= fdt_path_offset(fdt
, "/chosen@0");
891 p
= fdt_getprop(fdt
, offset
, "stdout-path", &l
);
893 p
= fdt_getprop(fdt
, offset
, "linux,stdout-path", &l
);
897 q
= strchrnul(p
, ':');
902 /* Get the node specified by stdout-path */
903 offset
= fdt_path_offset_namelen(fdt
, p
, l
);
905 pr_warn("earlycon: stdout-path %.*s not found\n", l
, p
);
909 for (match
= __earlycon_table
; match
< __earlycon_table_end
; match
++) {
910 if (!match
->compatible
[0])
913 if (fdt_node_check_compatible(fdt
, offset
, match
->compatible
))
916 ret
= of_setup_earlycon(match
, offset
, options
);
917 if (!ret
|| ret
== -EALREADY
)
925 * early_init_dt_scan_root - fetch the top level address and size cells
927 int __init
early_init_dt_scan_root(void)
930 const void *fdt
= initial_boot_params
;
931 int node
= fdt_path_offset(fdt
, "/");
936 dt_root_size_cells
= OF_ROOT_NODE_SIZE_CELLS_DEFAULT
;
937 dt_root_addr_cells
= OF_ROOT_NODE_ADDR_CELLS_DEFAULT
;
939 prop
= of_get_flat_dt_prop(node
, "#size-cells", NULL
);
940 if (!WARN(!prop
, "No '#size-cells' in root node\n"))
941 dt_root_size_cells
= be32_to_cpup(prop
);
942 pr_debug("dt_root_size_cells = %x\n", dt_root_size_cells
);
944 prop
= of_get_flat_dt_prop(node
, "#address-cells", NULL
);
945 if (!WARN(!prop
, "No '#address-cells' in root node\n"))
946 dt_root_addr_cells
= be32_to_cpup(prop
);
947 pr_debug("dt_root_addr_cells = %x\n", dt_root_addr_cells
);
952 u64 __init
dt_mem_next_cell(int s
, const __be32
**cellp
)
954 const __be32
*p
= *cellp
;
957 return of_read_number(p
, s
);
961 * early_init_dt_scan_memory - Look for and parse memory nodes
963 int __init
early_init_dt_scan_memory(void)
965 int node
, found_memory
= 0;
966 const void *fdt
= initial_boot_params
;
968 fdt_for_each_subnode(node
, fdt
, 0) {
969 const char *type
= of_get_flat_dt_prop(node
, "device_type", NULL
);
970 const __be32
*reg
, *endp
;
974 /* We are scanning "memory" nodes only */
975 if (type
== NULL
|| strcmp(type
, "memory") != 0)
978 if (!of_fdt_device_is_available(fdt
, node
))
981 reg
= of_get_flat_dt_prop(node
, "linux,usable-memory", &l
);
983 reg
= of_get_flat_dt_prop(node
, "reg", &l
);
987 endp
= reg
+ (l
/ sizeof(__be32
));
988 hotpluggable
= of_get_flat_dt_prop(node
, "hotpluggable", NULL
);
990 pr_debug("memory scan node %s, reg size %d,\n",
991 fdt_get_name(fdt
, node
, NULL
), l
);
993 while ((endp
- reg
) >= (dt_root_addr_cells
+ dt_root_size_cells
)) {
996 base
= dt_mem_next_cell(dt_root_addr_cells
, ®
);
997 size
= dt_mem_next_cell(dt_root_size_cells
, ®
);
1001 pr_debug(" - %llx, %llx\n", base
, size
);
1003 early_init_dt_add_memory_arch(base
, size
);
1010 if (memblock_mark_hotplug(base
, size
))
1011 pr_warn("failed to mark hotplug range 0x%llx - 0x%llx\n",
1015 return found_memory
;
1018 int __init
early_init_dt_scan_chosen(char *cmdline
)
1022 const void *rng_seed
;
1023 const void *fdt
= initial_boot_params
;
1025 node
= fdt_path_offset(fdt
, "/chosen");
1027 node
= fdt_path_offset(fdt
, "/chosen@0");
1029 /* Handle the cmdline config options even if no /chosen node */
1030 goto handle_cmdline
;
1032 chosen_node_offset
= node
;
1034 early_init_dt_check_for_initrd(node
);
1035 early_init_dt_check_for_elfcorehdr(node
);
1037 rng_seed
= of_get_flat_dt_prop(node
, "rng-seed", &l
);
1038 if (rng_seed
&& l
> 0) {
1039 add_bootloader_randomness(rng_seed
, l
);
1041 /* try to clear seed so it won't be found. */
1042 fdt_nop_property(initial_boot_params
, node
, "rng-seed");
1044 /* update CRC check value */
1045 of_fdt_crc32
= crc32_be(~0, initial_boot_params
,
1046 fdt_totalsize(initial_boot_params
));
1049 /* Retrieve command line */
1050 p
= of_get_flat_dt_prop(node
, "bootargs", &l
);
1051 if (p
!= NULL
&& l
> 0)
1052 strscpy(cmdline
, p
, min(l
, COMMAND_LINE_SIZE
));
1056 * CONFIG_CMDLINE is meant to be a default in case nothing else
1057 * managed to set the command line, unless CONFIG_CMDLINE_FORCE
1058 * is set in which case we override whatever was found earlier.
1060 #ifdef CONFIG_CMDLINE
1061 #if defined(CONFIG_CMDLINE_EXTEND)
1062 strlcat(cmdline
, " ", COMMAND_LINE_SIZE
);
1063 strlcat(cmdline
, CONFIG_CMDLINE
, COMMAND_LINE_SIZE
);
1064 #elif defined(CONFIG_CMDLINE_FORCE)
1065 strscpy(cmdline
, CONFIG_CMDLINE
, COMMAND_LINE_SIZE
);
1067 /* No arguments from boot loader, use kernel's cmdl*/
1068 if (!((char *)cmdline
)[0])
1069 strscpy(cmdline
, CONFIG_CMDLINE
, COMMAND_LINE_SIZE
);
1071 #endif /* CONFIG_CMDLINE */
1073 pr_debug("Command line is: %s\n", (char *)cmdline
);
1078 #ifndef MIN_MEMBLOCK_ADDR
1079 #define MIN_MEMBLOCK_ADDR __pa(PAGE_OFFSET)
1081 #ifndef MAX_MEMBLOCK_ADDR
1082 #define MAX_MEMBLOCK_ADDR ((phys_addr_t)~0)
1085 void __init __weak
early_init_dt_add_memory_arch(u64 base
, u64 size
)
1087 const u64 phys_offset
= MIN_MEMBLOCK_ADDR
;
1089 if (size
< PAGE_SIZE
- (base
& ~PAGE_MASK
)) {
1090 pr_warn("Ignoring memory block 0x%llx - 0x%llx\n",
1095 if (!PAGE_ALIGNED(base
)) {
1096 size
-= PAGE_SIZE
- (base
& ~PAGE_MASK
);
1097 base
= PAGE_ALIGN(base
);
1101 if (base
> MAX_MEMBLOCK_ADDR
) {
1102 pr_warn("Ignoring memory block 0x%llx - 0x%llx\n",
1107 if (base
+ size
- 1 > MAX_MEMBLOCK_ADDR
) {
1108 pr_warn("Ignoring memory range 0x%llx - 0x%llx\n",
1109 ((u64
)MAX_MEMBLOCK_ADDR
) + 1, base
+ size
);
1110 size
= MAX_MEMBLOCK_ADDR
- base
+ 1;
1113 if (base
+ size
< phys_offset
) {
1114 pr_warn("Ignoring memory block 0x%llx - 0x%llx\n",
1118 if (base
< phys_offset
) {
1119 pr_warn("Ignoring memory range 0x%llx - 0x%llx\n",
1121 size
-= phys_offset
- base
;
1124 memblock_add(base
, size
);
1127 static void * __init
early_init_dt_alloc_memory_arch(u64 size
, u64 align
)
1129 void *ptr
= memblock_alloc(size
, align
);
1132 panic("%s: Failed to allocate %llu bytes align=0x%llx\n",
1133 __func__
, size
, align
);
1138 bool __init
early_init_dt_verify(void *dt_virt
, phys_addr_t dt_phys
)
1143 /* check device tree validity */
1144 if (fdt_check_header(dt_virt
))
1147 /* Setup flat device-tree pointer */
1148 initial_boot_params
= dt_virt
;
1149 initial_boot_params_pa
= dt_phys
;
1150 of_fdt_crc32
= crc32_be(~0, initial_boot_params
,
1151 fdt_totalsize(initial_boot_params
));
1153 /* Initialize {size,address}-cells info */
1154 early_init_dt_scan_root();
1160 void __init
early_init_dt_scan_nodes(void)
1164 /* Retrieve various information from the /chosen node */
1165 rc
= early_init_dt_scan_chosen(boot_command_line
);
1167 pr_warn("No chosen node found, continuing without\n");
1169 /* Setup memory, calling early_init_dt_add_memory_arch */
1170 early_init_dt_scan_memory();
1172 /* Handle linux,usable-memory-range property */
1173 early_init_dt_check_for_usable_mem_range();
1176 bool __init
early_init_dt_scan(void *dt_virt
, phys_addr_t dt_phys
)
1180 status
= early_init_dt_verify(dt_virt
, dt_phys
);
1184 early_init_dt_scan_nodes();
1188 static void *__init
copy_device_tree(void *fdt
)
1193 size
= fdt_totalsize(fdt
);
1194 dt
= early_init_dt_alloc_memory_arch(size
,
1195 roundup_pow_of_two(FDT_V17_SIZE
));
1198 memcpy(dt
, fdt
, size
);
1204 * unflatten_device_tree - create tree of device_nodes from flat blob
1206 * unflattens the device-tree passed by the firmware, creating the
1207 * tree of struct device_node. It also fills the "name" and "type"
1208 * pointers of the nodes so the normal device-tree walking functions
1211 void __init
unflatten_device_tree(void)
1213 void *fdt
= initial_boot_params
;
1215 /* Save the statically-placed regions in the reserved_mem array */
1216 fdt_scan_reserved_mem_reg_nodes();
1218 /* Don't use the bootloader provided DTB if ACPI is enabled */
1223 * Populate an empty root node when ACPI is enabled or bootloader
1224 * doesn't provide one.
1227 fdt
= (void *) __dtb_empty_root_begin
;
1228 /* fdt_totalsize() will be used for copy size */
1229 if (fdt_totalsize(fdt
) >
1230 __dtb_empty_root_end
- __dtb_empty_root_begin
) {
1231 pr_err("invalid size in dtb_empty_root\n");
1234 of_fdt_crc32
= crc32_be(~0, fdt
, fdt_totalsize(fdt
));
1235 fdt
= copy_device_tree(fdt
);
1238 __unflatten_device_tree(fdt
, NULL
, &of_root
,
1239 early_init_dt_alloc_memory_arch
, false);
1241 /* Get pointer to "/chosen" and "/aliases" nodes for use everywhere */
1242 of_alias_scan(early_init_dt_alloc_memory_arch
);
1244 unittest_unflatten_overlay_base();
1248 * unflatten_and_copy_device_tree - copy and create tree of device_nodes from flat blob
1250 * Copies and unflattens the device-tree passed by the firmware, creating the
1251 * tree of struct device_node. It also fills the "name" and "type"
1252 * pointers of the nodes so the normal device-tree walking functions
1253 * can be used. This should only be used when the FDT memory has not been
1254 * reserved such is the case when the FDT is built-in to the kernel init
1255 * section. If the FDT memory is reserved already then unflatten_device_tree
1256 * should be used instead.
1258 void __init
unflatten_and_copy_device_tree(void)
1260 if (initial_boot_params
)
1261 initial_boot_params
= copy_device_tree(initial_boot_params
);
1263 unflatten_device_tree();
1267 static ssize_t
of_fdt_raw_read(struct file
*filp
, struct kobject
*kobj
,
1268 struct bin_attribute
*bin_attr
,
1269 char *buf
, loff_t off
, size_t count
)
1271 memcpy(buf
, initial_boot_params
+ off
, count
);
1275 static int __init
of_fdt_raw_init(void)
1277 static struct bin_attribute of_fdt_raw_attr
=
1278 __BIN_ATTR(fdt
, S_IRUSR
, of_fdt_raw_read
, NULL
, 0);
1280 if (!initial_boot_params
)
1283 if (of_fdt_crc32
!= crc32_be(~0, initial_boot_params
,
1284 fdt_totalsize(initial_boot_params
))) {
1285 pr_warn("not creating '/sys/firmware/fdt': CRC check failed\n");
1288 of_fdt_raw_attr
.size
= fdt_totalsize(initial_boot_params
);
1289 return sysfs_create_bin_file(firmware_kobj
, &of_fdt_raw_attr
);
1291 late_initcall(of_fdt_raw_init
);
1294 #endif /* CONFIG_OF_EARLY_FLATTREE */