drivers/media/common/saa7146_core.c

   1 /*
   2     saa7146.o - driver for generic saa7146-based hardware
   3
   4     Copyright (C) 1998-2003 Michael Hunold <michael@mihu.de>
   5
   6     This program is free software; you can redistribute it and/or modify
   7     it under the terms of the GNU General Public License as published by
   8     the Free Software Foundation; either version 2 of the License, or
   9     (at your option) any later version.
  10
  11     This program is distributed in the hope that it will be useful,
  12     but WITHOUT ANY WARRANTY; without even the implied warranty of
  13     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14     GNU General Public License for more details.
  15
  16     You should have received a copy of the GNU General Public License
  17     along with this program; if not, write to the Free Software
  18     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  19 */
  20
  21 #include <media/saa7146.h>
  22
  23 LIST_HEAD(saa7146_devices);
  24 DEFINE_MUTEX(saa7146_devices_lock);
  25
  26 static int saa7146_num;
  27
  28 unsigned int saa7146_debug;
  29
  30 module_param(saa7146_debug, uint, 0644);
  31 MODULE_PARM_DESC(saa7146_debug, "debug level (default: 0)");
  32
  33 #if 0
  34 static void dump_registers(struct saa7146_dev* dev)
  35 {
  36         int i = 0;
  37
  38         INFO((" @ %li jiffies:\n",jiffies));
  39         for(i = 0; i <= 0x148; i+=4) {
  40                 printk("0x%03x: 0x%08x\n",i,saa7146_read(dev,i));
  41         }
  42 }
  43 #endif
  44
  45 /****************************************************************************
  46  * gpio and debi helper functions
  47  ****************************************************************************/
  48
  49 void saa7146_setgpio(struct saa7146_dev *dev, int port, u32 data)
  50 {
  51         u32 value = 0;
  52
  53         BUG_ON(port > 3);
  54
  55         value = saa7146_read(dev, GPIO_CTRL);
  56         value &= ~(0xff << (8*port));
  57         value |= (data << (8*port));
  58         saa7146_write(dev, GPIO_CTRL, value);
  59 }
  60
  61 /* This DEBI code is based on the saa7146 Stradis driver by Nathan Laredo */
  62 static inline int saa7146_wait_for_debi_done_sleep(struct saa7146_dev *dev,
  63                                 unsigned long us1, unsigned long us2)
  64 {
  65         unsigned long timeout;
  66         int err;
  67
  68         /* wait for registers to be programmed */
  69         timeout = jiffies + usecs_to_jiffies(us1);
  70         while (1) {
  71                 err = time_after(jiffies, timeout);
  72                 if (saa7146_read(dev, MC2) & 2)
  73                         break;
  74                 if (err) {
  75                         printk(KERN_ERR "%s: %s timed out while waiting for "
  76                                         "registers getting programmed\n",
  77                                         dev->name, __func__);
  78                         return -ETIMEDOUT;
  79                 }
  80                 msleep(1);
  81         }
  82
  83         /* wait for transfer to complete */
  84         timeout = jiffies + usecs_to_jiffies(us2);
  85         while (1) {
  86                 err = time_after(jiffies, timeout);
  87                 if (!(saa7146_read(dev, PSR) & SPCI_DEBI_S))
  88                         break;
  89                 saa7146_read(dev, MC2);
  90                 if (err) {
  91                         DEB_S(("%s: %s timed out while waiting for transfer "
  92                                 "completion\n", dev->name, __func__));
  93                         return -ETIMEDOUT;
  94                 }
  95                 msleep(1);
  96         }
  97
  98         return 0;
  99 }
 100
 101 static inline int saa7146_wait_for_debi_done_busyloop(struct saa7146_dev *dev,
 102                                 unsigned long us1, unsigned long us2)
 103 {
 104         unsigned long loops;
 105
 106         /* wait for registers to be programmed */
 107         loops = us1;
 108         while (1) {
 109                 if (saa7146_read(dev, MC2) & 2)
 110                         break;
 111                 if (!loops--) {
 112                         printk(KERN_ERR "%s: %s timed out while waiting for "
 113                                         "registers getting programmed\n",
 114                                         dev->name, __func__);
 115                         return -ETIMEDOUT;
 116                 }
 117                 udelay(1);
 118         }
 119
 120         /* wait for transfer to complete */
 121         loops = us2 / 5;
 122         while (1) {
 123                 if (!(saa7146_read(dev, PSR) & SPCI_DEBI_S))
 124                         break;
 125                 saa7146_read(dev, MC2);
 126                 if (!loops--) {
 127                         DEB_S(("%s: %s timed out while waiting for transfer "
 128                                 "completion\n", dev->name, __func__));
 129                         return -ETIMEDOUT;
 130                 }
 131                 udelay(5);
 132         }
 133
 134         return 0;
 135 }
 136
 137 int saa7146_wait_for_debi_done(struct saa7146_dev *dev, int nobusyloop)
 138 {
 139         if (nobusyloop)
 140                 return saa7146_wait_for_debi_done_sleep(dev, 50000, 250000);
 141         else
 142                 return saa7146_wait_for_debi_done_busyloop(dev, 50000, 250000);
 143 }
 144
 145 /****************************************************************************
 146  * general helper functions
 147  ****************************************************************************/
 148
 149 /* this is videobuf_vmalloc_to_sg() from videobuf-dma-sg.c
 150    make sure virt has been allocated with vmalloc_32(), otherwise the BUG()
 151    may be triggered on highmem machines */
 152 static struct scatterlist* vmalloc_to_sg(unsigned char *virt, int nr_pages)
 153 {
 154         struct scatterlist *sglist;
 155         struct page *pg;
 156         int i;
 157
 158         sglist = kcalloc(nr_pages, sizeof(struct scatterlist), GFP_KERNEL);
 159         if (NULL == sglist)
 160                 return NULL;
 161         sg_init_table(sglist, nr_pages);
 162         for (i = 0; i < nr_pages; i++, virt += PAGE_SIZE) {
 163                 pg = vmalloc_to_page(virt);
 164                 if (NULL == pg)
 165                         goto err;
 166                 BUG_ON(PageHighMem(pg));
 167                 sg_set_page(&sglist[i], pg, PAGE_SIZE, 0);
 168         }
 169         return sglist;
 170
 171  err:
 172         kfree(sglist);
 173         return NULL;
 174 }
 175
 176 /********************************************************************************/
 177 /* common page table functions */
 178
 179 void *saa7146_vmalloc_build_pgtable(struct pci_dev *pci, long length, struct saa7146_pgtable *pt)
 180 {
 181         int pages = (length+PAGE_SIZE-1)/PAGE_SIZE;
 182         void *mem = vmalloc_32(length);
 183         int slen = 0;
 184
 185         if (NULL == mem)
 186                 goto err_null;
 187
 188         if (!(pt->slist = vmalloc_to_sg(mem, pages)))
 189                 goto err_free_mem;
 190
 191         if (saa7146_pgtable_alloc(pci, pt))
 192                 goto err_free_slist;
 193
 194         pt->nents = pages;
 195         slen = pci_map_sg(pci,pt->slist,pt->nents,PCI_DMA_FROMDEVICE);
 196         if (0 == slen)
 197                 goto err_free_pgtable;
 198
 199         if (0 != saa7146_pgtable_build_single(pci, pt, pt->slist, slen))
 200                 goto err_unmap_sg;
 201
 202         return mem;
 203
 204 err_unmap_sg:
 205         pci_unmap_sg(pci, pt->slist, pt->nents, PCI_DMA_FROMDEVICE);
 206 err_free_pgtable:
 207         saa7146_pgtable_free(pci, pt);
 208 err_free_slist:
 209         kfree(pt->slist);
 210         pt->slist = NULL;
 211 err_free_mem:
 212         vfree(mem);
 213 err_null:
 214         return NULL;
 215 }
 216
 217 void saa7146_vfree_destroy_pgtable(struct pci_dev *pci, void *mem, struct saa7146_pgtable *pt)
 218 {
 219         pci_unmap_sg(pci, pt->slist, pt->nents, PCI_DMA_FROMDEVICE);
 220         saa7146_pgtable_free(pci, pt);
 221         kfree(pt->slist);
 222         pt->slist = NULL;
 223         vfree(mem);
 224 }
 225
 226 void saa7146_pgtable_free(struct pci_dev *pci, struct saa7146_pgtable *pt)
 227 {
 228         if (NULL == pt->cpu)
 229                 return;
 230         pci_free_consistent(pci, pt->size, pt->cpu, pt->dma);
 231         pt->cpu = NULL;
 232 }
 233
 234 int saa7146_pgtable_alloc(struct pci_dev *pci, struct saa7146_pgtable *pt)
 235 {
 236         __le32       *cpu;
 237         dma_addr_t   dma_addr = 0;
 238
 239         cpu = pci_alloc_consistent(pci, PAGE_SIZE, &dma_addr);
 240         if (NULL == cpu) {
 241                 return -ENOMEM;
 242         }
 243         pt->size = PAGE_SIZE;
 244         pt->cpu  = cpu;
 245         pt->dma  = dma_addr;
 246
 247         return 0;
 248 }
 249
 250 int saa7146_pgtable_build_single(struct pci_dev *pci, struct saa7146_pgtable *pt,
 251         struct scatterlist *list, int sglen  )
 252 {
 253         __le32 *ptr, fill;
 254         int nr_pages = 0;
 255         int i,p;
 256
 257         BUG_ON(0 == sglen);
 258         BUG_ON(list->offset > PAGE_SIZE);
 259
 260         /* if we have a user buffer, the first page may not be
 261            aligned to a page boundary. */
 262         pt->offset = list->offset;
 263
 264         ptr = pt->cpu;
 265         for (i = 0; i < sglen; i++, list++) {
 266 /*
 267                 printk("i:%d, adr:0x%08x, len:%d, offset:%d\n", i,sg_dma_address(list), sg_dma_len(list), list->offset);
 268 */
 269                 for (p = 0; p * 4096 < list->length; p++, ptr++) {
 270                         *ptr = cpu_to_le32(sg_dma_address(list) + p * 4096);
 271                         nr_pages++;
 272                 }
 273         }
 274
 275
 276         /* safety; fill the page table up with the last valid page */
 277         fill = *(ptr-1);
 278         for(i=nr_pages;i<1024;i++) {
 279                 *ptr++ = fill;
 280         }
 281
 282 /*
 283         ptr = pt->cpu;
 284         printk("offset: %d\n",pt->offset);
 285         for(i=0;i<5;i++) {
 286                 printk("ptr1 %d: 0x%08x\n",i,ptr[i]);
 287         }
 288 */
 289         return 0;
 290 }
 291
 292 /********************************************************************************/
 293 /* interrupt handler */
 294 static irqreturn_t interrupt_hw(int irq, void *dev_id)
 295 {
 296         struct saa7146_dev *dev = dev_id;
 297         u32 isr;
 298         u32 ack_isr;
 299
 300         /* read out the interrupt status register */
 301         ack_isr = isr = saa7146_read(dev, ISR);
 302
 303         /* is this our interrupt? */
 304         if ( 0 == isr ) {
 305                 /* nope, some other device */
 306                 return IRQ_NONE;
 307         }
 308
 309         if (dev->ext) {
 310                 if (dev->ext->irq_mask & isr) {
 311                         if (dev->ext->irq_func)
 312                                 dev->ext->irq_func(dev, &isr);
 313                         isr &= ~dev->ext->irq_mask;
 314                 }
 315         }
 316         if (0 != (isr & (MASK_27))) {
 317                 DEB_INT(("irq: RPS0 (0x%08x).\n",isr));
 318                 if (dev->vv_data && dev->vv_callback)
 319                         dev->vv_callback(dev,isr);
 320                 isr &= ~MASK_27;
 321         }
 322         if (0 != (isr & (MASK_28))) {
 323                 if (dev->vv_data && dev->vv_callback)
 324                         dev->vv_callback(dev,isr);
 325                 isr &= ~MASK_28;
 326         }
 327         if (0 != (isr & (MASK_16|MASK_17))) {
 328                 SAA7146_IER_DISABLE(dev, MASK_16|MASK_17);
 329                 /* only wake up if we expect something */
 330                 if (0 != dev->i2c_op) {
 331                         dev->i2c_op = 0;
 332                         wake_up(&dev->i2c_wq);
 333                 } else {
 334                         u32 psr = saa7146_read(dev, PSR);
 335                         u32 ssr = saa7146_read(dev, SSR);
 336                         printk(KERN_WARNING "%s: unexpected i2c irq: isr %08x psr %08x ssr %08x\n",
 337                                dev->name, isr, psr, ssr);
 338                 }
 339                 isr &= ~(MASK_16|MASK_17);
 340         }
 341         if( 0 != isr ) {
 342                 ERR(("warning: interrupt enabled, but not handled properly.(0x%08x)\n",isr));
 343                 ERR(("disabling interrupt source(s)!\n"));
 344                 SAA7146_IER_DISABLE(dev,isr);
 345         }
 346         saa7146_write(dev, ISR, ack_isr);
 347         return IRQ_HANDLED;
 348 }
 349
 350 /*********************************************************************************/
 351 /* configuration-functions                                                       */
 352
 353 static int saa7146_init_one(struct pci_dev *pci, const struct pci_device_id *ent)
 354 {
 355         struct saa7146_pci_extension_data *pci_ext = (struct saa7146_pci_extension_data *)ent->driver_data;
 356         struct saa7146_extension *ext = pci_ext->ext;
 357         struct saa7146_dev *dev;
 358         int err = -ENOMEM;
 359
 360         /* clear out mem for sure */
 361         dev = kzalloc(sizeof(struct saa7146_dev), GFP_KERNEL);
 362         if (!dev) {
 363                 ERR(("out of memory.\n"));
 364                 goto out;
 365         }
 366
 367         DEB_EE(("pci:%p\n",pci));
 368
 369         err = pci_enable_device(pci);
 370         if (err < 0) {
 371                 ERR(("pci_enable_device() failed.\n"));
 372                 goto err_free;
 373         }
 374
 375         /* enable bus-mastering */
 376         pci_set_master(pci);
 377
 378         dev->pci = pci;
 379
 380         /* get chip-revision; this is needed to enable bug-fixes */
 381         err = pci_read_config_dword(pci, PCI_CLASS_REVISION, &dev->revision);
 382         if (err < 0) {
 383                 ERR(("pci_read_config_dword() failed.\n"));
 384                 goto err_disable;
 385         }
 386         dev->revision &= 0xf;
 387
 388         /* remap the memory from virtual to physical address */
 389
 390         err = pci_request_region(pci, 0, "saa7146");
 391         if (err < 0)
 392                 goto err_disable;
 393
 394         dev->mem = ioremap(pci_resource_start(pci, 0),
 395                            pci_resource_len(pci, 0));
 396         if (!dev->mem) {
 397                 ERR(("ioremap() failed.\n"));
 398                 err = -ENODEV;
 399                 goto err_release;
 400         }
 401
 402         /* we don't do a master reset here anymore, it screws up
 403            some boards that don't have an i2c-eeprom for configuration
 404            values */
 405 /*
 406         saa7146_write(dev, MC1, MASK_31);
 407 */
 408
 409         /* disable all irqs */
 410         saa7146_write(dev, IER, 0);
 411
 412         /* shut down all dma transfers and rps tasks */
 413         saa7146_write(dev, MC1, 0x30ff0000);
 414
 415         /* clear out any rps-signals pending */
 416         saa7146_write(dev, MC2, 0xf8000000);
 417
 418         /* request an interrupt for the saa7146 */
 419         err = request_irq(pci->irq, interrupt_hw, IRQF_SHARED | IRQF_DISABLED,
 420                           dev->name, dev);
 421         if (err < 0) {
 422                 ERR(("request_irq() failed.\n"));
 423                 goto err_unmap;
 424         }
 425
 426         err = -ENOMEM;
 427
 428         /* get memory for various stuff */
 429         dev->d_rps0.cpu_addr = pci_alloc_consistent(pci, SAA7146_RPS_MEM,
 430                                                     &dev->d_rps0.dma_handle);
 431         if (!dev->d_rps0.cpu_addr)
 432                 goto err_free_irq;
 433         memset(dev->d_rps0.cpu_addr, 0x0, SAA7146_RPS_MEM);
 434
 435         dev->d_rps1.cpu_addr = pci_alloc_consistent(pci, SAA7146_RPS_MEM,
 436                                                     &dev->d_rps1.dma_handle);
 437         if (!dev->d_rps1.cpu_addr)
 438                 goto err_free_rps0;
 439         memset(dev->d_rps1.cpu_addr, 0x0, SAA7146_RPS_MEM);
 440
 441         dev->d_i2c.cpu_addr = pci_alloc_consistent(pci, SAA7146_RPS_MEM,
 442                                                    &dev->d_i2c.dma_handle);
 443         if (!dev->d_i2c.cpu_addr)
 444                 goto err_free_rps1;
 445         memset(dev->d_i2c.cpu_addr, 0x0, SAA7146_RPS_MEM);
 446
 447         /* the rest + print status message */
 448
 449         /* create a nice device name */
 450         sprintf(dev->name, "saa7146 (%d)", saa7146_num);
 451
 452         INFO(("found saa7146 @ mem %p (revision %d, irq %d) (0x%04x,0x%04x).\n", dev->mem, dev->revision, pci->irq, pci->subsystem_vendor, pci->subsystem_device));
 453         dev->ext = ext;
 454
 455         mutex_init(&dev->lock);
 456         spin_lock_init(&dev->int_slock);
 457         spin_lock_init(&dev->slock);
 458
 459         mutex_init(&dev->i2c_lock);
 460
 461         dev->module = THIS_MODULE;
 462         init_waitqueue_head(&dev->i2c_wq);
 463
 464         /* set some sane pci arbitrition values */
 465         saa7146_write(dev, PCI_BT_V1, 0x1c00101f);
 466
 467         /* TODO: use the status code of the callback */
 468
 469         err = -ENODEV;
 470
 471         if (ext->probe && ext->probe(dev)) {
 472                 DEB_D(("ext->probe() failed for %p. skipping device.\n",dev));
 473                 goto err_free_i2c;
 474         }
 475
 476         if (ext->attach(dev, pci_ext)) {
 477                 DEB_D(("ext->attach() failed for %p. skipping device.\n",dev));
 478                 goto err_free_i2c;
 479         }
 480         /* V4L extensions will set the pci drvdata to the v4l2_device in the
 481            attach() above. So for those cards that do not use V4L we have to
 482            set it explicitly. */
 483         pci_set_drvdata(pci, &dev->v4l2_dev);
 484
 485         INIT_LIST_HEAD(&dev->item);
 486         list_add_tail(&dev->item,&saa7146_devices);
 487         saa7146_num++;
 488
 489         err = 0;
 490 out:
 491         return err;
 492
 493 err_free_i2c:
 494         pci_free_consistent(pci, SAA7146_RPS_MEM, dev->d_i2c.cpu_addr,
 495                             dev->d_i2c.dma_handle);
 496 err_free_rps1:
 497         pci_free_consistent(pci, SAA7146_RPS_MEM, dev->d_rps1.cpu_addr,
 498                             dev->d_rps1.dma_handle);
 499 err_free_rps0:
 500         pci_free_consistent(pci, SAA7146_RPS_MEM, dev->d_rps0.cpu_addr,
 501                             dev->d_rps0.dma_handle);
 502 err_free_irq:
 503         free_irq(pci->irq, (void *)dev);
 504 err_unmap:
 505         iounmap(dev->mem);
 506 err_release:
 507         pci_release_region(pci, 0);
 508 err_disable:
 509         pci_disable_device(pci);
 510 err_free:
 511         kfree(dev);
 512         goto out;
 513 }
 514
 515 static void saa7146_remove_one(struct pci_dev *pdev)
 516 {
 517         struct v4l2_device *v4l2_dev = pci_get_drvdata(pdev);
 518         struct saa7146_dev *dev = to_saa7146_dev(v4l2_dev);
 519         struct {
 520                 void *addr;
 521                 dma_addr_t dma;
 522         } dev_map[] = {
 523                 { dev->d_i2c.cpu_addr, dev->d_i2c.dma_handle },
 524                 { dev->d_rps1.cpu_addr, dev->d_rps1.dma_handle },
 525                 { dev->d_rps0.cpu_addr, dev->d_rps0.dma_handle },
 526                 { NULL, 0 }
 527         }, *p;
 528
 529         DEB_EE(("dev:%p\n",dev));
 530
 531         dev->ext->detach(dev);
 532         /* Zero the PCI drvdata after use. */
 533         pci_set_drvdata(pdev, NULL);
 534
 535         /* shut down all video dma transfers */
 536         saa7146_write(dev, MC1, 0x00ff0000);
 537
 538         /* disable all irqs, release irq-routine */
 539         saa7146_write(dev, IER, 0);
 540
 541         free_irq(pdev->irq, dev);
 542
 543         for (p = dev_map; p->addr; p++)
 544                 pci_free_consistent(pdev, SAA7146_RPS_MEM, p->addr, p->dma);
 545
 546         iounmap(dev->mem);
 547         pci_release_region(pdev, 0);
 548         list_del(&dev->item);
 549         pci_disable_device(pdev);
 550         kfree(dev);
 551
 552         saa7146_num--;
 553 }
 554
 555 /*********************************************************************************/
 556 /* extension handling functions                                                  */
 557
 558 int saa7146_register_extension(struct saa7146_extension* ext)
 559 {
 560         DEB_EE(("ext:%p\n",ext));
 561
 562         ext->driver.name = ext->name;
 563         ext->driver.id_table = ext->pci_tbl;
 564         ext->driver.probe = saa7146_init_one;
 565         ext->driver.remove = saa7146_remove_one;
 566
 567         printk("saa7146: register extension '%s'.\n",ext->name);
 568         return pci_register_driver(&ext->driver);
 569 }
 570
 571 int saa7146_unregister_extension(struct saa7146_extension* ext)
 572 {
 573         DEB_EE(("ext:%p\n",ext));
 574         printk("saa7146: unregister extension '%s'.\n",ext->name);
 575         pci_unregister_driver(&ext->driver);
 576         return 0;
 577 }
 578
 579 EXPORT_SYMBOL_GPL(saa7146_register_extension);
 580 EXPORT_SYMBOL_GPL(saa7146_unregister_extension);
 581
 582 /* misc functions used by extension modules */
 583 EXPORT_SYMBOL_GPL(saa7146_pgtable_alloc);
 584 EXPORT_SYMBOL_GPL(saa7146_pgtable_free);
 585 EXPORT_SYMBOL_GPL(saa7146_pgtable_build_single);
 586 EXPORT_SYMBOL_GPL(saa7146_vmalloc_build_pgtable);
 587 EXPORT_SYMBOL_GPL(saa7146_vfree_destroy_pgtable);
 588 EXPORT_SYMBOL_GPL(saa7146_wait_for_debi_done);
 589
 590 EXPORT_SYMBOL_GPL(saa7146_setgpio);
 591
 592 EXPORT_SYMBOL_GPL(saa7146_i2c_adapter_prepare);
 593
 594 EXPORT_SYMBOL_GPL(saa7146_debug);
 595 EXPORT_SYMBOL_GPL(saa7146_devices);
 596 EXPORT_SYMBOL_GPL(saa7146_devices_lock);
 597
 598 MODULE_AUTHOR("Michael Hunold <michael@mihu.de>");
 599 MODULE_DESCRIPTION("driver for generic saa7146-based hardware");
 600 MODULE_LICENSE("GPL");