xref: /openbmc/u-boot/include/fdt_support.h (revision e895a4b06f9062f052d438df7f4766b3decdb3d4)
1 /*
2  * (C) Copyright 2007
3  * Gerald Van Baren, Custom IDEAS, vanbaren@cideas.com
4  *
5  * SPDX-License-Identifier:	GPL-2.0+
6  */
7 
8 #ifndef __FDT_SUPPORT_H
9 #define __FDT_SUPPORT_H
10 
11 #ifdef CONFIG_OF_LIBFDT
12 
13 #include <libfdt.h>
14 
15 u32 fdt_getprop_u32_default_node(const void *fdt, int off, int cell,
16 				const char *prop, const u32 dflt);
17 u32 fdt_getprop_u32_default(const void *fdt, const char *path,
18 				const char *prop, const u32 dflt);
19 int fdt_chosen(void *fdt);
20 int fdt_initrd(void *fdt, ulong initrd_start, ulong initrd_end);
21 void do_fixup_by_path(void *fdt, const char *path, const char *prop,
22 		      const void *val, int len, int create);
23 void do_fixup_by_path_u32(void *fdt, const char *path, const char *prop,
24 			  u32 val, int create);
25 
26 static inline void do_fixup_by_path_string(void *fdt, const char *path,
27 					   const char *prop, const char *status)
28 {
29 	do_fixup_by_path(fdt, path, prop, status, strlen(status) + 1, 1);
30 }
31 
32 void do_fixup_by_prop(void *fdt,
33 		      const char *pname, const void *pval, int plen,
34 		      const char *prop, const void *val, int len,
35 		      int create);
36 void do_fixup_by_prop_u32(void *fdt,
37 			  const char *pname, const void *pval, int plen,
38 			  const char *prop, u32 val, int create);
39 void do_fixup_by_compat(void *fdt, const char *compat,
40 			const char *prop, const void *val, int len, int create);
41 void do_fixup_by_compat_u32(void *fdt, const char *compat,
42 			    const char *prop, u32 val, int create);
43 int fdt_fixup_memory(void *blob, u64 start, u64 size);
44 int fdt_fixup_memory_banks(void *blob, u64 start[], u64 size[], int banks);
45 void fdt_fixup_ethernet(void *fdt);
46 int fdt_find_and_setprop(void *fdt, const char *node, const char *prop,
47 			 const void *val, int len, int create);
48 void fdt_fixup_qe_firmware(void *fdt);
49 
50 #if defined(CONFIG_HAS_FSL_DR_USB) || defined(CONFIG_HAS_FSL_MPH_USB)
51 void fdt_fixup_dr_usb(void *blob, bd_t *bd);
52 #else
53 static inline void fdt_fixup_dr_usb(void *blob, bd_t *bd) {}
54 #endif /* defined(CONFIG_HAS_FSL_DR_USB) || defined(CONFIG_HAS_FSL_MPH_USB) */
55 
56 #if defined(CONFIG_SYS_FSL_SEC_COMPAT)
57 void fdt_fixup_crypto_node(void *blob, int sec_rev);
58 #else
59 static inline void fdt_fixup_crypto_node(void *blob, int sec_rev) {}
60 #endif
61 
62 #ifdef CONFIG_PCI
63 #include <pci.h>
64 int fdt_pci_dma_ranges(void *blob, int phb_off, struct pci_controller *hose);
65 #endif
66 
67 /**
68  * Add board-specific data to the FDT before booting the OS.
69  *
70  * Use CONFIG_SYS_FDT_PAD to ensure there is sufficient space.
71  *
72  * @param blob		FDT blob to update
73  * @param bd_t		Pointer to board data
74  * @return 0 if ok, or -FDT_ERR_... on error
75  */
76 int ft_board_setup(void *blob, bd_t *bd);
77 
78 /*
79  * The keystone2 SOC requires all 32 bit aliased addresses to be converted
80  * to their 36 physical format. This has to happen after all fdt nodes
81  * are added or modified by the image_setup_libfdt(). The ft_board_setup_ex()
82  * called at the end of the image_setup_libfdt() is to do that convertion.
83  */
84 void ft_board_setup_ex(void *blob, bd_t *bd);
85 void ft_cpu_setup(void *blob, bd_t *bd);
86 void ft_pci_setup(void *blob, bd_t *bd);
87 
88 void set_working_fdt_addr(void *addr);
89 int fdt_shrink_to_minimum(void *blob);
90 int fdt_increase_size(void *fdt, int add_len);
91 
92 int fdt_fixup_nor_flash_size(void *blob);
93 
94 void fdt_fixup_mtdparts(void *fdt, void *node_info, int node_info_size);
95 void fdt_del_node_and_alias(void *blob, const char *alias);
96 u64 fdt_translate_address(void *blob, int node_offset, const __be32 *in_addr);
97 int fdt_node_offset_by_compat_reg(void *blob, const char *compat,
98 					phys_addr_t compat_off);
99 int fdt_alloc_phandle(void *blob);
100 int fdt_set_phandle(void *fdt, int nodeoffset, uint32_t phandle);
101 unsigned int fdt_create_phandle(void *fdt, int nodeoffset);
102 int fdt_add_edid(void *blob, const char *compat, unsigned char *buf);
103 
104 int fdt_verify_alias_address(void *fdt, int anode, const char *alias,
105 			      u64 addr);
106 u64 fdt_get_base_address(void *fdt, int node);
107 int fdt_read_range(void *fdt, int node, int n, uint64_t *child_addr,
108 		   uint64_t *addr, uint64_t *len);
109 
110 enum fdt_status {
111 	FDT_STATUS_OKAY,
112 	FDT_STATUS_DISABLED,
113 	FDT_STATUS_FAIL,
114 	FDT_STATUS_FAIL_ERROR_CODE,
115 };
116 int fdt_set_node_status(void *fdt, int nodeoffset,
117 			enum fdt_status status, unsigned int error_code);
118 static inline int fdt_status_okay(void *fdt, int nodeoffset)
119 {
120 	return fdt_set_node_status(fdt, nodeoffset, FDT_STATUS_OKAY, 0);
121 }
122 static inline int fdt_status_disabled(void *fdt, int nodeoffset)
123 {
124 	return fdt_set_node_status(fdt, nodeoffset, FDT_STATUS_DISABLED, 0);
125 }
126 static inline int fdt_status_fail(void *fdt, int nodeoffset)
127 {
128 	return fdt_set_node_status(fdt, nodeoffset, FDT_STATUS_FAIL, 0);
129 }
130 
131 int fdt_set_status_by_alias(void *fdt, const char *alias,
132 			    enum fdt_status status, unsigned int error_code);
133 static inline int fdt_status_okay_by_alias(void *fdt, const char *alias)
134 {
135 	return fdt_set_status_by_alias(fdt, alias, FDT_STATUS_OKAY, 0);
136 }
137 static inline int fdt_status_disabled_by_alias(void *fdt, const char *alias)
138 {
139 	return fdt_set_status_by_alias(fdt, alias, FDT_STATUS_DISABLED, 0);
140 }
141 static inline int fdt_status_fail_by_alias(void *fdt, const char *alias)
142 {
143 	return fdt_set_status_by_alias(fdt, alias, FDT_STATUS_FAIL, 0);
144 }
145 
146 /* Helper to read a big number; size is in cells (not bytes) */
147 static inline u64 of_read_number(const fdt32_t *cell, int size)
148 {
149 	u64 r = 0;
150 	while (size--)
151 		r = (r << 32) | fdt32_to_cpu(*(cell++));
152 	return r;
153 }
154 
155 void of_bus_default_count_cells(void *blob, int parentoffset,
156 					int *addrc, int *sizec);
157 int ft_verify_fdt(void *fdt);
158 int arch_fixup_memory_node(void *blob);
159 
160 #endif /* ifdef CONFIG_OF_LIBFDT */
161 
162 #ifdef USE_HOSTCC
163 int fdtdec_get_int(const void *blob, int node, const char *prop_name,
164 		int default_val);
165 #endif
166 #endif /* ifndef __FDT_SUPPORT_H */
167