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 | ||
efb2e014 | 14 | #ifdef CONFIG_OF_DEVICE |
b41912ca SR |
15 | #include <linux/module.h> |
16 | #include <linux/device.h> | |
17 | #include <linux/mod_devicetable.h> | |
18 | #include <linux/pm.h> | |
19 | #include <linux/of_device.h> | |
eca39301 | 20 | #include <linux/platform_device.h> |
b41912ca | 21 | |
15c3597d GL |
22 | /** |
23 | * struct of_dev_auxdata - lookup table entry for device names & platform_data | |
24 | * @compatible: compatible value of node to match against node | |
25 | * @phys_addr: Start address of registers to match against node | |
26 | * @name: Name to assign for matching nodes | |
27 | * @platform_data: platform_data to assign for matching nodes | |
28 | * | |
29 | * This lookup table allows the caller of of_platform_populate() to override | |
30 | * the names of devices when creating devices from the device tree. The table | |
31 | * should be terminated with an empty entry. It also allows the platform_data | |
32 | * pointer to be set. | |
33 | * | |
34 | * The reason for this functionality is that some Linux infrastructure uses | |
35 | * the device name to look up a specific device, but the Linux-specific names | |
36 | * are not encoded into the device tree, so the kernel needs to provide specific | |
37 | * values. | |
38 | * | |
39 | * Note: Using an auxdata lookup table should be considered a last resort when | |
40 | * converting a platform to use the DT. Normally the automatically generated | |
41 | * device name will not matter, and drivers should obtain data from the device | |
42 | * node instead of from an anonymouns platform_data pointer. | |
43 | */ | |
44 | struct of_dev_auxdata { | |
45 | char *compatible; | |
46 | resource_size_t phys_addr; | |
47 | char *name; | |
48 | void *platform_data; | |
49 | }; | |
50 | ||
51 | /* Macro to simplify populating a lookup table */ | |
52 | #define OF_DEV_AUXDATA(_compat,_phys,_name,_pdata) \ | |
53 | { .compatible = _compat, .phys_addr = _phys, .name = _name, \ | |
54 | .platform_data = _pdata } | |
55 | ||
2dc11581 GL |
56 | /** |
57 | * of_platform_driver - Legacy of-aware driver for platform devices. | |
58 | * | |
59 | * An of_platform_driver driver is attached to a basic platform_device on | |
d714d197 | 60 | * the ibm ebus (ibmebus_bus_type). |
b41912ca SR |
61 | */ |
62 | struct of_platform_driver | |
63 | { | |
94a0cb1f | 64 | int (*probe)(struct platform_device* dev, |
b41912ca | 65 | const struct of_device_id *match); |
94a0cb1f | 66 | int (*remove)(struct platform_device* dev); |
b41912ca | 67 | |
94a0cb1f GL |
68 | int (*suspend)(struct platform_device* dev, pm_message_t state); |
69 | int (*resume)(struct platform_device* dev); | |
70 | int (*shutdown)(struct platform_device* dev); | |
b41912ca SR |
71 | |
72 | struct device_driver driver; | |
73 | }; | |
74 | #define to_of_platform_driver(drv) \ | |
75 | container_of(drv,struct of_platform_driver, driver) | |
76 | ||
cbb49c26 GL |
77 | extern const struct of_device_id of_default_bus_match_table[]; |
78 | ||
0763ed23 | 79 | /* Platform drivers register/unregister */ |
94a0cb1f | 80 | extern struct platform_device *of_device_alloc(struct device_node *np, |
94c09319 GL |
81 | const char *bus_id, |
82 | struct device *parent); | |
94a0cb1f | 83 | extern struct platform_device *of_find_device_by_node(struct device_node *np); |
b41912ca | 84 | |
5fd200f3 GL |
85 | #if !defined(CONFIG_SPARC) /* SPARC has its own device registration method */ |
86 | /* Platform devices and busses creation */ | |
94a0cb1f | 87 | extern struct platform_device *of_platform_device_create(struct device_node *np, |
5fd200f3 GL |
88 | const char *bus_id, |
89 | struct device *parent); | |
90 | ||
5fd200f3 GL |
91 | extern int of_platform_bus_probe(struct device_node *root, |
92 | const struct of_device_id *matches, | |
93 | struct device *parent); | |
29d4f8a4 GL |
94 | extern int of_platform_populate(struct device_node *root, |
95 | const struct of_device_id *matches, | |
15c3597d | 96 | const struct of_dev_auxdata *lookup, |
29d4f8a4 | 97 | struct device *parent); |
5fd200f3 GL |
98 | #endif /* !CONFIG_SPARC */ |
99 | ||
efb2e014 | 100 | #endif /* CONFIG_OF_DEVICE */ |
3f23de10 | 101 | |
b41912ca | 102 | #endif /* _LINUX_OF_PLATFORM_H */ |