descs.h 7.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227
  1. /*
  2. * TC956X ethernet driver.
  3. *
  4. * descs.h - Header File to describe the DMA descriptors and related definitions.
  5. * This is for DWMAC100 and 1000 cores.
  6. *
  7. * Copyright (C) 2007-2009 STMicroelectronics Ltd
  8. * Copyright (C) 2021 Toshiba Electronic Devices & Storage Corporation
  9. *
  10. * This file has been derived from the STMicro Linux driver,
  11. * and developed or modified for TC956X.
  12. *
  13. * This program is free software; you can redistribute it and/or modify
  14. * it under the terms of the GNU General Public License as published by
  15. * the Free Software Foundation; either version 2, or (at your option)
  16. * any later version.
  17. *
  18. * This program is distributed in the hope that it will be useful,
  19. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  20. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  21. * GNU General Public License for more details.
  22. *
  23. * You should have received a copy of the GNU General Public License
  24. * along with this program; if not, write to the Free Software
  25. * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  26. */
  27. /*! History:
  28. * 20 Jan 2021 : Initial Version
  29. * VERSION : 00-01
  30. *
  31. * 15 Mar 2021 : Base lined
  32. * VERSION : 01-00
  33. */
  34. #ifndef __DESCS_H__
  35. #define __DESCS_H__
  36. #include <linux/bitops.h>
  37. /* Normal receive descriptor defines */
  38. /* RDES0 */
  39. #define RDES0_PAYLOAD_CSUM_ERR BIT(0)
  40. #define RDES0_CRC_ERROR BIT(1)
  41. #define RDES0_DRIBBLING BIT(2)
  42. #define RDES0_MII_ERROR BIT(3)
  43. #define RDES0_RECEIVE_WATCHDOG BIT(4)
  44. #define RDES0_FRAME_TYPE BIT(5)
  45. #define RDES0_COLLISION BIT(6)
  46. #define RDES0_IPC_CSUM_ERROR BIT(7)
  47. #define RDES0_LAST_DESCRIPTOR BIT(8)
  48. #define RDES0_FIRST_DESCRIPTOR BIT(9)
  49. #define RDES0_VLAN_TAG BIT(10)
  50. #define RDES0_OVERFLOW_ERROR BIT(11)
  51. #define RDES0_LENGTH_ERROR BIT(12)
  52. #define RDES0_SA_FILTER_FAIL BIT(13)
  53. #define RDES0_DESCRIPTOR_ERROR BIT(14)
  54. #define RDES0_ERROR_SUMMARY BIT(15)
  55. #define RDES0_FRAME_LEN_MASK GENMASK(29, 16)
  56. #define RDES0_FRAME_LEN_SHIFT 16
  57. #define RDES0_DA_FILTER_FAIL BIT(30)
  58. #define RDES0_OWN BIT(31)
  59. /* RDES1 */
  60. #define RDES1_BUFFER1_SIZE_MASK GENMASK(10, 0)
  61. #define RDES1_BUFFER2_SIZE_MASK GENMASK(21, 11)
  62. #define RDES1_BUFFER2_SIZE_SHIFT 11
  63. #define RDES1_SECOND_ADDRESS_CHAINED BIT(24)
  64. #define RDES1_END_RING BIT(25)
  65. #define RDES1_DISABLE_IC BIT(31)
  66. /* Enhanced receive descriptor defines */
  67. /* RDES0 (similar to normal RDES) */
  68. #define ERDES0_RX_MAC_ADDR BIT(0)
  69. /* RDES1: completely differ from normal desc definitions */
  70. #define ERDES1_BUFFER1_SIZE_MASK GENMASK(12, 0)
  71. #define ERDES1_SECOND_ADDRESS_CHAINED BIT(14)
  72. #define ERDES1_END_RING BIT(15)
  73. #define ERDES1_BUFFER2_SIZE_MASK GENMASK(28, 16)
  74. #define ERDES1_BUFFER2_SIZE_SHIFT 16
  75. #define ERDES1_DISABLE_IC BIT(31)
  76. /* Normal transmit descriptor defines */
  77. /* TDES0 */
  78. #define TDES0_DEFERRED BIT(0)
  79. #define TDES0_UNDERFLOW_ERROR BIT(1)
  80. #define TDES0_EXCESSIVE_DEFERRAL BIT(2)
  81. #define TDES0_COLLISION_COUNT_MASK GENMASK(6, 3)
  82. #define TDES0_VLAN_FRAME BIT(7)
  83. #define TDES0_EXCESSIVE_COLLISIONS BIT(8)
  84. #define TDES0_LATE_COLLISION BIT(9)
  85. #define TDES0_NO_CARRIER BIT(10)
  86. #define TDES0_LOSS_CARRIER BIT(11)
  87. #define TDES0_PAYLOAD_ERROR BIT(12)
  88. #define TDES0_FRAME_FLUSHED BIT(13)
  89. #define TDES0_JABBER_TIMEOUT BIT(14)
  90. #define TDES0_ERROR_SUMMARY BIT(15)
  91. #define TDES0_IP_HEADER_ERROR BIT(16)
  92. #define TDES0_TIME_STAMP_STATUS BIT(17)
  93. #define TDES0_OWN ((u32)BIT(31)) /* silence sparse */
  94. /* TDES1 */
  95. #define TDES1_BUFFER1_SIZE_MASK GENMASK(10, 0)
  96. #define TDES1_BUFFER2_SIZE_MASK GENMASK(21, 11)
  97. #define TDES1_BUFFER2_SIZE_SHIFT 11
  98. #define TDES1_TIME_STAMP_ENABLE BIT(22)
  99. #define TDES1_DISABLE_PADDING BIT(23)
  100. #define TDES1_SECOND_ADDRESS_CHAINED BIT(24)
  101. #define TDES1_END_RING BIT(25)
  102. #define TDES1_CRC_DISABLE BIT(26)
  103. #define TDES1_CHECKSUM_INSERTION_MASK GENMASK(28, 27)
  104. #define TDES1_CHECKSUM_INSERTION_SHIFT 27
  105. #define TDES1_FIRST_SEGMENT BIT(29)
  106. #define TDES1_LAST_SEGMENT BIT(30)
  107. #define TDES1_INTERRUPT BIT(31)
  108. /* Enhanced transmit descriptor defines */
  109. /* TDES0 */
  110. #define ETDES0_DEFERRED BIT(0)
  111. #define ETDES0_UNDERFLOW_ERROR BIT(1)
  112. #define ETDES0_EXCESSIVE_DEFERRAL BIT(2)
  113. #define ETDES0_COLLISION_COUNT_MASK GENMASK(6, 3)
  114. #define ETDES0_VLAN_FRAME BIT(7)
  115. #define ETDES0_EXCESSIVE_COLLISIONS BIT(8)
  116. #define ETDES0_LATE_COLLISION BIT(9)
  117. #define ETDES0_NO_CARRIER BIT(10)
  118. #define ETDES0_LOSS_CARRIER BIT(11)
  119. #define ETDES0_PAYLOAD_ERROR BIT(12)
  120. #define ETDES0_FRAME_FLUSHED BIT(13)
  121. #define ETDES0_JABBER_TIMEOUT BIT(14)
  122. #define ETDES0_ERROR_SUMMARY BIT(15)
  123. #define ETDES0_IP_HEADER_ERROR BIT(16)
  124. #define ETDES0_TIME_STAMP_STATUS BIT(17)
  125. #define ETDES0_SECOND_ADDRESS_CHAINED BIT(20)
  126. #define ETDES0_END_RING BIT(21)
  127. #define ETDES0_CHECKSUM_INSERTION_MASK GENMASK(23, 22)
  128. #define ETDES0_CHECKSUM_INSERTION_SHIFT 22
  129. #define ETDES0_TIME_STAMP_ENABLE BIT(25)
  130. #define ETDES0_DISABLE_PADDING BIT(26)
  131. #define ETDES0_CRC_DISABLE BIT(27)
  132. #define ETDES0_FIRST_SEGMENT BIT(28)
  133. #define ETDES0_LAST_SEGMENT BIT(29)
  134. #define ETDES0_INTERRUPT BIT(30)
  135. #define ETDES0_OWN ((u32)BIT(31)) /* silence sparse */
  136. /* TDES1 */
  137. #define ETDES1_BUFFER1_SIZE_MASK GENMASK(12, 0)
  138. #define ETDES1_BUFFER2_SIZE_MASK GENMASK(28, 16)
  139. #define ETDES1_BUFFER2_SIZE_SHIFT 16
  140. /* Extended Receive descriptor definitions */
  141. #define ERDES4_IP_PAYLOAD_TYPE_MASK GENMASK(6, 2)
  142. #define ERDES4_IP_HDR_ERR BIT(3)
  143. #define ERDES4_IP_PAYLOAD_ERR BIT(4)
  144. #define ERDES4_IP_CSUM_BYPASSED BIT(5)
  145. #define ERDES4_IPV4_PKT_RCVD BIT(6)
  146. #define ERDES4_IPV6_PKT_RCVD BIT(7)
  147. #define ERDES4_MSG_TYPE_MASK GENMASK(11, 8)
  148. #define ERDES4_PTP_FRAME_TYPE BIT(12)
  149. #define ERDES4_PTP_VER BIT(13)
  150. #define ERDES4_TIMESTAMP_DROPPED BIT(14)
  151. #define ERDES4_AV_PKT_RCVD BIT(16)
  152. #define ERDES4_AV_TAGGED_PKT_RCVD BIT(17)
  153. #define ERDES4_VLAN_TAG_PRI_VAL_MASK GENMASK(20, 18)
  154. #define ERDES4_L3_FILTER_MATCH BIT(24)
  155. #define ERDES4_L4_FILTER_MATCH BIT(25)
  156. #define ERDES4_L3_L4_FILT_NO_MATCH_MASK GENMASK(27, 26)
  157. /* Extended RDES4 message type definitions */
  158. #define RDES_EXT_NO_PTP 0x0
  159. #define RDES_EXT_SYNC 0x1
  160. #define RDES_EXT_FOLLOW_UP 0x2
  161. #define RDES_EXT_DELAY_REQ 0x3
  162. #define RDES_EXT_DELAY_RESP 0x4
  163. #define RDES_EXT_PDELAY_REQ 0x5
  164. #define RDES_EXT_PDELAY_RESP 0x6
  165. #define RDES_EXT_PDELAY_FOLLOW_UP 0x7
  166. #define RDES_PTP_ANNOUNCE 0x8
  167. #define RDES_PTP_MANAGEMENT 0x9
  168. #define RDES_PTP_SIGNALING 0xa
  169. #define RDES_PTP_PKT_RESERVED_TYPE 0xf
  170. #ifdef TC956X_SRIOV_VF /* MMC SW counter related */
  171. /* RDES3 PMT message type definitions */
  172. #define RDES_PMT_NO_PTP 0x0
  173. #define RDES_PMT_SYNC 0x1
  174. #define RDES_PMT_FOLLOW_UP 0x2
  175. #define RDES_PMT_DELAY_REQ 0x3
  176. #define RDES_PMT_DELAY_RESP 0x4
  177. #define RDES_PMT_PDELAY_REQ 0x5
  178. #define RDES_PMT_PDELAY_RESP 0x6
  179. #define RDES_PMT_PDELAY_FOLLOW_UP 0x7
  180. #define RDES_PMT_PTP_ANNOUNCE 0x8
  181. #define RDES_PMT_PTP_MANAGEMENT 0x9
  182. #define RDES_PMT_PTP_SIGNALING 0xa
  183. #define RDES_PMT_PTP_PKT_RESERVED_TYPE 0xf
  184. #endif
  185. /* Basic descriptor structure for normal and alternate descriptors */
  186. struct dma_desc {
  187. __le32 des0;
  188. __le32 des1;
  189. __le32 des2;
  190. __le32 des3;
  191. };
  192. /* Extended descriptor structure (e.g. >= databook 3.50a) */
  193. struct dma_extended_desc {
  194. struct dma_desc basic; /* Basic descriptors */
  195. __le32 des4; /* Extended Status */
  196. __le32 des5; /* Reserved */
  197. __le32 des6; /* Tx/Rx Timestamp Low */
  198. __le32 des7; /* Tx/Rx Timestamp High */
  199. };
  200. /* Enhanced descriptor for TBS */
  201. struct dma_edesc {
  202. __le32 des4;
  203. __le32 des5;
  204. __le32 des6;
  205. __le32 des7;
  206. struct dma_desc basic;
  207. };
  208. /* Transmit checksum insertion control */
  209. #define TX_CIC_FULL 3 /* Include IP header and pseudoheader */
  210. #endif /* __DESCS_H__ */