xemac_i.h 7.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207
  1. /******************************************************************************
  2. *
  3. * Author: Xilinx, Inc.
  4. *
  5. *
  6. * This program is free software; you can redistribute it and/or modify it
  7. * under the terms of the GNU General Public License as published by the
  8. * Free Software Foundation; either version 2 of the License, or (at your
  9. * option) any later version.
  10. *
  11. *
  12. * XILINX IS PROVIDING THIS DESIGN, CODE, OR INFORMATION "AS IS" AS A
  13. * COURTESY TO YOU. BY PROVIDING THIS DESIGN, CODE, OR INFORMATION AS
  14. * ONE POSSIBLE IMPLEMENTATION OF THIS FEATURE, APPLICATION OR STANDARD,
  15. * XILINX IS MAKING NO REPRESENTATION THAT THIS IMPLEMENTATION IS FREE
  16. * FROM ANY CLAIMS OF INFRINGEMENT, AND YOU ARE RESPONSIBLE FOR OBTAINING
  17. * ANY THIRD PARTY RIGHTS YOU MAY REQUIRE FOR YOUR IMPLEMENTATION.
  18. * XILINX EXPRESSLY DISCLAIMS ANY WARRANTY WHATSOEVER WITH RESPECT TO
  19. * THE ADEQUACY OF THE IMPLEMENTATION, INCLUDING BUT NOT LIMITED TO ANY
  20. * WARRANTIES OR REPRESENTATIONS THAT THIS IMPLEMENTATION IS FREE FROM
  21. * CLAIMS OF INFRINGEMENT, IMPLIED WARRANTIES OF MERCHANTABILITY AND
  22. * FITNESS FOR A PARTICULAR PURPOSE.
  23. *
  24. *
  25. * Xilinx hardware products are not intended for use in life support
  26. * appliances, devices, or systems. Use in such applications is
  27. * expressly prohibited.
  28. *
  29. *
  30. * (c) Copyright 2002-2004 Xilinx Inc.
  31. * All rights reserved.
  32. *
  33. *
  34. * You should have received a copy of the GNU General Public License along
  35. * with this program; if not, write to the Free Software Foundation, Inc.,
  36. * 675 Mass Ave, Cambridge, MA 02139, USA.
  37. *
  38. ******************************************************************************/
  39. /*****************************************************************************/
  40. /**
  41. *
  42. * @file xemac_i.h
  43. *
  44. * This header file contains internal identifiers, which are those shared
  45. * between XEmac components. The identifiers in this file are not intended for
  46. * use external to the driver.
  47. *
  48. * <pre>
  49. * MODIFICATION HISTORY:
  50. *
  51. * Ver Who Date Changes
  52. * ----- ---- -------- -----------------------------------------------
  53. * 1.00a rpm 07/31/01 First release
  54. * 1.00b rpm 02/20/02 Repartitioned files and functions
  55. * 1.00b rpm 04/29/02 Moved register definitions to xemac_l.h
  56. * 1.00c rpm 12/05/02 New version includes support for simple DMA
  57. * </pre>
  58. *
  59. ******************************************************************************/
  60. #ifndef XEMAC_I_H /* prevent circular inclusions */
  61. #define XEMAC_I_H /* by using protection macros */
  62. /***************************** Include Files *********************************/
  63. #include "xemac.h"
  64. #include "xemac_l.h"
  65. /************************** Constant Definitions *****************************/
  66. /*
  67. * Default buffer descriptor control word masks. The default send BD control
  68. * is set for incrementing the source address by one for each byte transferred,
  69. * and specify that the destination address (FIFO) is local to the device. The
  70. * default receive BD control is set for incrementing the destination address
  71. * by one for each byte transferred, and specify that the source address is
  72. * local to the device.
  73. */
  74. #define XEM_DFT_SEND_BD_MASK (XDC_DMACR_SOURCE_INCR_MASK | \
  75. XDC_DMACR_DEST_LOCAL_MASK)
  76. #define XEM_DFT_RECV_BD_MASK (XDC_DMACR_DEST_INCR_MASK | \
  77. XDC_DMACR_SOURCE_LOCAL_MASK)
  78. /*
  79. * Masks for the IPIF Device Interrupt enable and status registers.
  80. */
  81. #define XEM_IPIF_EMAC_MASK 0x00000004UL /* MAC interrupt */
  82. #define XEM_IPIF_SEND_DMA_MASK 0x00000008UL /* Send DMA interrupt */
  83. #define XEM_IPIF_RECV_DMA_MASK 0x00000010UL /* Receive DMA interrupt */
  84. #define XEM_IPIF_RECV_FIFO_MASK 0x00000020UL /* Receive FIFO interrupt */
  85. #define XEM_IPIF_SEND_FIFO_MASK 0x00000040UL /* Send FIFO interrupt */
  86. /*
  87. * Default IPIF Device Interrupt mask when configured for DMA
  88. */
  89. #define XEM_IPIF_DMA_DFT_MASK (XEM_IPIF_SEND_DMA_MASK | \
  90. XEM_IPIF_RECV_DMA_MASK | \
  91. XEM_IPIF_EMAC_MASK | \
  92. XEM_IPIF_SEND_FIFO_MASK | \
  93. XEM_IPIF_RECV_FIFO_MASK)
  94. /*
  95. * Default IPIF Device Interrupt mask when configured without DMA
  96. */
  97. #define XEM_IPIF_FIFO_DFT_MASK (XEM_IPIF_EMAC_MASK | \
  98. XEM_IPIF_SEND_FIFO_MASK | \
  99. XEM_IPIF_RECV_FIFO_MASK)
  100. #define XEM_IPIF_DMA_DEV_INTR_COUNT 7 /* Number of interrupt sources */
  101. #define XEM_IPIF_FIFO_DEV_INTR_COUNT 5 /* Number of interrupt sources */
  102. #define XEM_IPIF_DEVICE_INTR_COUNT 7 /* Number of interrupt sources */
  103. #define XEM_IPIF_IP_INTR_COUNT 22 /* Number of MAC interrupts */
  104. /* a mask for all transmit interrupts, used in polled mode */
  105. #define XEM_EIR_XMIT_ALL_MASK (XEM_EIR_XMIT_DONE_MASK | \
  106. XEM_EIR_XMIT_ERROR_MASK | \
  107. XEM_EIR_XMIT_SFIFO_EMPTY_MASK | \
  108. XEM_EIR_XMIT_LFIFO_FULL_MASK)
  109. /* a mask for all receive interrupts, used in polled mode */
  110. #define XEM_EIR_RECV_ALL_MASK (XEM_EIR_RECV_DONE_MASK | \
  111. XEM_EIR_RECV_ERROR_MASK | \
  112. XEM_EIR_RECV_LFIFO_EMPTY_MASK | \
  113. XEM_EIR_RECV_LFIFO_OVER_MASK | \
  114. XEM_EIR_RECV_LFIFO_UNDER_MASK | \
  115. XEM_EIR_RECV_DFIFO_OVER_MASK | \
  116. XEM_EIR_RECV_MISSED_FRAME_MASK | \
  117. XEM_EIR_RECV_COLLISION_MASK | \
  118. XEM_EIR_RECV_FCS_ERROR_MASK | \
  119. XEM_EIR_RECV_LEN_ERROR_MASK | \
  120. XEM_EIR_RECV_SHORT_ERROR_MASK | \
  121. XEM_EIR_RECV_LONG_ERROR_MASK | \
  122. XEM_EIR_RECV_ALIGN_ERROR_MASK)
  123. /* a default interrupt mask for scatter-gather DMA operation */
  124. #define XEM_EIR_DFT_SG_MASK (XEM_EIR_RECV_ERROR_MASK | \
  125. XEM_EIR_RECV_LFIFO_OVER_MASK | \
  126. XEM_EIR_RECV_LFIFO_UNDER_MASK | \
  127. XEM_EIR_XMIT_SFIFO_OVER_MASK | \
  128. XEM_EIR_XMIT_SFIFO_UNDER_MASK | \
  129. XEM_EIR_XMIT_LFIFO_OVER_MASK | \
  130. XEM_EIR_XMIT_LFIFO_UNDER_MASK | \
  131. XEM_EIR_RECV_DFIFO_OVER_MASK | \
  132. XEM_EIR_RECV_MISSED_FRAME_MASK | \
  133. XEM_EIR_RECV_COLLISION_MASK | \
  134. XEM_EIR_RECV_FCS_ERROR_MASK | \
  135. XEM_EIR_RECV_LEN_ERROR_MASK | \
  136. XEM_EIR_RECV_SHORT_ERROR_MASK | \
  137. XEM_EIR_RECV_LONG_ERROR_MASK | \
  138. XEM_EIR_RECV_ALIGN_ERROR_MASK)
  139. /* a default interrupt mask for non-DMA operation (direct FIFOs) */
  140. #define XEM_EIR_DFT_FIFO_MASK (XEM_EIR_XMIT_DONE_MASK | \
  141. XEM_EIR_RECV_DONE_MASK | \
  142. XEM_EIR_DFT_SG_MASK)
  143. /*
  144. * Mask for the DMA interrupt enable and status registers when configured
  145. * for scatter-gather DMA.
  146. */
  147. #define XEM_DMA_SG_INTR_MASK (XDC_IXR_DMA_ERROR_MASK | \
  148. XDC_IXR_PKT_THRESHOLD_MASK | \
  149. XDC_IXR_PKT_WAIT_BOUND_MASK | \
  150. XDC_IXR_SG_END_MASK)
  151. /**************************** Type Definitions *******************************/
  152. /***************** Macros (Inline Functions) Definitions *********************/
  153. /*****************************************************************************/
  154. /*
  155. *
  156. * Clears a structure of given size, in bytes, by setting each byte to 0.
  157. *
  158. * @param StructPtr is a pointer to the structure to be cleared.
  159. * @param NumBytes is the number of bytes in the structure.
  160. *
  161. * @return
  162. *
  163. * None.
  164. *
  165. * @note
  166. *
  167. * Signature: void XEmac_mClearStruct(u8 *StructPtr, unsigned int NumBytes)
  168. *
  169. ******************************************************************************/
  170. #define XEmac_mClearStruct(StructPtr, NumBytes) \
  171. { \
  172. int i; \
  173. u8 *BytePtr = (u8 *)(StructPtr); \
  174. for (i=0; i < (unsigned int)(NumBytes); i++) \
  175. { \
  176. *BytePtr++ = 0; \
  177. } \
  178. }
  179. /************************** Variable Definitions *****************************/
  180. extern XEmac_Config XEmac_ConfigTable[];
  181. /************************** Function Prototypes ******************************/
  182. void XEmac_CheckEmacError(XEmac * InstancePtr, u32 IntrStatus);
  183. void XEmac_CheckFifoRecvError(XEmac * InstancePtr);
  184. void XEmac_CheckFifoSendError(XEmac * InstancePtr);
  185. #endif /* end of protection macro */