]>
Commit | Line | Data |
---|---|---|
9b6b563c PM |
1 | #ifndef _POWERPC_PROM_H |
2 | #define _POWERPC_PROM_H | |
3 | #ifdef __KERNEL__ | |
4 | ||
5 | /* | |
6 | * Definitions for talking to the Open Firmware PROM on | |
7 | * Power Macintosh computers. | |
8 | * | |
9 | * Copyright (C) 1996-2005 Paul Mackerras. | |
10 | * | |
11 | * Updates for PPC64 by Peter Bergner & David Engebretsen, IBM Corp. | |
12 | * | |
13 | * This program is free software; you can redistribute it and/or | |
14 | * modify it under the terms of the GNU General Public License | |
15 | * as published by the Free Software Foundation; either version | |
16 | * 2 of the License, or (at your option) any later version. | |
17 | */ | |
18 | #include <linux/types.h> | |
19 | #include <linux/proc_fs.h> | |
a9b14973 | 20 | #include <linux/platform_device.h> |
99ddef9b | 21 | #include <asm/irq.h> |
9b6b563c PM |
22 | #include <asm/atomic.h> |
23 | ||
97e873e5 SR |
24 | #define OF_ROOT_NODE_ADDR_CELLS_DEFAULT 1 |
25 | #define OF_ROOT_NODE_SIZE_CELLS_DEFAULT 1 | |
26 | ||
804ace88 | 27 | #define of_compat_cmp(s1, s2, l) strcasecmp((s1), (s2)) |
581b605a | 28 | #define of_prop_cmp(s1, s2) strcmp((s1), (s2)) |
1ef4d424 | 29 | #define of_node_cmp(s1, s2) strcasecmp((s1), (s2)) |
0081cbc3 | 30 | |
9b6b563c PM |
31 | /* Definitions used by the flattened device tree */ |
32 | #define OF_DT_HEADER 0xd00dfeed /* marker */ | |
33 | #define OF_DT_BEGIN_NODE 0x1 /* Start of node, full name */ | |
34 | #define OF_DT_END_NODE 0x2 /* End node */ | |
35 | #define OF_DT_PROP 0x3 /* Property: name off, size, | |
36 | * content */ | |
37 | #define OF_DT_NOP 0x4 /* nop */ | |
38 | #define OF_DT_END 0x9 | |
39 | ||
40 | #define OF_DT_VERSION 0x10 | |
41 | ||
42 | /* | |
43 | * This is what gets passed to the kernel by prom_init or kexec | |
44 | * | |
45 | * The dt struct contains the device tree structure, full pathes and | |
46 | * property contents. The dt strings contain a separate block with just | |
47 | * the strings for the property names, and is fully page aligned and | |
48 | * self contained in a page, so that it can be kept around by the kernel, | |
49 | * each property name appears only once in this page (cheap compression) | |
50 | * | |
51 | * the mem_rsvmap contains a map of reserved ranges of physical memory, | |
52 | * passing it here instead of in the device-tree itself greatly simplifies | |
53 | * the job of everybody. It's just a list of u64 pairs (base/size) that | |
54 | * ends when size is 0 | |
55 | */ | |
56 | struct boot_param_header | |
57 | { | |
58 | u32 magic; /* magic word OF_DT_HEADER */ | |
59 | u32 totalsize; /* total size of DT block */ | |
60 | u32 off_dt_struct; /* offset to structure */ | |
61 | u32 off_dt_strings; /* offset to strings */ | |
62 | u32 off_mem_rsvmap; /* offset to memory reserve map */ | |
63 | u32 version; /* format version */ | |
64 | u32 last_comp_version; /* last compatible version */ | |
65 | /* version 2 fields below */ | |
66 | u32 boot_cpuid_phys; /* Physical CPU id we're booting on */ | |
67 | /* version 3 fields below */ | |
68 | u32 dt_strings_size; /* size of the DT strings block */ | |
0e0293c8 DG |
69 | /* version 17 fields below */ |
70 | u32 dt_struct_size; /* size of the DT structure block */ | |
9b6b563c PM |
71 | }; |
72 | ||
73 | ||
74 | ||
75 | typedef u32 phandle; | |
76 | typedef u32 ihandle; | |
77 | ||
9b6b563c PM |
78 | struct property { |
79 | char *name; | |
80 | int length; | |
1a38147e | 81 | void *value; |
9b6b563c PM |
82 | struct property *next; |
83 | }; | |
84 | ||
85 | struct device_node { | |
a7f67bdf JK |
86 | const char *name; |
87 | const char *type; | |
9b6b563c PM |
88 | phandle node; |
89 | phandle linux_phandle; | |
9b6b563c PM |
90 | char *full_name; |
91 | ||
92 | struct property *properties; | |
088186de | 93 | struct property *deadprops; /* removed properties */ |
9b6b563c PM |
94 | struct device_node *parent; |
95 | struct device_node *child; | |
96 | struct device_node *sibling; | |
97 | struct device_node *next; /* next device of same type */ | |
98 | struct device_node *allnext; /* next in list of all nodes */ | |
99 | struct proc_dir_entry *pde; /* this node's proc directory */ | |
100 | struct kref kref; | |
101 | unsigned long _flags; | |
102 | void *data; | |
103 | }; | |
104 | ||
105 | extern struct device_node *of_chosen; | |
106 | ||
d3b814bb ME |
107 | static inline int of_node_check_flag(struct device_node *n, unsigned long flag) |
108 | { | |
109 | return test_bit(flag, &n->_flags); | |
110 | } | |
111 | ||
112 | static inline void of_node_set_flag(struct device_node *n, unsigned long flag) | |
113 | { | |
114 | set_bit(flag, &n->_flags); | |
115 | } | |
9b6b563c | 116 | |
9b6b563c PM |
117 | |
118 | #define HAVE_ARCH_DEVTREE_FIXUPS | |
119 | ||
120 | static inline void set_node_proc_entry(struct device_node *dn, struct proc_dir_entry *de) | |
121 | { | |
122 | dn->pde = de; | |
123 | } | |
124 | ||
125 | ||
9b6b563c | 126 | extern struct device_node *of_find_all_nodes(struct device_node *prev); |
9b6b563c PM |
127 | extern struct device_node *of_node_get(struct device_node *node); |
128 | extern void of_node_put(struct device_node *node); | |
129 | ||
3c726f8d | 130 | /* For scanning the flat device-tree at boot time */ |
e8222502 BH |
131 | extern int __init of_scan_flat_dt(int (*it)(unsigned long node, |
132 | const char *uname, int depth, | |
133 | void *data), | |
134 | void *data); | |
135 | extern void* __init of_get_flat_dt_prop(unsigned long node, const char *name, | |
136 | unsigned long *size); | |
137 | extern int __init of_flat_dt_is_compatible(unsigned long node, const char *name); | |
138 | extern unsigned long __init of_get_flat_dt_root(void); | |
3c726f8d | 139 | |
9b6b563c PM |
140 | /* For updating the device tree at runtime */ |
141 | extern void of_attach_node(struct device_node *); | |
34f329db | 142 | extern void of_detach_node(struct device_node *); |
9b6b563c PM |
143 | |
144 | /* Other Prototypes */ | |
145 | extern void finish_device_tree(void); | |
146 | extern void unflatten_device_tree(void); | |
147 | extern void early_init_devtree(void *); | |
9b6b563c | 148 | extern int machine_is_compatible(const char *compat); |
9b6b563c | 149 | extern void print_properties(struct device_node *node); |
9b6b563c PM |
150 | extern int prom_n_intr_cells(struct device_node* np); |
151 | extern void prom_get_irq_senses(unsigned char *senses, int off, int max); | |
183d0202 | 152 | extern int prom_add_property(struct device_node* np, struct property* prop); |
088186de DB |
153 | extern int prom_remove_property(struct device_node *np, struct property *prop); |
154 | extern int prom_update_property(struct device_node *np, | |
155 | struct property *newprop, | |
156 | struct property *oldprop); | |
9b6b563c | 157 | |
40ef8cbc | 158 | #ifdef CONFIG_PPC32 |
9b6b563c PM |
159 | /* |
160 | * PCI <-> OF matching functions | |
161 | * (XXX should these be here?) | |
162 | */ | |
163 | struct pci_bus; | |
164 | struct pci_dev; | |
165 | extern int pci_device_from_OF_node(struct device_node *node, | |
166 | u8* bus, u8* devfn); | |
167 | extern struct device_node* pci_busdev_to_OF_node(struct pci_bus *, int); | |
168 | extern struct device_node* pci_device_to_OF_node(struct pci_dev *); | |
169 | extern void pci_create_OF_bus_map(void); | |
40ef8cbc PM |
170 | #endif |
171 | ||
9b6b563c PM |
172 | extern struct resource *request_OF_resource(struct device_node* node, |
173 | int index, const char* name_postfix); | |
174 | extern int release_OF_resource(struct device_node* node, int index); | |
175 | ||
d2dd482b | 176 | |
d1405b86 | 177 | /* |
d2dd482b BH |
178 | * OF address retreival & translation |
179 | */ | |
180 | ||
181 | ||
a4dc7ff0 | 182 | /* Helper to read a big number; size is in cells (not bytes) */ |
b5a1a9ab | 183 | static inline u64 of_read_number(const u32 *cell, int size) |
cc9fd71c BH |
184 | { |
185 | u64 r = 0; | |
186 | while (size--) | |
187 | r = (r << 32) | *(cell++); | |
188 | return r; | |
189 | } | |
190 | ||
a4dc7ff0 PM |
191 | /* Like of_read_number, but we want an unsigned long result */ |
192 | #ifdef CONFIG_PPC32 | |
193 | static inline unsigned long of_read_ulong(const u32 *cell, int size) | |
194 | { | |
195 | return cell[size-1]; | |
196 | } | |
197 | #else | |
198 | #define of_read_ulong(cell, size) of_read_number(cell, size) | |
199 | #endif | |
200 | ||
d2dd482b | 201 | /* Translate an OF address block into a CPU physical address |
d1405b86 | 202 | */ |
a7f67bdf | 203 | extern u64 of_translate_address(struct device_node *np, const u32 *addr); |
d1405b86 | 204 | |
837c54db BH |
205 | /* Translate a DMA address from device space to CPU space */ |
206 | extern u64 of_translate_dma_address(struct device_node *dev, | |
207 | const u32 *in_addr); | |
208 | ||
d2dd482b BH |
209 | /* Extract an address from a device, returns the region size and |
210 | * the address space flags too. The PCI version uses a BAR number | |
211 | * instead of an absolute index | |
212 | */ | |
a7f67bdf | 213 | extern const u32 *of_get_address(struct device_node *dev, int index, |
d2dd482b | 214 | u64 *size, unsigned int *flags); |
a7f67bdf | 215 | extern const u32 *of_get_pci_address(struct device_node *dev, int bar_no, |
d2dd482b BH |
216 | u64 *size, unsigned int *flags); |
217 | ||
218 | /* Get an address as a resource. Note that if your address is | |
219 | * a PIO address, the conversion will fail if the physical address | |
220 | * can't be internally converted to an IO token with | |
221 | * pci_address_to_pio(), that is because it's either called to early | |
222 | * or it can't be matched to any host bridge IO space | |
223 | */ | |
224 | extern int of_address_to_resource(struct device_node *dev, int index, | |
225 | struct resource *r); | |
226 | extern int of_pci_address_to_resource(struct device_node *dev, int bar, | |
227 | struct resource *r); | |
d1405b86 | 228 | |
d4ad66fa JK |
229 | /* Parse the ibm,dma-window property of an OF node into the busno, phys and |
230 | * size parameters. | |
231 | */ | |
a7f67bdf | 232 | void of_parse_dma_window(struct device_node *dn, const void *dma_window_prop, |
d4ad66fa JK |
233 | unsigned long *busno, unsigned long *phys, unsigned long *size); |
234 | ||
b68239ee ME |
235 | extern void kdump_move_device_tree(void); |
236 | ||
acf7d768 BH |
237 | /* CPU OF node matching */ |
238 | struct device_node *of_get_cpu_node(int cpu, unsigned int *thread); | |
239 | ||
29cfe6f4 TT |
240 | /* Get the MAC address */ |
241 | extern const void *of_get_mac_address(struct device_node *np); | |
cc9fd71c BH |
242 | |
243 | /* | |
244 | * OF interrupt mapping | |
245 | */ | |
246 | ||
247 | /* This structure is returned when an interrupt is mapped. The controller | |
248 | * field needs to be put() after use | |
249 | */ | |
250 | ||
251 | #define OF_MAX_IRQ_SPEC 4 /* We handle specifiers of at most 4 cells */ | |
252 | ||
253 | struct of_irq { | |
254 | struct device_node *controller; /* Interrupt controller node */ | |
255 | u32 size; /* Specifier size */ | |
256 | u32 specifier[OF_MAX_IRQ_SPEC]; /* Specifier copy */ | |
257 | }; | |
258 | ||
40681b95 | 259 | /** |
cc9fd71c BH |
260 | * of_irq_map_init - Initialize the irq remapper |
261 | * @flags: flags defining workarounds to enable | |
262 | * | |
263 | * Some machines have bugs in the device-tree which require certain workarounds | |
264 | * to be applied. Call this before any interrupt mapping attempts to enable | |
265 | * those workarounds. | |
266 | */ | |
267 | #define OF_IMAP_OLDWORLD_MAC 0x00000001 | |
268 | #define OF_IMAP_NO_PHANDLE 0x00000002 | |
269 | ||
270 | extern void of_irq_map_init(unsigned int flags); | |
271 | ||
40681b95 | 272 | /** |
cc9fd71c BH |
273 | * of_irq_map_raw - Low level interrupt tree parsing |
274 | * @parent: the device interrupt parent | |
275 | * @intspec: interrupt specifier ("interrupts" property of the device) | |
006b64de | 276 | * @ointsize: size of the passed in interrupt specifier |
cc9fd71c BH |
277 | * @addr: address specifier (start of "reg" property of the device) |
278 | * @out_irq: structure of_irq filled by this function | |
279 | * | |
280 | * Returns 0 on success and a negative number on error | |
281 | * | |
282 | * This function is a low-level interrupt tree walking function. It | |
283 | * can be used to do a partial walk with synthetized reg and interrupts | |
284 | * properties, for example when resolving PCI interrupts when no device | |
285 | * node exist for the parent. | |
286 | * | |
287 | */ | |
288 | ||
a7f67bdf | 289 | extern int of_irq_map_raw(struct device_node *parent, const u32 *intspec, |
aa43f779 | 290 | u32 ointsize, const u32 *addr, |
cc9fd71c BH |
291 | struct of_irq *out_irq); |
292 | ||
293 | ||
40681b95 | 294 | /** |
cc9fd71c BH |
295 | * of_irq_map_one - Resolve an interrupt for a device |
296 | * @device: the device whose interrupt is to be resolved | |
297 | * @index: index of the interrupt to resolve | |
298 | * @out_irq: structure of_irq filled by this function | |
299 | * | |
300 | * This function resolves an interrupt, walking the tree, for a given | |
301 | * device-tree node. It's the high level pendant to of_irq_map_raw(). | |
302 | * It also implements the workarounds for OldWolrd Macs. | |
303 | */ | |
304 | extern int of_irq_map_one(struct device_node *device, int index, | |
305 | struct of_irq *out_irq); | |
306 | ||
40681b95 | 307 | /** |
cc9fd71c BH |
308 | * of_irq_map_pci - Resolve the interrupt for a PCI device |
309 | * @pdev: the device whose interrupt is to be resolved | |
310 | * @out_irq: structure of_irq filled by this function | |
311 | * | |
312 | * This function resolves the PCI interrupt for a given PCI device. If a | |
313 | * device-node exists for a given pci_dev, it will use normal OF tree | |
314 | * walking. If not, it will implement standard swizzling and walk up the | |
315 | * PCI tree until an device-node is found, at which point it will finish | |
316 | * resolving using the OF tree walking. | |
317 | */ | |
318 | struct pci_dev; | |
319 | extern int of_irq_map_pci(struct pci_dev *pdev, struct of_irq *out_irq); | |
320 | ||
c0b3ae14 MD |
321 | extern int of_irq_to_resource(struct device_node *dev, int index, |
322 | struct resource *r); | |
a9b14973 | 323 | |
c3e8011a CK |
324 | /** |
325 | * of_iomap - Maps the memory mapped IO for a given device_node | |
326 | * @device: the device whose io range will be mapped | |
327 | * @index: index of the io range | |
328 | * | |
329 | * Returns a pointer to the mapped memory | |
330 | */ | |
331 | extern void __iomem *of_iomap(struct device_node *device, int index); | |
cc9fd71c | 332 | |
76c1ce78 SR |
333 | /* |
334 | * NB: This is here while we transition from using asm/prom.h | |
335 | * to linux/of.h | |
336 | */ | |
337 | #include <linux/of.h> | |
338 | ||
9b6b563c PM |
339 | #endif /* __KERNEL__ */ |
340 | #endif /* _POWERPC_PROM_H */ |