drivers/net/xilinx_ll_temac_sdma.h

   1 /*
   2  * Xilinx xps_ll_temac ethernet driver for u-boot
   3  *
   4  * SDMA sub-controller interface
   5  *
   6  * Copyright (C) 2011 - 2012 Stephan Linz <linz@li-pro.net>
   7  * Copyright (C) 2008 - 2011 Michal Simek <monstr@monstr.eu>
   8  * Copyright (C) 2008 - 2011 PetaLogix
   9  *
  10  * Based on Yoshio Kashiwagi kashiwagi@co-nss.co.jp driver
  11  * Copyright (C) 2008 Nissin Systems Co.,Ltd.
  12  * March 2008 created
  13  *
  14  * This program is free software; you can redistribute it and/or modify it
  15  * under the terms of the GNU General Public License as published by the
  16  * Free Software Foundation; either version 2 of the License, or (at your
  17  * option) any later version.
  18  *
  19  * [0]: http://www.xilinx.com/support/documentation
  20  *
  21  * [S]: [0]/ip_documentation/xps_ll_temac.pdf
  22  * [A]: [0]/application_notes/xapp1041.pdf
  23  */
  24 #ifndef _XILINX_LL_TEMAC_SDMA_
  25 #define _XILINX_LL_TEMAC_SDMA_
  26
  27 #include <net.h>
  28
  29 #include <asm/types.h>
  30 #include <asm/byteorder.h>
  31
  32 #include <linux/compiler.h>
  33
  34 #if !defined(__BIG_ENDIAN)
  35 # error LL_TEMAC requires big endianess
  36 #endif
  37
  38 /*
  39  * DMA Buffer Descriptor for CDMAC
  40  *
  41  * Used for data connection from and to (Rx/Tx) the LocalLink (LL) TEMAC via
  42  * the Communications Direct Memory Access Controller (CDMAC) -- one for each.
  43  *
  44  * overview:
  45  *      ftp://ftp.xilinx.com/pub/documentation/misc/mpmc_getting_started.pdf
  46  *
  47  * [1]: [0]/ip_documentation/mpmc.pdf
  48  *      page 140, DMA Operation Descriptors
  49  *
  50  * [2]: [0]/user_guides/ug200.pdf
  51  *      page 229, DMA Controller -- Descriptor Format
  52  *
  53  * [3]: [0]/ip_documentation/xps_ll_temac.pdf
  54  *      page 72, Transmit LocalLink Frame Format
  55  *      page 73, Receive LocalLink Frame Format
  56  */
  57 struct cdmac_bd {
  58         struct cdmac_bd *next_p;        /* Next Descriptor Pointer */
  59         u8 *phys_buf_p;                 /* Buffer Address */
  60         u32 buf_len;                    /* Buffer Length */
  61         union {
  62                 u8 stctrl;              /* Status/Control the DMA transfer */
  63                 u32 app[5];             /* application specific data */
  64         } __packed __aligned(1) sca;
  65 };
  66
  67 /* CDMAC Descriptor Status and Control (stctrl), [1] p140, [2] p230 */
  68 #define CDMAC_BD_STCTRL_ERROR           (1 << 7)
  69 #define CDMAC_BD_STCTRL_IRQ_ON_END      (1 << 6)
  70 #define CDMAC_BD_STCTRL_STOP_ON_END     (1 << 5)
  71 #define CDMAC_BD_STCTRL_COMPLETED       (1 << 4)
  72 #define CDMAC_BD_STCTRL_SOP             (1 << 3)
  73 #define CDMAC_BD_STCTRL_EOP             (1 << 2)
  74 #define CDMAC_BD_STCTRL_DMACHBUSY       (1 << 1)
  75
  76 /* CDMAC Descriptor APP0: Transmit LocalLink Footer Word 3, [3] p72 */
  77 #define CDMAC_BD_APP0_TXCSCNTRL         (1 << 0)
  78
  79 /* CDMAC Descriptor APP1: Transmit LocalLink Footer Word 4, [3] p73 */
  80 #define CDMAC_BD_APP1_TXCSBEGIN_POS     16
  81 #define CDMAC_BD_APP1_TXCSBEGIN_MASK    (0xFFFF << CDMAC_BD_APP1_TXCSBEGIN_POS)
  82 #define CDMAC_BD_APP1_TXCSINSERT_POS    0
  83 #define CDMAC_BD_APP1_TXCSINSERT_MASK   (0xFFFF << CDMAC_BD_APP1_TXCSINSERT_POS)
  84
  85 /* CDMAC Descriptor APP2: Transmit LocalLink Footer Word 5, [3] p73 */
  86 #define CDMAC_BD_APP2_TXCSINIT_POS      0
  87 #define CDMAC_BD_APP2_TXCSINIT_MASK     (0xFFFF << CDMAC_BD_APP2_TXCSINIT_POS)
  88
  89 /* CDMAC Descriptor APP0: Receive LocalLink Footer Word 3, [3] p73 */
  90 #define CDMAC_BD_APP0_MADDRU_POS        0
  91 #define CDMAC_BD_APP0_MADDRU_MASK       (0xFFFF << CDMAC_BD_APP0_MADDRU_POS)
  92
  93 /* CDMAC Descriptor APP1: Receive LocalLink Footer Word 4, [3] p74 */
  94 #define CDMAC_BD_APP1_MADDRL_POS        0
  95 #define CDMAC_BD_APP1_MADDRL_MASK       (~0UL << CDMAC_BD_APP1_MADDRL_POS)
  96
  97 /* CDMAC Descriptor APP2: Receive LocalLink Footer Word 5, [3] p74 */
  98 #define CDMAC_BD_APP2_BCAST_FRAME       (1 << 2)
  99 #define CDMAC_BD_APP2_IPC_MCAST_FRAME   (1 << 1)
 100 #define CDMAC_BD_APP2_MAC_MCAST_FRAME   (1 << 0)
 101
 102 /* CDMAC Descriptor APP3: Receive LocalLink Footer Word 6, [3] p74 */
 103 #define CDMAC_BD_APP3_TLTPID_POS        16
 104 #define CDMAC_BD_APP3_TLTPID_MASK       (0xFFFF << CDMAC_BD_APP3_TLTPID_POS)
 105 #define CDMAC_BD_APP3_RXCSRAW_POS       0
 106 #define CDMAC_BD_APP3_RXCSRAW_MASK      (0xFFFF << CDMAC_BD_APP3_RXCSRAW_POS)
 107
 108 /* CDMAC Descriptor APP4: Receive LocalLink Footer Word 7, [3] p74 */
 109 #define CDMAC_BD_APP4_VLANTAG_POS       16
 110 #define CDMAC_BD_APP4_VLANTAG_MASK      (0xFFFF << CDMAC_BD_APP4_VLANTAG_POS)
 111 #define CDMAC_BD_APP4_RXBYTECNT_POS     0
 112 #define CDMAC_BD_APP4_RXBYTECNT_MASK    (0x3FFF << CDMAC_BD_APP4_RXBYTECNT_POS)
 113
 114 /*
 115  * SDMA Register Definition
 116  *
 117  * [0]: http://www.xilinx.com/support/documentation
 118  *
 119  * [1]: [0]/ip_documentation/mpmc.pdf
 120  *      page 54, SDMA Register Summary
 121  *      page 160, SDMA Registers
 122  *
 123  * [2]: [0]/user_guides/ug200.pdf
 124  *      page 244, DMA Controller -- Programming Interface and Registers
 125  */
 126 #define SDMA_CTRL_REGTYPE       u32
 127 #define SDMA_CTRL_REGSIZE       sizeof(SDMA_CTRL_REGTYPE)
 128 struct sdma_ctrl {
 129         /* Transmit Registers */
 130         SDMA_CTRL_REGTYPE tx_nxtdesc_ptr;   /* TX Next Description Pointer */
 131         SDMA_CTRL_REGTYPE tx_curbuf_addr;   /* TX Current Buffer Address */
 132         SDMA_CTRL_REGTYPE tx_curbuf_length; /* TX Current Buffer Length */
 133         SDMA_CTRL_REGTYPE tx_curdesc_ptr;   /* TX Current Descriptor Pointer */
 134         SDMA_CTRL_REGTYPE tx_taildesc_ptr;  /* TX Tail Descriptor Pointer */
 135         SDMA_CTRL_REGTYPE tx_chnl_ctrl;     /* TX Channel Control */
 136         SDMA_CTRL_REGTYPE tx_irq_reg;       /* TX Interrupt Register */
 137         SDMA_CTRL_REGTYPE tx_chnl_sts;      /* TX Status Register */
 138         /* Receive Registers */
 139         SDMA_CTRL_REGTYPE rx_nxtdesc_ptr;   /* RX Next Descriptor Pointer */
 140         SDMA_CTRL_REGTYPE rx_curbuf_addr;   /* RX Current Buffer Address */
 141         SDMA_CTRL_REGTYPE rx_curbuf_length; /* RX Current Buffer Length */
 142         SDMA_CTRL_REGTYPE rx_curdesc_ptr;   /* RX Current Descriptor Pointer */
 143         SDMA_CTRL_REGTYPE rx_taildesc_ptr;  /* RX Tail Descriptor Pointer */
 144         SDMA_CTRL_REGTYPE rx_chnl_ctrl;     /* RX Channel Control */
 145         SDMA_CTRL_REGTYPE rx_irq_reg;       /* RX Interrupt Register */
 146         SDMA_CTRL_REGTYPE rx_chnl_sts;      /* RX Status Register */
 147         /* Control Registers */
 148         SDMA_CTRL_REGTYPE dma_control_reg;  /* DMA Control Register */
 149 };
 150
 151 #define SDMA_CTRL_REGNUMS       sizeof(struct sdma_ctrl)/SDMA_CTRL_REGSIZE
 152
 153 /*
 154  * DMAC Register Index Enumeration
 155  *
 156  * [2]: http://www.xilinx.com/support/documentation/user_guides/ug200.pdf
 157  *      page 244, DMA Controller -- Programming Interface and Registers
 158  */
 159 enum dmac_ctrl {
 160         /* Transmit Registers */
 161         TX_NXTDESC_PTR = 0,     /* TX Next Description Pointer */
 162         TX_CURBUF_ADDR,         /* TX Current Buffer Address */
 163         TX_CURBUF_LENGTH,       /* TX Current Buffer Length */
 164         TX_CURDESC_PTR,         /* TX Current Descriptor Pointer */
 165         TX_TAILDESC_PTR,        /* TX Tail Descriptor Pointer */
 166         TX_CHNL_CTRL,           /* TX Channel Control */
 167         TX_IRQ_REG,             /* TX Interrupt Register */
 168         TX_CHNL_STS,            /* TX Status Register */
 169         /* Receive Registers */
 170         RX_NXTDESC_PTR,         /* RX Next Descriptor Pointer */
 171         RX_CURBUF_ADDR,         /* RX Current Buffer Address */
 172         RX_CURBUF_LENGTH,       /* RX Current Buffer Length */
 173         RX_CURDESC_PTR,         /* RX Current Descriptor Pointer */
 174         RX_TAILDESC_PTR,        /* RX Tail Descriptor Pointer */
 175         RX_CHNL_CTRL,           /* RX Channel Control */
 176         RX_IRQ_REG,             /* RX Interrupt Register */
 177         RX_CHNL_STS,            /* RX Status Register */
 178         /* Control Registers */
 179         DMA_CONTROL_REG         /* DMA Control Register */
 180 };
 181
 182 /* Rx/Tx Channel Control Register (*_chnl_ctrl), [1] p163, [2] p246/p252 */
 183 #define CHNL_CTRL_ITO_POS       24
 184 #define CHNL_CTRL_ITO_MASK      (0xFF << CHNL_CTRL_ITO_POS)
 185 #define CHNL_CTRL_IC_POS        16
 186 #define CHNL_CTRL_IC_MASK       (0xFF << CHNL_CTRL_IC_POS)
 187 #define CHNL_CTRL_MSBADDR_POS   12
 188 #define CHNL_CTRL_MSBADDR_MASK  (0xF << CHNL_CTRL_MSBADDR_POS)
 189 #define CHNL_CTRL_AME           (1 << 11)
 190 #define CHNL_CTRL_OBWC          (1 << 10)
 191 #define CHNL_CTRL_IOE           (1 << 9)
 192 #define CHNL_CTRL_LIC           (1 << 8)
 193 #define CHNL_CTRL_IE            (1 << 7)
 194 #define CHNL_CTRL_IEE           (1 << 2)
 195 #define CHNL_CTRL_IDE           (1 << 1)
 196 #define CHNL_CTRL_ICE           (1 << 0)
 197
 198 /* All interrupt enable bits */
 199 #define CHNL_CTRL_IRQ_MASK      (CHNL_CTRL_IE | \
 200                                  CHNL_CTRL_IEE | \
 201                                  CHNL_CTRL_IDE | \
 202                                  CHNL_CTRL_ICE)
 203
 204 /* Rx/Tx Interrupt Status Register (*_irq_reg), [1] p164, [2] p247/p253 */
 205 #define IRQ_REG_DTV_POS         24
 206 #define IRQ_REG_DTV_MASK        (0xFF << IRQ_REG_DTV_POS)
 207 #define IRQ_REG_CCV_POS         16
 208 #define IRQ_REG_CCV_MASK        (0xFF << IRQ_REG_CCV_POS)
 209 #define IRQ_REG_WRCQ_EMPTY      (1 << 14)
 210 #define IRQ_REG_CIC_POS         10
 211 #define IRQ_REG_CIC_MASK        (0xF << IRQ_REG_CIC_POS)
 212 #define IRQ_REG_DIC_POS         8
 213 #define IRQ_REG_DIC_MASK        (3 << 8)
 214 #define IRQ_REG_PLB_RD_NMI      (1 << 4)
 215 #define IRQ_REG_PLB_WR_NMI      (1 << 3)
 216 #define IRQ_REG_EI              (1 << 2)
 217 #define IRQ_REG_DI              (1 << 1)
 218 #define IRQ_REG_CI              (1 << 0)
 219
 220 /* All interrupt bits */
 221 #define IRQ_REG_IRQ_MASK        (IRQ_REG_PLB_RD_NMI | \
 222                                  IRQ_REG_PLB_WR_NMI | \
 223                                  IRQ_REG_EI | IRQ_REG_DI | IRQ_REG_CI)
 224
 225 /* Rx/Tx Channel Status Register (*_chnl_sts), [1] p165, [2] p249/p255 */
 226 #define CHNL_STS_ERROR_TAIL     (1 << 21)
 227 #define CHNL_STS_ERROR_CMP      (1 << 20)
 228 #define CHNL_STS_ERROR_ADDR     (1 << 19)
 229 #define CHNL_STS_ERROR_NXTP     (1 << 18)
 230 #define CHNL_STS_ERROR_CURP     (1 << 17)
 231 #define CHNL_STS_ERROR_BSYWR    (1 << 16)
 232 #define CHNL_STS_ERROR          (1 << 7)
 233 #define CHNL_STS_IOE            (1 << 6)
 234 #define CHNL_STS_SOE            (1 << 5)
 235 #define CHNL_STS_CMPLT          (1 << 4)
 236 #define CHNL_STS_SOP            (1 << 3)
 237 #define CHNL_STS_EOP            (1 << 2)
 238 #define CHNL_STS_EBUSY          (1 << 1)
 239
 240 /* DMA Control Register (dma_control_reg), [1] p166, [2] p256 */
 241 #define DMA_CONTROL_PLBED       (1 << 5)
 242 #define DMA_CONTROL_RXOCEID     (1 << 4)
 243 #define DMA_CONTROL_TXOCEID     (1 << 3)
 244 #define DMA_CONTROL_TPE         (1 << 2)
 245 #define DMA_CONTROL_RESET       (1 << 0)
 246
 247 #if defined(CONFIG_XILINX_440) || defined(CONFIG_XILINX_405)
 248
 249 /* Xilinx Device Control Register (DCR) in/out accessors */
 250 unsigned ll_temac_xldcr_in32(phys_addr_t addr);
 251 void ll_temac_xldcr_out32(phys_addr_t addr, unsigned value);
 252
 253 /* collect all register addresses for Xilinx DCR in/out accessors */
 254 void ll_temac_collect_xldcr_sdma_reg_addr(struct eth_device *dev);
 255
 256 #endif /* CONFIG_XILINX_440 || CONFIG_XILINX_405 */
 257
 258 /* Xilinx Processor Local Bus (PLB) in/out accessors */
 259 unsigned ll_temac_xlplb_in32(phys_addr_t base);
 260 void ll_temac_xlplb_out32(phys_addr_t base, unsigned value);
 261
 262 /* collect all register addresses for Xilinx PLB in/out accessors */
 263 void ll_temac_collect_xlplb_sdma_reg_addr(struct eth_device *dev);
 264
 265 /* initialize both Rx/Tx buffer descriptors */
 266 int ll_temac_init_sdma(struct eth_device *dev);
 267
 268 /* halt both Rx/Tx transfers */
 269 int ll_temac_halt_sdma(struct eth_device *dev);
 270
 271 /* reset SDMA and IRQ, disable interrupts and errors */
 272 int ll_temac_reset_sdma(struct eth_device *dev);
 273
 274 /* receive buffered data from SDMA (polling ISR) */
 275 int ll_temac_recv_sdma(struct eth_device *dev);
 276
 277 /* send buffered data to SDMA */
 278 int ll_temac_send_sdma(struct eth_device *dev, void *packet, int length);
 279
 280 #endif /* _XILINX_LL_TEMAC_SDMA_ */