git.sur5r.net Git - freertos/blob

   1 /******************************************************************************
   2 *
   3 * Copyright (C) 2014 Xilinx, Inc.  All rights reserved.
   4 *
   5 * Permission is hereby granted, free of charge, to any person obtaining a copy
   6 * of this software and associated documentation files (the "Software"), to deal
   7 * in the Software without restriction, including without limitation the rights
   8 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
   9 * copies of the Software, and to permit persons to whom the Software is
  10 * furnished to do so, subject to the following conditions:
  11 *
  12 * The above copyright notice and this permission notice shall be included in
  13 * all copies or substantial portions of the Software.
  14 *
  15 * Use of the Software is limited solely to applications:
  16 * (a) running on a Xilinx device, or
  17 * (b) that interact with a Xilinx device through a bus or interconnect.
  18 *
  19 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  20 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  21 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
  22 * XILINX  BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
  23 * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
  24 * OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  25 * SOFTWARE.
  26 *
  27 * Except as contained in this notice, the name of the Xilinx shall not be used
  28 * in advertising or otherwise to promote the sale, use or other dealings in
  29 * this Software without prior written authorization from Xilinx.
  30 *
  31 ******************************************************************************/
  32 /*****************************************************************************/
  33 /**
  34 *
  35 * @file xcsudma_hw.h
  36 * @addtogroup csudma_v1_0
  37 * @{
  38 *
  39 * This header file contains identifiers and register-level driver functions (or
  40 * macros) that can be used to access the Xilinx CSU_DMA core.
  41 *
  42 * <pre>
  43 * MODIFICATION HISTORY:
  44 *
  45 * Ver   Who     Date     Changes
  46 * ----- ------  -------- ------------------------------------------------------
  47 * 1.0   vnsld  22/10/14 First release
  48 * </pre>
  49 *
  50 ******************************************************************************/
  51
  52 #ifndef XCSUDMA_HW_H_
  53 #define XCSUDMA_HW_H_   /**< Prevent circular inclusions
  54                           *  by using protection macros */
  55
  56 #ifdef __cplusplus
  57 extern "C" {
  58 #endif
  59
  60 /***************************** Include Files *********************************/
  61
  62 #include "xil_io.h"
  63
  64 /************************** Constant Definitions *****************************/
  65
  66 /** @name Registers offsets
  67  * @{
  68  */
  69 #define XCSUDMA_ADDR_OFFSET     0x000   /**< Address Register Offset */
  70 #define XCSUDMA_SIZE_OFFSET     0x004   /**< Size Register Offset */
  71 #define XCSUDMA_STS_OFFSET      0x008   /**< Status Register Offset */
  72 #define XCSUDMA_CTRL_OFFSET     0x00C   /**< Control Register Offset */
  73 #define XCSUDMA_CRC_OFFSET      0x010   /**< CheckSum Register Offset */
  74 #define XCSUDMA_I_STS_OFFSET    0x014   /**< Interrupt Status Register
  75                                           *  Offset */
  76 #define XCSUDMA_I_EN_OFFSET     0x018   /**< Interrupt Enable Register
  77                                           *  Offset */
  78 #define XCSUDMA_I_DIS_OFFSET    0x01C   /**< Interrupt Disable Register
  79                                           *  Offset */
  80 #define XCSUDMA_I_MASK_OFFSET   0x020   /**< Interrupt Mask Register Offset */
  81 #define XCSUDMA_CTRL2_OFFSET    0x024   /**< Interrupt Control Register 2
  82                                           *  Offset */
  83 #define XCSUDMA_ADDR_MSB_OFFSET 0x028   /**< Address's MSB Register Offset */
  84 #define XCSUDMA_SAFETY_CHK_OFFSET 0xFF8 /**< Safety Check Field Offset */
  85 #define XCSUDMA_FUTURE_ECO_OFFSET 0xFFC /**< Future potential ECO Offset */
  86 /*@}*/
  87
  88 /** @name CSU Base address and CSU_DMA reset offset
  89  * @{
  90  */
  91 #define XCSU_BASEADDRESS        0xFFCA0000
  92                                                 /**< CSU Base Address */
  93 #define XCSU_DMA_RESET_OFFSET   0x0000000CU     /**< CSU_DMA Reset offset */
  94 /*@}*/
  95
  96 /** @name CSU_DMA Reset register bit masks
  97  * @{
  98  */
  99 #define XCSUDMA_RESET_SET_MASK          0x00000001U     /**< Reset set mask */
 100 #define XCSUDMA_RESET_UNSET_MASK        0x00000000U     /**< Reset unset mask*/
 101 /*@}*/
 102
 103 /** @name Offset difference for Source and destination
 104  * @{
 105  */
 106 #define XCSUDMA_OFFSET_DIFF     0x00000800U     /**< Offset difference for
 107                                                   *  source and
 108                                                   *  destination channels */
 109 /*@}*/
 110
 111 /** @name Address register bit masks
 112  * @{
 113  */
 114 #define XCSUDMA_ADDR_MASK       0xFFFFFFFCU     /**< Address mask */
 115 #define XCSUDMA_ADDR_LSB_MASK   0x00000003U     /**< Address alignment check
 116                                                   *  mask */
 117 /*@}*/
 118
 119 /** @name Size register bit masks and shifts
 120  * @{
 121  */
 122 #define XCSUDMA_SIZE_MASK       0x1FFFFFFCU     /**< Mask for size */
 123 #define XCSUDMA_LAST_WORD_MASK  0x00000001U     /**< Last word check bit mask*/
 124 #define XCSUDMA_SIZE_SHIFT      2U              /**< Shift for size */
 125 /*@}*/
 126
 127 /** @name Status register bit masks and shifts
 128  * @{
 129  */
 130 #define XCSUDMA_STS_DONE_CNT_MASK       0x0000E000U     /**< Count done mask */
 131 #define XCSUDMA_STS_FIFO_LEVEL_MASK     0x00001FE0U     /**< FIFO level mask */
 132 #define XCUSDMA_STS_OUTSTDG_MASK        0x0000001EU     /**< No.of outstanding
 133                                                           *  read/write
 134                                                           *  commands mask */
 135 #define XCSUDMA_STS_BUSY_MASK           0x00000001U     /**< Busy mask */
 136 #define XCSUDMA_STS_DONE_CNT_SHIFT      13U             /**< Shift for Count
 137                                                           *  done */
 138 #define XCSUDMA_STS_FIFO_LEVEL_SHIFT    5U              /**< Shift for FIFO
 139                                                           *  level */
 140 #define XCUSDMA_STS_OUTSTDG_SHIFT       1U              /**< Shift for No.of
 141                                                           *  outstanding
 142                                                           *  read/write
 143                                                           *  commands */
 144 /*@}*/
 145
 146 /** @name Control register bit masks and shifts
 147  * @{
 148  */
 149 #define XCSUDMA_CTRL_SSS_FIFOTHRESH_MASK 0xFE000000U    /**< SSS FIFO threshold
 150                                                           *  value mask */
 151 #define XCSUDMA_CTRL_APB_ERR_MASK       0x01000000U     /**< APB register
 152                                                           *  access error
 153                                                           *  mask */
 154 #define XCSUDMA_CTRL_ENDIAN_MASK        0x00800000U     /**< Endianess mask */
 155 #define XCSUDMA_CTRL_BURST_MASK         0x00400000U     /**< AXI burst type
 156                                                           *  mask */
 157 #define XCSUDMA_CTRL_TIMEOUT_MASK       0x003FFC00U     /**< Time out value
 158                                                           *  mask */
 159 #define XCSUDMA_CTRL_FIFO_THRESH_MASK   0x000003FCU     /**< FIFO threshold
 160                                                           *  mask */
 161 #define XCSUDMA_CTRL_PAUSE_MEM_MASK     0x00000001U     /**< Memory pause
 162                                                           *  mask */
 163 #define XCSUDMA_CTRL_PAUSE_STRM_MASK    0x00000002U     /**< Stream pause
 164                                                           *  mask */
 165 #define XCSUDMA_CTRL_SSS_FIFOTHRESH_SHIFT 25U           /**< SSS FIFO threshold
 166                                                           *  shift */
 167 #define XCSUDMA_CTRL_APB_ERR_SHIFT      24U             /**< APB error shift */
 168 #define XCSUDMA_CTRL_ENDIAN_SHIFT       23U             /**< Endianess shift */
 169 #define XCSUDMA_CTRL_BURST_SHIFT        22U             /**< AXI burst type
 170                                                           *  shift */
 171 #define XCSUDMA_CTRL_TIMEOUT_SHIFT      10U             /**< Time out value
 172                                                           *  shift */
 173 #define XCSUDMA_CTRL_FIFO_THRESH_SHIFT  2U              /**< FIFO thresh
 174                                                           *  shift */
 175 /*@}*/
 176
 177 /** @name CheckSum register bit masks
 178  * @{
 179  */
 180 #define XCSUDMA_CRC_RESET_MASK          0x00000000U     /**< Mask to reset
 181                                                           *  value of
 182                                                           *  check sum */
 183 /*@}*/
 184
 185 /** @name Interrupt Enable/Disable/Mask/Status registers bit masks
 186  * @{
 187  */
 188 #define XCSUDMA_IXR_FIFO_OVERFLOW_MASK  0x00000001U     /**< FIFO overflow
 189                                                           *  mask, it is valid
 190                                                           *  only to Destination
 191                                                           *  Channel */
 192 #define XCSUDMA_IXR_INVALID_APB_MASK    0x00000040U     /**< Invalid APB access
 193                                                           *  mask */
 194 #define XCSUDMA_IXR_FIFO_THRESHHIT_MASK 0x00000020U     /**< FIFO threshold hit
 195                                                           *  indicator mask */
 196 #define XCSUDMA_IXR_TIMEOUT_MEM_MASK    0x00000010U     /**< Time out counter
 197                                                           *  expired to access
 198                                                           *  memory mask */
 199 #define XCSUDMA_IXR_TIMEOUT_STRM_MASK   0x00000008U     /**< Time out counter
 200                                                           *  expired to access
 201                                                           *  stream mask */
 202 #define XCSUDMA_IXR_AXI_WRERR_MASK      0x00000004U     /**< AXI Read/Write
 203                                                           *  error mask */
 204 #define XCSUDMA_IXR_DONE_MASK           0x00000002U     /**< Done mask */
 205 #define XCSUDMA_IXR_MEM_DONE_MASK       0x00000001U     /**< Memory done
 206                                                           *  mask, it is valid
 207                                                           *  only for source
 208                                                           *  channel*/
 209 #define XCSUDMA_IXR_SRC_MASK            0x0000007FU
 210                                         /**< ((XCSUDMA_IXR_INVALID_APB_MASK)|
 211                                         (XCSUDMA_IXR_FIFO_THRESHHIT_MASK) |
 212                                         (XCSUDMA_IXR_TIMEOUT_MEM_MASK) |
 213                                         (XCSUDMA_IXR_TIMEOUT_STRM_MASK) |
 214                                         (XCSUDMA_IXR_AXI_WRERR_MASK) |
 215                                         (XCSUDMA_IXR_DONE_MASK) |
 216                                         (XCSUDMA_IXR_MEM_DONE_MASK)) */
 217                                         /**< All interrupt mask
 218                                           *  for source */
 219 #define XCSUDMA_IXR_DST_MASK            0x000000FEU
 220                                         /**< ((XCSUDMA_IXR_FIFO_OVERFLOW_MASK) |
 221                                         (XCSUDMA_IXR_INVALID_APB_MASK) |
 222                                         (XCSUDMA_IXR_FIFO_THRESHHIT_MASK) |
 223                                         (XCSUDMA_IXR_TIMEOUT_MEM_MASK) |
 224                                         (XCSUDMA_IXR_TIMEOUT_STRM_MASK) |
 225                                         (XCSUDMA_IXR_AXI_WRERR_MASK) |
 226                                         (XCSUDMA_IXR_DONE_MASK)) */
 227                                         /**< All interrupt mask
 228                                           *  for destination */
 229 /*@}*/
 230
 231 /** @name Control register 2 bit masks and shifts
 232  * @{
 233  */
 234 #define XCSUDMA_CTRL2_RESERVED_MASK     0x083F0000U     /**< Reserved bits
 235                                                           *  mask */
 236 #define XCSUDMA_CTRL2_ACACHE_MASK       0X07000000U     /**< AXI CACHE mask */
 237 #define XCSUDMA_CTRL2_ROUTE_MASK        0x00800000U     /**< Route mask */
 238 #define XCSUDMA_CTRL2_TIMEOUT_EN_MASK   0x00400000U     /**< Time out counters
 239                                                           *  enable mask */
 240 #define XCSUDMA_CTRL2_TIMEOUT_PRE_MASK  0x0000FFF0U     /**< Time out pre
 241                                                           *  mask */
 242 #define XCSUDMA_CTRL2_MAXCMDS_MASK      0x0000000FU     /**< Maximum commands
 243                                                           *  mask */
 244 #define XCSUDMA_CTRL2_RESET_MASK        0x0000FFF8U     /**< Reset mask */
 245 #define XCSUDMA_CTRL2_ACACHE_SHIFT      24U             /**< Shift for
 246                                                           *  AXI R/W CACHE */
 247 #define XCSUDMA_CTRL2_ROUTE_SHIFT       23U             /**< Shift for route */
 248 #define XCSUDMA_CTRL2_TIMEOUT_EN_SHIFT  22U             /**< Shift for Timeout
 249                                                           *  enable feild */
 250 #define XCSUDMA_CTRL2_TIMEOUT_PRE_SHIFT 4U              /**< Shift for Timeout
 251                                                           *  pre feild */
 252 /*@}*/
 253
 254 /** @name MSB Address register bit masks and shifts
 255  * @{
 256  */
 257 #define XCSUDMA_MSB_ADDR_MASK   0x0001FFFFU     /**< MSB bits of address
 258                                                   *  mask */
 259 #define XCSUDMA_MSB_ADDR_SHIFT  32U             /**< Shift for MSB bits of
 260                                                   *  address */
 261 /*@}*/
 262
 263 /***************** Macros (Inline Functions) Definitions *********************/
 264
 265 #define XCsuDma_In32            Xil_In32        /**< Input operation */
 266 #define XCsuDma_Out32           Xil_Out32       /**< Output operation */
 267
 268 /*****************************************************************************/
 269 /**
 270 *
 271 * This macro reads the given register.
 272 *
 273 * @param        BaseAddress is the Xilinx base address of the CSU_DMA core.
 274 * @param        RegOffset is the register offset of the register.
 275 *
 276 * @return       The 32-bit value of the register.
 277 *
 278 * @note         C-style signature:
 279 *               u32 XCsuDma_ReadReg(u32 BaseAddress, u32 RegOffset)
 280 *
 281 ******************************************************************************/
 282 #define XCsuDma_ReadReg(BaseAddress, RegOffset) \
 283                 XCsuDma_In32((BaseAddress) + (u32)(RegOffset))
 284
 285 /*****************************************************************************/
 286 /**
 287 *
 288 * This macro writes the value into the given register.
 289 *
 290 * @param        BaseAddress is the Xilinx base address of the CSU_DMA core.
 291 * @param        RegOffset is the register offset of the register.
 292 * @param        Data is the 32-bit value to write to the register.
 293 *
 294 * @return       None.
 295 *
 296 * @note         C-style signature:
 297 *               void XCsuDma_WriteReg(u32 BaseAddress, u32 RegOffset, u32 Data)
 298 *
 299 ******************************************************************************/
 300 #define XCsuDma_WriteReg(BaseAddress, RegOffset, Data) \
 301                 XCsuDma_Out32((BaseAddress) + (u32)(RegOffset), (u32)(Data))
 302
 303
 304 #ifdef __cplusplus
 305 }
 306
 307 #endif
 308
 309
 310 #endif /* End of protection macro */
 311 /** @} */