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  * modified for DViCO Fusion HDTV 5 RT GOLD by
  14  *      Chaogui Zhang <czhang1974@gmail.com>
  15  * modified for MSI TV@nywhere Plus by
  16  *      Henry Wong <henry@stuffedcow.net>
  17  *      Mark Schultz <n9xmj@yahoo.com>
  18  *      Brian Rogers <brian_rogers@comcast.net>
  19  * modified for AVerMedia Cardbus by
  20  *      Oldrich Jedlicka <oldium.pro@seznam.cz>
  21  *
  22  *  This program is free software; you can redistribute it and/or modify
  23  *  it under the terms of the GNU General Public License as published by
  24  *  the Free Software Foundation; either version 2 of the License, or
  25  *  (at your option) any later version.
  26  *
  27  *  This program is distributed in the hope that it will be useful,
  28  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  29  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  30  *  GNU General Public License for more details.
  31  *
  32  *  You should have received a copy of the GNU General Public License
  33  *  along with this program; if not, write to the Free Software
  34  *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  35  *
  36  */
  37
  38 #include <linux/module.h>
  39 #include <linux/init.h>
  40 #include <linux/kernel.h>
  41 #include <linux/string.h>
  42 #include <linux/timer.h>
  43 #include <linux/delay.h>
  44 #include <linux/errno.h>
  45 #include <linux/slab.h>
  46 #include <linux/i2c.h>
  47 #include <linux/workqueue.h>
  48
  49 #include <media/rc-core.h>
  50 #include <media/ir-kbd-i2c.h>
  51
  52 /* ----------------------------------------------------------------------- */
  53 /* insmod parameters                                                       */
  54
  55 static int debug;
  56 module_param(debug, int, 0644);    /* debug level (0,1,2) */
  57
  58 static int hauppauge;
  59 module_param(hauppauge, int, 0644);    /* Choose Hauppauge remote */
  60 MODULE_PARM_DESC(hauppauge, "Specify Hauppauge remote: 0=black, 1=grey (defaults to 0)");
  61
  62
  63 #define MODULE_NAME "ir-kbd-i2c"
  64 #define dprintk(level, fmt, arg...)     if (debug >= level) \
  65         printk(KERN_DEBUG MODULE_NAME ": " fmt , ## arg)
  66
  67 /* ----------------------------------------------------------------------- */
  68
  69 static int get_key_haup_common(struct IR_i2c *ir, u32 *ir_key, u32 *ir_raw,
  70                                int size, int offset)
  71 {
  72         unsigned char buf[6];
  73         int start, range, toggle, dev, code, ircode;
  74
  75         /* poll IR chip */
  76         if (size != i2c_master_recv(ir->c, buf, size))
  77                 return -EIO;
  78
  79         /* split rc5 data block ... */
  80         start  = (buf[offset] >> 7) &    1;
  81         range  = (buf[offset] >> 6) &    1;
  82         toggle = (buf[offset] >> 5) &    1;
  83         dev    =  buf[offset]       & 0x1f;
  84         code   = (buf[offset+1] >> 2) & 0x3f;
  85
  86         /* rc5 has two start bits
  87          * the first bit must be one
  88          * the second bit defines the command range (1 = 0-63, 0 = 64 - 127)
  89          */
  90         if (!start)
  91                 /* no key pressed */
  92                 return 0;
  93         /*
  94          * Hauppauge remotes (black/silver) always use
  95          * specific device ids. If we do not filter the
  96          * device ids then messages destined for devices
  97          * such as TVs (id=0) will get through causing
  98          * mis-fired events.
  99          *
 100          * We also filter out invalid key presses which
 101          * produce annoying debug log entries.
 102          */
 103         ircode= (start << 12) | (toggle << 11) | (dev << 6) | code;
 104         if ((ircode & 0x1fff)==0x1fff)
 105                 /* invalid key press */
 106                 return 0;
 107
 108         if (dev!=0x1e && dev!=0x1f)
 109                 /* not a hauppauge remote */
 110                 return 0;
 111
 112         if (!range)
 113                 code += 64;
 114
 115         dprintk(1,"ir hauppauge (rc5): s%d r%d t%d dev=%d code=%d\n",
 116                 start, range, toggle, dev, code);
 117
 118         /* return key */
 119         *ir_key = code;
 120         *ir_raw = ircode;
 121         return 1;
 122 }
 123
 124 static int get_key_haup(struct IR_i2c *ir, u32 *ir_key, u32 *ir_raw)
 125 {
 126         return get_key_haup_common (ir, ir_key, ir_raw, 3, 0);
 127 }
 128
 129 static int get_key_haup_xvr(struct IR_i2c *ir, u32 *ir_key, u32 *ir_raw)
 130 {
 131         return get_key_haup_common (ir, ir_key, ir_raw, 6, 3);
 132 }
 133
 134 static int get_key_pixelview(struct IR_i2c *ir, u32 *ir_key, u32 *ir_raw)
 135 {
 136         unsigned char b;
 137
 138         /* poll IR chip */
 139         if (1 != i2c_master_recv(ir->c, &b, 1)) {
 140                 dprintk(1,"read error\n");
 141                 return -EIO;
 142         }
 143         *ir_key = b;
 144         *ir_raw = b;
 145         return 1;
 146 }
 147
 148 static int get_key_fusionhdtv(struct IR_i2c *ir, u32 *ir_key, u32 *ir_raw)
 149 {
 150         unsigned char buf[4];
 151
 152         /* poll IR chip */
 153         if (4 != i2c_master_recv(ir->c, buf, 4)) {
 154                 dprintk(1,"read error\n");
 155                 return -EIO;
 156         }
 157
 158         if(buf[0] !=0 || buf[1] !=0 || buf[2] !=0 || buf[3] != 0)
 159                 dprintk(2, "%s: 0x%2x 0x%2x 0x%2x 0x%2x\n", __func__,
 160                         buf[0], buf[1], buf[2], buf[3]);
 161
 162         /* no key pressed or signal from other ir remote */
 163         if(buf[0] != 0x1 ||  buf[1] != 0xfe)
 164                 return 0;
 165
 166         *ir_key = buf[2];
 167         *ir_raw = (buf[2] << 8) | buf[3];
 168
 169         return 1;
 170 }
 171
 172 static int get_key_knc1(struct IR_i2c *ir, u32 *ir_key, u32 *ir_raw)
 173 {
 174         unsigned char b;
 175
 176         /* poll IR chip */
 177         if (1 != i2c_master_recv(ir->c, &b, 1)) {
 178                 dprintk(1,"read error\n");
 179                 return -EIO;
 180         }
 181
 182         /* it seems that 0xFE indicates that a button is still hold
 183            down, while 0xff indicates that no button is hold
 184            down. 0xfe sequences are sometimes interrupted by 0xFF */
 185
 186         dprintk(2,"key %02x\n", b);
 187
 188         if (b == 0xff)
 189                 return 0;
 190
 191         if (b == 0xfe)
 192                 /* keep old data */
 193                 return 1;
 194
 195         *ir_key = b;
 196         *ir_raw = b;
 197         return 1;
 198 }
 199
 200 static int get_key_avermedia_cardbus(struct IR_i2c *ir,
 201                                      u32 *ir_key, u32 *ir_raw)
 202 {
 203         unsigned char subaddr, key, keygroup;
 204         struct i2c_msg msg[] = { { .addr = ir->c->addr, .flags = 0,
 205                                    .buf = &subaddr, .len = 1},
 206                                  { .addr = ir->c->addr, .flags = I2C_M_RD,
 207                                   .buf = &key, .len = 1} };
 208         subaddr = 0x0d;
 209         if (2 != i2c_transfer(ir->c->adapter, msg, 2)) {
 210                 dprintk(1, "read error\n");
 211                 return -EIO;
 212         }
 213
 214         if (key == 0xff)
 215                 return 0;
 216
 217         subaddr = 0x0b;
 218         msg[1].buf = &keygroup;
 219         if (2 != i2c_transfer(ir->c->adapter, msg, 2)) {
 220                 dprintk(1, "read error\n");
 221                 return -EIO;
 222         }
 223
 224         if (keygroup == 0xff)
 225                 return 0;
 226
 227         dprintk(1, "read key 0x%02x/0x%02x\n", key, keygroup);
 228         if (keygroup < 2 || keygroup > 3) {
 229                 /* Only a warning */
 230                 dprintk(1, "warning: invalid key group 0x%02x for key 0x%02x\n",
 231                                                                 keygroup, key);
 232         }
 233         key |= (keygroup & 1) << 6;
 234
 235         *ir_key = key;
 236         *ir_raw = key;
 237         return 1;
 238 }
 239
 240 /* ----------------------------------------------------------------------- */
 241
 242 static void ir_key_poll(struct IR_i2c *ir)
 243 {
 244         static u32 ir_key, ir_raw;
 245         int rc;
 246
 247         dprintk(2,"ir_poll_key\n");
 248         rc = ir->get_key(ir, &ir_key, &ir_raw);
 249         if (rc < 0) {
 250                 dprintk(2,"error\n");
 251                 return;
 252         }
 253
 254         if (rc)
 255                 rc_keydown(ir->rc, ir_key, 0);
 256 }
 257
 258 static void ir_work(struct work_struct *work)
 259 {
 260         struct IR_i2c *ir = container_of(work, struct IR_i2c, work.work);
 261
 262         ir_key_poll(ir);
 263         schedule_delayed_work(&ir->work, msecs_to_jiffies(ir->polling_interval));
 264 }
 265
 266 /* ----------------------------------------------------------------------- */
 267
 268 static int ir_probe(struct i2c_client *client, const struct i2c_device_id *id)
 269 {
 270         char *ir_codes = NULL;
 271         const char *name = NULL;
 272         u64 rc_type = RC_TYPE_UNKNOWN;
 273         struct IR_i2c *ir;
 274         struct rc_dev *rc = NULL;
 275         struct i2c_adapter *adap = client->adapter;
 276         unsigned short addr = client->addr;
 277         int err;
 278
 279         ir = kzalloc(sizeof(struct IR_i2c), GFP_KERNEL);
 280         if (!ir)
 281                 return -ENOMEM;
 282
 283         ir->c = client;
 284         ir->polling_interval = DEFAULT_POLLING_INTERVAL;
 285         i2c_set_clientdata(client, ir);
 286
 287         switch(addr) {
 288         case 0x64:
 289                 name        = "Pixelview";
 290                 ir->get_key = get_key_pixelview;
 291                 rc_type     = RC_TYPE_OTHER;
 292                 ir_codes    = RC_MAP_EMPTY;
 293                 break;
 294         case 0x18:
 295         case 0x1f:
 296         case 0x1a:
 297                 name        = "Hauppauge";
 298                 ir->get_key = get_key_haup;
 299                 rc_type     = RC_TYPE_RC5;
 300                 if (hauppauge == 1) {
 301                         ir_codes    = RC_MAP_HAUPPAUGE_NEW;
 302                 } else {
 303                         ir_codes    = RC_MAP_RC5_TV;
 304                 }
 305                 break;
 306         case 0x30:
 307                 name        = "KNC One";
 308                 ir->get_key = get_key_knc1;
 309                 rc_type     = RC_TYPE_OTHER;
 310                 ir_codes    = RC_MAP_EMPTY;
 311                 break;
 312         case 0x6b:
 313                 name        = "FusionHDTV";
 314                 ir->get_key = get_key_fusionhdtv;
 315                 rc_type     = RC_TYPE_RC5;
 316                 ir_codes    = RC_MAP_FUSIONHDTV_MCE;
 317                 break;
 318         case 0x40:
 319                 name        = "AVerMedia Cardbus remote";
 320                 ir->get_key = get_key_avermedia_cardbus;
 321                 rc_type     = RC_TYPE_OTHER;
 322                 ir_codes    = RC_MAP_AVERMEDIA_CARDBUS;
 323                 break;
 324         }
 325
 326         /* Let the caller override settings */
 327         if (client->dev.platform_data) {
 328                 const struct IR_i2c_init_data *init_data =
 329                                                 client->dev.platform_data;
 330
 331                 ir_codes = init_data->ir_codes;
 332                 rc = init_data->rc_dev;
 333
 334                 name = init_data->name;
 335                 if (init_data->type)
 336                         rc_type = init_data->type;
 337
 338                 if (init_data->polling_interval)
 339                         ir->polling_interval = init_data->polling_interval;
 340
 341                 switch (init_data->internal_get_key_func) {
 342                 case IR_KBD_GET_KEY_CUSTOM:
 343                         /* The bridge driver provided us its own function */
 344                         ir->get_key = init_data->get_key;
 345                         break;
 346                 case IR_KBD_GET_KEY_PIXELVIEW:
 347                         ir->get_key = get_key_pixelview;
 348                         break;
 349                 case IR_KBD_GET_KEY_HAUP:
 350                         ir->get_key = get_key_haup;
 351                         break;
 352                 case IR_KBD_GET_KEY_KNC1:
 353                         ir->get_key = get_key_knc1;
 354                         break;
 355                 case IR_KBD_GET_KEY_FUSIONHDTV:
 356                         ir->get_key = get_key_fusionhdtv;
 357                         break;
 358                 case IR_KBD_GET_KEY_HAUP_XVR:
 359                         ir->get_key = get_key_haup_xvr;
 360                         break;
 361                 case IR_KBD_GET_KEY_AVERMEDIA_CARDBUS:
 362                         ir->get_key = get_key_avermedia_cardbus;
 363                         break;
 364                 }
 365         }
 366
 367         if (!rc) {
 368                 /*
 369                  * If platform_data doesn't specify rc_dev, initilize it
 370                  * internally
 371                  */
 372                 rc = rc_allocate_device();
 373                 if (!rc) {
 374                         err = -ENOMEM;
 375                         goto err_out_free;
 376                 }
 377         }
 378         ir->rc = rc;
 379
 380         /* Make sure we are all setup before going on */
 381         if (!name || !ir->get_key || !rc_type || !ir_codes) {
 382                 dprintk(1, ": Unsupported device at address 0x%02x\n",
 383                         addr);
 384                 err = -ENODEV;
 385                 goto err_out_free;
 386         }
 387
 388         /* Sets name */
 389         snprintf(ir->name, sizeof(ir->name), "i2c IR (%s)", name);
 390         ir->ir_codes = ir_codes;
 391
 392         snprintf(ir->phys, sizeof(ir->phys), "%s/%s/ir0",
 393                  dev_name(&adap->dev),
 394                  dev_name(&client->dev));
 395
 396         /*
 397          * Initialize input_dev fields
 398          * It doesn't make sense to allow overriding them via platform_data
 399          */
 400         rc->input_id.bustype = BUS_I2C;
 401         rc->input_phys       = ir->phys;
 402         rc->input_name       = ir->name;
 403
 404         /*
 405          * Initialize the other fields of rc_dev
 406          */
 407         rc->map_name       = ir->ir_codes;
 408         rc->allowed_protos = rc_type;
 409         if (!rc->driver_name)
 410                 rc->driver_name = MODULE_NAME;
 411
 412         err = rc_register_device(rc);
 413         if (err)
 414                 goto err_out_free;
 415
 416         printk(MODULE_NAME ": %s detected at %s [%s]\n",
 417                ir->name, ir->phys, adap->name);
 418
 419         /* start polling via eventd */
 420         INIT_DELAYED_WORK(&ir->work, ir_work);
 421         schedule_delayed_work(&ir->work, 0);
 422
 423         return 0;
 424
 425  err_out_free:
 426         /* Only frees rc if it were allocated internally */
 427         rc_free_device(rc);
 428         kfree(ir);
 429         return err;
 430 }
 431
 432 static int ir_remove(struct i2c_client *client)
 433 {
 434         struct IR_i2c *ir = i2c_get_clientdata(client);
 435
 436         /* kill outstanding polls */
 437         cancel_delayed_work_sync(&ir->work);
 438
 439         /* unregister device */
 440         rc_unregister_device(ir->rc);
 441
 442         /* free memory */
 443         kfree(ir);
 444         return 0;
 445 }
 446
 447 static const struct i2c_device_id ir_kbd_id[] = {
 448         /* Generic entry for any IR receiver */
 449         { "ir_video", 0 },
 450         /* IR device specific entries should be added here */
 451         { "ir_rx_z8f0811_haup", 0 },
 452         { "ir_rx_z8f0811_hdpvr", 0 },
 453         { }
 454 };
 455
 456 static struct i2c_driver driver = {
 457         .driver = {
 458                 .name   = "ir-kbd-i2c",
 459         },
 460         .probe          = ir_probe,
 461         .remove         = ir_remove,
 462         .id_table       = ir_kbd_id,
 463 };
 464
 465 /* ----------------------------------------------------------------------- */
 466
 467 MODULE_AUTHOR("Gerd Knorr, Michal Kochanowicz, Christoph Bartelmus, Ulrich Mueller");
 468 MODULE_DESCRIPTION("input driver for i2c IR remote controls");
 469 MODULE_LICENSE("GPL");
 470
 471 static int __init ir_init(void)
 472 {
 473         return i2c_add_driver(&driver);
 474 }
 475
 476 static void __exit ir_fini(void)
 477 {
 478         i2c_del_driver(&driver);
 479 }
 480
 481 module_init(ir_init);
 482 module_exit(ir_fini);
 483
 484 /*
 485  * Overrides for Emacs so that we follow Linus's tabbing style.
 486  * ---------------------------------------------------------------------------
 487  * Local variables:
 488  * c-basic-offset: 8
 489  * End:
 490  */