drivers/media/usb/em28xx/em28xx-core.c

   1 /*
   2    em28xx-core.c - driver for Empia EM2800/EM2820/2840 USB video capture devices
   3
   4    Copyright (C) 2005 Ludovico Cavedon <cavedon@sssup.it>
   5                       Markus Rechberger <mrechberger@gmail.com>
   6                       Mauro Carvalho Chehab <mchehab@infradead.org>
   7                       Sascha Sommer <saschasommer@freenet.de>
   8    Copyright (C) 2012 Frank Schäfer <fschaefer.oss@googlemail.com>
   9
  10    This program is free software; you can redistribute it and/or modify
  11    it under the terms of the GNU General Public License as published by
  12    the Free Software Foundation; either version 2 of the License, or
  13    (at your option) any later version.
  14
  15    This program is distributed in the hope that it will be useful,
  16    but WITHOUT ANY WARRANTY; without even the implied warranty of
  17    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18    GNU General Public License for more details.
  19
  20    You should have received a copy of the GNU General Public License
  21    along with this program; if not, write to the Free Software
  22    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  23  */
  24
  25 #include <linux/init.h>
  26 #include <linux/jiffies.h>
  27 #include <linux/list.h>
  28 #include <linux/module.h>
  29 #include <linux/slab.h>
  30 #include <linux/usb.h>
  31 #include <linux/vmalloc.h>
  32 #include <sound/ac97_codec.h>
  33 #include <media/v4l2-common.h>
  34
  35 #include "em28xx.h"
  36
  37 #define DRIVER_AUTHOR "Ludovico Cavedon <cavedon@sssup.it>, " \
  38                       "Markus Rechberger <mrechberger@gmail.com>, " \
  39                       "Mauro Carvalho Chehab <mchehab@infradead.org>, " \
  40                       "Sascha Sommer <saschasommer@freenet.de>"
  41
  42 MODULE_AUTHOR(DRIVER_AUTHOR);
  43 MODULE_DESCRIPTION(DRIVER_DESC);
  44 MODULE_LICENSE("GPL");
  45 MODULE_VERSION(EM28XX_VERSION);
  46
  47 /* #define ENABLE_DEBUG_ISOC_FRAMES */
  48
  49 static unsigned int core_debug;
  50 module_param(core_debug, int, 0644);
  51 MODULE_PARM_DESC(core_debug, "enable debug messages [core]");
  52
  53 #define em28xx_coredbg(fmt, arg...) do {\
  54         if (core_debug) \
  55                 printk(KERN_INFO "%s %s :"fmt, \
  56                          dev->name, __func__ , ##arg); } while (0)
  57
  58 static unsigned int reg_debug;
  59 module_param(reg_debug, int, 0644);
  60 MODULE_PARM_DESC(reg_debug, "enable debug messages [URB reg]");
  61
  62 #define em28xx_regdbg(fmt, arg...) do {\
  63         if (reg_debug) \
  64                 printk(KERN_INFO "%s %s :"fmt, \
  65                          dev->name, __func__ , ##arg); } while (0)
  66
  67 /* FIXME */
  68 #define em28xx_isocdbg(fmt, arg...) do {\
  69         if (core_debug) \
  70                 printk(KERN_INFO "%s %s :"fmt, \
  71                          dev->name, __func__ , ##arg); } while (0)
  72
  73 /*
  74  * em28xx_read_reg_req()
  75  * reads data from the usb device specifying bRequest
  76  */
  77 int em28xx_read_reg_req_len(struct em28xx *dev, u8 req, u16 reg,
  78                                    char *buf, int len)
  79 {
  80         int ret;
  81         int pipe = usb_rcvctrlpipe(dev->udev, 0);
  82
  83         if (dev->disconnected)
  84                 return -ENODEV;
  85
  86         if (len > URB_MAX_CTRL_SIZE)
  87                 return -EINVAL;
  88
  89         if (reg_debug) {
  90                 printk(KERN_DEBUG "(pipe 0x%08x): "
  91                         "IN:  %02x %02x %02x %02x %02x %02x %02x %02x ",
  92                         pipe,
  93                         USB_DIR_IN | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
  94                         req, 0, 0,
  95                         reg & 0xff, reg >> 8,
  96                         len & 0xff, len >> 8);
  97         }
  98
  99         mutex_lock(&dev->ctrl_urb_lock);
 100         ret = usb_control_msg(dev->udev, pipe, req,
 101                               USB_DIR_IN | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
 102                               0x0000, reg, dev->urb_buf, len, HZ);
 103         if (ret < 0) {
 104                 if (reg_debug)
 105                         printk(" failed!\n");
 106                 mutex_unlock(&dev->ctrl_urb_lock);
 107                 return usb_translate_errors(ret);
 108         }
 109
 110         if (len)
 111                 memcpy(buf, dev->urb_buf, len);
 112
 113         mutex_unlock(&dev->ctrl_urb_lock);
 114
 115         if (reg_debug) {
 116                 int byte;
 117
 118                 printk("<<<");
 119                 for (byte = 0; byte < len; byte++)
 120                         printk(" %02x", (unsigned char)buf[byte]);
 121                 printk("\n");
 122         }
 123
 124         return ret;
 125 }
 126
 127 /*
 128  * em28xx_read_reg_req()
 129  * reads data from the usb device specifying bRequest
 130  */
 131 int em28xx_read_reg_req(struct em28xx *dev, u8 req, u16 reg)
 132 {
 133         int ret;
 134         u8 val;
 135
 136         ret = em28xx_read_reg_req_len(dev, req, reg, &val, 1);
 137         if (ret < 0)
 138                 return ret;
 139
 140         return val;
 141 }
 142
 143 int em28xx_read_reg(struct em28xx *dev, u16 reg)
 144 {
 145         return em28xx_read_reg_req(dev, USB_REQ_GET_STATUS, reg);
 146 }
 147 EXPORT_SYMBOL_GPL(em28xx_read_reg);
 148
 149 /*
 150  * em28xx_write_regs_req()
 151  * sends data to the usb device, specifying bRequest
 152  */
 153 int em28xx_write_regs_req(struct em28xx *dev, u8 req, u16 reg, char *buf,
 154                                  int len)
 155 {
 156         int ret;
 157         int pipe = usb_sndctrlpipe(dev->udev, 0);
 158
 159         if (dev->disconnected)
 160                 return -ENODEV;
 161
 162         if ((len < 1) || (len > URB_MAX_CTRL_SIZE))
 163                 return -EINVAL;
 164
 165         if (reg_debug) {
 166                 int byte;
 167
 168                 printk(KERN_DEBUG "(pipe 0x%08x): "
 169                         "OUT: %02x %02x %02x %02x %02x %02x %02x %02x >>>",
 170                         pipe,
 171                         USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
 172                         req, 0, 0,
 173                         reg & 0xff, reg >> 8,
 174                         len & 0xff, len >> 8);
 175
 176                 for (byte = 0; byte < len; byte++)
 177                         printk(" %02x", (unsigned char)buf[byte]);
 178                 printk("\n");
 179         }
 180
 181         mutex_lock(&dev->ctrl_urb_lock);
 182         memcpy(dev->urb_buf, buf, len);
 183         ret = usb_control_msg(dev->udev, pipe, req,
 184                               USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
 185                               0x0000, reg, dev->urb_buf, len, HZ);
 186         mutex_unlock(&dev->ctrl_urb_lock);
 187
 188         if (ret < 0)
 189                 return usb_translate_errors(ret);
 190
 191         if (dev->wait_after_write)
 192                 msleep(dev->wait_after_write);
 193
 194         return ret;
 195 }
 196
 197 int em28xx_write_regs(struct em28xx *dev, u16 reg, char *buf, int len)
 198 {
 199         return em28xx_write_regs_req(dev, USB_REQ_GET_STATUS, reg, buf, len);
 200 }
 201 EXPORT_SYMBOL_GPL(em28xx_write_regs);
 202
 203 /* Write a single register */
 204 int em28xx_write_reg(struct em28xx *dev, u16 reg, u8 val)
 205 {
 206         return em28xx_write_regs(dev, reg, &val, 1);
 207 }
 208 EXPORT_SYMBOL_GPL(em28xx_write_reg);
 209
 210 /*
 211  * em28xx_write_reg_bits()
 212  * sets only some bits (specified by bitmask) of a register, by first reading
 213  * the actual value
 214  */
 215 int em28xx_write_reg_bits(struct em28xx *dev, u16 reg, u8 val,
 216                                  u8 bitmask)
 217 {
 218         int oldval;
 219         u8 newval;
 220
 221         oldval = em28xx_read_reg(dev, reg);
 222         if (oldval < 0)
 223                 return oldval;
 224
 225         newval = (((u8) oldval) & ~bitmask) | (val & bitmask);
 226
 227         return em28xx_write_regs(dev, reg, &newval, 1);
 228 }
 229 EXPORT_SYMBOL_GPL(em28xx_write_reg_bits);
 230
 231 /*
 232  * em28xx_toggle_reg_bits()
 233  * toggles/inverts the bits (specified by bitmask) of a register
 234  */
 235 int em28xx_toggle_reg_bits(struct em28xx *dev, u16 reg, u8 bitmask)
 236 {
 237         int oldval;
 238         u8 newval;
 239
 240         oldval = em28xx_read_reg(dev, reg);
 241         if (oldval < 0)
 242                 return oldval;
 243
 244         newval = (~oldval & bitmask) | (oldval & ~bitmask);
 245
 246         return em28xx_write_reg(dev, reg, newval);
 247 }
 248 EXPORT_SYMBOL_GPL(em28xx_toggle_reg_bits);
 249
 250 /*
 251  * em28xx_is_ac97_ready()
 252  * Checks if ac97 is ready
 253  */
 254 static int em28xx_is_ac97_ready(struct em28xx *dev)
 255 {
 256         unsigned long timeout = jiffies + msecs_to_jiffies(EM28XX_AC97_XFER_TIMEOUT);
 257         int ret;
 258
 259         /* Wait up to 50 ms for AC97 command to complete */
 260         while (time_is_after_jiffies(timeout)) {
 261                 ret = em28xx_read_reg(dev, EM28XX_R43_AC97BUSY);
 262                 if (ret < 0)
 263                         return ret;
 264
 265                 if (!(ret & 0x01))
 266                         return 0;
 267                 msleep(5);
 268         }
 269
 270         em28xx_warn("AC97 command still being executed: not handled properly!\n");
 271         return -EBUSY;
 272 }
 273
 274 /*
 275  * em28xx_read_ac97()
 276  * write a 16 bit value to the specified AC97 address (LSB first!)
 277  */
 278 int em28xx_read_ac97(struct em28xx *dev, u8 reg)
 279 {
 280         int ret;
 281         u8 addr = (reg & 0x7f) | 0x80;
 282         u16 val;
 283
 284         ret = em28xx_is_ac97_ready(dev);
 285         if (ret < 0)
 286                 return ret;
 287
 288         ret = em28xx_write_regs(dev, EM28XX_R42_AC97ADDR, &addr, 1);
 289         if (ret < 0)
 290                 return ret;
 291
 292         ret = dev->em28xx_read_reg_req_len(dev, 0, EM28XX_R40_AC97LSB,
 293                                            (u8 *)&val, sizeof(val));
 294
 295         if (ret < 0)
 296                 return ret;
 297         return le16_to_cpu(val);
 298 }
 299 EXPORT_SYMBOL_GPL(em28xx_read_ac97);
 300
 301 /*
 302  * em28xx_write_ac97()
 303  * write a 16 bit value to the specified AC97 address (LSB first!)
 304  */
 305 int em28xx_write_ac97(struct em28xx *dev, u8 reg, u16 val)
 306 {
 307         int ret;
 308         u8 addr = reg & 0x7f;
 309         __le16 value;
 310
 311         value = cpu_to_le16(val);
 312
 313         ret = em28xx_is_ac97_ready(dev);
 314         if (ret < 0)
 315                 return ret;
 316
 317         ret = em28xx_write_regs(dev, EM28XX_R40_AC97LSB, (u8 *) &value, 2);
 318         if (ret < 0)
 319                 return ret;
 320
 321         ret = em28xx_write_regs(dev, EM28XX_R42_AC97ADDR, &addr, 1);
 322         if (ret < 0)
 323                 return ret;
 324
 325         return 0;
 326 }
 327 EXPORT_SYMBOL_GPL(em28xx_write_ac97);
 328
 329 struct em28xx_vol_itable {
 330         enum em28xx_amux mux;
 331         u8               reg;
 332 };
 333
 334 static struct em28xx_vol_itable inputs[] = {
 335         { EM28XX_AMUX_VIDEO,    AC97_VIDEO      },
 336         { EM28XX_AMUX_LINE_IN,  AC97_LINE       },
 337         { EM28XX_AMUX_PHONE,    AC97_PHONE      },
 338         { EM28XX_AMUX_MIC,      AC97_MIC        },
 339         { EM28XX_AMUX_CD,       AC97_CD         },
 340         { EM28XX_AMUX_AUX,      AC97_AUX        },
 341         { EM28XX_AMUX_PCM_OUT,  AC97_PCM        },
 342 };
 343
 344 static int set_ac97_input(struct em28xx *dev)
 345 {
 346         int ret, i;
 347         enum em28xx_amux amux = dev->ctl_ainput;
 348
 349         /* EM28XX_AMUX_VIDEO2 is a special case used to indicate that
 350            em28xx should point to LINE IN, while AC97 should use VIDEO
 351          */
 352         if (amux == EM28XX_AMUX_VIDEO2)
 353                 amux = EM28XX_AMUX_VIDEO;
 354
 355         /* Mute all entres but the one that were selected */
 356         for (i = 0; i < ARRAY_SIZE(inputs); i++) {
 357                 if (amux == inputs[i].mux)
 358                         ret = em28xx_write_ac97(dev, inputs[i].reg, 0x0808);
 359                 else
 360                         ret = em28xx_write_ac97(dev, inputs[i].reg, 0x8000);
 361
 362                 if (ret < 0)
 363                         em28xx_warn("couldn't setup AC97 register %d\n",
 364                                      inputs[i].reg);
 365         }
 366         return 0;
 367 }
 368
 369 static int em28xx_set_audio_source(struct em28xx *dev)
 370 {
 371         int ret;
 372         u8 input;
 373
 374         if (dev->board.is_em2800) {
 375                 if (dev->ctl_ainput == EM28XX_AMUX_VIDEO)
 376                         input = EM2800_AUDIO_SRC_TUNER;
 377                 else
 378                         input = EM2800_AUDIO_SRC_LINE;
 379
 380                 ret = em28xx_write_regs(dev, EM2800_R08_AUDIOSRC, &input, 1);
 381                 if (ret < 0)
 382                         return ret;
 383         }
 384
 385         if (dev->board.has_msp34xx)
 386                 input = EM28XX_AUDIO_SRC_TUNER;
 387         else {
 388                 switch (dev->ctl_ainput) {
 389                 case EM28XX_AMUX_VIDEO:
 390                         input = EM28XX_AUDIO_SRC_TUNER;
 391                         break;
 392                 default:
 393                         input = EM28XX_AUDIO_SRC_LINE;
 394                         break;
 395                 }
 396         }
 397
 398         if (dev->board.mute_gpio && dev->mute)
 399                 em28xx_gpio_set(dev, dev->board.mute_gpio);
 400         else
 401                 em28xx_gpio_set(dev, INPUT(dev->ctl_input)->gpio);
 402
 403         ret = em28xx_write_reg_bits(dev, EM28XX_R0E_AUDIOSRC, input, 0xc0);
 404         if (ret < 0)
 405                 return ret;
 406         msleep(5);
 407
 408         switch (dev->audio_mode.ac97) {
 409         case EM28XX_NO_AC97:
 410                 break;
 411         default:
 412                 ret = set_ac97_input(dev);
 413         }
 414
 415         return ret;
 416 }
 417
 418 struct em28xx_vol_otable {
 419         enum em28xx_aout mux;
 420         u8               reg;
 421 };
 422
 423 static const struct em28xx_vol_otable outputs[] = {
 424         { EM28XX_AOUT_MASTER, AC97_MASTER               },
 425         { EM28XX_AOUT_LINE,   AC97_HEADPHONE            },
 426         { EM28XX_AOUT_MONO,   AC97_MASTER_MONO          },
 427         { EM28XX_AOUT_LFE,    AC97_CENTER_LFE_MASTER    },
 428         { EM28XX_AOUT_SURR,   AC97_SURROUND_MASTER      },
 429 };
 430
 431 int em28xx_audio_analog_set(struct em28xx *dev)
 432 {
 433         int ret, i;
 434         u8 xclk;
 435
 436         if (!dev->audio_mode.has_audio)
 437                 return 0;
 438
 439         /* It is assumed that all devices use master volume for output.
 440            It would be possible to use also line output.
 441          */
 442         if (dev->audio_mode.ac97 != EM28XX_NO_AC97) {
 443                 /* Mute all outputs */
 444                 for (i = 0; i < ARRAY_SIZE(outputs); i++) {
 445                         ret = em28xx_write_ac97(dev, outputs[i].reg, 0x8000);
 446                         if (ret < 0)
 447                                 em28xx_warn("couldn't setup AC97 register %d\n",
 448                                      outputs[i].reg);
 449                 }
 450         }
 451
 452         xclk = dev->board.xclk & 0x7f;
 453         if (!dev->mute)
 454                 xclk |= EM28XX_XCLK_AUDIO_UNMUTE;
 455
 456         ret = em28xx_write_reg(dev, EM28XX_R0F_XCLK, xclk);
 457         if (ret < 0)
 458                 return ret;
 459         msleep(10);
 460
 461         /* Selects the proper audio input */
 462         ret = em28xx_set_audio_source(dev);
 463
 464         /* Sets volume */
 465         if (dev->audio_mode.ac97 != EM28XX_NO_AC97) {
 466                 int vol;
 467
 468                 em28xx_write_ac97(dev, AC97_POWERDOWN, 0x4200);
 469                 em28xx_write_ac97(dev, AC97_EXTENDED_STATUS, 0x0031);
 470                 em28xx_write_ac97(dev, AC97_PCM_LR_ADC_RATE, 0xbb80);
 471
 472                 /* LSB: left channel - both channels with the same level */
 473                 vol = (0x1f - dev->volume) | ((0x1f - dev->volume) << 8);
 474
 475                 /* Mute device, if needed */
 476                 if (dev->mute)
 477                         vol |= 0x8000;
 478
 479                 /* Sets volume */
 480                 for (i = 0; i < ARRAY_SIZE(outputs); i++) {
 481                         if (dev->ctl_aoutput & outputs[i].mux)
 482                                 ret = em28xx_write_ac97(dev, outputs[i].reg,
 483                                                         vol);
 484                         if (ret < 0)
 485                                 em28xx_warn("couldn't setup AC97 register %d\n",
 486                                      outputs[i].reg);
 487                 }
 488
 489                 if (dev->ctl_aoutput & EM28XX_AOUT_PCM_IN) {
 490                         int sel = ac97_return_record_select(dev->ctl_aoutput);
 491
 492                         /* Use the same input for both left and right
 493                            channels */
 494                         sel |= (sel << 8);
 495
 496                         em28xx_write_ac97(dev, AC97_REC_SEL, sel);
 497                 }
 498         }
 499
 500         return ret;
 501 }
 502 EXPORT_SYMBOL_GPL(em28xx_audio_analog_set);
 503
 504 int em28xx_audio_setup(struct em28xx *dev)
 505 {
 506         int vid1, vid2, feat, cfg;
 507         u32 vid;
 508
 509         if (dev->chip_id == CHIP_ID_EM2870 ||
 510             dev->chip_id == CHIP_ID_EM2874 ||
 511             dev->chip_id == CHIP_ID_EM28174 ||
 512             dev->chip_id == CHIP_ID_EM28178) {
 513                 /* Digital only device - don't load any alsa module */
 514                 dev->audio_mode.has_audio = false;
 515                 dev->has_audio_class = false;
 516                 dev->has_alsa_audio = false;
 517                 return 0;
 518         }
 519
 520         dev->audio_mode.has_audio = true;
 521
 522         /* See how this device is configured */
 523         cfg = em28xx_read_reg(dev, EM28XX_R00_CHIPCFG);
 524         em28xx_info("Config register raw data: 0x%02x\n", cfg);
 525         if (cfg < 0) {
 526                 /* Register read error?  */
 527                 cfg = EM28XX_CHIPCFG_AC97; /* Be conservative */
 528         } else if ((cfg & EM28XX_CHIPCFG_AUDIOMASK) == 0x00) {
 529                 /* The device doesn't have vendor audio at all */
 530                 dev->has_alsa_audio = false;
 531                 dev->audio_mode.has_audio = false;
 532                 return 0;
 533         } else if ((cfg & EM28XX_CHIPCFG_AUDIOMASK) != EM28XX_CHIPCFG_AC97) {
 534                 if (dev->chip_id < CHIP_ID_EM2860 &&
 535                     (cfg & EM28XX_CHIPCFG_AUDIOMASK) ==
 536                     EM2820_CHIPCFG_I2S_1_SAMPRATE)
 537                         dev->audio_mode.i2s_samplerates = 1;
 538                 else if (dev->chip_id >= CHIP_ID_EM2860 &&
 539                          (cfg & EM28XX_CHIPCFG_AUDIOMASK) ==
 540                          EM2860_CHIPCFG_I2S_5_SAMPRATES)
 541                         dev->audio_mode.i2s_samplerates = 5;
 542                 else
 543                         dev->audio_mode.i2s_samplerates = 3;
 544                 em28xx_info("I2S Audio (%d sample rate(s))\n",
 545                                                dev->audio_mode.i2s_samplerates);
 546                 /* Skip the code that does AC97 vendor detection */
 547                 dev->audio_mode.ac97 = EM28XX_NO_AC97;
 548                 goto init_audio;
 549         }
 550
 551         dev->audio_mode.ac97 = EM28XX_AC97_OTHER;
 552
 553         vid1 = em28xx_read_ac97(dev, AC97_VENDOR_ID1);
 554         if (vid1 < 0) {
 555                 /*
 556                  * Device likely doesn't support AC97
 557                  * Note: (some) em2800 devices without eeprom reports 0x91 on
 558                  *       CHIPCFG register, even not having an AC97 chip
 559                  */
 560                 em28xx_warn("AC97 chip type couldn't be determined\n");
 561                 dev->audio_mode.ac97 = EM28XX_NO_AC97;
 562                 dev->has_alsa_audio = false;
 563                 dev->audio_mode.has_audio = false;
 564                 goto init_audio;
 565         }
 566
 567         vid2 = em28xx_read_ac97(dev, AC97_VENDOR_ID2);
 568         if (vid2 < 0)
 569                 goto init_audio;
 570
 571         vid = vid1 << 16 | vid2;
 572
 573         dev->audio_mode.ac97_vendor_id = vid;
 574         em28xx_warn("AC97 vendor ID = 0x%08x\n", vid);
 575
 576         feat = em28xx_read_ac97(dev, AC97_RESET);
 577         if (feat < 0)
 578                 goto init_audio;
 579
 580         dev->audio_mode.ac97_feat = feat;
 581         em28xx_warn("AC97 features = 0x%04x\n", feat);
 582
 583         /* Try to identify what audio processor we have */
 584         if (((vid == 0xffffffff) || (vid == 0x83847650)) && (feat == 0x6a90))
 585                 dev->audio_mode.ac97 = EM28XX_AC97_EM202;
 586         else if ((vid >> 8) == 0x838476)
 587                 dev->audio_mode.ac97 = EM28XX_AC97_SIGMATEL;
 588
 589 init_audio:
 590         /* Reports detected AC97 processor */
 591         switch (dev->audio_mode.ac97) {
 592         case EM28XX_NO_AC97:
 593                 em28xx_info("No AC97 audio processor\n");
 594                 break;
 595         case EM28XX_AC97_EM202:
 596                 em28xx_info("Empia 202 AC97 audio processor detected\n");
 597                 break;
 598         case EM28XX_AC97_SIGMATEL:
 599                 em28xx_info("Sigmatel audio processor detected(stac 97%02x)\n",
 600                             dev->audio_mode.ac97_vendor_id & 0xff);
 601                 break;
 602         case EM28XX_AC97_OTHER:
 603                 em28xx_warn("Unknown AC97 audio processor detected!\n");
 604                 break;
 605         default:
 606                 break;
 607         }
 608
 609         return em28xx_audio_analog_set(dev);
 610 }
 611 EXPORT_SYMBOL_GPL(em28xx_audio_setup);
 612
 613 const struct em28xx_led *em28xx_find_led(struct em28xx *dev,
 614                                          enum em28xx_led_role role)
 615 {
 616         if (dev->board.leds) {
 617                 u8 k = 0;
 618                 while (dev->board.leds[k].role >= 0 &&
 619                                dev->board.leds[k].role < EM28XX_NUM_LED_ROLES) {
 620                         if (dev->board.leds[k].role == role)
 621                                 return &dev->board.leds[k];
 622                         k++;
 623                 }
 624         }
 625         return NULL;
 626 }
 627 EXPORT_SYMBOL_GPL(em28xx_find_led);
 628
 629 int em28xx_capture_start(struct em28xx *dev, int start)
 630 {
 631         int rc;
 632
 633         if (dev->chip_id == CHIP_ID_EM2874 ||
 634             dev->chip_id == CHIP_ID_EM2884 ||
 635             dev->chip_id == CHIP_ID_EM28174 ||
 636             dev->chip_id == CHIP_ID_EM28178) {
 637                 /* The Transport Stream Enable Register moved in em2874 */
 638                 rc = em28xx_write_reg_bits(dev, EM2874_R5F_TS_ENABLE,
 639                                            start ?
 640                                                EM2874_TS1_CAPTURE_ENABLE : 0x00,
 641                                            EM2874_TS1_CAPTURE_ENABLE);
 642         } else {
 643                 /* FIXME: which is the best order? */
 644                 /* video registers are sampled by VREF */
 645                 rc = em28xx_write_reg_bits(dev, EM28XX_R0C_USBSUSP,
 646                                            start ? 0x10 : 0x00, 0x10);
 647                 if (rc < 0)
 648                         return rc;
 649
 650                 if (start) {
 651                         if (dev->board.is_webcam)
 652                                 rc = em28xx_write_reg(dev, 0x13, 0x0c);
 653
 654                         /* Enable video capture */
 655                         rc = em28xx_write_reg(dev, 0x48, 0x00);
 656
 657                         if (dev->mode == EM28XX_ANALOG_MODE)
 658                                 rc = em28xx_write_reg(dev,
 659                                                     EM28XX_R12_VINENABLE, 0x67);
 660                         else
 661                                 rc = em28xx_write_reg(dev,
 662                                                     EM28XX_R12_VINENABLE, 0x37);
 663
 664                         msleep(6);
 665                 } else {
 666                         /* disable video capture */
 667                         rc = em28xx_write_reg(dev, EM28XX_R12_VINENABLE, 0x27);
 668                 }
 669         }
 670
 671         if (rc < 0)
 672                 return rc;
 673
 674         /* Switch (explicitly controlled) analog capturing LED on/off */
 675         if (dev->mode == EM28XX_ANALOG_MODE) {
 676                 const struct em28xx_led *led;
 677                 led = em28xx_find_led(dev, EM28XX_LED_ANALOG_CAPTURING);
 678                 if (led)
 679                         em28xx_write_reg_bits(dev, led->gpio_reg,
 680                                               (!start ^ led->inverted) ?
 681                                               ~led->gpio_mask : led->gpio_mask,
 682                                               led->gpio_mask);
 683         }
 684
 685         return rc;
 686 }
 687
 688 int em28xx_gpio_set(struct em28xx *dev, struct em28xx_reg_seq *gpio)
 689 {
 690         int rc = 0;
 691
 692         if (!gpio)
 693                 return rc;
 694
 695         if (dev->mode != EM28XX_SUSPEND) {
 696                 em28xx_write_reg(dev, 0x48, 0x00);
 697                 if (dev->mode == EM28XX_ANALOG_MODE)
 698                         em28xx_write_reg(dev, EM28XX_R12_VINENABLE, 0x67);
 699                 else
 700                         em28xx_write_reg(dev, EM28XX_R12_VINENABLE, 0x37);
 701                 msleep(6);
 702         }
 703
 704         /* Send GPIO reset sequences specified at board entry */
 705         while (gpio->sleep >= 0) {
 706                 if (gpio->reg >= 0) {
 707                         rc = em28xx_write_reg_bits(dev,
 708                                                    gpio->reg,
 709                                                    gpio->val,
 710                                                    gpio->mask);
 711                         if (rc < 0)
 712                                 return rc;
 713                 }
 714                 if (gpio->sleep > 0)
 715                         msleep(gpio->sleep);
 716
 717                 gpio++;
 718         }
 719         return rc;
 720 }
 721 EXPORT_SYMBOL_GPL(em28xx_gpio_set);
 722
 723 int em28xx_set_mode(struct em28xx *dev, enum em28xx_mode set_mode)
 724 {
 725         if (dev->mode == set_mode)
 726                 return 0;
 727
 728         if (set_mode == EM28XX_SUSPEND) {
 729                 dev->mode = set_mode;
 730
 731                 /* FIXME: add suspend support for ac97 */
 732
 733                 return em28xx_gpio_set(dev, dev->board.suspend_gpio);
 734         }
 735
 736         dev->mode = set_mode;
 737
 738         if (dev->mode == EM28XX_DIGITAL_MODE)
 739                 return em28xx_gpio_set(dev, dev->board.dvb_gpio);
 740         else
 741                 return em28xx_gpio_set(dev, INPUT(dev->ctl_input)->gpio);
 742 }
 743 EXPORT_SYMBOL_GPL(em28xx_set_mode);
 744
 745 /* ------------------------------------------------------------------
 746         URB control
 747    ------------------------------------------------------------------*/
 748
 749 /*
 750  * URB completion handler for isoc/bulk transfers
 751  */
 752 static void em28xx_irq_callback(struct urb *urb)
 753 {
 754         struct em28xx *dev = urb->context;
 755         int i;
 756
 757         switch (urb->status) {
 758         case 0:             /* success */
 759         case -ETIMEDOUT:    /* NAK */
 760                 break;
 761         case -ECONNRESET:   /* kill */
 762         case -ENOENT:
 763         case -ESHUTDOWN:
 764                 return;
 765         default:            /* error */
 766                 em28xx_isocdbg("urb completition error %d.\n", urb->status);
 767                 break;
 768         }
 769
 770         /* Copy data from URB */
 771         spin_lock(&dev->slock);
 772         dev->usb_ctl.urb_data_copy(dev, urb);
 773         spin_unlock(&dev->slock);
 774
 775         /* Reset urb buffers */
 776         for (i = 0; i < urb->number_of_packets; i++) {
 777                 /* isoc only (bulk: number_of_packets = 0) */
 778                 urb->iso_frame_desc[i].status = 0;
 779                 urb->iso_frame_desc[i].actual_length = 0;
 780         }
 781         urb->status = 0;
 782
 783         urb->status = usb_submit_urb(urb, GFP_ATOMIC);
 784         if (urb->status) {
 785                 em28xx_isocdbg("urb resubmit failed (error=%i)\n",
 786                                urb->status);
 787         }
 788 }
 789
 790 /*
 791  * Stop and Deallocate URBs
 792  */
 793 void em28xx_uninit_usb_xfer(struct em28xx *dev, enum em28xx_mode mode)
 794 {
 795         struct urb *urb;
 796         struct em28xx_usb_bufs *usb_bufs;
 797         int i;
 798
 799         em28xx_isocdbg("em28xx: called em28xx_uninit_usb_xfer in mode %d\n",
 800                        mode);
 801
 802         if (mode == EM28XX_DIGITAL_MODE)
 803                 usb_bufs = &dev->usb_ctl.digital_bufs;
 804         else
 805                 usb_bufs = &dev->usb_ctl.analog_bufs;
 806
 807         for (i = 0; i < usb_bufs->num_bufs; i++) {
 808                 urb = usb_bufs->urb[i];
 809                 if (urb) {
 810                         if (!irqs_disabled())
 811                                 usb_kill_urb(urb);
 812                         else
 813                                 usb_unlink_urb(urb);
 814
 815                         if (usb_bufs->transfer_buffer[i]) {
 816                                 usb_free_coherent(dev->udev,
 817                                         urb->transfer_buffer_length,
 818                                         usb_bufs->transfer_buffer[i],
 819                                         urb->transfer_dma);
 820                         }
 821                         usb_free_urb(urb);
 822                         usb_bufs->urb[i] = NULL;
 823                 }
 824                 usb_bufs->transfer_buffer[i] = NULL;
 825         }
 826
 827         kfree(usb_bufs->urb);
 828         kfree(usb_bufs->transfer_buffer);
 829
 830         usb_bufs->urb = NULL;
 831         usb_bufs->transfer_buffer = NULL;
 832         usb_bufs->num_bufs = 0;
 833
 834         em28xx_capture_start(dev, 0);
 835 }
 836 EXPORT_SYMBOL_GPL(em28xx_uninit_usb_xfer);
 837
 838 /*
 839  * Stop URBs
 840  */
 841 void em28xx_stop_urbs(struct em28xx *dev)
 842 {
 843         int i;
 844         struct urb *urb;
 845         struct em28xx_usb_bufs *isoc_bufs = &dev->usb_ctl.digital_bufs;
 846
 847         em28xx_isocdbg("em28xx: called em28xx_stop_urbs\n");
 848
 849         for (i = 0; i < isoc_bufs->num_bufs; i++) {
 850                 urb = isoc_bufs->urb[i];
 851                 if (urb) {
 852                         if (!irqs_disabled())
 853                                 usb_kill_urb(urb);
 854                         else
 855                                 usb_unlink_urb(urb);
 856                 }
 857         }
 858
 859         em28xx_capture_start(dev, 0);
 860 }
 861 EXPORT_SYMBOL_GPL(em28xx_stop_urbs);
 862
 863 /*
 864  * Allocate URBs
 865  */
 866 int em28xx_alloc_urbs(struct em28xx *dev, enum em28xx_mode mode, int xfer_bulk,
 867                       int num_bufs, int max_pkt_size, int packet_multiplier)
 868 {
 869         struct em28xx_usb_bufs *usb_bufs;
 870         int i;
 871         int sb_size, pipe;
 872         struct urb *urb;
 873         int j, k;
 874
 875         em28xx_isocdbg("em28xx: called em28xx_alloc_isoc in mode %d\n", mode);
 876
 877         /* Check mode and if we have an endpoint for the selected
 878            transfer type, select buffer                          */
 879         if (mode == EM28XX_DIGITAL_MODE) {
 880                 if ((xfer_bulk && !dev->dvb_ep_bulk) ||
 881                     (!xfer_bulk && !dev->dvb_ep_isoc)) {
 882                         em28xx_errdev("no endpoint for DVB mode and transfer type %d\n",
 883                                       xfer_bulk > 0);
 884                         return -EINVAL;
 885                 }
 886                 usb_bufs = &dev->usb_ctl.digital_bufs;
 887         } else if (mode == EM28XX_ANALOG_MODE) {
 888                 if ((xfer_bulk && !dev->analog_ep_bulk) ||
 889                     (!xfer_bulk && !dev->analog_ep_isoc)) {
 890                         em28xx_errdev("no endpoint for analog mode and transfer type %d\n",
 891                                        xfer_bulk > 0);
 892                         return -EINVAL;
 893                 }
 894                 usb_bufs = &dev->usb_ctl.analog_bufs;
 895         } else {
 896                 em28xx_errdev("invalid mode selected\n");
 897                 return -EINVAL;
 898         }
 899
 900         /* De-allocates all pending stuff */
 901         em28xx_uninit_usb_xfer(dev, mode);
 902
 903         usb_bufs->num_bufs = num_bufs;
 904
 905         usb_bufs->urb = kzalloc(sizeof(void *)*num_bufs,  GFP_KERNEL);
 906         if (!usb_bufs->urb) {
 907                 em28xx_errdev("cannot alloc memory for usb buffers\n");
 908                 return -ENOMEM;
 909         }
 910
 911         usb_bufs->transfer_buffer = kzalloc(sizeof(void *)*num_bufs,
 912                                              GFP_KERNEL);
 913         if (!usb_bufs->transfer_buffer) {
 914                 em28xx_errdev("cannot allocate memory for usb transfer\n");
 915                 kfree(usb_bufs->urb);
 916                 return -ENOMEM;
 917         }
 918
 919         usb_bufs->max_pkt_size = max_pkt_size;
 920         if (xfer_bulk)
 921                 usb_bufs->num_packets = 0;
 922         else
 923                 usb_bufs->num_packets = packet_multiplier;
 924         dev->usb_ctl.vid_buf = NULL;
 925         dev->usb_ctl.vbi_buf = NULL;
 926
 927         sb_size = packet_multiplier * usb_bufs->max_pkt_size;
 928
 929         /* allocate urbs and transfer buffers */
 930         for (i = 0; i < usb_bufs->num_bufs; i++) {
 931                 urb = usb_alloc_urb(usb_bufs->num_packets, GFP_KERNEL);
 932                 if (!urb) {
 933                         em28xx_err("cannot alloc usb_ctl.urb %i\n", i);
 934                         em28xx_uninit_usb_xfer(dev, mode);
 935                         return -ENOMEM;
 936                 }
 937                 usb_bufs->urb[i] = urb;
 938
 939                 usb_bufs->transfer_buffer[i] = usb_alloc_coherent(dev->udev,
 940                         sb_size, GFP_KERNEL, &urb->transfer_dma);
 941                 if (!usb_bufs->transfer_buffer[i]) {
 942                         em28xx_err("unable to allocate %i bytes for transfer"
 943                                         " buffer %i%s\n",
 944                                         sb_size, i,
 945                                         in_interrupt() ? " while in int" : "");
 946                         em28xx_uninit_usb_xfer(dev, mode);
 947                         return -ENOMEM;
 948                 }
 949                 memset(usb_bufs->transfer_buffer[i], 0, sb_size);
 950
 951                 if (xfer_bulk) { /* bulk */
 952                         pipe = usb_rcvbulkpipe(dev->udev,
 953                                                mode == EM28XX_ANALOG_MODE ?
 954                                                dev->analog_ep_bulk :
 955                                                dev->dvb_ep_bulk);
 956                         usb_fill_bulk_urb(urb, dev->udev, pipe,
 957                                           usb_bufs->transfer_buffer[i], sb_size,
 958                                           em28xx_irq_callback, dev);
 959                         urb->transfer_flags = URB_NO_TRANSFER_DMA_MAP;
 960                 } else { /* isoc */
 961                         pipe = usb_rcvisocpipe(dev->udev,
 962                                                mode == EM28XX_ANALOG_MODE ?
 963                                                dev->analog_ep_isoc :
 964                                                dev->dvb_ep_isoc);
 965                         usb_fill_int_urb(urb, dev->udev, pipe,
 966                                          usb_bufs->transfer_buffer[i], sb_size,
 967                                          em28xx_irq_callback, dev, 1);
 968                         urb->transfer_flags = URB_ISO_ASAP |
 969                                               URB_NO_TRANSFER_DMA_MAP;
 970                         k = 0;
 971                         for (j = 0; j < usb_bufs->num_packets; j++) {
 972                                 urb->iso_frame_desc[j].offset = k;
 973                                 urb->iso_frame_desc[j].length =
 974                                                         usb_bufs->max_pkt_size;
 975                                 k += usb_bufs->max_pkt_size;
 976                         }
 977                 }
 978
 979                 urb->number_of_packets = usb_bufs->num_packets;
 980         }
 981
 982         return 0;
 983 }
 984 EXPORT_SYMBOL_GPL(em28xx_alloc_urbs);
 985
 986 /*
 987  * Allocate URBs and start IRQ
 988  */
 989 int em28xx_init_usb_xfer(struct em28xx *dev, enum em28xx_mode mode,
 990                     int xfer_bulk, int num_bufs, int max_pkt_size,
 991                     int packet_multiplier,
 992                     int (*urb_data_copy) (struct em28xx *dev, struct urb *urb))
 993 {
 994         struct em28xx_dmaqueue *dma_q = &dev->vidq;
 995         struct em28xx_dmaqueue *vbi_dma_q = &dev->vbiq;
 996         struct em28xx_usb_bufs *usb_bufs;
 997         int i;
 998         int rc;
 999         int alloc;
1000
1001         em28xx_isocdbg("em28xx: called em28xx_init_usb_xfer in mode %d\n",
1002                        mode);
1003
1004         dev->usb_ctl.urb_data_copy = urb_data_copy;
1005
1006         if (mode == EM28XX_DIGITAL_MODE) {
1007                 usb_bufs = &dev->usb_ctl.digital_bufs;
1008                 /* no need to free/alloc usb buffers in digital mode */
1009                 alloc = 0;
1010         } else {
1011                 usb_bufs = &dev->usb_ctl.analog_bufs;
1012                 alloc = 1;
1013         }
1014
1015         if (alloc) {
1016                 rc = em28xx_alloc_urbs(dev, mode, xfer_bulk, num_bufs,
1017                                        max_pkt_size, packet_multiplier);
1018                 if (rc)
1019                         return rc;
1020         }
1021
1022         if (xfer_bulk) {
1023                 rc = usb_clear_halt(dev->udev, usb_bufs->urb[0]->pipe);
1024                 if (rc < 0) {
1025                         em28xx_err("failed to clear USB bulk endpoint stall/halt condition (error=%i)\n",
1026                                    rc);
1027                         em28xx_uninit_usb_xfer(dev, mode);
1028                         return rc;
1029                 }
1030         }
1031
1032         init_waitqueue_head(&dma_q->wq);
1033         init_waitqueue_head(&vbi_dma_q->wq);
1034
1035         em28xx_capture_start(dev, 1);
1036
1037         /* submit urbs and enables IRQ */
1038         for (i = 0; i < usb_bufs->num_bufs; i++) {
1039                 rc = usb_submit_urb(usb_bufs->urb[i], GFP_ATOMIC);
1040                 if (rc) {
1041                         em28xx_err("submit of urb %i failed (error=%i)\n", i,
1042                                    rc);
1043                         em28xx_uninit_usb_xfer(dev, mode);
1044                         return rc;
1045                 }
1046         }
1047
1048         return 0;
1049 }
1050 EXPORT_SYMBOL_GPL(em28xx_init_usb_xfer);
1051
1052 /*
1053  * Device control list
1054  */
1055
1056 static LIST_HEAD(em28xx_devlist);
1057 static DEFINE_MUTEX(em28xx_devlist_mutex);
1058
1059 /*
1060  * Extension interface
1061  */
1062
1063 static LIST_HEAD(em28xx_extension_devlist);
1064
1065 int em28xx_register_extension(struct em28xx_ops *ops)
1066 {
1067         struct em28xx *dev = NULL;
1068
1069         mutex_lock(&em28xx_devlist_mutex);
1070         list_add_tail(&ops->next, &em28xx_extension_devlist);
1071         list_for_each_entry(dev, &em28xx_devlist, devlist) {
1072                 ops->init(dev);
1073         }
1074         mutex_unlock(&em28xx_devlist_mutex);
1075         printk(KERN_INFO "em28xx: Registered (%s) extension\n", ops->name);
1076         return 0;
1077 }
1078 EXPORT_SYMBOL(em28xx_register_extension);
1079
1080 void em28xx_unregister_extension(struct em28xx_ops *ops)
1081 {
1082         struct em28xx *dev = NULL;
1083
1084         mutex_lock(&em28xx_devlist_mutex);
1085         list_for_each_entry(dev, &em28xx_devlist, devlist) {
1086                 ops->fini(dev);
1087         }
1088         list_del(&ops->next);
1089         mutex_unlock(&em28xx_devlist_mutex);
1090         printk(KERN_INFO "Em28xx: Removed (%s) extension\n", ops->name);
1091 }
1092 EXPORT_SYMBOL(em28xx_unregister_extension);
1093
1094 void em28xx_init_extension(struct em28xx *dev)
1095 {
1096         const struct em28xx_ops *ops = NULL;
1097
1098         mutex_lock(&em28xx_devlist_mutex);
1099         list_add_tail(&dev->devlist, &em28xx_devlist);
1100         list_for_each_entry(ops, &em28xx_extension_devlist, next) {
1101                 if (ops->init)
1102                         ops->init(dev);
1103         }
1104         mutex_unlock(&em28xx_devlist_mutex);
1105 }
1106
1107 void em28xx_close_extension(struct em28xx *dev)
1108 {
1109         const struct em28xx_ops *ops = NULL;
1110
1111         mutex_lock(&em28xx_devlist_mutex);
1112         list_for_each_entry(ops, &em28xx_extension_devlist, next) {
1113                 if (ops->fini)
1114                         ops->fini(dev);
1115         }
1116         list_del(&dev->devlist);
1117         mutex_unlock(&em28xx_devlist_mutex);
1118 }