Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
tjh.dev
kernel
os
linux
1/*
2 * platform_device.h - generic, centralized driver model
3 *
4 * Copyright (c) 2001-2003 Patrick Mochel <mochel@osdl.org>
5 *
6 * This file is released under the GPLv2
7 *
8 * See Documentation/driver-model/ for more information.
9 */
10
11#ifndef _PLATFORM_DEVICE_H_
12#define _PLATFORM_DEVICE_H_
13
14#include <linux/device.h>
15#include <linux/mod_devicetable.h>
16
17struct mfd_cell;
18
19struct platform_device {
20 const char * name;
21 int id;
22 struct device dev;
23 u32 num_resources;
24 struct resource * resource;
25
26 const struct platform_device_id *id_entry;
27
28 /* MFD cell pointer */
29 struct mfd_cell *mfd_cell;
30
31 /* arch specific additions */
32 struct pdev_archdata archdata;
33};
34
35#define platform_get_device_id(pdev) ((pdev)->id_entry)
36
37#define to_platform_device(x) container_of((x), struct platform_device, dev)
38
39extern int platform_device_register(struct platform_device *);
40extern void platform_device_unregister(struct platform_device *);
41
42extern struct bus_type platform_bus_type;
43extern struct device platform_bus;
44
45extern struct resource *platform_get_resource(struct platform_device *, unsigned int, unsigned int);
46extern int platform_get_irq(struct platform_device *, unsigned int);
47extern struct resource *platform_get_resource_byname(struct platform_device *, unsigned int, const char *);
48extern int platform_get_irq_byname(struct platform_device *, const char *);
49extern int platform_add_devices(struct platform_device **, int);
50
51extern struct platform_device *platform_device_register_resndata(
52 struct device *parent, const char *name, int id,
53 const struct resource *res, unsigned int num,
54 const void *data, size_t size);
55
56/**
57 * platform_device_register_simple - add a platform-level device and its resources
58 * @name: base name of the device we're adding
59 * @id: instance id
60 * @res: set of resources that needs to be allocated for the device
61 * @num: number of resources
62 *
63 * This function creates a simple platform device that requires minimal
64 * resource and memory management. Canned release function freeing memory
65 * allocated for the device allows drivers using such devices to be
66 * unloaded without waiting for the last reference to the device to be
67 * dropped.
68 *
69 * This interface is primarily intended for use with legacy drivers which
70 * probe hardware directly. Because such drivers create sysfs device nodes
71 * themselves, rather than letting system infrastructure handle such device
72 * enumeration tasks, they don't fully conform to the Linux driver model.
73 * In particular, when such drivers are built as modules, they can't be
74 * "hotplugged".
75 *
76 * Returns &struct platform_device pointer on success, or ERR_PTR() on error.
77 */
78static inline struct platform_device *platform_device_register_simple(
79 const char *name, int id,
80 const struct resource *res, unsigned int num)
81{
82 return platform_device_register_resndata(NULL, name, id,
83 res, num, NULL, 0);
84}
85
86/**
87 * platform_device_register_data - add a platform-level device with platform-specific data
88 * @parent: parent device for the device we're adding
89 * @name: base name of the device we're adding
90 * @id: instance id
91 * @data: platform specific data for this platform device
92 * @size: size of platform specific data
93 *
94 * This function creates a simple platform device that requires minimal
95 * resource and memory management. Canned release function freeing memory
96 * allocated for the device allows drivers using such devices to be
97 * unloaded without waiting for the last reference to the device to be
98 * dropped.
99 *
100 * Returns &struct platform_device pointer on success, or ERR_PTR() on error.
101 */
102static inline struct platform_device *platform_device_register_data(
103 struct device *parent, const char *name, int id,
104 const void *data, size_t size)
105{
106 return platform_device_register_resndata(parent, name, id,
107 NULL, 0, data, size);
108}
109
110extern struct platform_device *platform_device_alloc(const char *name, int id);
111extern int platform_device_add_resources(struct platform_device *pdev,
112 const struct resource *res,
113 unsigned int num);
114extern int platform_device_add_data(struct platform_device *pdev, const void *data, size_t size);
115extern int platform_device_add(struct platform_device *pdev);
116extern void platform_device_del(struct platform_device *pdev);
117extern void platform_device_put(struct platform_device *pdev);
118
119struct platform_driver {
120 int (*probe)(struct platform_device *);
121 int (*remove)(struct platform_device *);
122 void (*shutdown)(struct platform_device *);
123 int (*suspend)(struct platform_device *, pm_message_t state);
124 int (*resume)(struct platform_device *);
125 struct device_driver driver;
126 const struct platform_device_id *id_table;
127};
128
129extern int platform_driver_register(struct platform_driver *);
130extern void platform_driver_unregister(struct platform_driver *);
131
132/* non-hotpluggable platform devices may use this so that probe() and
133 * its support may live in __init sections, conserving runtime memory.
134 */
135extern int platform_driver_probe(struct platform_driver *driver,
136 int (*probe)(struct platform_device *));
137
138static inline void *platform_get_drvdata(const struct platform_device *pdev)
139{
140 return dev_get_drvdata(&pdev->dev);
141}
142
143static inline void platform_set_drvdata(struct platform_device *pdev, void *data)
144{
145 dev_set_drvdata(&pdev->dev, data);
146}
147
148extern struct platform_device *platform_create_bundle(struct platform_driver *driver,
149 int (*probe)(struct platform_device *),
150 struct resource *res, unsigned int n_res,
151 const void *data, size_t size);
152
153extern const struct dev_pm_ops * platform_bus_get_pm_ops(void);
154extern void platform_bus_set_pm_ops(const struct dev_pm_ops *pm);
155
156/* early platform driver interface */
157struct early_platform_driver {
158 const char *class_str;
159 struct platform_driver *pdrv;
160 struct list_head list;
161 int requested_id;
162 char *buffer;
163 int bufsize;
164};
165
166#define EARLY_PLATFORM_ID_UNSET -2
167#define EARLY_PLATFORM_ID_ERROR -3
168
169extern int early_platform_driver_register(struct early_platform_driver *epdrv,
170 char *buf);
171extern void early_platform_add_devices(struct platform_device **devs, int num);
172
173static inline int is_early_platform_device(struct platform_device *pdev)
174{
175 return !pdev->dev.driver;
176}
177
178extern void early_platform_driver_register_all(char *class_str);
179extern int early_platform_driver_probe(char *class_str,
180 int nr_probe, int user_only);
181extern void early_platform_cleanup(void);
182
183#define early_platform_init(class_string, platdrv) \
184 early_platform_init_buffer(class_string, platdrv, NULL, 0)
185
186#ifndef MODULE
187#define early_platform_init_buffer(class_string, platdrv, buf, bufsiz) \
188static __initdata struct early_platform_driver early_driver = { \
189 .class_str = class_string, \
190 .buffer = buf, \
191 .bufsize = bufsiz, \
192 .pdrv = platdrv, \
193 .requested_id = EARLY_PLATFORM_ID_UNSET, \
194}; \
195static int __init early_platform_driver_setup_func(char *buffer) \
196{ \
197 return early_platform_driver_register(&early_driver, buffer); \
198} \
199early_param(class_string, early_platform_driver_setup_func)
200#else /* MODULE */
201#define early_platform_init_buffer(class_string, platdrv, buf, bufsiz) \
202static inline char *early_platform_driver_setup_func(void) \
203{ \
204 return bufsiz ? buf : NULL; \
205}
206#endif /* MODULE */
207
208#endif /* _PLATFORM_DEVICE_H_ */