Commit | Line | Data |
---|---|---|
1da177e4 LT |
1 | /* |
2 | * Copyright (C) 1999-2002 Vojtech Pavlik | |
3 | * | |
4 | * This program is free software; you can redistribute it and/or modify it | |
5 | * under the terms of the GNU General Public License version 2 as published by | |
6 | * the Free Software Foundation. | |
7 | */ | |
607ca46e DH |
8 | #ifndef _SERIO_H |
9 | #define _SERIO_H | |
1da177e4 | 10 | |
1da177e4 | 11 | |
7e044e05 | 12 | #include <linux/types.h> |
1da177e4 LT |
13 | #include <linux/interrupt.h> |
14 | #include <linux/list.h> | |
15 | #include <linux/spinlock.h> | |
c4e32e9f | 16 | #include <linux/mutex.h> |
1da177e4 LT |
17 | #include <linux/device.h> |
18 | #include <linux/mod_devicetable.h> | |
607ca46e | 19 | #include <uapi/linux/serio.h> |
1da177e4 LT |
20 | |
21 | struct serio { | |
22 | void *port_data; | |
23 | ||
24 | char name[32]; | |
25 | char phys[32]; | |
26 | ||
7e044e05 | 27 | bool manual_bind; |
1da177e4 LT |
28 | |
29 | struct serio_device_id id; | |
30 | ||
31 | spinlock_t lock; /* protects critical sections from port's interrupt handler */ | |
32 | ||
33 | int (*write)(struct serio *, unsigned char); | |
34 | int (*open)(struct serio *); | |
35 | void (*close)(struct serio *); | |
36 | int (*start)(struct serio *); | |
37 | void (*stop)(struct serio *); | |
38 | ||
09822582 DES |
39 | struct serio *parent; |
40 | struct list_head child_node; /* Entry in parent->children list */ | |
41 | struct list_head children; | |
88aa0103 | 42 | unsigned int depth; /* level of nesting in serio hierarchy */ |
1da177e4 LT |
43 | |
44 | struct serio_driver *drv; /* accessed from interrupt, must be protected by serio->lock and serio->sem */ | |
c4e32e9f | 45 | struct mutex drv_mutex; /* protects serio->drv so attributes can pin driver */ |
1da177e4 LT |
46 | |
47 | struct device dev; | |
1da177e4 LT |
48 | |
49 | struct list_head node; | |
50 | }; | |
51 | #define to_serio_port(d) container_of(d, struct serio, dev) | |
52 | ||
53 | struct serio_driver { | |
ceee4271 | 54 | const char *description; |
1da177e4 | 55 | |
ceee4271 | 56 | const struct serio_device_id *id_table; |
7e044e05 | 57 | bool manual_bind; |
1da177e4 LT |
58 | |
59 | void (*write_wakeup)(struct serio *); | |
7d12e780 | 60 | irqreturn_t (*interrupt)(struct serio *, unsigned char, unsigned int); |
1da177e4 LT |
61 | int (*connect)(struct serio *, struct serio_driver *drv); |
62 | int (*reconnect)(struct serio *); | |
63 | void (*disconnect)(struct serio *); | |
64 | void (*cleanup)(struct serio *); | |
65 | ||
66 | struct device_driver driver; | |
67 | }; | |
68 | #define to_serio_driver(d) container_of(d, struct serio_driver, driver) | |
69 | ||
70 | int serio_open(struct serio *serio, struct serio_driver *drv); | |
71 | void serio_close(struct serio *serio); | |
72 | void serio_rescan(struct serio *serio); | |
73 | void serio_reconnect(struct serio *serio); | |
7d12e780 | 74 | irqreturn_t serio_interrupt(struct serio *serio, unsigned char data, unsigned int flags); |
1da177e4 LT |
75 | |
76 | void __serio_register_port(struct serio *serio, struct module *owner); | |
eb5589a8 PG |
77 | |
78 | /* use a define to avoid include chaining to get THIS_MODULE */ | |
79 | #define serio_register_port(serio) \ | |
80 | __serio_register_port(serio, THIS_MODULE) | |
1da177e4 LT |
81 | |
82 | void serio_unregister_port(struct serio *serio); | |
dbf4ccd6 | 83 | void serio_unregister_child_port(struct serio *serio); |
1da177e4 | 84 | |
eb5589a8 PG |
85 | int __must_check __serio_register_driver(struct serio_driver *drv, |
86 | struct module *owner, const char *mod_name); | |
87 | ||
88 | /* use a define to avoid include chaining to get THIS_MODULE & friends */ | |
89 | #define serio_register_driver(drv) \ | |
90 | __serio_register_driver(drv, THIS_MODULE, KBUILD_MODNAME) | |
91 | ||
1da177e4 LT |
92 | void serio_unregister_driver(struct serio_driver *drv); |
93 | ||
fa7f86d1 AL |
94 | /** |
95 | * module_serio_driver() - Helper macro for registering a serio driver | |
96 | * @__serio_driver: serio_driver struct | |
97 | * | |
98 | * Helper macro for serio drivers which do not do anything special in | |
99 | * module init/exit. This eliminates a lot of boilerplate. Each module | |
100 | * may only use this macro once, and calling it replaces module_init() | |
101 | * and module_exit(). | |
102 | */ | |
103 | #define module_serio_driver(__serio_driver) \ | |
104 | module_driver(__serio_driver, serio_register_driver, \ | |
105 | serio_unregister_driver) | |
106 | ||
1da177e4 LT |
107 | static inline int serio_write(struct serio *serio, unsigned char data) |
108 | { | |
109 | if (serio->write) | |
110 | return serio->write(serio, data); | |
111 | else | |
112 | return -1; | |
113 | } | |
114 | ||
115 | static inline void serio_drv_write_wakeup(struct serio *serio) | |
116 | { | |
117 | if (serio->drv && serio->drv->write_wakeup) | |
118 | serio->drv->write_wakeup(serio); | |
119 | } | |
120 | ||
1da177e4 | 121 | /* |
0b28002f | 122 | * Use the following functions to manipulate serio's per-port |
1da177e4 LT |
123 | * driver-specific data. |
124 | */ | |
125 | static inline void *serio_get_drvdata(struct serio *serio) | |
126 | { | |
127 | return dev_get_drvdata(&serio->dev); | |
128 | } | |
129 | ||
130 | static inline void serio_set_drvdata(struct serio *serio, void *data) | |
131 | { | |
132 | dev_set_drvdata(&serio->dev, data); | |
133 | } | |
134 | ||
135 | /* | |
0b28002f | 136 | * Use the following functions to protect critical sections in |
1da177e4 LT |
137 | * driver code from port's interrupt handler |
138 | */ | |
139 | static inline void serio_pause_rx(struct serio *serio) | |
140 | { | |
141 | spin_lock_irq(&serio->lock); | |
142 | } | |
143 | ||
144 | static inline void serio_continue_rx(struct serio *serio) | |
145 | { | |
146 | spin_unlock_irq(&serio->lock); | |
147 | } | |
148 | ||
1da177e4 | 149 | #endif |