[net-next-2.6.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 platform_device {
	const char	* name;
	int		id;
	struct device	dev;
	u32		num_resources;
	struct resource	* resource;

	const struct platform_device_id	*id_entry;

	/* 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_simple(const char *, int id,
					struct resource *, unsigned int);
extern struct platform_device *platform_device_register_data(struct device *,
		const char *, int, const void *, size_t);

extern struct platform_device *platform_device_alloc(const char *name, int id);
extern int platform_device_add_resources(struct platform_device *pdev, 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;
	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 *));

#define platform_get_drvdata(_dev)	dev_get_drvdata(&(_dev)->dev)
#define platform_set_drvdata(_dev,data)	dev_set_drvdata(&(_dev)->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 */

#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 RK	16
	17	struct platform_device {
	18	const char * name;
1359555e	19	int id;
bbbf508d RK	20	struct device dev;
	21	u32 num_resources;
	22	struct resource * resource;
57fee4a5	23
3d03ba4d	24	const struct platform_device_id *id_entry;
d7aacadd MD	25
	26	/* arch specific additions */
	27	struct pdev_archdata archdata;
bbbf508d RK	28	};
bbbf508d RK	29
57fee4a5 EM	30	#define platform_get_device_id(pdev) ((pdev)->id_entry)
57fee4a5 EM	31
bbbf508d RK	32	#define to_platform_device(x) container_of((x), struct platform_device, dev)
	33
	34	extern int platform_device_register(struct platform_device *);
	35	extern void platform_device_unregister(struct platform_device *);
	36
	37	extern struct bus_type platform_bus_type;
	38	extern struct device platform_bus;
	39
	40	extern struct resource platform_get_resource(struct platform_device , unsigned int, unsigned int);
	41	extern int platform_get_irq(struct platform_device *, unsigned int);
c0afe7ba LW	42	extern struct resource platform_get_resource_byname(struct platform_device , unsigned int, const char *);
c0afe7ba LW	43	extern int platform_get_irq_byname(struct platform_device , const char );
bbbf508d RK	44	extern int platform_add_devices(struct platform_device **, int);
bbbf508d RK	45
ae72cddb	46	extern struct platform_device platform_device_register_simple(const char , int id,
1359555e	47	struct resource *, unsigned int);
d8bf2540 DES	48	extern struct platform_device platform_device_register_data(struct device ,
d8bf2540 DES	49	const char , int, const void , size_t);
bbbf508d	50
1359555e	51	extern struct platform_device platform_device_alloc(const char name, int id);
37c12e74	52	extern int platform_device_add_resources(struct platform_device pdev, struct resource res, unsigned int num);
6eefd34f	53	extern int platform_device_add_data(struct platform_device pdev, const void data, size_t size);
37c12e74	54	extern int platform_device_add(struct platform_device *pdev);
93ce3061	55	extern void platform_device_del(struct platform_device *pdev);
37c12e74 RK	56	extern void platform_device_put(struct platform_device *pdev);
37c12e74 RK	57
00d3dcdd RK	58	struct platform_driver {
	59	int (probe)(struct platform_device );
	60	int (remove)(struct platform_device );
	61	void (shutdown)(struct platform_device );
	62	int (suspend)(struct platform_device , pm_message_t state);
	63	int (resume)(struct platform_device );
	64	struct device_driver driver;
57fee4a5	65	struct platform_device_id *id_table;
00d3dcdd RK	66	};
	67
	68	extern int platform_driver_register(struct platform_driver *);
	69	extern void platform_driver_unregister(struct platform_driver *);
	70
c67334fb DB	71	/* non-hotpluggable platform devices may use this so that probe() and
	72	* its support may live in __init sections, conserving runtime memory.
	73	*/
	74	extern int platform_driver_probe(struct platform_driver *driver,
	75	int (probe)(struct platform_device ));
	76
00d3dcdd RK	77	#define platform_get_drvdata(_dev) dev_get_drvdata(&(_dev)->dev)
	78	#define platform_set_drvdata(_dev,data) dev_set_drvdata(&(_dev)->dev, (data))
	79
ecdf6ceb DT	80	extern struct platform_device platform_create_bundle(struct platform_driver driver,
	81	int (probe)(struct platform_device ),
	82	struct resource *res, unsigned int n_res,
	83	const void *data, size_t size);
	84
13977091 MD	85	/* early platform driver interface */
	86	struct early_platform_driver {
	87	const char *class_str;
	88	struct platform_driver *pdrv;
	89	struct list_head list;
	90	int requested_id;
c60e0504 MD	91	char *buffer;
c60e0504 MD	92	int bufsize;
13977091 MD	93	};
	94
	95	#define EARLY_PLATFORM_ID_UNSET -2
	96	#define EARLY_PLATFORM_ID_ERROR -3
	97
	98	extern int early_platform_driver_register(struct early_platform_driver *epdrv,
	99	char *buf);
	100	extern void early_platform_add_devices(struct platform_device **devs, int num);
	101
	102	static inline int is_early_platform_device(struct platform_device *pdev)
	103	{
	104	return !pdev->dev.driver;
	105	}
	106
	107	extern void early_platform_driver_register_all(char *class_str);
	108	extern int early_platform_driver_probe(char *class_str,
	109	int nr_probe, int user_only);
	110	extern void early_platform_cleanup(void);
	111
c60e0504 MD	112	#define early_platform_init(class_string, platdrv) \
c60e0504 MD	113	early_platform_init_buffer(class_string, platdrv, NULL, 0)
13977091 MD	114
13977091 MD	115	#ifndef MODULE
c60e0504	116	#define early_platform_init_buffer(class_string, platdrv, buf, bufsiz) \
13977091 MD	117	static __initdata struct early_platform_driver early_driver = { \
13977091 MD	118	.class_str = class_string, \
c60e0504 MD	119	.buffer = buf, \
	120	.bufsize = bufsiz, \
	121	.pdrv = platdrv, \
13977091 MD	122	.requested_id = EARLY_PLATFORM_ID_UNSET, \
13977091 MD	123	}; \
c60e0504	124	static int __init early_platform_driver_setup_func(char *buffer) \
13977091	125	{ \
c60e0504	126	return early_platform_driver_register(&early_driver, buffer); \
13977091 MD	127	} \
	128	early_param(class_string, early_platform_driver_setup_func)
	129	#else /* MODULE */
c60e0504 MD	130	#define early_platform_init_buffer(class_string, platdrv, buf, bufsiz) \
	131	static inline char *early_platform_driver_setup_func(void) \
	132	{ \
	133	return bufsiz ? buf : NULL; \
	134	}
13977091 MD	135	#endif /* MODULE */
13977091 MD	136
bbbf508d	137	#endif /* _PLATFORM_DEVICE_H_ */