![Magnus Damm](/assets/img/avatar_default.png)
V3 of the early platform driver implementation. Platform drivers are great for embedded platforms because we can separate driver configuration from the actual driver. So base addresses, interrupts and other configuration can be kept with the processor or board code, and the platform driver can be reused by many different platforms. For early devices we have nothing today. For instance, to configure early timers and early serial ports we cannot use platform devices. This because the setup order during boot. Timers are needed before the platform driver core code is available. The same goes for early printk support. Early in this case means before initcalls. These early drivers today have their configuration either hard coded or they receive it using some special configuration method. This is working quite well, but if we want to support both regular kernel modules and early devices then we need to have two ways of configuring the same driver. A single way would be better. The early platform driver patch is basically a set of functions that allow drivers to register themselves and architecture code to locate them and probe. Registration happens through early_param(). The time for the probe is decided by the architecture code. See Documentation/driver-model/platform.txt for more details. [akpm@linux-foundation.org: coding-style fixes] Signed-off-by: Magnus Damm <damm@igel.co.jp> Cc: Paul Mundt <lethal@linux-sh.org> Cc: Kay Sievers <kay.sievers@vrfy.org> Cc: David Brownell <david-b@pacbell.net> Cc: Tejun Heo <htejun@gmail.com> Signed-off-by: Andrew Morton <akpm@linux-foundation.org> Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>
123 lines
4.2 KiB
C
123 lines
4.2 KiB
C
/*
|
|
* 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;
|
|
void *platform_data;
|
|
|
|
struct platform_device_id *id_entry;
|
|
};
|
|
|
|
#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, char *);
|
|
extern int platform_get_irq_byname(struct platform_device *, 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 (*suspend_late)(struct platform_device *, pm_message_t state);
|
|
int (*resume_early)(struct platform_device *);
|
|
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))
|
|
|
|
/* early platform driver interface */
|
|
struct early_platform_driver {
|
|
const char *class_str;
|
|
struct platform_driver *pdrv;
|
|
struct list_head list;
|
|
int requested_id;
|
|
};
|
|
|
|
#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);
|
|
|
|
|
|
#ifndef MODULE
|
|
#define early_platform_init(class_string, platform_driver) \
|
|
static __initdata struct early_platform_driver early_driver = { \
|
|
.class_str = class_string, \
|
|
.pdrv = platform_driver, \
|
|
.requested_id = EARLY_PLATFORM_ID_UNSET, \
|
|
}; \
|
|
static int __init early_platform_driver_setup_func(char *buf) \
|
|
{ \
|
|
return early_platform_driver_register(&early_driver, buf); \
|
|
} \
|
|
early_param(class_string, early_platform_driver_setup_func)
|
|
#else /* MODULE */
|
|
#define early_platform_init(class_string, platform_driver)
|
|
#endif /* MODULE */
|
|
|
|
#endif /* _PLATFORM_DEVICE_H_ */
|