Blame view
include/linux/platform_device.h
12.1 KB
55716d264 treewide: Replace... |
1 |
/* SPDX-License-Identifier: GPL-2.0-only */ |
bbbf508d6 [DRIVER MODEL] Ad... |
2 3 4 5 6 |
/* * platform_device.h - generic, centralized driver model * * Copyright (c) 2001-2003 Patrick Mochel <mochel@osdl.org> * |
fe34c89d2 docs: driver-mode... |
7 |
* See Documentation/driver-api/driver-model/ for more information. |
bbbf508d6 [DRIVER MODEL] Ad... |
8 9 10 11 12 13 |
*/ #ifndef _PLATFORM_DEVICE_H_ #define _PLATFORM_DEVICE_H_ #include <linux/device.h> |
689ae231a platform: Add sup... |
14 15 |
#define PLATFORM_DEVID_NONE (-1) #define PLATFORM_DEVID_AUTO (-2) |
e710d7d5a mfd: Fetch cell p... |
16 |
struct mfd_cell; |
f4d052660 device property: ... |
17 |
struct property_entry; |
ac3167257 headers: separate... |
18 |
struct platform_device_id; |
e710d7d5a mfd: Fetch cell p... |
19 |
|
bbbf508d6 [DRIVER MODEL] Ad... |
20 |
struct platform_device { |
6ae07f27a driver core: plat... |
21 |
const char *name; |
1359555eb Driver core: Make... |
22 |
int id; |
689ae231a platform: Add sup... |
23 |
bool id_auto; |
bbbf508d6 [DRIVER MODEL] Ad... |
24 |
struct device dev; |
e3a36eb6d driver code: clar... |
25 |
u64 platform_dma_mask; |
9495b7e92 driver core: plat... |
26 |
struct device_dma_parameters dma_parms; |
bbbf508d6 [DRIVER MODEL] Ad... |
27 |
u32 num_resources; |
6ae07f27a driver core: plat... |
28 |
struct resource *resource; |
57fee4a58 platform: introdu... |
29 |
|
3d03ba4d1 driver core: make... |
30 |
const struct platform_device_id *id_entry; |
3d713e0e3 driver core: plat... |
31 |
char *driver_override; /* Driver name to force a match */ |
d7aacaddc Driver Core: Add ... |
32 |
|
e710d7d5a mfd: Fetch cell p... |
33 34 |
/* MFD cell pointer */ struct mfd_cell *mfd_cell; |
d7aacaddc Driver Core: Add ... |
35 36 |
/* arch specific additions */ struct pdev_archdata archdata; |
bbbf508d6 [DRIVER MODEL] Ad... |
37 |
}; |
57fee4a58 platform: introdu... |
38 |
#define platform_get_device_id(pdev) ((pdev)->id_entry) |
719cf71ca ACPI / glue: Spli... |
39 |
#define dev_is_platform(dev) ((dev)->bus == &platform_bus_type) |
bbbf508d6 [DRIVER MODEL] Ad... |
40 41 42 43 44 45 46 |
#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; |
6ae07f27a driver core: plat... |
47 48 |
extern struct resource *platform_get_resource(struct platform_device *, unsigned int, unsigned int); |
36f3313d6 platform: Add pla... |
49 50 51 |
extern struct device * platform_find_device_by_driver(struct device *start, const struct device_driver *drv); |
7945f929f drivers: provide ... |
52 |
extern void __iomem * |
890cc39a8 drivers: provide ... |
53 54 55 |
devm_platform_get_and_ioremap_resource(struct platform_device *pdev, unsigned int index, struct resource **res); extern void __iomem * |
7945f929f drivers: provide ... |
56 57 |
devm_platform_ioremap_resource(struct platform_device *pdev, unsigned int index); |
bb6243b4f drivers: platform... |
58 59 60 |
extern void __iomem * devm_platform_ioremap_resource_wc(struct platform_device *pdev, unsigned int index); |
c9c8641d3 drivers: provide ... |
61 62 63 |
extern void __iomem * devm_platform_ioremap_resource_byname(struct platform_device *pdev, const char *name); |
bbbf508d6 [DRIVER MODEL] Ad... |
64 |
extern int platform_get_irq(struct platform_device *, unsigned int); |
8973ea479 driver core: plat... |
65 |
extern int platform_get_irq_optional(struct platform_device *, unsigned int); |
4b83555d5 driver-core: plat... |
66 |
extern int platform_irq_count(struct platform_device *); |
6ae07f27a driver core: plat... |
67 68 69 |
extern struct resource *platform_get_resource_byname(struct platform_device *, unsigned int, const char *); |
c0afe7ba5 driver core: Cons... |
70 |
extern int platform_get_irq_byname(struct platform_device *, const char *); |
f1da567f1 driver core: plat... |
71 72 |
extern int platform_get_irq_byname_optional(struct platform_device *dev, const char *name); |
bbbf508d6 [DRIVER MODEL] Ad... |
73 |
extern int platform_add_devices(struct platform_device **, int); |
01dcc60a7 new helper to cre... |
74 75 |
struct platform_device_info { struct device *parent; |
ce793486e driver core / ACP... |
76 |
struct fwnode_handle *fwnode; |
2c1ea6abd platform: set of_... |
77 |
bool of_node_reused; |
01dcc60a7 new helper to cre... |
78 79 80 81 82 83 84 85 86 87 |
const char *name; int id; const struct resource *res; unsigned int num_res; const void *data; size_t size_data; u64 dma_mask; |
00bbc1d8e driver core: plat... |
88 |
|
469e1906a platform: constif... |
89 |
const struct property_entry *properties; |
01dcc60a7 new helper to cre... |
90 91 |
}; extern struct platform_device *platform_device_register_full( |
5a3072be6 drivers_base: mak... |
92 |
const struct platform_device_info *pdevinfo); |
01dcc60a7 new helper to cre... |
93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 |
/** * 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... |
109 110 |
struct device *parent, const char *name, int id, const struct resource *res, unsigned int num, |
01dcc60a7 new helper to cre... |
111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 |
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... |
126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 |
/** * 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... |
180 |
|
1359555eb Driver core: Make... |
181 |
extern struct platform_device *platform_device_alloc(const char *name, int id); |
0b7f1a7ef platform: Make pl... |
182 183 184 |
extern int platform_device_add_resources(struct platform_device *pdev, const struct resource *res, unsigned int num); |
6ae07f27a driver core: plat... |
185 186 |
extern int platform_device_add_data(struct platform_device *pdev, const void *data, size_t size); |
00bbc1d8e driver core: plat... |
187 |
extern int platform_device_add_properties(struct platform_device *pdev, |
277036f05 platform: Accept ... |
188 |
const struct property_entry *properties); |
37c12e749 [DRIVER MODEL] Im... |
189 |
extern int platform_device_add(struct platform_device *pdev); |
93ce3061b [PATCH] Driver Co... |
190 |
extern void platform_device_del(struct platform_device *pdev); |
37c12e749 [DRIVER MODEL] Im... |
191 |
extern void platform_device_put(struct platform_device *pdev); |
00d3dcdd9 [DRIVER MODEL] Ad... |
192 193 194 195 196 197 198 |
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... |
199 |
const struct platform_device_id *id_table; |
3f9120b04 driver core: prev... |
200 |
bool prevent_deferred_probe; |
00d3dcdd9 [DRIVER MODEL] Ad... |
201 |
}; |
10dbc5e39 driver core: move... |
202 203 |
#define to_platform_driver(drv) (container_of((drv), struct platform_driver, \ driver)) |
9447057ea platform_device: ... |
204 205 206 207 208 209 210 |
/* * use a macro to avoid include chaining to get THIS_MODULE */ #define platform_driver_register(drv) \ __platform_driver_register(drv, THIS_MODULE) extern int __platform_driver_register(struct platform_driver *, struct module *); |
00d3dcdd9 [DRIVER MODEL] Ad... |
211 |
extern void platform_driver_unregister(struct platform_driver *); |
c67334fbd Driver core: plat... |
212 213 214 |
/* non-hotpluggable platform devices may use this so that probe() and * its support may live in __init sections, conserving runtime memory. */ |
c3b50dc21 core: platform: l... |
215 216 217 218 |
#define platform_driver_probe(drv, probe) \ __platform_driver_probe(drv, probe, THIS_MODULE) extern int __platform_driver_probe(struct platform_driver *driver, int (*probe)(struct platform_device *), struct module *module); |
c67334fbd Driver core: plat... |
219 |
|
71d642908 Driver core: conv... |
220 221 222 223 |
static inline void *platform_get_drvdata(const struct platform_device *pdev) { return dev_get_drvdata(&pdev->dev); } |
6ae07f27a driver core: plat... |
224 225 |
static inline void platform_set_drvdata(struct platform_device *pdev, void *data) |
71d642908 Driver core: conv... |
226 227 228 |
{ dev_set_drvdata(&pdev->dev, data); } |
00d3dcdd9 [DRIVER MODEL] Ad... |
229 |
|
940ab8896 drivercore: Add h... |
230 231 232 233 234 235 |
/* 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... |
236 237 |
module_driver(__platform_driver, platform_driver_register, \ platform_driver_unregister) |
940ab8896 drivercore: Add h... |
238 |
|
f309d4443 platform_device: ... |
239 240 241 242 243 244 245 246 |
/* builtin_platform_driver() - Helper macro for builtin drivers that * don't do anything special in driver init. This eliminates some * boilerplate. Each driver may only use this macro once, and * calling it replaces device_initcall(). Note this is meant to be * a parallel of module_platform_driver() above, but w/o _exit stuff. */ #define builtin_platform_driver(__platform_driver) \ builtin_driver(__platform_driver, platform_driver_register) |
bab734fcd driver core: add ... |
247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 |
/* module_platform_driver_probe() - 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_probe(__platform_driver, __platform_probe) \ static int __init __platform_driver##_init(void) \ { \ return platform_driver_probe(&(__platform_driver), \ __platform_probe); \ } \ module_init(__platform_driver##_init); \ static void __exit __platform_driver##_exit(void) \ { \ platform_driver_unregister(&(__platform_driver)); \ } \ module_exit(__platform_driver##_exit); |
f309d4443 platform_device: ... |
264 265 266 267 268 269 270 271 272 273 274 275 276 |
/* builtin_platform_driver_probe() - Helper macro for drivers that don't do * anything special in device init. This eliminates some boilerplate. Each * driver may only use this macro once, and using it replaces device_initcall. * This is meant to be a parallel of module_platform_driver_probe above, but * without the __exit parts. */ #define builtin_platform_driver_probe(__platform_driver, __platform_probe) \ static int __init __platform_driver##_init(void) \ { \ return platform_driver_probe(&(__platform_driver), \ __platform_probe); \ } \ device_initcall(__platform_driver##_init); \ |
291f653a1 core: platform: l... |
277 278 279 |
#define platform_create_bundle(driver, probe, res, n_res, data, size) \ __platform_create_bundle(driver, probe, res, n_res, data, size, THIS_MODULE) extern struct platform_device *__platform_create_bundle( |
6ae07f27a driver core: plat... |
280 281 |
struct platform_driver *driver, int (*probe)(struct platform_device *), struct resource *res, unsigned int n_res, |
291f653a1 core: platform: l... |
282 |
const void *data, size_t size, struct module *module); |
ecdf6ceb8 Driver core: add ... |
283 |
|
dbe2256dd driver-core: plat... |
284 285 286 287 288 289 290 |
int __platform_register_drivers(struct platform_driver * const *drivers, unsigned int count, struct module *owner); void platform_unregister_drivers(struct platform_driver * const *drivers, unsigned int count); #define platform_register_drivers(drivers, count) \ __platform_register_drivers(drivers, count, THIS_MODULE) |
69c9dd1ec PM: Export platfo... |
291 292 |
#ifdef CONFIG_SUSPEND extern int platform_pm_suspend(struct device *dev); |
69c9dd1ec PM: Export platfo... |
293 |
extern int platform_pm_resume(struct device *dev); |
69c9dd1ec PM: Export platfo... |
294 295 296 |
#else #define platform_pm_suspend NULL #define platform_pm_resume NULL |
69c9dd1ec PM: Export platfo... |
297 298 299 300 |
#endif #ifdef CONFIG_HIBERNATE_CALLBACKS extern int platform_pm_freeze(struct device *dev); |
69c9dd1ec PM: Export platfo... |
301 |
extern int platform_pm_thaw(struct device *dev); |
69c9dd1ec PM: Export platfo... |
302 |
extern int platform_pm_poweroff(struct device *dev); |
69c9dd1ec PM: Export platfo... |
303 |
extern int platform_pm_restore(struct device *dev); |
69c9dd1ec PM: Export platfo... |
304 305 306 307 308 |
#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... |
309 |
#endif |
07397df29 dma-mapping: move... |
310 |
extern int platform_dma_configure(struct device *dev); |
69c9dd1ec PM: Export platfo... |
311 312 |
#ifdef CONFIG_PM_SLEEP #define USE_PLATFORM_PM_SLEEP_OPS \ |
69c9dd1ec PM: Export platfo... |
313 314 315 316 317 |
.suspend = platform_pm_suspend, \ .resume = platform_pm_resume, \ .freeze = platform_pm_freeze, \ .thaw = platform_pm_thaw, \ .poweroff = platform_pm_poweroff, \ |
9b39e73d0 PM / Sleep: Remov... |
318 |
.restore = platform_pm_restore, |
69c9dd1ec PM: Export platfo... |
319 320 321 |
#else #define USE_PLATFORM_PM_SLEEP_OPS #endif |
507fd01d5 drivers: move the... |
322 323 324 325 326 327 |
#ifndef CONFIG_SUPERH /* * REVISIT: This stub is needed for all non-SuperH users of early platform * drivers. It should go away once we introduce the new platform_device-based * early driver framework. */ |
201e91091 sh: add the sh_ p... |
328 |
static inline int is_sh_early_platform_device(struct platform_device *pdev) |
507fd01d5 drivers: move the... |
329 330 331 332 |
{ return 0; } #endif /* CONFIG_SUPERH */ |
bbbf508d6 [DRIVER MODEL] Ad... |
333 |
#endif /* _PLATFORM_DEVICE_H_ */ |