blob: 069ee41391055477101204a44f5a6143e7caec2b [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001#ifndef _GAMEPORT_H
2#define _GAMEPORT_H
3
4/*
5 * Copyright (c) 1999-2002 Vojtech Pavlik
6 *
7 * This program is free software; you can redistribute it and/or modify it
8 * under the terms of the GNU General Public License version 2 as published by
9 * the Free Software Foundation.
10 */
11
David Woodhouse25478bb2006-04-25 13:59:30 +010012#ifdef __KERNEL__
Linus Torvalds1da177e2005-04-16 15:20:36 -070013#include <asm/io.h>
Dmitry Torokhov7e044e02009-05-09 16:08:05 -070014#include <linux/types.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070015#include <linux/list.h>
Arjan van de Ven286295e2006-02-19 00:22:03 -050016#include <linux/mutex.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070017#include <linux/device.h>
Tim Schmielau4e57b682005-10-30 15:03:48 -080018#include <linux/timer.h>
Tejun Heo5a0e3ad2010-03-24 17:04:11 +090019#include <linux/slab.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070020
21struct gameport {
22
23 void *port_data; /* Private pointer for gameport drivers */
24 char name[32];
25 char phys[32];
26
27 int io;
28 int speed;
29 int fuzz;
30
31 void (*trigger)(struct gameport *);
32 unsigned char (*read)(struct gameport *);
33 int (*cooked_read)(struct gameport *, int *, int *);
34 int (*calibrate)(struct gameport *, int *, int *);
35 int (*open)(struct gameport *, int);
36 void (*close)(struct gameport *);
37
38 struct timer_list poll_timer;
39 unsigned int poll_interval; /* in msecs */
40 spinlock_t timer_lock;
41 unsigned int poll_cnt;
42 void (*poll_handler)(struct gameport *);
43
44 struct gameport *parent, *child;
45
46 struct gameport_driver *drv;
Arjan van de Ven286295e2006-02-19 00:22:03 -050047 struct mutex drv_mutex; /* protects serio->drv so attributes can pin driver */
Linus Torvalds1da177e2005-04-16 15:20:36 -070048
49 struct device dev;
Linus Torvalds1da177e2005-04-16 15:20:36 -070050
51 struct list_head node;
52};
53#define to_gameport_port(d) container_of(d, struct gameport, dev)
54
55struct gameport_driver {
Dmitry Torokhov37b0bb12010-09-13 23:53:55 -070056 const char *description;
Linus Torvalds1da177e2005-04-16 15:20:36 -070057
58 int (*connect)(struct gameport *, struct gameport_driver *drv);
59 int (*reconnect)(struct gameport *);
60 void (*disconnect)(struct gameport *);
61
62 struct device_driver driver;
63
Dmitry Torokhov7e044e02009-05-09 16:08:05 -070064 bool ignore;
Linus Torvalds1da177e2005-04-16 15:20:36 -070065};
66#define to_gameport_driver(d) container_of(d, struct gameport_driver, driver)
67
68int gameport_open(struct gameport *gameport, struct gameport_driver *drv, int mode);
69void gameport_close(struct gameport *gameport);
Linus Torvalds1da177e2005-04-16 15:20:36 -070070
Adrian Bunk668d1e62005-05-28 02:11:12 -050071#if defined(CONFIG_GAMEPORT) || (defined(MODULE) && defined(CONFIG_GAMEPORT_MODULE))
72
Linus Torvalds1da177e2005-04-16 15:20:36 -070073void __gameport_register_port(struct gameport *gameport, struct module *owner);
74static inline void gameport_register_port(struct gameport *gameport)
75{
76 __gameport_register_port(gameport, THIS_MODULE);
77}
78
79void gameport_unregister_port(struct gameport *gameport);
80
Joe Perchesb9075fa2011-10-31 17:11:33 -070081__printf(2, 3)
82void gameport_set_phys(struct gameport *gameport, const char *fmt, ...);
Adrian Bunk668d1e62005-05-28 02:11:12 -050083
84#else
85
86static inline void gameport_register_port(struct gameport *gameport)
87{
88 return;
89}
90
91static inline void gameport_unregister_port(struct gameport *gameport)
92{
93 return;
94}
95
Joe Perchesb9075fa2011-10-31 17:11:33 -070096static inline __printf(2, 3)
97void gameport_set_phys(struct gameport *gameport, const char *fmt, ...)
Adrian Bunk668d1e62005-05-28 02:11:12 -050098{
99 return;
100}
101
102#endif
103
Linus Torvalds1da177e2005-04-16 15:20:36 -0700104static inline struct gameport *gameport_allocate_port(void)
105{
Robert P. J. Daycd861282006-12-13 00:34:52 -0800106 struct gameport *gameport = kzalloc(sizeof(struct gameport), GFP_KERNEL);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700107
108 return gameport;
109}
110
111static inline void gameport_free_port(struct gameport *gameport)
112{
113 kfree(gameport);
114}
115
116static inline void gameport_set_name(struct gameport *gameport, const char *name)
117{
118 strlcpy(gameport->name, name, sizeof(gameport->name));
119}
120
Linus Torvalds1da177e2005-04-16 15:20:36 -0700121/*
Akinobu Mita0b280022006-03-26 01:38:58 -0800122 * Use the following functions to manipulate gameport's per-port
Linus Torvalds1da177e2005-04-16 15:20:36 -0700123 * driver-specific data.
124 */
125static inline void *gameport_get_drvdata(struct gameport *gameport)
126{
127 return dev_get_drvdata(&gameport->dev);
128}
129
130static inline void gameport_set_drvdata(struct gameport *gameport, void *data)
131{
132 dev_set_drvdata(&gameport->dev, data);
133}
134
135/*
Akinobu Mita0b280022006-03-26 01:38:58 -0800136 * Use the following functions to pin gameport's driver in process context
Linus Torvalds1da177e2005-04-16 15:20:36 -0700137 */
138static inline int gameport_pin_driver(struct gameport *gameport)
139{
Arjan van de Ven286295e2006-02-19 00:22:03 -0500140 return mutex_lock_interruptible(&gameport->drv_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700141}
142
143static inline void gameport_unpin_driver(struct gameport *gameport)
144{
Arjan van de Ven286295e2006-02-19 00:22:03 -0500145 mutex_unlock(&gameport->drv_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700146}
147
Dmitry Torokhov6902c0b2008-06-06 01:33:22 -0400148int __gameport_register_driver(struct gameport_driver *drv,
149 struct module *owner, const char *mod_name);
Dmitry Torokhov8c4b3c22008-06-06 01:33:51 -0400150static inline int __must_check gameport_register_driver(struct gameport_driver *drv)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700151{
Dmitry Torokhov6902c0b2008-06-06 01:33:22 -0400152 return __gameport_register_driver(drv, THIS_MODULE, KBUILD_MODNAME);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700153}
154
155void gameport_unregister_driver(struct gameport_driver *drv);
156
David Woodhouse25478bb2006-04-25 13:59:30 +0100157#endif /* __KERNEL__ */
158
Linus Torvalds1da177e2005-04-16 15:20:36 -0700159#define GAMEPORT_MODE_DISABLED 0
160#define GAMEPORT_MODE_RAW 1
161#define GAMEPORT_MODE_COOKED 2
162
163#define GAMEPORT_ID_VENDOR_ANALOG 0x0001
164#define GAMEPORT_ID_VENDOR_MADCATZ 0x0002
165#define GAMEPORT_ID_VENDOR_LOGITECH 0x0003
166#define GAMEPORT_ID_VENDOR_CREATIVE 0x0004
167#define GAMEPORT_ID_VENDOR_GENIUS 0x0005
168#define GAMEPORT_ID_VENDOR_INTERACT 0x0006
169#define GAMEPORT_ID_VENDOR_MICROSOFT 0x0007
170#define GAMEPORT_ID_VENDOR_THRUSTMASTER 0x0008
171#define GAMEPORT_ID_VENDOR_GRAVIS 0x0009
172#define GAMEPORT_ID_VENDOR_GUILLEMOT 0x000a
173
David Woodhouse25478bb2006-04-25 13:59:30 +0100174#ifdef __KERNEL__
175
Linus Torvalds1da177e2005-04-16 15:20:36 -0700176static inline void gameport_trigger(struct gameport *gameport)
177{
178 if (gameport->trigger)
179 gameport->trigger(gameport);
180 else
181 outb(0xff, gameport->io);
182}
183
184static inline unsigned char gameport_read(struct gameport *gameport)
185{
186 if (gameport->read)
187 return gameport->read(gameport);
188 else
189 return inb(gameport->io);
190}
191
192static inline int gameport_cooked_read(struct gameport *gameport, int *axes, int *buttons)
193{
194 if (gameport->cooked_read)
195 return gameport->cooked_read(gameport, axes, buttons);
196 else
197 return -1;
198}
199
200static inline int gameport_calibrate(struct gameport *gameport, int *axes, int *max)
201{
202 if (gameport->calibrate)
203 return gameport->calibrate(gameport, axes, max);
204 else
205 return -1;
206}
207
208static inline int gameport_time(struct gameport *gameport, int time)
209{
210 return (time * gameport->speed) / 1000;
211}
212
213static inline void gameport_set_poll_handler(struct gameport *gameport, void (*handler)(struct gameport *))
214{
215 gameport->poll_handler = handler;
216}
217
218static inline void gameport_set_poll_interval(struct gameport *gameport, unsigned int msecs)
219{
220 gameport->poll_interval = msecs;
221}
222
223void gameport_start_polling(struct gameport *gameport);
224void gameport_stop_polling(struct gameport *gameport);
225
David Woodhouse25478bb2006-04-25 13:59:30 +0100226#endif /* __KERNEL__ */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700227#endif