xref: /linux/drivers/input/joystick/iforce/iforce.h (revision ccea15f45eb0ab12d658f88b5d4be005cb2bb1a7)
1 /*
2  * $Id: iforce.h,v 1.13 2002/07/07 10:22:50 jdeneux Exp $
3  *
4  *  Copyright (c) 2000-2002 Vojtech Pavlik <vojtech@ucw.cz>
5  *  Copyright (c) 2001-2002 Johann Deneux <deneux@ifrance.com>
6  *
7  *  USB/RS232 I-Force joysticks and wheels.
8  */
9 
10 /*
11  * This program is free software; you can redistribute it and/or modify
12  * it under the terms of the GNU General Public License as published by
13  * the Free Software Foundation; either version 2 of the License, or
14  * (at your option) any later version.
15  *
16  * This program is distributed in the hope that it will be useful,
17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
19  * GNU General Public License for more details.
20  *
21  * You should have received a copy of the GNU General Public License
22  * along with this program; if not, write to the Free Software
23  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
24  *
25  * Should you need to contact me, the author, you can do so either by
26  * e-mail - mail your message to <vojtech@ucw.cz>, or by paper mail:
27  * Vojtech Pavlik, Simunkova 1594, Prague 8, 182 00 Czech Republic
28  */
29 
30 #include <linux/kernel.h>
31 #include <linux/slab.h>
32 #include <linux/input.h>
33 #include <linux/module.h>
34 #include <linux/init.h>
35 #include <linux/spinlock.h>
36 #include <linux/usb.h>
37 #include <linux/serio.h>
38 #include <linux/config.h>
39 #include <linux/circ_buf.h>
40 #include <linux/mutex.h>
41 
42 /* This module provides arbitrary resource management routines.
43  * I use it to manage the device's memory.
44  * Despite the name of this module, I am *not* going to access the ioports.
45  */
46 #include <linux/ioport.h>
47 
48 
49 #define IFORCE_MAX_LENGTH	16
50 
51 /* iforce::bus */
52 #define IFORCE_232	1
53 #define IFORCE_USB	2
54 
55 #define FALSE 0
56 #define TRUE 1
57 
58 #define FF_EFFECTS_MAX	32
59 
60 /* Each force feedback effect is made of one core effect, which can be
61  * associated to at most to effect modifiers
62  */
63 #define FF_MOD1_IS_USED		0
64 #define FF_MOD2_IS_USED		1
65 #define FF_CORE_IS_USED		2
66 #define FF_CORE_IS_PLAYED	3	/* Effect is currently being played */
67 #define FF_CORE_SHOULD_PLAY	4	/* User wants the effect to be played */
68 #define FF_CORE_UPDATE		5	/* Effect is being updated */
69 #define FF_MODCORE_MAX		5
70 
71 #define CHECK_OWNERSHIP(i, iforce)	\
72 	((i) < FF_EFFECTS_MAX && i >= 0 && \
73 	test_bit(FF_CORE_IS_USED, (iforce)->core_effects[(i)].flags) && \
74 	(current->pid == 0 || \
75 	(iforce)->core_effects[(i)].owner == current->pid))
76 
77 struct iforce_core_effect {
78 	/* Information about where modifiers are stored in the device's memory */
79 	struct resource mod1_chunk;
80 	struct resource mod2_chunk;
81 	unsigned long flags[NBITS(FF_MODCORE_MAX)];
82 	pid_t owner;
83 	/* Used to keep track of parameters of an effect. They are needed
84 	 * to know what parts of an effect changed in an update operation.
85 	 * We try to send only parameter packets if possible, as sending
86 	 * effect parameter requires the effect to be stoped and restarted
87 	 */
88 	struct ff_effect effect;
89 };
90 
91 #define FF_CMD_EFFECT		0x010e
92 #define FF_CMD_ENVELOPE		0x0208
93 #define FF_CMD_MAGNITUDE	0x0303
94 #define FF_CMD_PERIOD		0x0407
95 #define FF_CMD_CONDITION	0x050a
96 
97 #define FF_CMD_AUTOCENTER	0x4002
98 #define FF_CMD_PLAY		0x4103
99 #define FF_CMD_ENABLE		0x4201
100 #define FF_CMD_GAIN		0x4301
101 
102 #define FF_CMD_QUERY		0xff01
103 
104 /* Buffer for async write */
105 #define XMIT_SIZE		256
106 #define XMIT_INC(var, n)	(var)+=n; (var)&= XMIT_SIZE -1
107 /* iforce::xmit_flags */
108 #define IFORCE_XMIT_RUNNING	0
109 #define IFORCE_XMIT_AGAIN	1
110 
111 struct iforce_device {
112 	u16 idvendor;
113 	u16 idproduct;
114 	char *name;
115 	signed short *btn;
116 	signed short *abs;
117 	signed short *ff;
118 };
119 
120 struct iforce {
121 	struct input_dev *dev;		/* Input device interface */
122 	struct iforce_device *type;
123 	int bus;
124 
125 	unsigned char data[IFORCE_MAX_LENGTH];
126 	unsigned char edata[IFORCE_MAX_LENGTH];
127 	u16 ecmd;
128 	u16 expect_packet;
129 
130 #ifdef CONFIG_JOYSTICK_IFORCE_232
131 	struct serio *serio;		/* RS232 transfer */
132 	int idx, pkt, len, id;
133 	unsigned char csum;
134 #endif
135 #ifdef CONFIG_JOYSTICK_IFORCE_USB
136 	struct usb_device *usbdev;	/* USB transfer */
137 	struct urb *irq, *out, *ctrl;
138 	struct usb_ctrlrequest cr;
139 #endif
140 	spinlock_t xmit_lock;
141 	/* Buffer used for asynchronous sending of bytes to the device */
142 	struct circ_buf xmit;
143 	unsigned char xmit_data[XMIT_SIZE];
144 	long xmit_flags[1];
145 
146 					/* Force Feedback */
147 	wait_queue_head_t wait;
148 	struct resource device_memory;
149 	struct iforce_core_effect core_effects[FF_EFFECTS_MAX];
150 	struct mutex mem_mutex;
151 };
152 
153 /* Get hi and low bytes of a 16-bits int */
154 #define HI(a)	((unsigned char)((a) >> 8))
155 #define LO(a)	((unsigned char)((a) & 0xff))
156 
157 /* For many parameters, it seems that 0x80 is a special value that should
158  * be avoided. Instead, we replace this value by 0x7f
159  */
160 #define HIFIX80(a) ((unsigned char)(((a)<0? (a)+255 : (a))>>8))
161 
162 /* Encode a time value */
163 #define TIME_SCALE(a)	(a)
164 
165 
166 /* Public functions */
167 /* iforce-serio.c */
168 void iforce_serial_xmit(struct iforce *iforce);
169 
170 /* iforce-usb.c */
171 void iforce_usb_xmit(struct iforce *iforce);
172 void iforce_usb_delete(struct iforce *iforce);
173 
174 /* iforce-main.c */
175 int iforce_init_device(struct iforce *iforce);
176 void iforce_delete_device(struct iforce *iforce);
177 
178 /* iforce-packets.c */
179 int iforce_control_playback(struct iforce*, u16 id, unsigned int);
180 void iforce_process_packet(struct iforce *iforce, u16 cmd, unsigned char *data, struct pt_regs *regs);
181 int iforce_send_packet(struct iforce *iforce, u16 cmd, unsigned char* data);
182 void iforce_dump_packet(char *msg, u16 cmd, unsigned char *data) ;
183 int iforce_get_id_packet(struct iforce *iforce, char *packet);
184 
185 /* iforce-ff.c */
186 int iforce_upload_periodic(struct iforce*, struct ff_effect*, int is_update);
187 int iforce_upload_constant(struct iforce*, struct ff_effect*, int is_update);
188 int iforce_upload_condition(struct iforce*, struct ff_effect*, int is_update);
189 
190 /* Public variables */
191 extern struct serio_driver iforce_serio_drv;
192 extern struct usb_driver iforce_usb_driver;
193