linux/drivers/dma/mic_x100_dma.h
<<
>>
Prefs
   1/*
   2 * Intel MIC Platform Software Stack (MPSS)
   3 *
   4 * Copyright(c) 2014 Intel Corporation.
   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, version 2, as
   8 * published by the Free Software Foundation.
   9 *
  10 * This program is distributed in the hope that it will be useful, but
  11 * WITHOUT ANY WARRANTY; without even the implied warranty of
  12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  13 * General Public License for more details.
  14 *
  15 * The full GNU General Public License is included in this distribution in
  16 * the file called "COPYING".
  17 *
  18 * Intel MIC X100 DMA Driver.
  19 *
  20 * Adapted from IOAT dma driver.
  21 */
  22#ifndef _MIC_X100_DMA_H_
  23#define _MIC_X100_DMA_H_
  24
  25#include <linux/kernel.h>
  26#include <linux/delay.h>
  27#include <linux/sched.h>
  28#include <linux/debugfs.h>
  29#include <linux/slab.h>
  30#include <linux/interrupt.h>
  31#include <linux/mic_bus.h>
  32
  33#include "dmaengine.h"
  34
  35/*
  36 * MIC has a total of 8 dma channels.
  37 * Four channels are assigned for host SW use & the remaining for MIC SW.
  38 * MIC DMA transfer size & addresses need to be 64 byte aligned.
  39 */
  40#define MIC_DMA_MAX_NUM_CHAN    8
  41#define MIC_DMA_NUM_CHAN        4
  42#define MIC_DMA_ALIGN_SHIFT     DMAENGINE_ALIGN_64_BYTES
  43#define MIC_DMA_ALIGN_BYTES     (1 << MIC_DMA_ALIGN_SHIFT)
  44#define MIC_DMA_DESC_RX_SIZE    (128 * 1024 - 4)
  45
  46/*
  47 * Register descriptions
  48 * All the registers are 32 bit registers.
  49 * DCR is a global register and all others are per-channel.
  50 * DCR - bits 0, 2, 4, 6, 8, 10, 12, 14 - enable bits for channels 0 to 7
  51 *       bits 1, 3, 5, 7, 9, 11, 13, 15 - owner bits for channels 0 to 7
  52 * DCAR - bit 24 & 25 interrupt masks for mic owned & host owned channels
  53 * DHPR - head of the descriptor ring updated by s/w
  54 * DTPR - tail of the descriptor ring updated by h/w
  55 * DRAR_LO - lower 32 bits of descriptor ring's mic address
  56 * DRAR_HI - 3:0 - remaining 4 bits of descriptor ring's mic address
  57 *           20:4 descriptor ring size
  58 *           25:21 mic smpt entry number
  59 * DSTAT - 16:0 h/w completion count; 31:28 dma engine status
  60 * DCHERR - this register is non-zero on error
  61 * DCHERRMSK - interrupt mask register
  62 */
  63#define MIC_DMA_HW_CMP_CNT_MASK         0x1ffff
  64#define MIC_DMA_CHAN_QUIESCE            0x20000000
  65#define MIC_DMA_SBOX_BASE               0x00010000
  66#define MIC_DMA_SBOX_DCR                0x0000A280
  67#define MIC_DMA_SBOX_CH_BASE            0x0001A000
  68#define MIC_DMA_SBOX_CHAN_OFF           0x40
  69#define MIC_DMA_SBOX_DCAR_IM0           (0x1 << 24)
  70#define MIC_DMA_SBOX_DCAR_IM1           (0x1 << 25)
  71#define MIC_DMA_SBOX_DRARHI_SYS_MASK    (0x1 << 26)
  72#define MIC_DMA_REG_DCAR                0
  73#define MIC_DMA_REG_DHPR                4
  74#define MIC_DMA_REG_DTPR                8
  75#define MIC_DMA_REG_DRAR_LO             20
  76#define MIC_DMA_REG_DRAR_HI             24
  77#define MIC_DMA_REG_DSTAT               32
  78#define MIC_DMA_REG_DCHERR              44
  79#define MIC_DMA_REG_DCHERRMSK           48
  80
  81/* HW dma desc */
  82struct mic_dma_desc {
  83        u64 qw0;
  84        u64 qw1;
  85};
  86
  87enum mic_dma_chan_owner {
  88        MIC_DMA_CHAN_MIC = 0,
  89        MIC_DMA_CHAN_HOST
  90};
  91
  92/*
  93 * mic_dma_chan - channel specific information
  94 * @ch_num: channel number
  95 * @owner: owner of this channel
  96 * @last_tail: cached value of descriptor ring tail
  97 * @head: index of next descriptor in desc_ring
  98 * @issued: hardware notification point
  99 * @submitted: index that will be used to submit descriptors to h/w
 100 * @api_ch: dma engine api channel
 101 * @desc_ring: dma descriptor ring
 102 * @desc_ring_micpa: mic physical address of desc_ring
 103 * @status_dest: destination for status (fence) descriptor
 104 * @status_dest_micpa: mic address for status_dest,
 105 *                     DMA controller uses this address
 106 * @tx_array: array of async_tx
 107 * @cleanup_lock: lock held when processing completed tx
 108 * @prep_lock: lock held in prep_memcpy & released in tx_submit
 109 * @issue_lock: lock used to synchronize writes to head
 110 * @cookie: mic_irq cookie used with mic irq request
 111 */
 112struct mic_dma_chan {
 113        int ch_num;
 114        enum mic_dma_chan_owner owner;
 115        u32 last_tail;
 116        u32 head;
 117        u32 issued;
 118        u32 submitted;
 119        struct dma_chan api_ch;
 120        struct mic_dma_desc *desc_ring;
 121        dma_addr_t desc_ring_micpa;
 122        u64 *status_dest;
 123        dma_addr_t status_dest_micpa;
 124        struct dma_async_tx_descriptor *tx_array;
 125        spinlock_t cleanup_lock;
 126        spinlock_t prep_lock;
 127        spinlock_t issue_lock;
 128        struct mic_irq *cookie;
 129};
 130
 131/*
 132 * struct mic_dma_device - per mic device
 133 * @mic_ch: dma channels
 134 * @dma_dev: underlying dma device
 135 * @mbdev: mic bus dma device
 136 * @mmio: virtual address of the mmio space
 137 * @dbg_dir: debugfs directory
 138 * @start_ch: first channel number that can be used
 139 * @max_xfer_size: maximum transfer size per dma descriptor
 140 */
 141struct mic_dma_device {
 142        struct mic_dma_chan mic_ch[MIC_DMA_MAX_NUM_CHAN];
 143        struct dma_device dma_dev;
 144        struct mbus_device *mbdev;
 145        void __iomem *mmio;
 146        struct dentry *dbg_dir;
 147        int start_ch;
 148        size_t max_xfer_size;
 149};
 150
 151static inline struct mic_dma_chan *to_mic_dma_chan(struct dma_chan *ch)
 152{
 153        return container_of(ch, struct mic_dma_chan, api_ch);
 154}
 155
 156static inline struct mic_dma_device *to_mic_dma_dev(struct mic_dma_chan *ch)
 157{
 158        return
 159        container_of((const typeof(((struct mic_dma_device *)0)->mic_ch)*)
 160                     (ch - ch->ch_num), struct mic_dma_device, mic_ch);
 161}
 162
 163static inline struct mbus_device *to_mbus_device(struct mic_dma_chan *ch)
 164{
 165        return to_mic_dma_dev(ch)->mbdev;
 166}
 167
 168static inline struct mbus_hw_ops *to_mbus_hw_ops(struct mic_dma_chan *ch)
 169{
 170        return to_mbus_device(ch)->hw_ops;
 171}
 172
 173static inline struct device *mic_dma_ch_to_device(struct mic_dma_chan *ch)
 174{
 175        return to_mic_dma_dev(ch)->dma_dev.dev;
 176}
 177
 178static inline void __iomem *mic_dma_chan_to_mmio(struct mic_dma_chan *ch)
 179{
 180        return to_mic_dma_dev(ch)->mmio;
 181}
 182
 183static inline u32 mic_dma_read_reg(struct mic_dma_chan *ch, u32 reg)
 184{
 185        return ioread32(mic_dma_chan_to_mmio(ch) + MIC_DMA_SBOX_CH_BASE +
 186                        ch->ch_num * MIC_DMA_SBOX_CHAN_OFF + reg);
 187}
 188
 189static inline void mic_dma_write_reg(struct mic_dma_chan *ch, u32 reg, u32 val)
 190{
 191        iowrite32(val, mic_dma_chan_to_mmio(ch) + MIC_DMA_SBOX_CH_BASE +
 192                  ch->ch_num * MIC_DMA_SBOX_CHAN_OFF + reg);
 193}
 194
 195static inline u32 mic_dma_mmio_read(struct mic_dma_chan *ch, u32 offset)
 196{
 197        return ioread32(mic_dma_chan_to_mmio(ch) + offset);
 198}
 199
 200static inline void mic_dma_mmio_write(struct mic_dma_chan *ch, u32 val,
 201                                      u32 offset)
 202{
 203        iowrite32(val, mic_dma_chan_to_mmio(ch) + offset);
 204}
 205
 206static inline u32 mic_dma_read_cmp_cnt(struct mic_dma_chan *ch)
 207{
 208        return mic_dma_read_reg(ch, MIC_DMA_REG_DSTAT) &
 209               MIC_DMA_HW_CMP_CNT_MASK;
 210}
 211
 212static inline void mic_dma_chan_set_owner(struct mic_dma_chan *ch)
 213{
 214        u32 dcr = mic_dma_mmio_read(ch, MIC_DMA_SBOX_BASE + MIC_DMA_SBOX_DCR);
 215        u32 chan_num = ch->ch_num;
 216
 217        dcr = (dcr & ~(0x1 << (chan_num * 2))) | (ch->owner << (chan_num * 2));
 218        mic_dma_mmio_write(ch, dcr, MIC_DMA_SBOX_BASE + MIC_DMA_SBOX_DCR);
 219}
 220
 221static inline void mic_dma_enable_chan(struct mic_dma_chan *ch)
 222{
 223        u32 dcr = mic_dma_mmio_read(ch, MIC_DMA_SBOX_BASE + MIC_DMA_SBOX_DCR);
 224
 225        dcr |= 2 << (ch->ch_num << 1);
 226        mic_dma_mmio_write(ch, dcr, MIC_DMA_SBOX_BASE + MIC_DMA_SBOX_DCR);
 227}
 228
 229static inline void mic_dma_disable_chan(struct mic_dma_chan *ch)
 230{
 231        u32 dcr = mic_dma_mmio_read(ch, MIC_DMA_SBOX_BASE + MIC_DMA_SBOX_DCR);
 232
 233        dcr &= ~(2 << (ch->ch_num << 1));
 234        mic_dma_mmio_write(ch, dcr, MIC_DMA_SBOX_BASE + MIC_DMA_SBOX_DCR);
 235}
 236
 237static void mic_dma_chan_set_desc_ring(struct mic_dma_chan *ch)
 238{
 239        u32 drar_hi;
 240        dma_addr_t desc_ring_micpa = ch->desc_ring_micpa;
 241
 242        drar_hi = (MIC_DMA_DESC_RX_SIZE & 0x1ffff) << 4;
 243        if (MIC_DMA_CHAN_MIC == ch->owner) {
 244                drar_hi |= (desc_ring_micpa >> 32) & 0xf;
 245        } else {
 246                drar_hi |= MIC_DMA_SBOX_DRARHI_SYS_MASK;
 247                drar_hi |= ((desc_ring_micpa >> 34)
 248                            & 0x1f) << 21;
 249                drar_hi |= (desc_ring_micpa >> 32) & 0x3;
 250        }
 251        mic_dma_write_reg(ch, MIC_DMA_REG_DRAR_LO, (u32) desc_ring_micpa);
 252        mic_dma_write_reg(ch, MIC_DMA_REG_DRAR_HI, drar_hi);
 253}
 254
 255static inline void mic_dma_chan_mask_intr(struct mic_dma_chan *ch)
 256{
 257        u32 dcar = mic_dma_read_reg(ch, MIC_DMA_REG_DCAR);
 258
 259        if (MIC_DMA_CHAN_MIC == ch->owner)
 260                dcar |= MIC_DMA_SBOX_DCAR_IM0;
 261        else
 262                dcar |= MIC_DMA_SBOX_DCAR_IM1;
 263        mic_dma_write_reg(ch, MIC_DMA_REG_DCAR, dcar);
 264}
 265
 266static inline void mic_dma_chan_unmask_intr(struct mic_dma_chan *ch)
 267{
 268        u32 dcar = mic_dma_read_reg(ch, MIC_DMA_REG_DCAR);
 269
 270        if (MIC_DMA_CHAN_MIC == ch->owner)
 271                dcar &= ~MIC_DMA_SBOX_DCAR_IM0;
 272        else
 273                dcar &= ~MIC_DMA_SBOX_DCAR_IM1;
 274        mic_dma_write_reg(ch, MIC_DMA_REG_DCAR, dcar);
 275}
 276
 277static void mic_dma_ack_interrupt(struct mic_dma_chan *ch)
 278{
 279        if (MIC_DMA_CHAN_MIC == ch->owner) {
 280                /* HW errata */
 281                mic_dma_chan_mask_intr(ch);
 282                mic_dma_chan_unmask_intr(ch);
 283        }
 284        to_mbus_hw_ops(ch)->ack_interrupt(to_mbus_device(ch), ch->ch_num);
 285}
 286#endif
 287