Commit | Line | Data |
---|---|---|
b41912ca SR |
1 | #ifndef _LINUX_OF_PLATFORM_H |
2 | #define _LINUX_OF_PLATFORM_H | |
3 | /* | |
4 | * Copyright (C) 2006 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 | * as published by the Free Software Foundation; either version | |
10 | * 2 of the License, or (at your option) any later version. | |
11 | * | |
12 | */ | |
13 | ||
b41912ca SR |
14 | #include <linux/device.h> |
15 | #include <linux/mod_devicetable.h> | |
16 | #include <linux/pm.h> | |
17 | #include <linux/of_device.h> | |
eca39301 | 18 | #include <linux/platform_device.h> |
b41912ca | 19 | |
15c3597d GL |
20 | /** |
21 | * struct of_dev_auxdata - lookup table entry for device names & platform_data | |
22 | * @compatible: compatible value of node to match against node | |
23 | * @phys_addr: Start address of registers to match against node | |
24 | * @name: Name to assign for matching nodes | |
25 | * @platform_data: platform_data to assign for matching nodes | |
26 | * | |
27 | * This lookup table allows the caller of of_platform_populate() to override | |
28 | * the names of devices when creating devices from the device tree. The table | |
29 | * should be terminated with an empty entry. It also allows the platform_data | |
30 | * pointer to be set. | |
31 | * | |
32 | * The reason for this functionality is that some Linux infrastructure uses | |
33 | * the device name to look up a specific device, but the Linux-specific names | |
34 | * are not encoded into the device tree, so the kernel needs to provide specific | |
35 | * values. | |
36 | * | |
37 | * Note: Using an auxdata lookup table should be considered a last resort when | |
38 | * converting a platform to use the DT. Normally the automatically generated | |
39 | * device name will not matter, and drivers should obtain data from the device | |
40 | * node instead of from an anonymouns platform_data pointer. | |
41 | */ | |
42 | struct of_dev_auxdata { | |
43 | char *compatible; | |
44 | resource_size_t phys_addr; | |
45 | char *name; | |
46 | void *platform_data; | |
47 | }; | |
48 | ||
49 | /* Macro to simplify populating a lookup table */ | |
50 | #define OF_DEV_AUXDATA(_compat,_phys,_name,_pdata) \ | |
51 | { .compatible = _compat, .phys_addr = _phys, .name = _name, \ | |
52 | .platform_data = _pdata } | |
53 | ||
cbb49c26 GL |
54 | extern const struct of_device_id of_default_bus_match_table[]; |
55 | ||
0763ed23 | 56 | /* Platform drivers register/unregister */ |
94a0cb1f | 57 | extern struct platform_device *of_device_alloc(struct device_node *np, |
94c09319 GL |
58 | const char *bus_id, |
59 | struct device *parent); | |
94a0cb1f | 60 | extern struct platform_device *of_find_device_by_node(struct device_node *np); |
b41912ca | 61 | |
5fd200f3 | 62 | /* Platform devices and busses creation */ |
94a0cb1f | 63 | extern struct platform_device *of_platform_device_create(struct device_node *np, |
5fd200f3 GL |
64 | const char *bus_id, |
65 | struct device *parent); | |
66 | ||
5fd200f3 GL |
67 | extern int of_platform_bus_probe(struct device_node *root, |
68 | const struct of_device_id *matches, | |
69 | struct device *parent); | |
8a46f4f7 | 70 | #ifdef CONFIG_OF_ADDRESS |
29d4f8a4 GL |
71 | extern int of_platform_populate(struct device_node *root, |
72 | const struct of_device_id *matches, | |
15c3597d | 73 | const struct of_dev_auxdata *lookup, |
29d4f8a4 | 74 | struct device *parent); |
8a46f4f7 | 75 | #else |
964dba28 GL |
76 | static inline int of_platform_populate(struct device_node *root, |
77 | const struct of_device_id *matches, | |
78 | const struct of_dev_auxdata *lookup, | |
79 | struct device *parent) | |
80 | { | |
81 | return -ENODEV; | |
82 | } | |
8a46f4f7 | 83 | #endif |
5fd200f3 | 84 | |
b41912ca | 85 | #endif /* _LINUX_OF_PLATFORM_H */ |