blob: 26c3302ae58fffdd19f07ccd2af7cbc88a297e6b [file] [log] [blame]
Grant Likelyd8678b52009-10-15 10:57:53 -06001/*
2 * Definitions for working with the Flattened Device Tree data format
3 *
4 * Copyright 2009 Benjamin Herrenschmidt, IBM Corp
5 * benh@kernel.crashing.org
6 *
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.
10 */
11
12#ifndef _LINUX_OF_FDT_H
13#define _LINUX_OF_FDT_H
14
Grant Likely8482f562009-10-15 10:58:04 -060015#include <linux/types.h>
16#include <linux/init.h>
17
Grant Likelyd8678b52009-10-15 10:57:53 -060018/* Definitions used by the flattened device tree */
19#define OF_DT_HEADER 0xd00dfeed /* marker */
Grant Likelyd8678b52009-10-15 10:57:53 -060020
Grant Likelyd45d94f2009-10-15 10:57:55 -060021#ifndef __ASSEMBLY__
Grant Likelyd45d94f2009-10-15 10:57:55 -060022
Grant Likelycf32eb82010-04-13 16:12:25 -070023#if defined(CONFIG_OF_FLATTREE)
Stephen Neuendorffer9706a362010-11-18 15:54:59 -080024
Grant Likelya0817482011-01-08 21:42:42 -070025struct device_node;
26
Stephen Neuendorffer9706a362010-11-18 15:54:59 -080027/* For scanning an arbitrary device-tree at any time */
Rob Herringc972de12014-04-01 22:48:01 -050028extern char *of_fdt_get_string(const void *blob, u32 offset);
29extern void *of_fdt_get_property(const void *blob,
Stephen Neuendorffer9706a362010-11-18 15:54:59 -080030 unsigned long node,
31 const char *name,
Rob Herring9d0c4df2014-04-01 23:49:03 -050032 int *size);
Rob Herringc972de12014-04-01 22:48:01 -050033extern int of_fdt_is_compatible(const void *blob,
Stephen Neuendorffer9706a362010-11-18 15:54:59 -080034 unsigned long node,
35 const char *compat);
Kevin Cernekeecc783782015-04-09 13:05:15 -070036extern bool of_fdt_is_big_endian(const void *blob,
37 unsigned long node);
Rob Herringc972de12014-04-01 22:48:01 -050038extern int of_fdt_match(const void *blob, unsigned long node,
Uwe Kleine-König7b482c82011-12-20 22:56:45 +010039 const char *const *compat);
Gavin Shan83262412016-05-03 23:22:51 +100040extern void *of_fdt_unflatten_tree(const unsigned long *blob,
41 struct device_node *dad,
42 struct device_node **mynodes);
Stephen Neuendorffer9706a362010-11-18 15:54:59 -080043
Grant Likelye169cfb2009-11-23 14:53:09 -070044/* TBD: Temporary export of fdt globals - remove when code fully merged */
Grant Likelyf00abd92009-11-24 03:27:10 -070045extern int __initdata dt_root_addr_cells;
46extern int __initdata dt_root_size_cells;
Rob Herring1daa0c42014-03-31 15:25:04 -050047extern void *initial_boot_params;
Grant Likelye169cfb2009-11-23 14:53:09 -070048
Rob Herringccf33562014-04-03 13:38:32 -050049extern char __dtb_start[];
50extern char __dtb_end[];
51
Grant Likely8482f562009-10-15 10:58:04 -060052/* For scanning the flat device-tree at boot time */
Grant Likely31a6a872009-11-23 19:49:38 -070053extern int of_scan_flat_dt(int (*it)(unsigned long node, const char *uname,
54 int depth, void *data),
55 void *data);
Shannon Zhao9c609862016-04-07 20:03:33 +080056extern int of_get_flat_dt_subnode_by_name(unsigned long node,
57 const char *uname);
Rob Herring9d0c4df2014-04-01 23:49:03 -050058extern const void *of_get_flat_dt_prop(unsigned long node, const char *name,
59 int *size);
Grant Likely31a6a872009-11-23 19:49:38 -070060extern int of_flat_dt_is_compatible(unsigned long node, const char *name);
Uwe Kleine-König7b482c82011-12-20 22:56:45 +010061extern int of_flat_dt_match(unsigned long node, const char *const *matches);
Grant Likely31a6a872009-11-23 19:49:38 -070062extern unsigned long of_get_flat_dt_root(void);
Rob Herringc0556d32014-04-22 12:55:10 -050063extern int of_get_flat_dt_size(void);
Grant Likely32c97682010-10-20 11:45:14 -060064
Grant Likely86e03222009-12-10 23:42:21 -070065extern int early_init_dt_scan_chosen(unsigned long node, const char *uname,
66 int depth, void *data);
Grant Likely51975db2010-02-01 21:34:14 -070067extern int early_init_dt_scan_memory(unsigned long node, const char *uname,
68 int depth, void *data);
Marek Szyprowskie8d9d1f2014-02-28 14:42:47 +010069extern void early_init_fdt_scan_reserved_mem(void);
Ard Biesheuvel24bbd922015-06-01 13:40:31 +020070extern void early_init_fdt_reserve_self(void);
Grant Likely51975db2010-02-01 21:34:14 -070071extern void early_init_dt_add_memory_arch(u64 base, u64 size);
Marek Szyprowskie8d9d1f2014-02-28 14:42:47 +010072extern int early_init_dt_reserve_memory_arch(phys_addr_t base, phys_addr_t size,
73 bool no_map);
Grant Likelyfe55c182011-08-04 10:27:32 +010074extern void * early_init_dt_alloc_memory_arch(u64 size, u64 align);
Rob Herring9d0c4df2014-04-01 23:49:03 -050075extern u64 dt_mem_next_cell(int s, const __be32 **cellp);
Grant Likely8482f562009-10-15 10:58:04 -060076
Grant Likelyf00abd92009-11-24 03:27:10 -070077/* Early flat tree scan hooks */
78extern int early_init_dt_scan_root(unsigned long node, const char *uname,
79 int depth, void *data);
80
Rob Herring0288ffcb2013-08-26 09:47:40 -050081extern bool early_init_dt_scan(void *params);
Laura Abbott4972a742014-07-15 10:03:34 -070082extern bool early_init_dt_verify(void *params);
83extern void early_init_dt_scan_nodes(void);
Rob Herring0288ffcb2013-08-26 09:47:40 -050084
Rob Herring6a903a22013-08-27 21:41:56 -050085extern const char *of_flat_dt_get_machine_name(void);
86extern const void *of_flat_dt_match_machine(const void *default_match,
87 const void * (*get_next_compat)(const char * const**));
88
Grant Likely82b29282009-10-15 10:58:07 -060089/* Other Prototypes */
Grant Likely82b29282009-10-15 10:58:07 -060090extern void unflatten_device_tree(void);
Rob Herringa8bf7522013-08-26 11:22:45 -050091extern void unflatten_and_copy_device_tree(void);
Grant Likely82b29282009-10-15 10:58:07 -060092extern void early_init_devtree(void *);
Kevin Haob27652d2013-12-24 15:12:08 +080093extern void early_get_first_memblock_info(void *, phys_addr_t *);
Peter Hurleyc90fe9c2016-01-16 15:23:44 -080094extern u64 of_flat_dt_translate_address(unsigned long node);
Laura Abbott704033c2014-07-15 10:03:35 -070095extern void of_fdt_limit_memory(int limit);
Grant Likely8bfe9b52010-04-13 16:12:26 -070096#else /* CONFIG_OF_FLATTREE */
Marek Szyprowskie8d9d1f2014-02-28 14:42:47 +010097static inline void early_init_fdt_scan_reserved_mem(void) {}
Ard Biesheuvel24bbd922015-06-01 13:40:31 +020098static inline void early_init_fdt_reserve_self(void) {}
Rob Herring6a903a22013-08-27 21:41:56 -050099static inline const char *of_flat_dt_get_machine_name(void) { return NULL; }
Grant Likely8bfe9b52010-04-13 16:12:26 -0700100static inline void unflatten_device_tree(void) {}
Rob Herringa8bf7522013-08-26 11:22:45 -0500101static inline void unflatten_and_copy_device_tree(void) {}
Grant Likelycf32eb82010-04-13 16:12:25 -0700102#endif /* CONFIG_OF_FLATTREE */
Grant Likely82b29282009-10-15 10:58:07 -0600103
Grant Likelyd45d94f2009-10-15 10:57:55 -0600104#endif /* __ASSEMBLY__ */
Grant Likelyd8678b52009-10-15 10:57:53 -0600105#endif /* _LINUX_OF_FDT_H */