blob: f395bb3fa2f2065375f25c51ea8221d27a4d3dc6 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/**
2 * System devices follow a slightly different driver model.
3 * They don't need to do dynammic driver binding, can't be probed,
4 * and don't reside on any type of peripheral bus.
5 * So, we represent and treat them a little differently.
6 *
7 * We still have a notion of a driver for a system device, because we still
8 * want to perform basic operations on these devices.
9 *
10 * We also support auxillary drivers binding to devices of a certain class.
11 *
12 * This allows configurable drivers to register themselves for devices of
13 * a certain type. And, it allows class definitions to reside in generic
14 * code while arch-specific code can register specific drivers.
15 *
16 * Auxillary drivers registered with a NULL cls are registered as drivers
17 * for all system devices, and get notification calls for each device.
18 */
19
20
21#ifndef _SYSDEV_H_
22#define _SYSDEV_H_
23
24#include <linux/kobject.h>
Ralf Baechle3367b992007-05-08 00:27:52 -070025#include <linux/module.h>
Pavel Machek438510f2005-04-16 15:25:24 -070026#include <linux/pm.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070027
28
29struct sys_device;
30
31struct sysdev_class {
Kay Sieversaf5ca3f2007-12-20 02:09:39 +010032 const char *name;
Linus Torvalds1da177e2005-04-16 15:20:36 -070033 struct list_head drivers;
34
35 /* Default operations for these types of devices */
36 int (*shutdown)(struct sys_device *);
Pavel Machek438510f2005-04-16 15:25:24 -070037 int (*suspend)(struct sys_device *, pm_message_t state);
Linus Torvalds1da177e2005-04-16 15:20:36 -070038 int (*resume)(struct sys_device *);
39 struct kset kset;
40};
41
Shaohua Li670dd902006-05-08 13:45:57 +080042struct sysdev_class_attribute {
43 struct attribute attr;
44 ssize_t (*show)(struct sysdev_class *, char *);
45 ssize_t (*store)(struct sysdev_class *, const char *, size_t);
46};
47
Mike Travis9d1fe322008-04-08 11:43:04 -070048#define _SYSDEV_CLASS_ATTR(_name,_mode,_show,_store) \
49{ \
Shaohua Li670dd902006-05-08 13:45:57 +080050 .attr = {.name = __stringify(_name), .mode = _mode }, \
51 .show = _show, \
52 .store = _store, \
Mike Travis9d1fe322008-04-08 11:43:04 -070053}
54
55#define SYSDEV_CLASS_ATTR(_name,_mode,_show,_store) \
56 struct sysdev_class_attribute attr_##_name = \
57 _SYSDEV_CLASS_ATTR(_name,_mode,_show,_store)
Shaohua Li670dd902006-05-08 13:45:57 +080058
Linus Torvalds1da177e2005-04-16 15:20:36 -070059
60extern int sysdev_class_register(struct sysdev_class *);
61extern void sysdev_class_unregister(struct sysdev_class *);
62
Shaohua Li670dd902006-05-08 13:45:57 +080063extern int sysdev_class_create_file(struct sysdev_class *,
64 struct sysdev_class_attribute *);
65extern void sysdev_class_remove_file(struct sysdev_class *,
66 struct sysdev_class_attribute *);
Linus Torvalds1da177e2005-04-16 15:20:36 -070067/**
68 * Auxillary system device drivers.
69 */
70
71struct sysdev_driver {
72 struct list_head entry;
73 int (*add)(struct sys_device *);
74 int (*remove)(struct sys_device *);
75 int (*shutdown)(struct sys_device *);
Pavel Machek438510f2005-04-16 15:25:24 -070076 int (*suspend)(struct sys_device *, pm_message_t state);
Linus Torvalds1da177e2005-04-16 15:20:36 -070077 int (*resume)(struct sys_device *);
78};
79
80
81extern int sysdev_driver_register(struct sysdev_class *, struct sysdev_driver *);
82extern void sysdev_driver_unregister(struct sysdev_class *, struct sysdev_driver *);
83
84
85/**
86 * sys_devices can be simplified a lot from regular devices, because they're
87 * simply not as versatile.
88 */
89
90struct sys_device {
91 u32 id;
92 struct sysdev_class * cls;
93 struct kobject kobj;
94};
95
96extern int sysdev_register(struct sys_device *);
97extern void sysdev_unregister(struct sys_device *);
98
99
100struct sysdev_attribute {
101 struct attribute attr;
Andi Kleen4a0b2b42008-07-01 18:48:41 +0200102 ssize_t (*show)(struct sys_device *, struct sysdev_attribute *, char *);
103 ssize_t (*store)(struct sys_device *, struct sysdev_attribute *,
104 const char *, size_t);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700105};
106
107
Mike Travis9d1fe322008-04-08 11:43:04 -0700108#define _SYSDEV_ATTR(_name, _mode, _show, _store) \
Olof Johansson7583b6e2007-01-28 21:24:57 -0600109{ \
Tejun Heo7b595752007-06-14 03:45:17 +0900110 .attr = { .name = __stringify(_name), .mode = _mode }, \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700111 .show = _show, \
112 .store = _store, \
Olof Johansson7583b6e2007-01-28 21:24:57 -0600113}
114
Mike Travis9d1fe322008-04-08 11:43:04 -0700115#define SYSDEV_ATTR(_name, _mode, _show, _store) \
116 struct sysdev_attribute attr_##_name = \
117 _SYSDEV_ATTR(_name, _mode, _show, _store);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700118
119extern int sysdev_create_file(struct sys_device *, struct sysdev_attribute *);
120extern void sysdev_remove_file(struct sys_device *, struct sysdev_attribute *);
121
Andi Kleen98007942008-07-01 18:48:42 +0200122struct sysdev_ext_attribute {
123 struct sysdev_attribute attr;
124 void *var;
125};
126
127/*
128 * Support for simple variable sysdev attributes.
129 * The pointer to the variable is stored in a sysdev_ext_attribute
130 */
131
132/* Add more types as needed */
133
134extern ssize_t sysdev_show_ulong(struct sys_device *, struct sysdev_attribute *,
135 char *);
136extern ssize_t sysdev_store_ulong(struct sys_device *,
137 struct sysdev_attribute *, const char *, size_t);
138extern ssize_t sysdev_show_int(struct sys_device *, struct sysdev_attribute *,
139 char *);
140extern ssize_t sysdev_store_int(struct sys_device *,
141 struct sysdev_attribute *, const char *, size_t);
142
143#define _SYSDEV_ULONG_ATTR(_name, _mode, _var) \
144 { _SYSDEV_ATTR(_name, _mode, sysdev_show_ulong, sysdev_store_ulong), \
145 &(_var) }
146#define SYSDEV_ULONG_ATTR(_name, _mode, _var) \
147 struct sysdev_ext_attribute attr_##_name = \
148 _SYSDEV_ULONG_ATTR(_name, _mode, _var);
149#define _SYSDEV_INT_ATTR(_name, _mode, _var) \
150 { _SYSDEV_ATTR(_name, _mode, sysdev_show_int, sysdev_store_int), \
151 &(_var) }
152#define SYSDEV_INT_ATTR(_name, _mode, _var) \
153 struct sysdev_ext_attribute attr_##_name = \
154 _SYSDEV_INT_ATTR(_name, _mode, _var);
155
Linus Torvalds1da177e2005-04-16 15:20:36 -0700156#endif /* _SYSDEV_H_ */