]>
Commit | Line | Data |
---|---|---|
64dbbd40 GVB |
1 | /* |
2 | * (C) Copyright 2007 | |
3 | * Gerald Van Baren, Custom IDEAS, [email protected] | |
4 | * | |
1a459660 | 5 | * SPDX-License-Identifier: GPL-2.0+ |
64dbbd40 GVB |
6 | */ |
7 | ||
8 | #ifndef __FDT_SUPPORT_H | |
9 | #define __FDT_SUPPORT_H | |
10 | ||
11 | #ifdef CONFIG_OF_LIBFDT | |
12 | ||
58864ddc | 13 | #include <libfdt.h> |
64dbbd40 | 14 | |
94fb182c AG |
15 | u32 fdt_getprop_u32_default_node(const void *fdt, int off, int cell, |
16 | const char *prop, const u32 dflt); | |
07e12784 GB |
17 | u32 fdt_getprop_u32_default(const void *fdt, const char *path, |
18 | const char *prop, const u32 dflt); | |
3c4c142e PK |
19 | |
20 | /** | |
21 | * Add data to the root of the FDT before booting the OS. | |
22 | * | |
23 | * See doc/device-tree-bindings/root.txt | |
24 | * | |
25 | * @param fdt FDT address in memory | |
26 | * @return 0 if ok, or -FDT_ERR_... on error | |
27 | */ | |
10be5b5d | 28 | int fdt_root(void *fdt); |
3c4c142e PK |
29 | |
30 | /** | |
31 | * Add chosen data the FDT before booting the OS. | |
32 | * | |
33 | * In particular, this adds the kernel command line (bootargs) to the FDT. | |
34 | * | |
35 | * @param fdt FDT address in memory | |
36 | * @return 0 if ok, or -FDT_ERR_... on error | |
37 | */ | |
bc6ed0f9 | 38 | int fdt_chosen(void *fdt); |
3c4c142e PK |
39 | |
40 | /** | |
41 | * Add initrd information to the FDT before booting the OS. | |
42 | * | |
43 | * @param fdt FDT address in memory | |
44 | * @return 0 if ok, or -FDT_ERR_... on error | |
45 | */ | |
dbe963ae | 46 | int fdt_initrd(void *fdt, ulong initrd_start, ulong initrd_end); |
3c4c142e | 47 | |
e93becf8 KG |
48 | void do_fixup_by_path(void *fdt, const char *path, const char *prop, |
49 | const void *val, int len, int create); | |
50 | void do_fixup_by_path_u32(void *fdt, const char *path, const char *prop, | |
51 | u32 val, int create); | |
8ddb10ea CL |
52 | |
53 | static inline void do_fixup_by_path_string(void *fdt, const char *path, | |
54 | const char *prop, const char *status) | |
55 | { | |
56 | do_fixup_by_path(fdt, path, prop, status, strlen(status) + 1, 1); | |
57 | } | |
58 | ||
9eb77cea KG |
59 | void do_fixup_by_prop(void *fdt, |
60 | const char *pname, const void *pval, int plen, | |
61 | const char *prop, const void *val, int len, | |
62 | int create); | |
63 | void do_fixup_by_prop_u32(void *fdt, | |
64 | const char *pname, const void *pval, int plen, | |
65 | const char *prop, u32 val, int create); | |
66 | void do_fixup_by_compat(void *fdt, const char *compat, | |
67 | const char *prop, const void *val, int len, int create); | |
68 | void do_fixup_by_compat_u32(void *fdt, const char *compat, | |
69 | const char *prop, u32 val, int create); | |
5c1cf89f AP |
70 | /** |
71 | * Setup the memory node in the DT. Creates one if none was existing before. | |
72 | * Calls fdt_fixup_memory_banks() to populate a single reg pair covering the | |
73 | * whole memory. | |
74 | * | |
75 | * @param blob FDT blob to update | |
76 | * @param start Begin of DRAM mapping in physical memory | |
77 | * @param size Size of the single memory bank | |
78 | * @return 0 if ok, or -1 or -FDT_ERR_... on error | |
79 | */ | |
3c927281 | 80 | int fdt_fixup_memory(void *blob, u64 start, u64 size); |
5c1cf89f AP |
81 | |
82 | /** | |
83 | * Fill the DT memory node with multiple memory banks. | |
84 | * Creates the node if none was existing before. | |
85 | * If banks is 0, it will not touch the existing reg property. This allows | |
86 | * boards to not mess with the existing DT setup, which may have been | |
87 | * filled in properly before. | |
88 | * | |
89 | * @param blob FDT blob to update | |
90 | * @param start Array of size <banks> to hold the start addresses. | |
91 | * @param size Array of size <banks> to hold the size of each region. | |
92 | * @param banks Number of memory banks to create. If 0, the reg | |
93 | * property will be left untouched. | |
94 | * @return 0 if ok, or -1 or -FDT_ERR_... on error | |
95 | */ | |
a6bd9e83 | 96 | int fdt_fixup_memory_banks(void *blob, u64 start[], u64 size[], int banks); |
5c1cf89f | 97 | |
ba37aa03 | 98 | void fdt_fixup_ethernet(void *fdt); |
22fb2246 MF |
99 | int fdt_find_and_setprop(void *fdt, const char *node, const char *prop, |
100 | const void *val, int len, int create); | |
b8ec2385 | 101 | void fdt_fixup_qe_firmware(void *fdt); |
64dbbd40 | 102 | |
08daa258 TH |
103 | /** |
104 | * Update native-mode property of display-timings node to the phandle | |
105 | * of the timings matching a display by name (case insensitive). | |
106 | * | |
107 | * see kernel Documentation/devicetree/bindings/video/display-timing.txt | |
108 | * | |
109 | * @param blob FDT blob to update | |
110 | * @param path path within dt | |
111 | * @param display name of display timing to match | |
112 | * @return 0 if ok, or -FDT_ERR_... on error | |
113 | */ | |
114 | int fdt_fixup_display(void *blob, const char *path, const char *display); | |
115 | ||
b9f6786a | 116 | #if defined(CONFIG_USB_EHCI_FSL) || defined(CONFIG_USB_XHCI_FSL) |
18e69a35 AV |
117 | void fdt_fixup_dr_usb(void *blob, bd_t *bd); |
118 | #else | |
119 | static inline void fdt_fixup_dr_usb(void *blob, bd_t *bd) {} | |
b9f6786a | 120 | #endif /* defined(CONFIG_USB_EHCI_FSL) || defined(CONFIG_USB_XHCI_FSL) */ |
18e69a35 | 121 | |
929a2138 | 122 | #if defined(CONFIG_SYS_FSL_SEC_COMPAT) |
6b70ffb9 KP |
123 | void fdt_fixup_crypto_node(void *blob, int sec_rev); |
124 | #else | |
125 | static inline void fdt_fixup_crypto_node(void *blob, int sec_rev) {} | |
126 | #endif | |
127 | ||
8ab451c4 KG |
128 | #ifdef CONFIG_PCI |
129 | #include <pci.h> | |
130 | int fdt_pci_dma_ranges(void *blob, int phb_off, struct pci_controller *hose); | |
131 | #endif | |
132 | ||
a9e8e291 SG |
133 | int fdt_find_or_add_subnode(void *fdt, int parentoffset, const char *name); |
134 | ||
e895a4b0 SG |
135 | /** |
136 | * Add board-specific data to the FDT before booting the OS. | |
137 | * | |
138 | * Use CONFIG_SYS_FDT_PAD to ensure there is sufficient space. | |
6f4dbc21 | 139 | * This function is called if CONFIG_OF_BOARD_SETUP is defined |
e895a4b0 SG |
140 | * |
141 | * @param blob FDT blob to update | |
142 | * @param bd_t Pointer to board data | |
143 | * @return 0 if ok, or -FDT_ERR_... on error | |
144 | */ | |
145 | int ft_board_setup(void *blob, bd_t *bd); | |
146 | ||
00c200f1 VA |
147 | /* |
148 | * The keystone2 SOC requires all 32 bit aliased addresses to be converted | |
149 | * to their 36 physical format. This has to happen after all fdt nodes | |
150 | * are added or modified by the image_setup_libfdt(). The ft_board_setup_ex() | |
151 | * called at the end of the image_setup_libfdt() is to do that convertion. | |
152 | */ | |
153 | void ft_board_setup_ex(void *blob, bd_t *bd); | |
e125a2ff GVB |
154 | void ft_cpu_setup(void *blob, bd_t *bd); |
155 | void ft_pci_setup(void *blob, bd_t *bd); | |
e125a2ff | 156 | |
c654b517 SG |
157 | /** |
158 | * Add system-specific data to the FDT before booting the OS. | |
159 | * | |
160 | * Use CONFIG_SYS_FDT_PAD to ensure there is sufficient space. | |
161 | * This function is called if CONFIG_OF_SYSTEM_SETUP is defined | |
162 | * | |
163 | * @param blob FDT blob to update | |
164 | * @param bd_t Pointer to board data | |
165 | * @return 0 if ok, or -FDT_ERR_... on error | |
166 | */ | |
167 | int ft_system_setup(void *blob, bd_t *bd); | |
168 | ||
90fbee3e | 169 | void set_working_fdt_addr(ulong addr); |
5bf58ccc | 170 | int fdt_shrink_to_minimum(void *blob); |
b3606f14 | 171 | int fdt_increase_size(void *fdt, int add_len); |
54f9c866 | 172 | |
8a805df1 | 173 | int fdt_fixup_nor_flash_size(void *blob); |
30d45c0d | 174 | |
f4ae23a7 | 175 | #if defined(CONFIG_FDT_FIXUP_PARTITIONS) |
3c950e2e | 176 | void fdt_fixup_mtdparts(void *fdt, void *node_info, int node_info_size); |
f4ae23a7 CS |
177 | #else |
178 | static inline void fdt_fixup_mtdparts(void *fdt, void *node_info, | |
179 | int node_info_size) {} | |
180 | #endif | |
181 | ||
49b97d9c | 182 | void fdt_del_node_and_alias(void *blob, const char *alias); |
11e44fc6 SW |
183 | u64 fdt_translate_address(const void *blob, int node_offset, |
184 | const __be32 *in_addr); | |
75e73afd KG |
185 | int fdt_node_offset_by_compat_reg(void *blob, const char *compat, |
186 | phys_addr_t compat_off); | |
b4b847e9 | 187 | int fdt_alloc_phandle(void *blob); |
f117c0f0 | 188 | int fdt_set_phandle(void *fdt, int nodeoffset, uint32_t phandle); |
3c927ccc | 189 | unsigned int fdt_create_phandle(void *fdt, int nodeoffset); |
beca5a5f | 190 | int fdt_add_edid(void *blob, const char *compat, unsigned char *buf); |
3c950e2e | 191 | |
bb682001 TT |
192 | int fdt_verify_alias_address(void *fdt, int anode, const char *alias, |
193 | u64 addr); | |
194 | u64 fdt_get_base_address(void *fdt, int node); | |
c48e6868 AG |
195 | int fdt_read_range(void *fdt, int node, int n, uint64_t *child_addr, |
196 | uint64_t *addr, uint64_t *len); | |
bb682001 | 197 | |
2a523f52 SL |
198 | enum fdt_status { |
199 | FDT_STATUS_OKAY, | |
200 | FDT_STATUS_DISABLED, | |
201 | FDT_STATUS_FAIL, | |
202 | FDT_STATUS_FAIL_ERROR_CODE, | |
203 | }; | |
204 | int fdt_set_node_status(void *fdt, int nodeoffset, | |
205 | enum fdt_status status, unsigned int error_code); | |
206 | static inline int fdt_status_okay(void *fdt, int nodeoffset) | |
207 | { | |
208 | return fdt_set_node_status(fdt, nodeoffset, FDT_STATUS_OKAY, 0); | |
209 | } | |
210 | static inline int fdt_status_disabled(void *fdt, int nodeoffset) | |
211 | { | |
212 | return fdt_set_node_status(fdt, nodeoffset, FDT_STATUS_DISABLED, 0); | |
213 | } | |
b940ca64 GR |
214 | static inline int fdt_status_fail(void *fdt, int nodeoffset) |
215 | { | |
216 | return fdt_set_node_status(fdt, nodeoffset, FDT_STATUS_FAIL, 0); | |
217 | } | |
2a523f52 | 218 | |
b940ca64 | 219 | int fdt_set_status_by_alias(void *fdt, const char *alias, |
2a523f52 | 220 | enum fdt_status status, unsigned int error_code); |
b940ca64 | 221 | static inline int fdt_status_okay_by_alias(void *fdt, const char *alias) |
2a523f52 SL |
222 | { |
223 | return fdt_set_status_by_alias(fdt, alias, FDT_STATUS_OKAY, 0); | |
224 | } | |
b940ca64 | 225 | static inline int fdt_status_disabled_by_alias(void *fdt, const char *alias) |
2a523f52 SL |
226 | { |
227 | return fdt_set_status_by_alias(fdt, alias, FDT_STATUS_DISABLED, 0); | |
228 | } | |
b940ca64 GR |
229 | static inline int fdt_status_fail_by_alias(void *fdt, const char *alias) |
230 | { | |
231 | return fdt_set_status_by_alias(fdt, alias, FDT_STATUS_FAIL, 0); | |
232 | } | |
2a523f52 | 233 | |
08df4a21 AB |
234 | /* Helper to read a big number; size is in cells (not bytes) */ |
235 | static inline u64 of_read_number(const fdt32_t *cell, int size) | |
236 | { | |
237 | u64 r = 0; | |
238 | while (size--) | |
239 | r = (r << 32) | fdt32_to_cpu(*(cell++)); | |
240 | return r; | |
241 | } | |
242 | ||
11e44fc6 | 243 | void of_bus_default_count_cells(const void *blob, int parentoffset, |
f43b4356 | 244 | int *addrc, int *sizec); |
d50b07df JH |
245 | int ft_verify_fdt(void *fdt); |
246 | int arch_fixup_memory_node(void *blob); | |
f43b4356 | 247 | |
d4f495a8 HG |
248 | int fdt_setup_simplefb_node(void *fdt, int node, u64 base_address, u32 width, |
249 | u32 height, u32 stride, const char *format); | |
250 | ||
64dbbd40 | 251 | #endif /* ifdef CONFIG_OF_LIBFDT */ |
29a23f9d HS |
252 | |
253 | #ifdef USE_HOSTCC | |
254 | int fdtdec_get_int(const void *blob, int node, const char *prop_name, | |
255 | int default_val); | |
256 | #endif | |
64dbbd40 | 257 | #endif /* ifndef __FDT_SUPPORT_H */ |