2 * Definitions for working with the Flattened Device Tree data format
4 * Copyright 2009 Benjamin Herrenschmidt, IBM Corp
5 * benh@kernel.crashing.org
7 * This program is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU General Public License
9 * version 2 as published by the Free Software Foundation.
12 #ifndef _LINUX_OF_FDT_H
13 #define _LINUX_OF_FDT_H
15 #include <linux/types.h>
16 #include <linux/init.h>
18 /* Definitions used by the flattened device tree */
19 #define OF_DT_HEADER 0xd00dfeed /* marker */
23 #if defined(CONFIG_OF_FLATTREE)
27 /* For scanning an arbitrary device-tree at any time */
28 extern char *of_fdt_get_string(const void *blob
, u32 offset
);
29 extern void *of_fdt_get_property(const void *blob
,
33 extern int of_fdt_is_compatible(const void *blob
,
36 extern int of_fdt_match(const void *blob
, unsigned long node
,
37 const char *const *compat
);
38 extern void of_fdt_unflatten_tree(unsigned long *blob
,
39 struct device_node
**mynodes
);
41 /* TBD: Temporary export of fdt globals - remove when code fully merged */
42 extern int __initdata dt_root_addr_cells
;
43 extern int __initdata dt_root_size_cells
;
44 extern void *initial_boot_params
;
46 extern char __dtb_start
[];
47 extern char __dtb_end
[];
49 /* For scanning the flat device-tree at boot time */
50 extern int of_scan_flat_dt(int (*it
)(unsigned long node
, const char *uname
,
51 int depth
, void *data
),
53 extern const void *of_get_flat_dt_prop(unsigned long node
, const char *name
,
55 extern int of_flat_dt_is_compatible(unsigned long node
, const char *name
);
56 extern int of_flat_dt_match(unsigned long node
, const char *const *matches
);
57 extern unsigned long of_get_flat_dt_root(void);
58 extern int of_get_flat_dt_size(void);
60 extern int early_init_dt_scan_chosen(unsigned long node
, const char *uname
,
61 int depth
, void *data
);
62 extern int early_init_dt_scan_memory(unsigned long node
, const char *uname
,
63 int depth
, void *data
);
64 extern void early_init_fdt_scan_reserved_mem(void);
65 extern void early_init_dt_add_memory_arch(u64 base
, u64 size
);
66 extern int early_init_dt_reserve_memory_arch(phys_addr_t base
, phys_addr_t size
,
68 extern void * early_init_dt_alloc_memory_arch(u64 size
, u64 align
);
69 extern u64
dt_mem_next_cell(int s
, const __be32
**cellp
);
71 /* Early flat tree scan hooks */
72 extern int early_init_dt_scan_root(unsigned long node
, const char *uname
,
73 int depth
, void *data
);
75 extern bool early_init_dt_scan(void *params
);
76 extern bool early_init_dt_verify(void *params
);
77 extern void early_init_dt_scan_nodes(void);
79 extern const char *of_flat_dt_get_machine_name(void);
80 extern const void *of_flat_dt_match_machine(const void *default_match
,
81 const void * (*get_next_compat
)(const char * const**));
83 /* Other Prototypes */
84 extern void unflatten_device_tree(void);
85 extern void unflatten_and_copy_device_tree(void);
86 extern void early_init_devtree(void *);
87 extern void early_get_first_memblock_info(void *, phys_addr_t
*);
88 extern u64
fdt_translate_address(const void *blob
, int node_offset
);
89 extern void of_fdt_limit_memory(int limit
);
90 #else /* CONFIG_OF_FLATTREE */
91 static inline void early_init_fdt_scan_reserved_mem(void) {}
92 static inline const char *of_flat_dt_get_machine_name(void) { return NULL
; }
93 static inline void unflatten_device_tree(void) {}
94 static inline void unflatten_and_copy_device_tree(void) {}
95 #endif /* CONFIG_OF_FLATTREE */
97 #endif /* __ASSEMBLY__ */
98 #endif /* _LINUX_OF_FDT_H */