Blame view
include/linux/platform_device.h
9.39 KB
bbbf508d6 [DRIVER MODEL] Ad... |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
/* * platform_device.h - generic, centralized driver model * * Copyright (c) 2001-2003 Patrick Mochel <mochel@osdl.org> * * This file is released under the GPLv2 * * See Documentation/driver-model/ for more information. */ #ifndef _PLATFORM_DEVICE_H_ #define _PLATFORM_DEVICE_H_ #include <linux/device.h> |
57fee4a58 platform: introdu... |
15 |
#include <linux/mod_devicetable.h> |
bbbf508d6 [DRIVER MODEL] Ad... |
16 |
|
e710d7d5a mfd: Fetch cell p... |
17 |
struct mfd_cell; |
bbbf508d6 [DRIVER MODEL] Ad... |
18 19 |
struct platform_device { const char * name; |
1359555eb Driver core: Make... |
20 |
int id; |
bbbf508d6 [DRIVER MODEL] Ad... |
21 22 23 |
struct device dev; u32 num_resources; struct resource * resource; |
57fee4a58 platform: introdu... |
24 |
|
3d03ba4d1 driver core: make... |
25 |
const struct platform_device_id *id_entry; |
d7aacaddc Driver Core: Add ... |
26 |
|
e710d7d5a mfd: Fetch cell p... |
27 28 |
/* MFD cell pointer */ struct mfd_cell *mfd_cell; |
d7aacaddc Driver Core: Add ... |
29 30 |
/* arch specific additions */ struct pdev_archdata archdata; |
bbbf508d6 [DRIVER MODEL] Ad... |
31 |
}; |
57fee4a58 platform: introdu... |
32 |
#define platform_get_device_id(pdev) ((pdev)->id_entry) |
bbbf508d6 [DRIVER MODEL] Ad... |
33 34 35 36 37 38 39 |
#define to_platform_device(x) container_of((x), struct platform_device, dev) extern int platform_device_register(struct platform_device *); extern void platform_device_unregister(struct platform_device *); extern struct bus_type platform_bus_type; extern struct device platform_bus; |
a77ce8167 driver core: Add ... |
40 |
extern void arch_setup_pdev_archdata(struct platform_device *); |
bbbf508d6 [DRIVER MODEL] Ad... |
41 42 |
extern struct resource *platform_get_resource(struct platform_device *, unsigned int, unsigned int); extern int platform_get_irq(struct platform_device *, unsigned int); |
c0afe7ba5 driver core: Cons... |
43 44 |
extern struct resource *platform_get_resource_byname(struct platform_device *, unsigned int, const char *); extern int platform_get_irq_byname(struct platform_device *, const char *); |
bbbf508d6 [DRIVER MODEL] Ad... |
45 |
extern int platform_add_devices(struct platform_device **, int); |
01dcc60a7 new helper to cre... |
46 47 48 49 50 51 52 53 54 55 56 57 58 59 |
struct platform_device_info { struct device *parent; const char *name; int id; const struct resource *res; unsigned int num_res; const void *data; size_t size_data; u64 dma_mask; }; extern struct platform_device *platform_device_register_full( |
5a3072be6 drivers_base: mak... |
60 |
const struct platform_device_info *pdevinfo); |
01dcc60a7 new helper to cre... |
61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 |
/** * platform_device_register_resndata - add a platform-level device with * resources and platform-specific data * * @parent: parent device for the device we're adding * @name: base name of the device we're adding * @id: instance id * @res: set of resources that needs to be allocated for the device * @num: number of resources * @data: platform specific data for this platform device * @size: size of platform specific data * * Returns &struct platform_device pointer on success, or ERR_PTR() on error. */ static inline struct platform_device *platform_device_register_resndata( |
44f28bdea Driver core: redu... |
77 78 |
struct device *parent, const char *name, int id, const struct resource *res, unsigned int num, |
01dcc60a7 new helper to cre... |
79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 |
const void *data, size_t size) { struct platform_device_info pdevinfo = { .parent = parent, .name = name, .id = id, .res = res, .num_res = num, .data = data, .size_data = size, .dma_mask = 0, }; return platform_device_register_full(&pdevinfo); } |
44f28bdea Driver core: redu... |
94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 |
/** * platform_device_register_simple - add a platform-level device and its resources * @name: base name of the device we're adding * @id: instance id * @res: set of resources that needs to be allocated for the device * @num: number of resources * * This function creates a simple platform device that requires minimal * resource and memory management. Canned release function freeing memory * allocated for the device allows drivers using such devices to be * unloaded without waiting for the last reference to the device to be * dropped. * * This interface is primarily intended for use with legacy drivers which * probe hardware directly. Because such drivers create sysfs device nodes * themselves, rather than letting system infrastructure handle such device * enumeration tasks, they don't fully conform to the Linux driver model. * In particular, when such drivers are built as modules, they can't be * "hotplugged". * * Returns &struct platform_device pointer on success, or ERR_PTR() on error. */ static inline struct platform_device *platform_device_register_simple( const char *name, int id, const struct resource *res, unsigned int num) { return platform_device_register_resndata(NULL, name, id, res, num, NULL, 0); } /** * platform_device_register_data - add a platform-level device with platform-specific data * @parent: parent device for the device we're adding * @name: base name of the device we're adding * @id: instance id * @data: platform specific data for this platform device * @size: size of platform specific data * * This function creates a simple platform device that requires minimal * resource and memory management. Canned release function freeing memory * allocated for the device allows drivers using such devices to be * unloaded without waiting for the last reference to the device to be * dropped. * * Returns &struct platform_device pointer on success, or ERR_PTR() on error. */ static inline struct platform_device *platform_device_register_data( struct device *parent, const char *name, int id, const void *data, size_t size) { return platform_device_register_resndata(parent, name, id, NULL, 0, data, size); } |
bbbf508d6 [DRIVER MODEL] Ad... |
148 |
|
1359555eb Driver core: Make... |
149 |
extern struct platform_device *platform_device_alloc(const char *name, int id); |
0b7f1a7ef platform: Make pl... |
150 151 152 |
extern int platform_device_add_resources(struct platform_device *pdev, const struct resource *res, unsigned int num); |
6eefd34fd Driver core: Make... |
153 |
extern int platform_device_add_data(struct platform_device *pdev, const void *data, size_t size); |
37c12e749 [DRIVER MODEL] Im... |
154 |
extern int platform_device_add(struct platform_device *pdev); |
93ce3061b [PATCH] Driver Co... |
155 |
extern void platform_device_del(struct platform_device *pdev); |
37c12e749 [DRIVER MODEL] Im... |
156 |
extern void platform_device_put(struct platform_device *pdev); |
00d3dcdd9 [DRIVER MODEL] Ad... |
157 158 159 160 161 162 163 |
struct platform_driver { int (*probe)(struct platform_device *); int (*remove)(struct platform_device *); void (*shutdown)(struct platform_device *); int (*suspend)(struct platform_device *, pm_message_t state); int (*resume)(struct platform_device *); struct device_driver driver; |
831fad2f7 Driver core: make... |
164 |
const struct platform_device_id *id_table; |
00d3dcdd9 [DRIVER MODEL] Ad... |
165 166 167 168 |
}; extern int platform_driver_register(struct platform_driver *); extern void platform_driver_unregister(struct platform_driver *); |
c67334fbd Driver core: plat... |
169 170 171 172 173 |
/* non-hotpluggable platform devices may use this so that probe() and * its support may live in __init sections, conserving runtime memory. */ extern int platform_driver_probe(struct platform_driver *driver, int (*probe)(struct platform_device *)); |
71d642908 Driver core: conv... |
174 175 176 177 178 179 180 181 182 |
static inline void *platform_get_drvdata(const struct platform_device *pdev) { return dev_get_drvdata(&pdev->dev); } static inline void platform_set_drvdata(struct platform_device *pdev, void *data) { dev_set_drvdata(&pdev->dev, data); } |
00d3dcdd9 [DRIVER MODEL] Ad... |
183 |
|
940ab8896 drivercore: Add h... |
184 185 186 187 188 189 |
/* module_platform_driver() - Helper macro for drivers that don't do * anything special in module init/exit. This eliminates a lot of * boilerplate. Each module may only use this macro once, and * calling it replaces module_init() and module_exit() */ #define module_platform_driver(__platform_driver) \ |
907d0ed1c drivercore: Gener... |
190 191 |
module_driver(__platform_driver, platform_driver_register, \ platform_driver_unregister) |
940ab8896 drivercore: Add h... |
192 |
|
ecdf6ceb8 Driver core: add ... |
193 194 195 196 |
extern struct platform_device *platform_create_bundle(struct platform_driver *driver, int (*probe)(struct platform_device *), struct resource *res, unsigned int n_res, const void *data, size_t size); |
13977091a Driver Core: earl... |
197 198 199 200 201 202 |
/* early platform driver interface */ struct early_platform_driver { const char *class_str; struct platform_driver *pdrv; struct list_head list; int requested_id; |
c60e0504c Driver Core: Earl... |
203 204 |
char *buffer; int bufsize; |
13977091a Driver Core: earl... |
205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 |
}; #define EARLY_PLATFORM_ID_UNSET -2 #define EARLY_PLATFORM_ID_ERROR -3 extern int early_platform_driver_register(struct early_platform_driver *epdrv, char *buf); extern void early_platform_add_devices(struct platform_device **devs, int num); static inline int is_early_platform_device(struct platform_device *pdev) { return !pdev->dev.driver; } extern void early_platform_driver_register_all(char *class_str); extern int early_platform_driver_probe(char *class_str, int nr_probe, int user_only); extern void early_platform_cleanup(void); |
c60e0504c Driver Core: Earl... |
223 224 |
#define early_platform_init(class_string, platdrv) \ early_platform_init_buffer(class_string, platdrv, NULL, 0) |
13977091a Driver Core: earl... |
225 226 |
#ifndef MODULE |
c60e0504c Driver Core: Earl... |
227 |
#define early_platform_init_buffer(class_string, platdrv, buf, bufsiz) \ |
13977091a Driver Core: earl... |
228 229 |
static __initdata struct early_platform_driver early_driver = { \ .class_str = class_string, \ |
c60e0504c Driver Core: Earl... |
230 231 232 |
.buffer = buf, \ .bufsize = bufsiz, \ .pdrv = platdrv, \ |
13977091a Driver Core: earl... |
233 234 |
.requested_id = EARLY_PLATFORM_ID_UNSET, \ }; \ |
c60e0504c Driver Core: Earl... |
235 |
static int __init early_platform_driver_setup_func(char *buffer) \ |
13977091a Driver Core: earl... |
236 |
{ \ |
c60e0504c Driver Core: Earl... |
237 |
return early_platform_driver_register(&early_driver, buffer); \ |
13977091a Driver Core: earl... |
238 239 240 |
} \ early_param(class_string, early_platform_driver_setup_func) #else /* MODULE */ |
c60e0504c Driver Core: Earl... |
241 242 243 244 245 |
#define early_platform_init_buffer(class_string, platdrv, buf, bufsiz) \ static inline char *early_platform_driver_setup_func(void) \ { \ return bufsiz ? buf : NULL; \ } |
13977091a Driver Core: earl... |
246 |
#endif /* MODULE */ |
69c9dd1ec PM: Export platfo... |
247 248 |
#ifdef CONFIG_SUSPEND extern int platform_pm_suspend(struct device *dev); |
69c9dd1ec PM: Export platfo... |
249 |
extern int platform_pm_resume(struct device *dev); |
69c9dd1ec PM: Export platfo... |
250 251 252 |
#else #define platform_pm_suspend NULL #define platform_pm_resume NULL |
69c9dd1ec PM: Export platfo... |
253 254 255 256 |
#endif #ifdef CONFIG_HIBERNATE_CALLBACKS extern int platform_pm_freeze(struct device *dev); |
69c9dd1ec PM: Export platfo... |
257 |
extern int platform_pm_thaw(struct device *dev); |
69c9dd1ec PM: Export platfo... |
258 |
extern int platform_pm_poweroff(struct device *dev); |
69c9dd1ec PM: Export platfo... |
259 |
extern int platform_pm_restore(struct device *dev); |
69c9dd1ec PM: Export platfo... |
260 261 262 263 264 |
#else #define platform_pm_freeze NULL #define platform_pm_thaw NULL #define platform_pm_poweroff NULL #define platform_pm_restore NULL |
69c9dd1ec PM: Export platfo... |
265 266 267 268 |
#endif #ifdef CONFIG_PM_SLEEP #define USE_PLATFORM_PM_SLEEP_OPS \ |
69c9dd1ec PM: Export platfo... |
269 270 271 272 273 |
.suspend = platform_pm_suspend, \ .resume = platform_pm_resume, \ .freeze = platform_pm_freeze, \ .thaw = platform_pm_thaw, \ .poweroff = platform_pm_poweroff, \ |
9b39e73d0 PM / Sleep: Remov... |
274 |
.restore = platform_pm_restore, |
69c9dd1ec PM: Export platfo... |
275 276 277 |
#else #define USE_PLATFORM_PM_SLEEP_OPS #endif |
bbbf508d6 [DRIVER MODEL] Ad... |
278 |
#endif /* _PLATFORM_DEVICE_H_ */ |