blob: 271b3fdf00709e2752115e0d371cfa397791eec4 [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>
Leif Lindholmd5031872016-09-27 23:54:12 +030017#include <linux/errno.h>
Grant Likely8482f562009-10-15 10:58:04 -060018
Grant Likelyd8678b52009-10-15 10:57:53 -060019/* Definitions used by the flattened device tree */
20#define OF_DT_HEADER 0xd00dfeed /* marker */
Grant Likelyd8678b52009-10-15 10:57:53 -060021
Grant Likelyd45d94f2009-10-15 10:57:55 -060022#ifndef __ASSEMBLY__
Grant Likelyd45d94f2009-10-15 10:57:55 -060023
Grant Likelycf32eb82010-04-13 16:12:25 -070024#if defined(CONFIG_OF_FLATTREE)
Stephen Neuendorffer9706a362010-11-18 15:54:59 -080025
Grant Likelya0817482011-01-08 21:42:42 -070026struct device_node;
27
Stephen Neuendorffer9706a362010-11-18 15:54:59 -080028/* For scanning an arbitrary device-tree at any time */
Rob Herringc972de12014-04-01 22:48:01 -050029extern char *of_fdt_get_string(const void *blob, u32 offset);
30extern void *of_fdt_get_property(const void *blob,
Stephen Neuendorffer9706a362010-11-18 15:54:59 -080031 unsigned long node,
32 const char *name,
Rob Herring9d0c4df2014-04-01 23:49:03 -050033 int *size);
Rob Herringc972de12014-04-01 22:48:01 -050034extern int of_fdt_is_compatible(const void *blob,
Stephen Neuendorffer9706a362010-11-18 15:54:59 -080035 unsigned long node,
36 const char *compat);
Kevin Cernekeecc783782015-04-09 13:05:15 -070037extern bool of_fdt_is_big_endian(const void *blob,
38 unsigned long node);
Rob Herringc972de12014-04-01 22:48:01 -050039extern int of_fdt_match(const void *blob, unsigned long node,
Uwe Kleine-König7b482c82011-12-20 22:56:45 +010040 const char *const *compat);
Gavin Shan83262412016-05-03 23:22:51 +100041extern void *of_fdt_unflatten_tree(const unsigned long *blob,
42 struct device_node *dad,
43 struct device_node **mynodes);
Stephen Neuendorffer9706a362010-11-18 15:54:59 -080044
Grant Likelye169cfb2009-11-23 14:53:09 -070045/* TBD: Temporary export of fdt globals - remove when code fully merged */
Grant Likelyf00abd92009-11-24 03:27:10 -070046extern int __initdata dt_root_addr_cells;
47extern int __initdata dt_root_size_cells;
Rob Herring1daa0c42014-03-31 15:25:04 -050048extern void *initial_boot_params;
Grant Likelye169cfb2009-11-23 14:53:09 -070049
Rob Herringccf33562014-04-03 13:38:32 -050050extern char __dtb_start[];
51extern char __dtb_end[];
52
Grant Likely8482f562009-10-15 10:58:04 -060053/* For scanning the flat device-tree at boot time */
Grant Likely31a6a872009-11-23 19:49:38 -070054extern int of_scan_flat_dt(int (*it)(unsigned long node, const char *uname,
55 int depth, void *data),
56 void *data);
Shannon Zhao9c609862016-04-07 20:03:33 +080057extern int of_get_flat_dt_subnode_by_name(unsigned long node,
58 const char *uname);
Rob Herring9d0c4df2014-04-01 23:49:03 -050059extern const void *of_get_flat_dt_prop(unsigned long node, const char *name,
60 int *size);
Grant Likely31a6a872009-11-23 19:49:38 -070061extern int of_flat_dt_is_compatible(unsigned long node, const char *name);
Uwe Kleine-König7b482c82011-12-20 22:56:45 +010062extern int of_flat_dt_match(unsigned long node, const char *const *matches);
Grant Likely31a6a872009-11-23 19:49:38 -070063extern unsigned long of_get_flat_dt_root(void);
Rob Herringc0556d32014-04-22 12:55:10 -050064extern int of_get_flat_dt_size(void);
Grant Likely32c97682010-10-20 11:45:14 -060065
Grant Likely86e03222009-12-10 23:42:21 -070066extern int early_init_dt_scan_chosen(unsigned long node, const char *uname,
67 int depth, void *data);
Grant Likely51975db2010-02-01 21:34:14 -070068extern int early_init_dt_scan_memory(unsigned long node, const char *uname,
69 int depth, void *data);
Leif Lindholmd5031872016-09-27 23:54:12 +030070extern int early_init_dt_scan_chosen_stdout(void);
Marek Szyprowskie8d9d1f2014-02-28 14:42:47 +010071extern void early_init_fdt_scan_reserved_mem(void);
Ard Biesheuvel24bbd922015-06-01 13:40:31 +020072extern void early_init_fdt_reserve_self(void);
Grant Likely51975db2010-02-01 21:34:14 -070073extern void early_init_dt_add_memory_arch(u64 base, u64 size);
Reza Arbab41a9ada2016-12-12 16:43:02 -080074extern int early_init_dt_mark_hotplug_memory_arch(u64 base, u64 size);
Marek Szyprowskie8d9d1f2014-02-28 14:42:47 +010075extern int early_init_dt_reserve_memory_arch(phys_addr_t base, phys_addr_t size,
76 bool no_map);
Grant Likelyfe55c182011-08-04 10:27:32 +010077extern void * early_init_dt_alloc_memory_arch(u64 size, u64 align);
Rob Herring9d0c4df2014-04-01 23:49:03 -050078extern u64 dt_mem_next_cell(int s, const __be32 **cellp);
Grant Likely8482f562009-10-15 10:58:04 -060079
Grant Likelyf00abd92009-11-24 03:27:10 -070080/* Early flat tree scan hooks */
81extern int early_init_dt_scan_root(unsigned long node, const char *uname,
82 int depth, void *data);
83
Rob Herring0288ffcb2013-08-26 09:47:40 -050084extern bool early_init_dt_scan(void *params);
Laura Abbott4972a742014-07-15 10:03:34 -070085extern bool early_init_dt_verify(void *params);
86extern void early_init_dt_scan_nodes(void);
Rob Herring0288ffcb2013-08-26 09:47:40 -050087
Rob Herring6a903a22013-08-27 21:41:56 -050088extern const char *of_flat_dt_get_machine_name(void);
89extern const void *of_flat_dt_match_machine(const void *default_match,
90 const void * (*get_next_compat)(const char * const**));
91
Grant Likely82b29282009-10-15 10:58:07 -060092/* Other Prototypes */
Grant Likely82b29282009-10-15 10:58:07 -060093extern void unflatten_device_tree(void);
Rob Herringa8bf7522013-08-26 11:22:45 -050094extern void unflatten_and_copy_device_tree(void);
Grant Likely82b29282009-10-15 10:58:07 -060095extern void early_init_devtree(void *);
Kevin Haob27652d2013-12-24 15:12:08 +080096extern void early_get_first_memblock_info(void *, phys_addr_t *);
Peter Hurleyc90fe9c2016-01-16 15:23:44 -080097extern u64 of_flat_dt_translate_address(unsigned long node);
Laura Abbott704033c2014-07-15 10:03:35 -070098extern void of_fdt_limit_memory(int limit);
Grant Likely8bfe9b52010-04-13 16:12:26 -070099#else /* CONFIG_OF_FLATTREE */
Leif Lindholmd5031872016-09-27 23:54:12 +0300100static inline int early_init_dt_scan_chosen_stdout(void) { return -ENODEV; }
Marek Szyprowskie8d9d1f2014-02-28 14:42:47 +0100101static inline void early_init_fdt_scan_reserved_mem(void) {}
Ard Biesheuvel24bbd922015-06-01 13:40:31 +0200102static inline void early_init_fdt_reserve_self(void) {}
Rob Herring6a903a22013-08-27 21:41:56 -0500103static inline const char *of_flat_dt_get_machine_name(void) { return NULL; }
Grant Likely8bfe9b52010-04-13 16:12:26 -0700104static inline void unflatten_device_tree(void) {}
Rob Herringa8bf7522013-08-26 11:22:45 -0500105static inline void unflatten_and_copy_device_tree(void) {}
Grant Likelycf32eb82010-04-13 16:12:25 -0700106#endif /* CONFIG_OF_FLATTREE */
Grant Likely82b29282009-10-15 10:58:07 -0600107
Grant Likelyd45d94f2009-10-15 10:57:55 -0600108#endif /* __ASSEMBLY__ */
Grant Likelyd8678b52009-10-15 10:57:53 -0600109#endif /* _LINUX_OF_FDT_H */