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; | |
2968ab13 LJ |
39 | /* |
40 | * Device Tree compatible string | |
41 | * See: Documentation/devicetree/usage-model.txt Chapter 2.2 for details | |
42 | */ | |
c94bb233 | 43 | const char *of_compatible; |
eb895607 | 44 | |
aa613de6 | 45 | /* |
2798e226 AS |
46 | * These resources can be specified relative to the parent device. |
47 | * For accessing hardware you should use resources from the platform dev | |
aa613de6 DB |
48 | */ |
49 | int num_resources; | |
50 | const struct resource *resources; | |
5f2545fa DD |
51 | |
52 | /* don't check for resource conflicts */ | |
53 | bool ignore_resource_conflicts; | |
4c90aa94 MB |
54 | |
55 | /* | |
56 | * Disable runtime PM callbacks for this subdevice - see | |
57 | * pm_runtime_no_callbacks(). | |
58 | */ | |
59 | bool pm_runtime_no_callbacks; | |
aa613de6 DB |
60 | }; |
61 | ||
1e29af62 AS |
62 | /* |
63 | * Convenience functions for clients using shared cells. Refcounting | |
64 | * happens automatically, with the cell's enable/disable callbacks | |
65 | * being called only when a device is first being enabled or no other | |
66 | * clients are making use of it. | |
67 | */ | |
f77289ac AS |
68 | extern int mfd_cell_enable(struct platform_device *pdev); |
69 | extern int mfd_cell_disable(struct platform_device *pdev); | |
1e29af62 | 70 | |
fa1df691 AS |
71 | /* |
72 | * "Clone" multiple platform devices for a single cell. This is to be used | |
73 | * for devices that have multiple users of a cell. For example, if an mfd | |
74 | * driver wants the cell "foo" to be used by a GPIO driver, an MTD driver, | |
75 | * and a platform driver, the following bit of code would be use after first | |
76 | * calling mfd_add_devices(): | |
77 | * | |
78 | * const char *fclones[] = { "foo-gpio", "foo-mtd" }; | |
79 | * err = mfd_clone_cells("foo", fclones, ARRAY_SIZE(fclones)); | |
80 | * | |
81 | * Each driver (MTD, GPIO, and platform driver) would then register | |
82 | * platform_drivers for "foo-mtd", "foo-gpio", and "foo", respectively. | |
83 | * The cell's .enable/.disable hooks should be used to deal with hardware | |
84 | * resource contention. | |
85 | */ | |
86 | extern int mfd_clone_cell(const char *cell, const char **clones, | |
87 | size_t n_clones); | |
88 | ||
fe891a00 AS |
89 | /* |
90 | * Given a platform device that's been created by mfd_add_devices(), fetch | |
91 | * the mfd_cell that created it. | |
92 | */ | |
93 | static inline const struct mfd_cell *mfd_get_cell(struct platform_device *pdev) | |
94 | { | |
e710d7d5 | 95 | return pdev->mfd_cell; |
fe891a00 AS |
96 | } |
97 | ||
424f525a | 98 | extern int mfd_add_devices(struct device *parent, int id, |
1e29af62 | 99 | struct mfd_cell *cells, int n_devs, |
7f71ac93 BD |
100 | struct resource *mem_base, |
101 | int irq_base); | |
aa613de6 | 102 | |
424f525a | 103 | extern void mfd_remove_devices(struct device *parent); |
aa613de6 DB |
104 | |
105 | #endif |