V4L/DVB (5756): Tda9887: store tuning operations in tuner_operations structure
[linux-2.6] / drivers / media / video / ir-kbd-i2c.c
1 /*
2  *
3  * keyboard input driver for i2c IR remote controls
4  *
5  * Copyright (c) 2000-2003 Gerd Knorr <kraxel@bytesex.org>
6  * modified for PixelView (BT878P+W/FM) by
7  *      Michal Kochanowicz <mkochano@pld.org.pl>
8  *      Christoph Bartelmus <lirc@bartelmus.de>
9  * modified for KNC ONE TV Station/Anubis Typhoon TView Tuner by
10  *      Ulrich Mueller <ulrich.mueller42@web.de>
11  * modified for em2820 based USB TV tuners by
12  *      Markus Rechberger <mrechberger@gmail.com>
13  *
14  *  This program is free software; you can redistribute it and/or modify
15  *  it under the terms of the GNU General Public License as published by
16  *  the Free Software Foundation; either version 2 of the License, or
17  *  (at your option) any later version.
18  *
19  *  This program is distributed in the hope that it will be useful,
20  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
21  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
22  *  GNU General Public License for more details.
23  *
24  *  You should have received a copy of the GNU General Public License
25  *  along with this program; if not, write to the Free Software
26  *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
27  *
28  */
29
30 #include <linux/module.h>
31 #include <linux/moduleparam.h>
32 #include <linux/init.h>
33 #include <linux/kernel.h>
34 #include <linux/string.h>
35 #include <linux/timer.h>
36 #include <linux/delay.h>
37 #include <linux/errno.h>
38 #include <linux/slab.h>
39 #include <linux/i2c.h>
40 #include <linux/workqueue.h>
41 #include <asm/semaphore.h>
42
43 #include <media/ir-common.h>
44 #include <media/ir-kbd-i2c.h>
45
46 /* ----------------------------------------------------------------------- */
47 /* insmod parameters                                                       */
48
49 static int debug;
50 module_param(debug, int, 0644);    /* debug level (0,1,2) */
51
52 static int hauppauge = 0;
53 module_param(hauppauge, int, 0644);    /* Choose Hauppauge remote */
54 MODULE_PARM_DESC(hauppauge, "Specify Hauppauge remote: 0=black, 1=grey (defaults to 0)");
55
56
57 #define DEVNAME "ir-kbd-i2c"
58 #define dprintk(level, fmt, arg...)     if (debug >= level) \
59         printk(KERN_DEBUG DEVNAME ": " fmt , ## arg)
60
61 /* ----------------------------------------------------------------------- */
62
63 static int get_key_haup(struct IR_i2c *ir, u32 *ir_key, u32 *ir_raw)
64 {
65         unsigned char buf[3];
66         int start, range, toggle, dev, code;
67
68         /* poll IR chip */
69         if (3 != i2c_master_recv(&ir->c,buf,3))
70                 return -EIO;
71
72         /* split rc5 data block ... */
73         start  = (buf[0] >> 7) &    1;
74         range  = (buf[0] >> 6) &    1;
75         toggle = (buf[0] >> 5) &    1;
76         dev    =  buf[0]       & 0x1f;
77         code   = (buf[1] >> 2) & 0x3f;
78
79         /* rc5 has two start bits
80          * the first bit must be one
81          * the second bit defines the command range (1 = 0-63, 0 = 64 - 127)
82          */
83         if (!start)
84                 /* no key pressed */
85                 return 0;
86
87         if (!range)
88                 code += 64;
89
90         dprintk(1,"ir hauppauge (rc5): s%d r%d t%d dev=%d code=%d\n",
91                 start, range, toggle, dev, code);
92
93         /* return key */
94         *ir_key = code;
95         *ir_raw = (start << 12) | (toggle << 11) | (dev << 6) | code;
96         return 1;
97 }
98
99 static int get_key_pixelview(struct IR_i2c *ir, u32 *ir_key, u32 *ir_raw)
100 {
101         unsigned char b;
102
103         /* poll IR chip */
104         if (1 != i2c_master_recv(&ir->c,&b,1)) {
105                 dprintk(1,"read error\n");
106                 return -EIO;
107         }
108         *ir_key = b;
109         *ir_raw = b;
110         return 1;
111 }
112
113 static int get_key_pv951(struct IR_i2c *ir, u32 *ir_key, u32 *ir_raw)
114 {
115         unsigned char b;
116
117         /* poll IR chip */
118         if (1 != i2c_master_recv(&ir->c,&b,1)) {
119                 dprintk(1,"read error\n");
120                 return -EIO;
121         }
122
123         /* ignore 0xaa */
124         if (b==0xaa)
125                 return 0;
126         dprintk(2,"key %02x\n", b);
127
128         *ir_key = b;
129         *ir_raw = b;
130         return 1;
131 }
132
133 static int get_key_knc1(struct IR_i2c *ir, u32 *ir_key, u32 *ir_raw)
134 {
135         unsigned char b;
136
137         /* poll IR chip */
138         if (1 != i2c_master_recv(&ir->c,&b,1)) {
139                 dprintk(1,"read error\n");
140                 return -EIO;
141         }
142
143         /* it seems that 0xFE indicates that a button is still hold
144            down, while 0xff indicates that no button is hold
145            down. 0xfe sequences are sometimes interrupted by 0xFF */
146
147         dprintk(2,"key %02x\n", b);
148
149         if (b == 0xff)
150                 return 0;
151
152         if (b == 0xfe)
153                 /* keep old data */
154                 return 1;
155
156         *ir_key = b;
157         *ir_raw = b;
158         return 1;
159 }
160
161 /* Common (grey or coloured) pinnacle PCTV remote handling
162  *
163  */
164 static int get_key_pinnacle(struct IR_i2c *ir, u32 *ir_key, u32 *ir_raw,
165                             int parity_offset, int marker, int code_modulo)
166 {
167         unsigned char b[4];
168         unsigned int start = 0,parity = 0,code = 0;
169
170         /* poll IR chip */
171         if (4 != i2c_master_recv(&ir->c,b,4)) {
172                 dprintk(2,"read error\n");
173                 return -EIO;
174         }
175
176         for (start = 0; start < ARRAY_SIZE(b); start++) {
177                 if (b[start] == marker) {
178                         code=b[(start+parity_offset+1)%4];
179                         parity=b[(start+parity_offset)%4];
180                 }
181         }
182
183         /* Empty Request */
184         if (parity==0)
185                 return 0;
186
187         /* Repeating... */
188         if (ir->old == parity)
189                 return 0;
190
191         ir->old = parity;
192
193         /* drop special codes when a key is held down a long time for the grey controller
194            In this case, the second bit of the code is asserted */
195         if (marker == 0xfe && (code & 0x40))
196                 return 0;
197
198         code %= code_modulo;
199
200         *ir_raw = code;
201         *ir_key = code;
202
203         dprintk(1,"Pinnacle PCTV key %02x\n", code);
204
205         return 1;
206 }
207
208 /* The grey pinnacle PCTV remote
209  *
210  *  There are one issue with this remote:
211  *   - I2c packet does not change when the same key is pressed quickly. The workaround
212  *     is to hold down each key for about half a second, so that another code is generated
213  *     in the i2c packet, and the function can distinguish key presses.
214  *
215  * Sylvain Pasche <sylvain.pasche@gmail.com>
216  */
217 int get_key_pinnacle_grey(struct IR_i2c *ir, u32 *ir_key, u32 *ir_raw)
218 {
219
220         return get_key_pinnacle(ir, ir_key, ir_raw, 1, 0xfe, 0xff);
221 }
222
223 EXPORT_SYMBOL_GPL(get_key_pinnacle_grey);
224
225
226 /* The new pinnacle PCTV remote (with the colored buttons)
227  *
228  * Ricardo Cerqueira <v4l@cerqueira.org>
229  */
230 int get_key_pinnacle_color(struct IR_i2c *ir, u32 *ir_key, u32 *ir_raw)
231 {
232         /* code_modulo parameter (0x88) is used to reduce code value to fit inside IR_KEYTAB_SIZE
233          *
234          * this is the only value that results in 42 unique
235          * codes < 128
236          */
237
238         return get_key_pinnacle(ir, ir_key, ir_raw, 2, 0x80, 0x88);
239 }
240
241 EXPORT_SYMBOL_GPL(get_key_pinnacle_color);
242
243 /* ----------------------------------------------------------------------- */
244
245 static void ir_key_poll(struct IR_i2c *ir)
246 {
247         static u32 ir_key, ir_raw;
248         int rc;
249
250         dprintk(2,"ir_poll_key\n");
251         rc = ir->get_key(ir, &ir_key, &ir_raw);
252         if (rc < 0) {
253                 dprintk(2,"error\n");
254                 return;
255         }
256
257         if (0 == rc) {
258                 ir_input_nokey(ir->input, &ir->ir);
259         } else {
260                 ir_input_keydown(ir->input, &ir->ir, ir_key, ir_raw);
261         }
262 }
263
264 static void ir_timer(unsigned long data)
265 {
266         struct IR_i2c *ir = (struct IR_i2c*)data;
267         schedule_work(&ir->work);
268 }
269
270 static void ir_work(struct work_struct *work)
271 {
272         struct IR_i2c *ir = container_of(work, struct IR_i2c, work);
273
274         ir_key_poll(ir);
275         mod_timer(&ir->timer, jiffies + msecs_to_jiffies(100));
276 }
277
278 /* ----------------------------------------------------------------------- */
279
280 static int ir_attach(struct i2c_adapter *adap, int addr,
281                       unsigned short flags, int kind);
282 static int ir_detach(struct i2c_client *client);
283 static int ir_probe(struct i2c_adapter *adap);
284
285 static struct i2c_driver driver = {
286         .driver = {
287                 .name   = "ir-kbd-i2c",
288         },
289         .id             = I2C_DRIVERID_INFRARED,
290         .attach_adapter = ir_probe,
291         .detach_client  = ir_detach,
292 };
293
294 static struct i2c_client client_template =
295 {
296         .name = "unset",
297         .driver = &driver
298 };
299
300 static int ir_attach(struct i2c_adapter *adap, int addr,
301                      unsigned short flags, int kind)
302 {
303         IR_KEYTAB_TYPE *ir_codes = NULL;
304         char *name;
305         int ir_type;
306         struct IR_i2c *ir;
307         struct input_dev *input_dev;
308         int err;
309
310         ir = kzalloc(sizeof(struct IR_i2c),GFP_KERNEL);
311         input_dev = input_allocate_device();
312         if (!ir || !input_dev) {
313                 err = -ENOMEM;
314                 goto err_out_free;
315         }
316
317         ir->c = client_template;
318         ir->input = input_dev;
319
320         ir->c.adapter = adap;
321         ir->c.addr    = addr;
322
323         i2c_set_clientdata(&ir->c, ir);
324
325         switch(addr) {
326         case 0x64:
327                 name        = "Pixelview";
328                 ir->get_key = get_key_pixelview;
329                 ir_type     = IR_TYPE_OTHER;
330                 ir_codes    = ir_codes_empty;
331                 break;
332         case 0x4b:
333                 name        = "PV951";
334                 ir->get_key = get_key_pv951;
335                 ir_type     = IR_TYPE_OTHER;
336                 ir_codes    = ir_codes_pv951;
337                 break;
338         case 0x18:
339         case 0x1a:
340                 name        = "Hauppauge";
341                 ir->get_key = get_key_haup;
342                 ir_type     = IR_TYPE_RC5;
343                 if (hauppauge == 1) {
344                         ir_codes    = ir_codes_hauppauge_new;
345                 } else {
346                         ir_codes    = ir_codes_rc5_tv;
347                 }
348                 break;
349         case 0x30:
350                 name        = "KNC One";
351                 ir->get_key = get_key_knc1;
352                 ir_type     = IR_TYPE_OTHER;
353                 ir_codes    = ir_codes_empty;
354                 break;
355         case 0x7a:
356         case 0x47:
357         case 0x71:
358                 /* Handled by saa7134-input */
359                 name        = "SAA713x remote";
360                 ir_type     = IR_TYPE_OTHER;
361                 break;
362         default:
363                 /* shouldn't happen */
364                 printk(DEVNAME ": Huh? unknown i2c address (0x%02x)?\n", addr);
365                 err = -ENODEV;
366                 goto err_out_free;
367         }
368
369         /* Sets name */
370         snprintf(ir->c.name, sizeof(ir->c.name), "i2c IR (%s)", name);
371         ir->ir_codes = ir_codes;
372
373         /* register i2c device
374          * At device register, IR codes may be changed to be
375          * board dependent.
376          */
377         err = i2c_attach_client(&ir->c);
378         if (err)
379                 goto err_out_free;
380
381         /* If IR not supported or disabled, unregisters driver */
382         if (ir->get_key == NULL) {
383                 err = -ENODEV;
384                 goto err_out_detach;
385         }
386
387         /* Phys addr can only be set after attaching (for ir->c.dev.bus_id) */
388         snprintf(ir->phys, sizeof(ir->phys), "%s/%s/ir0",
389                  ir->c.adapter->dev.bus_id,
390                  ir->c.dev.bus_id);
391
392         /* init + register input device */
393         ir_input_init(input_dev, &ir->ir, ir_type, ir->ir_codes);
394         input_dev->id.bustype = BUS_I2C;
395         input_dev->name       = ir->c.name;
396         input_dev->phys       = ir->phys;
397
398         err = input_register_device(ir->input);
399         if (err)
400                 goto err_out_detach;
401
402         printk(DEVNAME ": %s detected at %s [%s]\n",
403                ir->input->name, ir->input->phys, adap->name);
404
405         /* start polling via eventd */
406         INIT_WORK(&ir->work, ir_work);
407         init_timer(&ir->timer);
408         ir->timer.function = ir_timer;
409         ir->timer.data     = (unsigned long)ir;
410         schedule_work(&ir->work);
411
412         return 0;
413
414  err_out_detach:
415         i2c_detach_client(&ir->c);
416  err_out_free:
417         input_free_device(input_dev);
418         kfree(ir);
419         return err;
420 }
421
422 static int ir_detach(struct i2c_client *client)
423 {
424         struct IR_i2c *ir = i2c_get_clientdata(client);
425
426         /* kill outstanding polls */
427         del_timer_sync(&ir->timer);
428         flush_scheduled_work();
429
430         /* unregister devices */
431         input_unregister_device(ir->input);
432         i2c_detach_client(&ir->c);
433
434         /* free memory */
435         kfree(ir);
436         return 0;
437 }
438
439 static int ir_probe(struct i2c_adapter *adap)
440 {
441
442         /* The external IR receiver is at i2c address 0x34 (0x35 for
443            reads).  Future Hauppauge cards will have an internal
444            receiver at 0x30 (0x31 for reads).  In theory, both can be
445            fitted, and Hauppauge suggest an external overrides an
446            internal.
447
448            That's why we probe 0x1a (~0x34) first. CB
449         */
450
451         static const int probe_bttv[] = { 0x1a, 0x18, 0x4b, 0x64, 0x30, -1};
452         static const int probe_saa7134[] = { 0x7a, 0x47, 0x71, -1 };
453         static const int probe_em28XX[] = { 0x30, 0x47, -1 };
454         const int *probe = NULL;
455         struct i2c_client c;
456         unsigned char buf;
457         int i,rc;
458
459         switch (adap->id) {
460         case I2C_HW_B_BT848:
461                 probe = probe_bttv;
462                 break;
463         case I2C_HW_B_CX2341X:
464                 probe = probe_bttv;
465                 break;
466         case I2C_HW_SAA7134:
467                 probe = probe_saa7134;
468                 break;
469         case I2C_HW_B_EM28XX:
470                 probe = probe_em28XX;
471                 break;
472         }
473         if (NULL == probe)
474                 return 0;
475
476         memset(&c,0,sizeof(c));
477         c.adapter = adap;
478         for (i = 0; -1 != probe[i]; i++) {
479                 c.addr = probe[i];
480                 rc = i2c_master_recv(&c,&buf,0);
481                 dprintk(1,"probe 0x%02x @ %s: %s\n",
482                         probe[i], adap->name,
483                         (0 == rc) ? "yes" : "no");
484                 if (0 == rc) {
485                         ir_attach(adap,probe[i],0,0);
486                         break;
487                 }
488         }
489         return 0;
490 }
491
492 /* ----------------------------------------------------------------------- */
493
494 MODULE_AUTHOR("Gerd Knorr, Michal Kochanowicz, Christoph Bartelmus, Ulrich Mueller");
495 MODULE_DESCRIPTION("input driver for i2c IR remote controls");
496 MODULE_LICENSE("GPL");
497
498 static int __init ir_init(void)
499 {
500         return i2c_add_driver(&driver);
501 }
502
503 static void __exit ir_fini(void)
504 {
505         i2c_del_driver(&driver);
506 }
507
508 module_init(ir_init);
509 module_exit(ir_fini);
510
511 /*
512  * Overrides for Emacs so that we follow Linus's tabbing style.
513  * ---------------------------------------------------------------------------
514  * Local variables:
515  * c-basic-offset: 8
516  * End:
517  */