Commit | Line | Data |
---|---|---|
aa613de6 DB |
1 | /* |
2 | * drivers/mfd/mfd-core.h | |
3 | * | |
4 | * core MFD support | |
5 | * Copyright (c) 2006 Ian Molton | |
6 | * Copyright (c) 2007 Dmitry Baryshkov | |
7 | * | |
8 | * This program is free software; you can redistribute it and/or modify | |
9 | * it under the terms of the GNU General Public License version 2 as | |
10 | * published by the Free Software Foundation. | |
11 | * | |
12 | */ | |
13 | ||
7f71ac93 BD |
14 | #ifndef MFD_CORE_H |
15 | #define MFD_CORE_H | |
16 | ||
aa613de6 DB |
17 | #include <linux/platform_device.h> |
18 | ||
19 | /* | |
20 | * This struct describes the MFD part ("cell"). | |
21 | * After registration the copy of this structure will become the platform data | |
22 | * of the resulting platform_device | |
23 | */ | |
24 | struct mfd_cell { | |
25 | const char *name; | |
3bed6e41 | 26 | int id; |
aa613de6 | 27 | |
1e29af62 AS |
28 | /* refcounting for multiple drivers to use a single cell */ |
29 | atomic_t *usage_count; | |
aa613de6 DB |
30 | int (*enable)(struct platform_device *dev); |
31 | int (*disable)(struct platform_device *dev); | |
1e29af62 | 32 | |
aa613de6 DB |
33 | int (*suspend)(struct platform_device *dev); |
34 | int (*resume)(struct platform_device *dev); | |
35 | ||
eb895607 SO |
36 | /* platform data passed to the sub devices drivers */ |
37 | void *platform_data; | |
38 | size_t pdata_size; | |
c94bb233 | 39 | const char *of_compatible; |
eb895607 | 40 | |
aa613de6 | 41 | /* |
2798e226 AS |
42 | * These resources can be specified relative to the parent device. |
43 | * For accessing hardware you should use resources from the platform dev | |
aa613de6 DB |
44 | */ |
45 | int num_resources; | |
46 | const struct resource *resources; | |
5f2545fa DD |
47 | |
48 | /* don't check for resource conflicts */ | |
49 | bool ignore_resource_conflicts; | |
4c90aa94 MB |
50 | |
51 | /* | |
52 | * Disable runtime PM callbacks for this subdevice - see | |
53 | * pm_runtime_no_callbacks(). | |
54 | */ | |
55 | bool pm_runtime_no_callbacks; | |
aa613de6 DB |
56 | }; |
57 | ||
1e29af62 AS |
58 | /* |
59 | * Convenience functions for clients using shared cells. Refcounting | |
60 | * happens automatically, with the cell's enable/disable callbacks | |
61 | * being called only when a device is first being enabled or no other | |
62 | * clients are making use of it. | |
63 | */ | |
f77289ac AS |
64 | extern int mfd_cell_enable(struct platform_device *pdev); |
65 | extern int mfd_cell_disable(struct platform_device *pdev); | |
1e29af62 | 66 | |
fa1df691 AS |
67 | /* |
68 | * "Clone" multiple platform devices for a single cell. This is to be used | |
69 | * for devices that have multiple users of a cell. For example, if an mfd | |
70 | * driver wants the cell "foo" to be used by a GPIO driver, an MTD driver, | |
71 | * and a platform driver, the following bit of code would be use after first | |
72 | * calling mfd_add_devices(): | |
73 | * | |
74 | * const char *fclones[] = { "foo-gpio", "foo-mtd" }; | |
75 | * err = mfd_clone_cells("foo", fclones, ARRAY_SIZE(fclones)); | |
76 | * | |
77 | * Each driver (MTD, GPIO, and platform driver) would then register | |
78 | * platform_drivers for "foo-mtd", "foo-gpio", and "foo", respectively. | |
79 | * The cell's .enable/.disable hooks should be used to deal with hardware | |
80 | * resource contention. | |
81 | */ | |
82 | extern int mfd_clone_cell(const char *cell, const char **clones, | |
83 | size_t n_clones); | |
84 | ||
fe891a00 AS |
85 | /* |
86 | * Given a platform device that's been created by mfd_add_devices(), fetch | |
87 | * the mfd_cell that created it. | |
88 | */ | |
89 | static inline const struct mfd_cell *mfd_get_cell(struct platform_device *pdev) | |
90 | { | |
e710d7d5 | 91 | return pdev->mfd_cell; |
fe891a00 AS |
92 | } |
93 | ||
424f525a | 94 | extern int mfd_add_devices(struct device *parent, int id, |
1e29af62 | 95 | struct mfd_cell *cells, int n_devs, |
7f71ac93 BD |
96 | struct resource *mem_base, |
97 | int irq_base); | |
aa613de6 | 98 | |
424f525a | 99 | extern void mfd_remove_devices(struct device *parent); |
aa613de6 DB |
100 | |
101 | #endif |