drivers/dma/sh/usb-dmac.c

/* [<][>][^][v][top][bottom][index][help] */
This source file includes following definitions.
usb_dmac_write
usb_dmac_read
usb_dmac_chan_read
usb_dmac_chan_write
usb_dmac_chan_is_busy
usb_dmac_calc_tend
usb_dmac_chan_start_sg
usb_dmac_chan_start_desc
usb_dmac_init
usb_dmac_desc_alloc
usb_dmac_desc_free
usb_dmac_desc_get
usb_dmac_desc_put
usb_dmac_soft_reset
usb_dmac_chan_halt
usb_dmac_stop
usb_dmac_alloc_chan_resources
usb_dmac_free_chan_resources
usb_dmac_prep_slave_sg
usb_dmac_chan_terminate_all
usb_dmac_get_current_residue
usb_dmac_chan_get_residue_if_complete
usb_dmac_chan_get_residue
usb_dmac_tx_status
usb_dmac_issue_pending
usb_dmac_virt_desc_free
usb_dmac_isr_transfer_end
usb_dmac_isr_channel
usb_dmac_chan_filter
usb_dmac_of_xlate
usb_dmac_runtime_suspend
usb_dmac_runtime_resume
usb_dmac_chan_probe
usb_dmac_parse_of
usb_dmac_probe
usb_dmac_chan_remove
usb_dmac_remove
usb_dmac_shutdown
   1 // SPDX-License-Identifier: GPL-2.0
   2 /*
   3  * Renesas USB DMA Controller Driver
   4  *
   5  * Copyright (C) 2015 Renesas Electronics Corporation
   6  *
   7  * based on rcar-dmac.c
   8  * Copyright (C) 2014 Renesas Electronics Inc.
   9  * Author: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
  10  */
  11 
  12 #include <linux/delay.h>
  13 #include <linux/dma-mapping.h>
  14 #include <linux/dmaengine.h>
  15 #include <linux/interrupt.h>
  16 #include <linux/list.h>
  17 #include <linux/module.h>
  18 #include <linux/of.h>
  19 #include <linux/of_dma.h>
  20 #include <linux/of_platform.h>
  21 #include <linux/platform_device.h>
  22 #include <linux/pm_runtime.h>
  23 #include <linux/slab.h>
  24 #include <linux/spinlock.h>
  25 
  26 #include "../dmaengine.h"
  27 #include "../virt-dma.h"
  28 
  29 /*
  30  * struct usb_dmac_sg - Descriptor for a hardware transfer
  31  * @mem_addr: memory address
  32  * @size: transfer size in bytes
  33  */
  34 struct usb_dmac_sg {
  35         dma_addr_t mem_addr;
  36         u32 size;
  37 };
  38 
  39 /*
  40  * struct usb_dmac_desc - USB DMA Transfer Descriptor
  41  * @vd: base virtual channel DMA transaction descriptor
  42  * @direction: direction of the DMA transfer
  43  * @sg_allocated_len: length of allocated sg
  44  * @sg_len: length of sg
  45  * @sg_index: index of sg
  46  * @residue: residue after the DMAC completed a transfer
  47  * @node: node for desc_got and desc_freed
  48  * @done_cookie: cookie after the DMAC completed a transfer
  49  * @sg: information for the transfer
  50  */
  51 struct usb_dmac_desc {
  52         struct virt_dma_desc vd;
  53         enum dma_transfer_direction direction;
  54         unsigned int sg_allocated_len;
  55         unsigned int sg_len;
  56         unsigned int sg_index;
  57         u32 residue;
  58         struct list_head node;
  59         dma_cookie_t done_cookie;
  60         struct usb_dmac_sg sg[];
  61 };
  62 
  63 #define to_usb_dmac_desc(vd)    container_of(vd, struct usb_dmac_desc, vd)
  64 
  65 /*
  66  * struct usb_dmac_chan - USB DMA Controller Channel
  67  * @vc: base virtual DMA channel object
  68  * @iomem: channel I/O memory base
  69  * @index: index of this channel in the controller
  70  * @irq: irq number of this channel
  71  * @desc: the current descriptor
  72  * @descs_allocated: number of descriptors allocated
  73  * @desc_got: got descriptors
  74  * @desc_freed: freed descriptors after the DMAC completed a transfer
  75  */
  76 struct usb_dmac_chan {
  77         struct virt_dma_chan vc;
  78         void __iomem *iomem;
  79         unsigned int index;
  80         int irq;
  81         struct usb_dmac_desc *desc;
  82         int descs_allocated;
  83         struct list_head desc_got;
  84         struct list_head desc_freed;
  85 };
  86 
  87 #define to_usb_dmac_chan(c) container_of(c, struct usb_dmac_chan, vc.chan)
  88 
  89 /*
  90  * struct usb_dmac - USB DMA Controller
  91  * @engine: base DMA engine object
  92  * @dev: the hardware device
  93  * @iomem: remapped I/O memory base
  94  * @n_channels: number of available channels
  95  * @channels: array of DMAC channels
  96  */
  97 struct usb_dmac {
  98         struct dma_device engine;
  99         struct device *dev;
 100         void __iomem *iomem;
 101 
 102         unsigned int n_channels;
 103         struct usb_dmac_chan *channels;
 104 };
 105 
 106 #define to_usb_dmac(d)          container_of(d, struct usb_dmac, engine)
 107 
 108 /* -----------------------------------------------------------------------------
 109  * Registers
 110  */
 111 
 112 #define USB_DMAC_CHAN_OFFSET(i)         (0x20 + 0x20 * (i))
 113 
 114 #define USB_DMASWR                      0x0008
 115 #define USB_DMASWR_SWR                  (1 << 0)
 116 #define USB_DMAOR                       0x0060
 117 #define USB_DMAOR_AE                    (1 << 1)
 118 #define USB_DMAOR_DME                   (1 << 0)
 119 
 120 #define USB_DMASAR                      0x0000
 121 #define USB_DMADAR                      0x0004
 122 #define USB_DMATCR                      0x0008
 123 #define USB_DMATCR_MASK                 0x00ffffff
 124 #define USB_DMACHCR                     0x0014
 125 #define USB_DMACHCR_FTE                 (1 << 24)
 126 #define USB_DMACHCR_NULLE               (1 << 16)
 127 #define USB_DMACHCR_NULL                (1 << 12)
 128 #define USB_DMACHCR_TS_8B               ((0 << 7) | (0 << 6))
 129 #define USB_DMACHCR_TS_16B              ((0 << 7) | (1 << 6))
 130 #define USB_DMACHCR_TS_32B              ((1 << 7) | (0 << 6))
 131 #define USB_DMACHCR_IE                  (1 << 5)
 132 #define USB_DMACHCR_SP                  (1 << 2)
 133 #define USB_DMACHCR_TE                  (1 << 1)
 134 #define USB_DMACHCR_DE                  (1 << 0)
 135 #define USB_DMATEND                     0x0018
 136 
 137 /* Hardcode the xfer_shift to 5 (32bytes) */
 138 #define USB_DMAC_XFER_SHIFT     5
 139 #define USB_DMAC_XFER_SIZE      (1 << USB_DMAC_XFER_SHIFT)
 140 #define USB_DMAC_CHCR_TS        USB_DMACHCR_TS_32B
 141 #define USB_DMAC_SLAVE_BUSWIDTH DMA_SLAVE_BUSWIDTH_32_BYTES
 142 
 143 /* for descriptors */
 144 #define USB_DMAC_INITIAL_NR_DESC        16
 145 #define USB_DMAC_INITIAL_NR_SG          8
 146 
 147 /* -----------------------------------------------------------------------------
 148  * Device access
 149  */
 150 
 151 static void usb_dmac_write(struct usb_dmac *dmac, u32 reg, u32 data)
 152 {
 153         writel(data, dmac->iomem + reg);
 154 }
 155 
 156 static u32 usb_dmac_read(struct usb_dmac *dmac, u32 reg)
 157 {
 158         return readl(dmac->iomem + reg);
 159 }
 160 
 161 static u32 usb_dmac_chan_read(struct usb_dmac_chan *chan, u32 reg)
 162 {
 163         return readl(chan->iomem + reg);
 164 }
 165 
 166 static void usb_dmac_chan_write(struct usb_dmac_chan *chan, u32 reg, u32 data)
 167 {
 168         writel(data, chan->iomem + reg);
 169 }
 170 
 171 /* -----------------------------------------------------------------------------
 172  * Initialization and configuration
 173  */
 174 
 175 static bool usb_dmac_chan_is_busy(struct usb_dmac_chan *chan)
 176 {
 177         u32 chcr = usb_dmac_chan_read(chan, USB_DMACHCR);
 178 
 179         return (chcr & (USB_DMACHCR_DE | USB_DMACHCR_TE)) == USB_DMACHCR_DE;
 180 }
 181 
 182 static u32 usb_dmac_calc_tend(u32 size)
 183 {
 184         /*
 185          * Please refer to the Figure "Example of Final Transaction Valid
 186          * Data Transfer Enable (EDTEN) Setting" in the data sheet.
 187          */
 188         return 0xffffffff << (32 - (size % USB_DMAC_XFER_SIZE ? :
 189                                                 USB_DMAC_XFER_SIZE));
 190 }
 191 
 192 /* This function is already held by vc.lock */
 193 static void usb_dmac_chan_start_sg(struct usb_dmac_chan *chan,
 194                                    unsigned int index)
 195 {
 196         struct usb_dmac_desc *desc = chan->desc;
 197         struct usb_dmac_sg *sg = desc->sg + index;
 198         dma_addr_t src_addr = 0, dst_addr = 0;
 199 
 200         WARN_ON_ONCE(usb_dmac_chan_is_busy(chan));
 201 
 202         if (desc->direction == DMA_DEV_TO_MEM)
 203                 dst_addr = sg->mem_addr;
 204         else
 205                 src_addr = sg->mem_addr;
 206 
 207         dev_dbg(chan->vc.chan.device->dev,
 208                 "chan%u: queue sg %p: %u@%pad -> %pad\n",
 209                 chan->index, sg, sg->size, &src_addr, &dst_addr);
 210 
 211         usb_dmac_chan_write(chan, USB_DMASAR, src_addr & 0xffffffff);
 212         usb_dmac_chan_write(chan, USB_DMADAR, dst_addr & 0xffffffff);
 213         usb_dmac_chan_write(chan, USB_DMATCR,
 214                             DIV_ROUND_UP(sg->size, USB_DMAC_XFER_SIZE));
 215         usb_dmac_chan_write(chan, USB_DMATEND, usb_dmac_calc_tend(sg->size));
 216 
 217         usb_dmac_chan_write(chan, USB_DMACHCR, USB_DMAC_CHCR_TS |
 218                         USB_DMACHCR_NULLE | USB_DMACHCR_IE | USB_DMACHCR_DE);
 219 }
 220 
 221 /* This function is already held by vc.lock */
 222 static void usb_dmac_chan_start_desc(struct usb_dmac_chan *chan)
 223 {
 224         struct virt_dma_desc *vd;
 225 
 226         vd = vchan_next_desc(&chan->vc);
 227         if (!vd) {
 228                 chan->desc = NULL;
 229                 return;
 230         }
 231 
 232         /*
 233          * Remove this request from vc->desc_issued. Otherwise, this driver
 234          * will get the previous value from vchan_next_desc() after a transfer
 235          * was completed.
 236          */
 237         list_del(&vd->node);
 238 
 239         chan->desc = to_usb_dmac_desc(vd);
 240         chan->desc->sg_index = 0;
 241         usb_dmac_chan_start_sg(chan, 0);
 242 }
 243 
 244 static int usb_dmac_init(struct usb_dmac *dmac)
 245 {
 246         u16 dmaor;
 247 
 248         /* Clear all channels and enable the DMAC globally. */
 249         usb_dmac_write(dmac, USB_DMAOR, USB_DMAOR_DME);
 250 
 251         dmaor = usb_dmac_read(dmac, USB_DMAOR);
 252         if ((dmaor & (USB_DMAOR_AE | USB_DMAOR_DME)) != USB_DMAOR_DME) {
 253                 dev_warn(dmac->dev, "DMAOR initialization failed.\n");
 254                 return -EIO;
 255         }
 256 
 257         return 0;
 258 }
 259 
 260 /* -----------------------------------------------------------------------------
 261  * Descriptors allocation and free
 262  */
 263 static int usb_dmac_desc_alloc(struct usb_dmac_chan *chan, unsigned int sg_len,
 264                                gfp_t gfp)
 265 {
 266         struct usb_dmac_desc *desc;
 267         unsigned long flags;
 268 
 269         desc = kzalloc(struct_size(desc, sg, sg_len), gfp);
 270         if (!desc)
 271                 return -ENOMEM;
 272 
 273         desc->sg_allocated_len = sg_len;
 274         INIT_LIST_HEAD(&desc->node);
 275 
 276         spin_lock_irqsave(&chan->vc.lock, flags);
 277         list_add_tail(&desc->node, &chan->desc_freed);
 278         spin_unlock_irqrestore(&chan->vc.lock, flags);
 279 
 280         return 0;
 281 }
 282 
 283 static void usb_dmac_desc_free(struct usb_dmac_chan *chan)
 284 {
 285         struct usb_dmac_desc *desc, *_desc;
 286         LIST_HEAD(list);
 287 
 288         list_splice_init(&chan->desc_freed, &list);
 289         list_splice_init(&chan->desc_got, &list);
 290 
 291         list_for_each_entry_safe(desc, _desc, &list, node) {
 292                 list_del(&desc->node);
 293                 kfree(desc);
 294         }
 295         chan->descs_allocated = 0;
 296 }
 297 
 298 static struct usb_dmac_desc *usb_dmac_desc_get(struct usb_dmac_chan *chan,
 299                                                unsigned int sg_len, gfp_t gfp)
 300 {
 301         struct usb_dmac_desc *desc = NULL;
 302         unsigned long flags;
 303 
 304         /* Get a freed descritpor */
 305         spin_lock_irqsave(&chan->vc.lock, flags);
 306         list_for_each_entry(desc, &chan->desc_freed, node) {
 307                 if (sg_len <= desc->sg_allocated_len) {
 308                         list_move_tail(&desc->node, &chan->desc_got);
 309                         spin_unlock_irqrestore(&chan->vc.lock, flags);
 310                         return desc;
 311                 }
 312         }
 313         spin_unlock_irqrestore(&chan->vc.lock, flags);
 314 
 315         /* Allocate a new descriptor */
 316         if (!usb_dmac_desc_alloc(chan, sg_len, gfp)) {
 317                 /* If allocated the desc, it was added to tail of the list */
 318                 spin_lock_irqsave(&chan->vc.lock, flags);
 319                 desc = list_last_entry(&chan->desc_freed, struct usb_dmac_desc,
 320                                        node);
 321                 list_move_tail(&desc->node, &chan->desc_got);
 322                 spin_unlock_irqrestore(&chan->vc.lock, flags);
 323                 return desc;
 324         }
 325 
 326         return NULL;
 327 }
 328 
 329 static void usb_dmac_desc_put(struct usb_dmac_chan *chan,
 330                               struct usb_dmac_desc *desc)
 331 {
 332         unsigned long flags;
 333 
 334         spin_lock_irqsave(&chan->vc.lock, flags);
 335         list_move_tail(&desc->node, &chan->desc_freed);
 336         spin_unlock_irqrestore(&chan->vc.lock, flags);
 337 }
 338 
 339 /* -----------------------------------------------------------------------------
 340  * Stop and reset
 341  */
 342 
 343 static void usb_dmac_soft_reset(struct usb_dmac_chan *uchan)
 344 {
 345         struct dma_chan *chan = &uchan->vc.chan;
 346         struct usb_dmac *dmac = to_usb_dmac(chan->device);
 347         int i;
 348 
 349         /* Don't issue soft reset if any one of channels is busy */
 350         for (i = 0; i < dmac->n_channels; ++i) {
 351                 if (usb_dmac_chan_is_busy(uchan))
 352                         return;
 353         }
 354 
 355         usb_dmac_write(dmac, USB_DMAOR, 0);
 356         usb_dmac_write(dmac, USB_DMASWR, USB_DMASWR_SWR);
 357         udelay(100);
 358         usb_dmac_write(dmac, USB_DMASWR, 0);
 359         usb_dmac_write(dmac, USB_DMAOR, 1);
 360 }
 361 
 362 static void usb_dmac_chan_halt(struct usb_dmac_chan *chan)
 363 {
 364         u32 chcr = usb_dmac_chan_read(chan, USB_DMACHCR);
 365 
 366         chcr &= ~(USB_DMACHCR_IE | USB_DMACHCR_TE | USB_DMACHCR_DE);
 367         usb_dmac_chan_write(chan, USB_DMACHCR, chcr);
 368 
 369         usb_dmac_soft_reset(chan);
 370 }
 371 
 372 static void usb_dmac_stop(struct usb_dmac *dmac)
 373 {
 374         usb_dmac_write(dmac, USB_DMAOR, 0);
 375 }
 376 
 377 /* -----------------------------------------------------------------------------
 378  * DMA engine operations
 379  */
 380 
 381 static int usb_dmac_alloc_chan_resources(struct dma_chan *chan)
 382 {
 383         struct usb_dmac_chan *uchan = to_usb_dmac_chan(chan);
 384         int ret;
 385 
 386         while (uchan->descs_allocated < USB_DMAC_INITIAL_NR_DESC) {
 387                 ret = usb_dmac_desc_alloc(uchan, USB_DMAC_INITIAL_NR_SG,
 388                                           GFP_KERNEL);
 389                 if (ret < 0) {
 390                         usb_dmac_desc_free(uchan);
 391                         return ret;
 392                 }
 393                 uchan->descs_allocated++;
 394         }
 395 
 396         return pm_runtime_get_sync(chan->device->dev);
 397 }
 398 
 399 static void usb_dmac_free_chan_resources(struct dma_chan *chan)
 400 {
 401         struct usb_dmac_chan *uchan = to_usb_dmac_chan(chan);
 402         unsigned long flags;
 403 
 404         /* Protect against ISR */
 405         spin_lock_irqsave(&uchan->vc.lock, flags);
 406         usb_dmac_chan_halt(uchan);
 407         spin_unlock_irqrestore(&uchan->vc.lock, flags);
 408 
 409         usb_dmac_desc_free(uchan);
 410         vchan_free_chan_resources(&uchan->vc);
 411 
 412         pm_runtime_put(chan->device->dev);
 413 }
 414 
 415 static struct dma_async_tx_descriptor *
 416 usb_dmac_prep_slave_sg(struct dma_chan *chan, struct scatterlist *sgl,
 417                        unsigned int sg_len, enum dma_transfer_direction dir,
 418                        unsigned long dma_flags, void *context)
 419 {
 420         struct usb_dmac_chan *uchan = to_usb_dmac_chan(chan);
 421         struct usb_dmac_desc *desc;
 422         struct scatterlist *sg;
 423         int i;
 424 
 425         if (!sg_len) {
 426                 dev_warn(chan->device->dev,
 427                          "%s: bad parameter: len=%d\n", __func__, sg_len);
 428                 return NULL;
 429         }
 430 
 431         desc = usb_dmac_desc_get(uchan, sg_len, GFP_NOWAIT);
 432         if (!desc)
 433                 return NULL;
 434 
 435         desc->direction = dir;
 436         desc->sg_len = sg_len;
 437         for_each_sg(sgl, sg, sg_len, i) {
 438                 desc->sg[i].mem_addr = sg_dma_address(sg);
 439                 desc->sg[i].size = sg_dma_len(sg);
 440         }
 441 
 442         return vchan_tx_prep(&uchan->vc, &desc->vd, dma_flags);
 443 }
 444 
 445 static int usb_dmac_chan_terminate_all(struct dma_chan *chan)
 446 {
 447         struct usb_dmac_chan *uchan = to_usb_dmac_chan(chan);
 448         struct usb_dmac_desc *desc, *_desc;
 449         unsigned long flags;
 450         LIST_HEAD(head);
 451         LIST_HEAD(list);
 452 
 453         spin_lock_irqsave(&uchan->vc.lock, flags);
 454         usb_dmac_chan_halt(uchan);
 455         vchan_get_all_descriptors(&uchan->vc, &head);
 456         if (uchan->desc)
 457                 uchan->desc = NULL;
 458         list_splice_init(&uchan->desc_got, &list);
 459         list_for_each_entry_safe(desc, _desc, &list, node)
 460                 list_move_tail(&desc->node, &uchan->desc_freed);
 461         spin_unlock_irqrestore(&uchan->vc.lock, flags);
 462         vchan_dma_desc_free_list(&uchan->vc, &head);
 463 
 464         return 0;
 465 }
 466 
 467 static unsigned int usb_dmac_get_current_residue(struct usb_dmac_chan *chan,
 468                                                  struct usb_dmac_desc *desc,
 469                                                  int sg_index)
 470 {
 471         struct usb_dmac_sg *sg = desc->sg + sg_index;
 472         u32 mem_addr = sg->mem_addr & 0xffffffff;
 473         unsigned int residue = sg->size;
 474 
 475         /*
 476          * We cannot use USB_DMATCR to calculate residue because USB_DMATCR
 477          * has unsuited value to calculate.
 478          */
 479         if (desc->direction == DMA_DEV_TO_MEM)
 480                 residue -= usb_dmac_chan_read(chan, USB_DMADAR) - mem_addr;
 481         else
 482                 residue -= usb_dmac_chan_read(chan, USB_DMASAR) - mem_addr;
 483 
 484         return residue;
 485 }
 486 
 487 static u32 usb_dmac_chan_get_residue_if_complete(struct usb_dmac_chan *chan,
 488                                                  dma_cookie_t cookie)
 489 {
 490         struct usb_dmac_desc *desc;
 491         u32 residue = 0;
 492 
 493         list_for_each_entry_reverse(desc, &chan->desc_freed, node) {
 494                 if (desc->done_cookie == cookie) {
 495                         residue = desc->residue;
 496                         break;
 497                 }
 498         }
 499 
 500         return residue;
 501 }
 502 
 503 static u32 usb_dmac_chan_get_residue(struct usb_dmac_chan *chan,
 504                                      dma_cookie_t cookie)
 505 {
 506         u32 residue = 0;
 507         struct virt_dma_desc *vd;
 508         struct usb_dmac_desc *desc = chan->desc;
 509         int i;
 510 
 511         if (!desc) {
 512                 vd = vchan_find_desc(&chan->vc, cookie);
 513                 if (!vd)
 514                         return 0;
 515                 desc = to_usb_dmac_desc(vd);
 516         }
 517 
 518         /* Compute the size of all usb_dmac_sg still to be transferred */
 519         for (i = desc->sg_index + 1; i < desc->sg_len; i++)
 520                 residue += desc->sg[i].size;
 521 
 522         /* Add the residue for the current sg */
 523         residue += usb_dmac_get_current_residue(chan, desc, desc->sg_index);
 524 
 525         return residue;
 526 }
 527 
 528 static enum dma_status usb_dmac_tx_status(struct dma_chan *chan,
 529                                           dma_cookie_t cookie,
 530                                           struct dma_tx_state *txstate)
 531 {
 532         struct usb_dmac_chan *uchan = to_usb_dmac_chan(chan);
 533         enum dma_status status;
 534         unsigned int residue = 0;
 535         unsigned long flags;
 536 
 537         status = dma_cookie_status(chan, cookie, txstate);
 538         /* a client driver will get residue after DMA_COMPLETE */
 539         if (!txstate)
 540                 return status;
 541 
 542         spin_lock_irqsave(&uchan->vc.lock, flags);
 543         if (status == DMA_COMPLETE)
 544                 residue = usb_dmac_chan_get_residue_if_complete(uchan, cookie);
 545         else
 546                 residue = usb_dmac_chan_get_residue(uchan, cookie);
 547         spin_unlock_irqrestore(&uchan->vc.lock, flags);
 548 
 549         dma_set_residue(txstate, residue);
 550 
 551         return status;
 552 }
 553 
 554 static void usb_dmac_issue_pending(struct dma_chan *chan)
 555 {
 556         struct usb_dmac_chan *uchan = to_usb_dmac_chan(chan);
 557         unsigned long flags;
 558 
 559         spin_lock_irqsave(&uchan->vc.lock, flags);
 560         if (vchan_issue_pending(&uchan->vc) && !uchan->desc)
 561                 usb_dmac_chan_start_desc(uchan);
 562         spin_unlock_irqrestore(&uchan->vc.lock, flags);
 563 }
 564 
 565 static void usb_dmac_virt_desc_free(struct virt_dma_desc *vd)
 566 {
 567         struct usb_dmac_desc *desc = to_usb_dmac_desc(vd);
 568         struct usb_dmac_chan *chan = to_usb_dmac_chan(vd->tx.chan);
 569 
 570         usb_dmac_desc_put(chan, desc);
 571 }
 572 
 573 /* -----------------------------------------------------------------------------
 574  * IRQ handling
 575  */
 576 
 577 static void usb_dmac_isr_transfer_end(struct usb_dmac_chan *chan)
 578 {
 579         struct usb_dmac_desc *desc = chan->desc;
 580 
 581         BUG_ON(!desc);
 582 
 583         if (++desc->sg_index < desc->sg_len) {
 584                 usb_dmac_chan_start_sg(chan, desc->sg_index);
 585         } else {
 586                 desc->residue = usb_dmac_get_current_residue(chan, desc,
 587                                                         desc->sg_index - 1);
 588                 desc->done_cookie = desc->vd.tx.cookie;
 589                 vchan_cookie_complete(&desc->vd);
 590 
 591                 /* Restart the next transfer if this driver has a next desc */
 592                 usb_dmac_chan_start_desc(chan);
 593         }
 594 }
 595 
 596 static irqreturn_t usb_dmac_isr_channel(int irq, void *dev)
 597 {
 598         struct usb_dmac_chan *chan = dev;
 599         irqreturn_t ret = IRQ_NONE;
 600         u32 mask = 0;
 601         u32 chcr;
 602         bool xfer_end = false;
 603 
 604         spin_lock(&chan->vc.lock);
 605 
 606         chcr = usb_dmac_chan_read(chan, USB_DMACHCR);
 607         if (chcr & (USB_DMACHCR_TE | USB_DMACHCR_SP)) {
 608                 mask |= USB_DMACHCR_DE | USB_DMACHCR_TE | USB_DMACHCR_SP;
 609                 if (chcr & USB_DMACHCR_DE)
 610                         xfer_end = true;
 611                 ret |= IRQ_HANDLED;
 612         }
 613         if (chcr & USB_DMACHCR_NULL) {
 614                 /* An interruption of TE will happen after we set FTE */
 615                 mask |= USB_DMACHCR_NULL;
 616                 chcr |= USB_DMACHCR_FTE;
 617                 ret |= IRQ_HANDLED;
 618         }
 619         if (mask)
 620                 usb_dmac_chan_write(chan, USB_DMACHCR, chcr & ~mask);
 621 
 622         if (xfer_end)
 623                 usb_dmac_isr_transfer_end(chan);
 624 
 625         spin_unlock(&chan->vc.lock);
 626 
 627         return ret;
 628 }
 629 
 630 /* -----------------------------------------------------------------------------
 631  * OF xlate and channel filter
 632  */
 633 
 634 static bool usb_dmac_chan_filter(struct dma_chan *chan, void *arg)
 635 {
 636         struct usb_dmac_chan *uchan = to_usb_dmac_chan(chan);
 637         struct of_phandle_args *dma_spec = arg;
 638 
 639         /* USB-DMAC should be used with fixed usb controller's FIFO */
 640         if (uchan->index != dma_spec->args[0])
 641                 return false;
 642 
 643         return true;
 644 }
 645 
 646 static struct dma_chan *usb_dmac_of_xlate(struct of_phandle_args *dma_spec,
 647                                           struct of_dma *ofdma)
 648 {
 649         struct dma_chan *chan;
 650         dma_cap_mask_t mask;
 651 
 652         if (dma_spec->args_count != 1)
 653                 return NULL;
 654 
 655         /* Only slave DMA channels can be allocated via DT */
 656         dma_cap_zero(mask);
 657         dma_cap_set(DMA_SLAVE, mask);
 658 
 659         chan = __dma_request_channel(&mask, usb_dmac_chan_filter, dma_spec,
 660                                      ofdma->of_node);
 661         if (!chan)
 662                 return NULL;
 663 
 664         return chan;
 665 }
 666 
 667 /* -----------------------------------------------------------------------------
 668  * Power management
 669  */
 670 
 671 #ifdef CONFIG_PM
 672 static int usb_dmac_runtime_suspend(struct device *dev)
 673 {
 674         struct usb_dmac *dmac = dev_get_drvdata(dev);
 675         int i;
 676 
 677         for (i = 0; i < dmac->n_channels; ++i) {
 678                 if (!dmac->channels[i].iomem)
 679                         break;
 680                 usb_dmac_chan_halt(&dmac->channels[i]);
 681         }
 682 
 683         return 0;
 684 }
 685 
 686 static int usb_dmac_runtime_resume(struct device *dev)
 687 {
 688         struct usb_dmac *dmac = dev_get_drvdata(dev);
 689 
 690         return usb_dmac_init(dmac);
 691 }
 692 #endif /* CONFIG_PM */
 693 
 694 static const struct dev_pm_ops usb_dmac_pm = {
 695         SET_NOIRQ_SYSTEM_SLEEP_PM_OPS(pm_runtime_force_suspend,
 696                                       pm_runtime_force_resume)
 697         SET_RUNTIME_PM_OPS(usb_dmac_runtime_suspend, usb_dmac_runtime_resume,
 698                            NULL)
 699 };
 700 
 701 /* -----------------------------------------------------------------------------
 702  * Probe and remove
 703  */
 704 
 705 static int usb_dmac_chan_probe(struct usb_dmac *dmac,
 706                                struct usb_dmac_chan *uchan,
 707                                unsigned int index)
 708 {
 709         struct platform_device *pdev = to_platform_device(dmac->dev);
 710         char pdev_irqname[5];
 711         char *irqname;
 712         int ret;
 713 
 714         uchan->index = index;
 715         uchan->iomem = dmac->iomem + USB_DMAC_CHAN_OFFSET(index);
 716 
 717         /* Request the channel interrupt. */
 718         sprintf(pdev_irqname, "ch%u", index);
 719         uchan->irq = platform_get_irq_byname(pdev, pdev_irqname);
 720         if (uchan->irq < 0)
 721                 return -ENODEV;
 722 
 723         irqname = devm_kasprintf(dmac->dev, GFP_KERNEL, "%s:%u",
 724                                  dev_name(dmac->dev), index);
 725         if (!irqname)
 726                 return -ENOMEM;
 727 
 728         ret = devm_request_irq(dmac->dev, uchan->irq, usb_dmac_isr_channel,
 729                                IRQF_SHARED, irqname, uchan);
 730         if (ret) {
 731                 dev_err(dmac->dev, "failed to request IRQ %u (%d)\n",
 732                         uchan->irq, ret);
 733                 return ret;
 734         }
 735 
 736         uchan->vc.desc_free = usb_dmac_virt_desc_free;
 737         vchan_init(&uchan->vc, &dmac->engine);
 738         INIT_LIST_HEAD(&uchan->desc_freed);
 739         INIT_LIST_HEAD(&uchan->desc_got);
 740 
 741         return 0;
 742 }
 743 
 744 static int usb_dmac_parse_of(struct device *dev, struct usb_dmac *dmac)
 745 {
 746         struct device_node *np = dev->of_node;
 747         int ret;
 748 
 749         ret = of_property_read_u32(np, "dma-channels", &dmac->n_channels);
 750         if (ret < 0) {
 751                 dev_err(dev, "unable to read dma-channels property\n");
 752                 return ret;
 753         }
 754 
 755         if (dmac->n_channels <= 0 || dmac->n_channels >= 100) {
 756                 dev_err(dev, "invalid number of channels %u\n",
 757                         dmac->n_channels);
 758                 return -EINVAL;
 759         }
 760 
 761         return 0;
 762 }
 763 
 764 static int usb_dmac_probe(struct platform_device *pdev)
 765 {
 766         const enum dma_slave_buswidth widths = USB_DMAC_SLAVE_BUSWIDTH;
 767         struct dma_device *engine;
 768         struct usb_dmac *dmac;
 769         struct resource *mem;
 770         unsigned int i;
 771         int ret;
 772 
 773         dmac = devm_kzalloc(&pdev->dev, sizeof(*dmac), GFP_KERNEL);
 774         if (!dmac)
 775                 return -ENOMEM;
 776 
 777         dmac->dev = &pdev->dev;
 778         platform_set_drvdata(pdev, dmac);
 779 
 780         ret = usb_dmac_parse_of(&pdev->dev, dmac);
 781         if (ret < 0)
 782                 return ret;
 783 
 784         dmac->channels = devm_kcalloc(&pdev->dev, dmac->n_channels,
 785                                       sizeof(*dmac->channels), GFP_KERNEL);
 786         if (!dmac->channels)
 787                 return -ENOMEM;
 788 
 789         /* Request resources. */
 790         mem = platform_get_resource(pdev, IORESOURCE_MEM, 0);
 791         dmac->iomem = devm_ioremap_resource(&pdev->dev, mem);
 792         if (IS_ERR(dmac->iomem))
 793                 return PTR_ERR(dmac->iomem);
 794 
 795         /* Enable runtime PM and initialize the device. */
 796         pm_runtime_enable(&pdev->dev);
 797         ret = pm_runtime_get_sync(&pdev->dev);
 798         if (ret < 0) {
 799                 dev_err(&pdev->dev, "runtime PM get sync failed (%d)\n", ret);
 800                 goto error_pm;
 801         }
 802 
 803         ret = usb_dmac_init(dmac);
 804 
 805         if (ret) {
 806                 dev_err(&pdev->dev, "failed to reset device\n");
 807                 goto error;
 808         }
 809 
 810         /* Initialize the channels. */
 811         INIT_LIST_HEAD(&dmac->engine.channels);
 812 
 813         for (i = 0; i < dmac->n_channels; ++i) {
 814                 ret = usb_dmac_chan_probe(dmac, &dmac->channels[i], i);
 815                 if (ret < 0)
 816                         goto error;
 817         }
 818 
 819         /* Register the DMAC as a DMA provider for DT. */
 820         ret = of_dma_controller_register(pdev->dev.of_node, usb_dmac_of_xlate,
 821                                          NULL);
 822         if (ret < 0)
 823                 goto error;
 824 
 825         /*
 826          * Register the DMA engine device.
 827          *
 828          * Default transfer size of 32 bytes requires 32-byte alignment.
 829          */
 830         engine = &dmac->engine;
 831         dma_cap_set(DMA_SLAVE, engine->cap_mask);
 832 
 833         engine->dev = &pdev->dev;
 834 
 835         engine->src_addr_widths = widths;
 836         engine->dst_addr_widths = widths;
 837         engine->directions = BIT(DMA_MEM_TO_DEV) | BIT(DMA_DEV_TO_MEM);
 838         engine->residue_granularity = DMA_RESIDUE_GRANULARITY_BURST;
 839 
 840         engine->device_alloc_chan_resources = usb_dmac_alloc_chan_resources;
 841         engine->device_free_chan_resources = usb_dmac_free_chan_resources;
 842         engine->device_prep_slave_sg = usb_dmac_prep_slave_sg;
 843         engine->device_terminate_all = usb_dmac_chan_terminate_all;
 844         engine->device_tx_status = usb_dmac_tx_status;
 845         engine->device_issue_pending = usb_dmac_issue_pending;
 846 
 847         ret = dma_async_device_register(engine);
 848         if (ret < 0)
 849                 goto error;
 850 
 851         pm_runtime_put(&pdev->dev);
 852         return 0;
 853 
 854 error:
 855         of_dma_controller_free(pdev->dev.of_node);
 856         pm_runtime_put(&pdev->dev);
 857 error_pm:
 858         pm_runtime_disable(&pdev->dev);
 859         return ret;
 860 }
 861 
 862 static void usb_dmac_chan_remove(struct usb_dmac *dmac,
 863                                  struct usb_dmac_chan *uchan)
 864 {
 865         usb_dmac_chan_halt(uchan);
 866         devm_free_irq(dmac->dev, uchan->irq, uchan);
 867 }
 868 
 869 static int usb_dmac_remove(struct platform_device *pdev)
 870 {
 871         struct usb_dmac *dmac = platform_get_drvdata(pdev);
 872         int i;
 873 
 874         for (i = 0; i < dmac->n_channels; ++i)
 875                 usb_dmac_chan_remove(dmac, &dmac->channels[i]);
 876         of_dma_controller_free(pdev->dev.of_node);
 877         dma_async_device_unregister(&dmac->engine);
 878 
 879         pm_runtime_disable(&pdev->dev);
 880 
 881         return 0;
 882 }
 883 
 884 static void usb_dmac_shutdown(struct platform_device *pdev)
 885 {
 886         struct usb_dmac *dmac = platform_get_drvdata(pdev);
 887 
 888         usb_dmac_stop(dmac);
 889 }
 890 
 891 static const struct of_device_id usb_dmac_of_ids[] = {
 892         { .compatible = "renesas,usb-dmac", },
 893         { /* Sentinel */ }
 894 };
 895 MODULE_DEVICE_TABLE(of, usb_dmac_of_ids);
 896 
 897 static struct platform_driver usb_dmac_driver = {
 898         .driver         = {
 899                 .pm     = &usb_dmac_pm,
 900                 .name   = "usb-dmac",
 901                 .of_match_table = usb_dmac_of_ids,
 902         },
 903         .probe          = usb_dmac_probe,
 904         .remove         = usb_dmac_remove,
 905         .shutdown       = usb_dmac_shutdown,
 906 };
 907 
 908 module_platform_driver(usb_dmac_driver);
 909 
 910 MODULE_DESCRIPTION("Renesas USB DMA Controller Driver");
 911 MODULE_AUTHOR("Yoshihiro Shimoda <yoshihiro.shimoda.uh@renesas.com>");
 912 MODULE_LICENSE("GPL v2");
/* [<][>][^][v][top][bottom][index][help] */
root/drivers/dma/sh/usb-dmac.c

DEFINITIONS
