[mirror_ubuntu-artful-kernel.git] / include / linux / platform_device.h

/*
 * 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>
#include <linux/mod_devicetable.h>

struct mfd_cell;

struct platform_device {
	const char	* name;
	int		id;
	struct device	dev;
	u32		num_resources;
	struct resource	* resource;

	const struct platform_device_id	*id_entry;

	/* MFD cell pointer */
	struct mfd_cell *mfd_cell;

	/* arch specific additions */
	struct pdev_archdata	archdata;
};

#define platform_get_device_id(pdev)	((pdev)->id_entry)

#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;

extern struct resource *platform_get_resource(struct platform_device *, unsigned int, unsigned int);
extern int platform_get_irq(struct platform_device *, unsigned int);
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 *);
extern int platform_add_devices(struct platform_device **, int);

extern struct platform_device *platform_device_register_resndata(
		struct device *parent, const char *name, int id,
		const struct resource *res, unsigned int num,
		const void *data, size_t size);

/**
 * 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);
}

extern struct platform_device *platform_device_alloc(const char *name, int id);
extern int platform_device_add_resources(struct platform_device *pdev,
					 const struct resource *res,
					 unsigned int num);
extern int platform_device_add_data(struct platform_device *pdev, const void *data, size_t size);
extern int platform_device_add(struct platform_device *pdev);
extern void platform_device_del(struct platform_device *pdev);
extern void platform_device_put(struct platform_device *pdev);

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;
	const struct platform_device_id *id_table;
};

extern int platform_driver_register(struct platform_driver *);
extern void platform_driver_unregister(struct platform_driver *);

/* 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 *));

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);
}

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);

/* early platform driver interface */
struct early_platform_driver {
	const char *class_str;
	struct platform_driver *pdrv;
	struct list_head list;
	int requested_id;
	char *buffer;
	int bufsize;
};

#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);

#define early_platform_init(class_string, platdrv)		\
	early_platform_init_buffer(class_string, platdrv, NULL, 0)

#ifndef MODULE
#define early_platform_init_buffer(class_string, platdrv, buf, bufsiz)	\
static __initdata struct early_platform_driver early_driver = {		\
	.class_str = class_string,					\
	.buffer = buf,							\
	.bufsize = bufsiz,						\
	.pdrv = platdrv,						\
	.requested_id = EARLY_PLATFORM_ID_UNSET,			\
};									\
static int __init early_platform_driver_setup_func(char *buffer)	\
{									\
	return early_platform_driver_register(&early_driver, buffer);	\
}									\
early_param(class_string, early_platform_driver_setup_func)
#else /* MODULE */
#define early_platform_init_buffer(class_string, platdrv, buf, bufsiz)	\
static inline char *early_platform_driver_setup_func(void)		\
{									\
	return bufsiz ? buf : NULL;					\
}
#endif /* MODULE */

#ifdef CONFIG_PM_SLEEP
extern int platform_pm_prepare(struct device *dev);
extern void platform_pm_complete(struct device *dev);
#else
#define platform_pm_prepare	NULL
#define platform_pm_complete	NULL
#endif

#ifdef CONFIG_SUSPEND
extern int platform_pm_suspend(struct device *dev);
extern int platform_pm_suspend_noirq(struct device *dev);
extern int platform_pm_resume(struct device *dev);
extern int platform_pm_resume_noirq(struct device *dev);
#else
#define platform_pm_suspend		NULL
#define platform_pm_resume		NULL
#define platform_pm_suspend_noirq	NULL
#define platform_pm_resume_noirq	NULL
#endif

#ifdef CONFIG_HIBERNATE_CALLBACKS
extern int platform_pm_freeze(struct device *dev);
extern int platform_pm_freeze_noirq(struct device *dev);
extern int platform_pm_thaw(struct device *dev);
extern int platform_pm_thaw_noirq(struct device *dev);
extern int platform_pm_poweroff(struct device *dev);
extern int platform_pm_poweroff_noirq(struct device *dev);
extern int platform_pm_restore(struct device *dev);
extern int platform_pm_restore_noirq(struct device *dev);
#else
#define platform_pm_freeze		NULL
#define platform_pm_thaw		NULL
#define platform_pm_poweroff		NULL
#define platform_pm_restore		NULL
#define platform_pm_freeze_noirq	NULL
#define platform_pm_thaw_noirq		NULL
#define platform_pm_poweroff_noirq	NULL
#define platform_pm_restore_noirq	NULL
#endif

#ifdef CONFIG_PM_SLEEP
#define USE_PLATFORM_PM_SLEEP_OPS \
	.prepare = platform_pm_prepare, \
	.complete = platform_pm_complete, \
	.suspend = platform_pm_suspend, \
	.resume = platform_pm_resume, \
	.freeze = platform_pm_freeze, \
	.thaw = platform_pm_thaw, \
	.poweroff = platform_pm_poweroff, \
	.restore = platform_pm_restore, \
	.suspend_noirq = platform_pm_suspend_noirq, \
	.resume_noirq = platform_pm_resume_noirq, \
	.freeze_noirq = platform_pm_freeze_noirq, \
	.thaw_noirq = platform_pm_thaw_noirq, \
	.poweroff_noirq = platform_pm_poweroff_noirq, \
	.restore_noirq = platform_pm_restore_noirq,
#else
#define USE_PLATFORM_PM_SLEEP_OPS
#endif

#endif /* _PLATFORM_DEVICE_H_ */
Commit	Line	Data
bbbf508d RK	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>
57fee4a5	15	#include <linux/mod_devicetable.h>
bbbf508d	16
e710d7d5 SO	17	struct mfd_cell;
e710d7d5 SO	18
bbbf508d RK	19	struct platform_device {
bbbf508d RK	20	const char * name;
1359555e	21	int id;
bbbf508d RK	22	struct device dev;
	23	u32 num_resources;
	24	struct resource * resource;
57fee4a5	25
3d03ba4d	26	const struct platform_device_id *id_entry;
d7aacadd	27
e710d7d5 SO	28	/* MFD cell pointer */
	29	struct mfd_cell *mfd_cell;
	30
d7aacadd MD	31	/* arch specific additions */
d7aacadd MD	32	struct pdev_archdata archdata;
bbbf508d RK	33	};
bbbf508d RK	34
57fee4a5 EM	35	#define platform_get_device_id(pdev) ((pdev)->id_entry)
57fee4a5 EM	36
bbbf508d RK	37	#define to_platform_device(x) container_of((x), struct platform_device, dev)
	38
	39	extern int platform_device_register(struct platform_device *);
	40	extern void platform_device_unregister(struct platform_device *);
	41
	42	extern struct bus_type platform_bus_type;
	43	extern struct device platform_bus;
	44
	45	extern struct resource platform_get_resource(struct platform_device , unsigned int, unsigned int);
	46	extern int platform_get_irq(struct platform_device *, unsigned int);
c0afe7ba LW	47	extern struct resource platform_get_resource_byname(struct platform_device , unsigned int, const char *);
c0afe7ba LW	48	extern int platform_get_irq_byname(struct platform_device , const char );
bbbf508d RK	49	extern int platform_add_devices(struct platform_device **, int);
bbbf508d RK	50
44f28bde UKK	51	extern 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	*/
	78	static 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	*/
	102	static 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	}
bbbf508d	109
1359555e	110	extern struct platform_device platform_device_alloc(const char name, int id);
0b7f1a7e GU	111	extern int platform_device_add_resources(struct platform_device *pdev,
	112	const struct resource *res,
	113	unsigned int num);
6eefd34f	114	extern int platform_device_add_data(struct platform_device pdev, const void data, size_t size);
37c12e74	115	extern int platform_device_add(struct platform_device *pdev);
93ce3061	116	extern void platform_device_del(struct platform_device *pdev);
37c12e74 RK	117	extern void platform_device_put(struct platform_device *pdev);
37c12e74 RK	118
00d3dcdd RK	119	struct 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;
831fad2f	126	const struct platform_device_id *id_table;
00d3dcdd RK	127	};
	128
	129	extern int platform_driver_register(struct platform_driver *);
	130	extern void platform_driver_unregister(struct platform_driver *);
	131
c67334fb DB	132	/* non-hotpluggable platform devices may use this so that probe() and
	133	* its support may live in __init sections, conserving runtime memory.
	134	*/
	135	extern int platform_driver_probe(struct platform_driver *driver,
	136	int (probe)(struct platform_device ));
	137
71d64290 MKB	138	static inline void platform_get_drvdata(const struct platform_device pdev)
	139	{
	140	return dev_get_drvdata(&pdev->dev);
	141	}
	142
	143	static inline void platform_set_drvdata(struct platform_device pdev, void data)
	144	{
	145	dev_set_drvdata(&pdev->dev, data);
	146	}
00d3dcdd	147
ecdf6ceb DT	148	extern 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
13977091 MD	153	/* early platform driver interface */
	154	struct early_platform_driver {
	155	const char *class_str;
	156	struct platform_driver *pdrv;
	157	struct list_head list;
	158	int requested_id;
c60e0504 MD	159	char *buffer;
c60e0504 MD	160	int bufsize;
13977091 MD	161	};
	162
	163	#define EARLY_PLATFORM_ID_UNSET -2
	164	#define EARLY_PLATFORM_ID_ERROR -3
	165
	166	extern int early_platform_driver_register(struct early_platform_driver *epdrv,
	167	char *buf);
	168	extern void early_platform_add_devices(struct platform_device **devs, int num);
	169
	170	static inline int is_early_platform_device(struct platform_device *pdev)
	171	{
	172	return !pdev->dev.driver;
	173	}
	174
	175	extern void early_platform_driver_register_all(char *class_str);
	176	extern int early_platform_driver_probe(char *class_str,
	177	int nr_probe, int user_only);
	178	extern void early_platform_cleanup(void);
	179
c60e0504 MD	180	#define early_platform_init(class_string, platdrv) \
c60e0504 MD	181	early_platform_init_buffer(class_string, platdrv, NULL, 0)
13977091 MD	182
13977091 MD	183	#ifndef MODULE
c60e0504	184	#define early_platform_init_buffer(class_string, platdrv, buf, bufsiz) \
13977091 MD	185	static __initdata struct early_platform_driver early_driver = { \
13977091 MD	186	.class_str = class_string, \
c60e0504 MD	187	.buffer = buf, \
	188	.bufsize = bufsiz, \
	189	.pdrv = platdrv, \
13977091 MD	190	.requested_id = EARLY_PLATFORM_ID_UNSET, \
13977091 MD	191	}; \
c60e0504	192	static int __init early_platform_driver_setup_func(char *buffer) \
13977091	193	{ \
c60e0504	194	return early_platform_driver_register(&early_driver, buffer); \
13977091 MD	195	} \
	196	early_param(class_string, early_platform_driver_setup_func)
	197	#else /* MODULE */
c60e0504 MD	198	#define early_platform_init_buffer(class_string, platdrv, buf, bufsiz) \
	199	static inline char *early_platform_driver_setup_func(void) \
	200	{ \
	201	return bufsiz ? buf : NULL; \
	202	}
13977091 MD	203	#endif /* MODULE */
13977091 MD	204
69c9dd1e RW	205	#ifdef CONFIG_PM_SLEEP
	206	extern int platform_pm_prepare(struct device *dev);
	207	extern void platform_pm_complete(struct device *dev);
	208	#else
	209	#define platform_pm_prepare NULL
	210	#define platform_pm_complete NULL
	211	#endif
	212
	213	#ifdef CONFIG_SUSPEND
	214	extern int platform_pm_suspend(struct device *dev);
	215	extern int platform_pm_suspend_noirq(struct device *dev);
	216	extern int platform_pm_resume(struct device *dev);
	217	extern int platform_pm_resume_noirq(struct device *dev);
	218	#else
	219	#define platform_pm_suspend NULL
	220	#define platform_pm_resume NULL
	221	#define platform_pm_suspend_noirq NULL
	222	#define platform_pm_resume_noirq NULL
	223	#endif
	224
	225	#ifdef CONFIG_HIBERNATE_CALLBACKS
	226	extern int platform_pm_freeze(struct device *dev);
	227	extern int platform_pm_freeze_noirq(struct device *dev);
	228	extern int platform_pm_thaw(struct device *dev);
	229	extern int platform_pm_thaw_noirq(struct device *dev);
	230	extern int platform_pm_poweroff(struct device *dev);
	231	extern int platform_pm_poweroff_noirq(struct device *dev);
	232	extern int platform_pm_restore(struct device *dev);
	233	extern int platform_pm_restore_noirq(struct device *dev);
	234	#else
	235	#define platform_pm_freeze NULL
	236	#define platform_pm_thaw NULL
	237	#define platform_pm_poweroff NULL
	238	#define platform_pm_restore NULL
	239	#define platform_pm_freeze_noirq NULL
	240	#define platform_pm_thaw_noirq NULL
	241	#define platform_pm_poweroff_noirq NULL
	242	#define platform_pm_restore_noirq NULL
	243	#endif
	244
	245	#ifdef CONFIG_PM_SLEEP
	246	#define USE_PLATFORM_PM_SLEEP_OPS \
	247	.prepare = platform_pm_prepare, \
	248	.complete = platform_pm_complete, \
	249	.suspend = platform_pm_suspend, \
	250	.resume = platform_pm_resume, \
	251	.freeze = platform_pm_freeze, \
	252	.thaw = platform_pm_thaw, \
	253	.poweroff = platform_pm_poweroff, \
	254	.restore = platform_pm_restore, \
	255	.suspend_noirq = platform_pm_suspend_noirq, \
	256	.resume_noirq = platform_pm_resume_noirq, \
	257	.freeze_noirq = platform_pm_freeze_noirq, \
	258	.thaw_noirq = platform_pm_thaw_noirq, \
	259	.poweroff_noirq = platform_pm_poweroff_noirq, \
	260	.restore_noirq = platform_pm_restore_noirq,
	261	#else
	262	#define USE_PLATFORM_PM_SLEEP_OPS
	263	#endif
	264
bbbf508d	265	#endif /* _PLATFORM_DEVICE_H_ */