1 /* SPDX-License-Identifier: GPL-2.0-or-later */ 2 /* 3 * Actions Semi Owl SoCs Ethernet MAC driver 4 * 5 * Copyright (c) 2012 Actions Semi Inc. 6 * Copyright (c) 2021 Cristian Ciocaltea <cristian.ciocaltea@gmail.com> 7 */ 8 9 #ifndef __OWL_EMAC_H__ 10 #define __OWL_EMAC_H__ 11 12 #define OWL_EMAC_DRVNAME "owl-emac" 13 14 #define OWL_EMAC_POLL_DELAY_USEC 5 15 #define OWL_EMAC_MDIO_POLL_TIMEOUT_USEC 1000 16 #define OWL_EMAC_RESET_POLL_TIMEOUT_USEC 2000 17 #define OWL_EMAC_TX_TIMEOUT (2 * HZ) 18 19 #define OWL_EMAC_MTU_MIN ETH_MIN_MTU 20 #define OWL_EMAC_MTU_MAX ETH_DATA_LEN 21 #define OWL_EMAC_RX_FRAME_MAX_LEN (ETH_FRAME_LEN + ETH_FCS_LEN) 22 #define OWL_EMAC_SKB_ALIGN 4 23 #define OWL_EMAC_SKB_RESERVE 18 24 25 #define OWL_EMAC_MAX_MULTICAST_ADDRS 14 26 #define OWL_EMAC_SETUP_FRAME_LEN 192 27 28 #define OWL_EMAC_RX_RING_SIZE 64 29 #define OWL_EMAC_TX_RING_SIZE 32 30 31 /* Bus mode register */ 32 #define OWL_EMAC_REG_MAC_CSR0 0x0000 33 #define OWL_EMAC_BIT_MAC_CSR0_SWR BIT(0) /* Software reset */ 34 35 /* Transmit/receive poll demand registers */ 36 #define OWL_EMAC_REG_MAC_CSR1 0x0008 37 #define OWL_EMAC_VAL_MAC_CSR1_TPD 0x01 38 #define OWL_EMAC_REG_MAC_CSR2 0x0010 39 #define OWL_EMAC_VAL_MAC_CSR2_RPD 0x01 40 41 /* Receive/transmit descriptor list base address registers */ 42 #define OWL_EMAC_REG_MAC_CSR3 0x0018 43 #define OWL_EMAC_REG_MAC_CSR4 0x0020 44 45 /* Status register */ 46 #define OWL_EMAC_REG_MAC_CSR5 0x0028 47 #define OWL_EMAC_MSK_MAC_CSR5_TS GENMASK(22, 20) /* Transmit process state */ 48 #define OWL_EMAC_OFF_MAC_CSR5_TS 20 49 #define OWL_EMAC_VAL_MAC_CSR5_TS_DATA 0x03 /* Transferring data HOST -> FIFO */ 50 #define OWL_EMAC_VAL_MAC_CSR5_TS_CDES 0x07 /* Closing transmit descriptor */ 51 #define OWL_EMAC_MSK_MAC_CSR5_RS GENMASK(19, 17) /* Receive process state */ 52 #define OWL_EMAC_OFF_MAC_CSR5_RS 17 53 #define OWL_EMAC_VAL_MAC_CSR5_RS_FDES 0x01 /* Fetching receive descriptor */ 54 #define OWL_EMAC_VAL_MAC_CSR5_RS_CDES 0x05 /* Closing receive descriptor */ 55 #define OWL_EMAC_VAL_MAC_CSR5_RS_DATA 0x07 /* Transferring data FIFO -> HOST */ 56 #define OWL_EMAC_BIT_MAC_CSR5_NIS BIT(16) /* Normal interrupt summary */ 57 #define OWL_EMAC_BIT_MAC_CSR5_AIS BIT(15) /* Abnormal interrupt summary */ 58 #define OWL_EMAC_BIT_MAC_CSR5_ERI BIT(14) /* Early receive interrupt */ 59 #define OWL_EMAC_BIT_MAC_CSR5_GTE BIT(11) /* General-purpose timer expiration */ 60 #define OWL_EMAC_BIT_MAC_CSR5_ETI BIT(10) /* Early transmit interrupt */ 61 #define OWL_EMAC_BIT_MAC_CSR5_RPS BIT(8) /* Receive process stopped */ 62 #define OWL_EMAC_BIT_MAC_CSR5_RU BIT(7) /* Receive buffer unavailable */ 63 #define OWL_EMAC_BIT_MAC_CSR5_RI BIT(6) /* Receive interrupt */ 64 #define OWL_EMAC_BIT_MAC_CSR5_UNF BIT(5) /* Transmit underflow */ 65 #define OWL_EMAC_BIT_MAC_CSR5_LCIS BIT(4) /* Link change status */ 66 #define OWL_EMAC_BIT_MAC_CSR5_LCIQ BIT(3) /* Link change interrupt */ 67 #define OWL_EMAC_BIT_MAC_CSR5_TU BIT(2) /* Transmit buffer unavailable */ 68 #define OWL_EMAC_BIT_MAC_CSR5_TPS BIT(1) /* Transmit process stopped */ 69 #define OWL_EMAC_BIT_MAC_CSR5_TI BIT(0) /* Transmit interrupt */ 70 71 /* Operation mode register */ 72 #define OWL_EMAC_REG_MAC_CSR6 0x0030 73 #define OWL_EMAC_BIT_MAC_CSR6_RA BIT(30) /* Receive all */ 74 #define OWL_EMAC_BIT_MAC_CSR6_TTM BIT(22) /* Transmit threshold mode */ 75 #define OWL_EMAC_BIT_MAC_CSR6_SF BIT(21) /* Store and forward */ 76 #define OWL_EMAC_MSK_MAC_CSR6_SPEED GENMASK(17, 16) /* Eth speed selection */ 77 #define OWL_EMAC_OFF_MAC_CSR6_SPEED 16 78 #define OWL_EMAC_VAL_MAC_CSR6_SPEED_100M 0x00 79 #define OWL_EMAC_VAL_MAC_CSR6_SPEED_10M 0x02 80 #define OWL_EMAC_BIT_MAC_CSR6_ST BIT(13) /* Start/stop transmit command */ 81 #define OWL_EMAC_BIT_MAC_CSR6_LP BIT(10) /* Loopback mode */ 82 #define OWL_EMAC_BIT_MAC_CSR6_FD BIT(9) /* Full duplex mode */ 83 #define OWL_EMAC_BIT_MAC_CSR6_PM BIT(7) /* Pass all multicast */ 84 #define OWL_EMAC_BIT_MAC_CSR6_PR BIT(6) /* Promiscuous mode */ 85 #define OWL_EMAC_BIT_MAC_CSR6_IF BIT(4) /* Inverse filtering */ 86 #define OWL_EMAC_BIT_MAC_CSR6_PB BIT(3) /* Pass bad frames */ 87 #define OWL_EMAC_BIT_MAC_CSR6_HO BIT(2) /* Hash only filtering mode */ 88 #define OWL_EMAC_BIT_MAC_CSR6_SR BIT(1) /* Start/stop receive command */ 89 #define OWL_EMAC_BIT_MAC_CSR6_HP BIT(0) /* Hash/perfect receive filtering mode */ 90 #define OWL_EMAC_MSK_MAC_CSR6_STSR (OWL_EMAC_BIT_MAC_CSR6_ST | \ 91 OWL_EMAC_BIT_MAC_CSR6_SR) 92 93 /* Interrupt enable register */ 94 #define OWL_EMAC_REG_MAC_CSR7 0x0038 95 #define OWL_EMAC_BIT_MAC_CSR7_NIE BIT(16) /* Normal interrupt summary enable */ 96 #define OWL_EMAC_BIT_MAC_CSR7_AIE BIT(15) /* Abnormal interrupt summary enable */ 97 #define OWL_EMAC_BIT_MAC_CSR7_ERE BIT(14) /* Early receive interrupt enable */ 98 #define OWL_EMAC_BIT_MAC_CSR7_GTE BIT(11) /* General-purpose timer overflow */ 99 #define OWL_EMAC_BIT_MAC_CSR7_ETE BIT(10) /* Early transmit interrupt enable */ 100 #define OWL_EMAC_BIT_MAC_CSR7_RSE BIT(8) /* Receive stopped enable */ 101 #define OWL_EMAC_BIT_MAC_CSR7_RUE BIT(7) /* Receive buffer unavailable enable */ 102 #define OWL_EMAC_BIT_MAC_CSR7_RIE BIT(6) /* Receive interrupt enable */ 103 #define OWL_EMAC_BIT_MAC_CSR7_UNE BIT(5) /* Underflow interrupt enable */ 104 #define OWL_EMAC_BIT_MAC_CSR7_TUE BIT(2) /* Transmit buffer unavailable enable */ 105 #define OWL_EMAC_BIT_MAC_CSR7_TSE BIT(1) /* Transmit stopped enable */ 106 #define OWL_EMAC_BIT_MAC_CSR7_TIE BIT(0) /* Transmit interrupt enable */ 107 #define OWL_EMAC_BIT_MAC_CSR7_ALL_NOT_TUE (OWL_EMAC_BIT_MAC_CSR7_ERE | \ 108 OWL_EMAC_BIT_MAC_CSR7_GTE | \ 109 OWL_EMAC_BIT_MAC_CSR7_ETE | \ 110 OWL_EMAC_BIT_MAC_CSR7_RSE | \ 111 OWL_EMAC_BIT_MAC_CSR7_RUE | \ 112 OWL_EMAC_BIT_MAC_CSR7_RIE | \ 113 OWL_EMAC_BIT_MAC_CSR7_UNE | \ 114 OWL_EMAC_BIT_MAC_CSR7_TSE | \ 115 OWL_EMAC_BIT_MAC_CSR7_TIE) 116 117 /* Missed frames and overflow counter register */ 118 #define OWL_EMAC_REG_MAC_CSR8 0x0040 119 /* MII management and serial ROM register */ 120 #define OWL_EMAC_REG_MAC_CSR9 0x0048 121 122 /* MII serial management register */ 123 #define OWL_EMAC_REG_MAC_CSR10 0x0050 124 #define OWL_EMAC_BIT_MAC_CSR10_SB BIT(31) /* Start transfer or busy */ 125 #define OWL_EMAC_MSK_MAC_CSR10_CLKDIV GENMASK(30, 28) /* Clock divider */ 126 #define OWL_EMAC_OFF_MAC_CSR10_CLKDIV 28 127 #define OWL_EMAC_VAL_MAC_CSR10_CLKDIV_128 0x04 128 #define OWL_EMAC_VAL_MAC_CSR10_OPCODE_WR 0x01 /* Register write command */ 129 #define OWL_EMAC_OFF_MAC_CSR10_OPCODE 26 /* Operation mode */ 130 #define OWL_EMAC_VAL_MAC_CSR10_OPCODE_DCG 0x00 /* Disable clock generation */ 131 #define OWL_EMAC_VAL_MAC_CSR10_OPCODE_WR 0x01 /* Register write command */ 132 #define OWL_EMAC_VAL_MAC_CSR10_OPCODE_RD 0x02 /* Register read command */ 133 #define OWL_EMAC_VAL_MAC_CSR10_OPCODE_CDS 0x03 /* Clock divider set */ 134 #define OWL_EMAC_MSK_MAC_CSR10_PHYADD GENMASK(25, 21) /* Physical layer address */ 135 #define OWL_EMAC_OFF_MAC_CSR10_PHYADD 21 136 #define OWL_EMAC_MSK_MAC_CSR10_REGADD GENMASK(20, 16) /* Register address */ 137 #define OWL_EMAC_OFF_MAC_CSR10_REGADD 16 138 #define OWL_EMAC_MSK_MAC_CSR10_DATA GENMASK(15, 0) /* Register data */ 139 140 /* General-purpose timer and interrupt mitigation control register */ 141 #define OWL_EMAC_REG_MAC_CSR11 0x0058 142 #define OWL_EMAC_OFF_MAC_CSR11_TT 27 /* Transmit timer */ 143 #define OWL_EMAC_OFF_MAC_CSR11_NTP 24 /* No. of transmit packets */ 144 #define OWL_EMAC_OFF_MAC_CSR11_RT 20 /* Receive timer */ 145 #define OWL_EMAC_OFF_MAC_CSR11_NRP 17 /* No. of receive packets */ 146 147 /* MAC address low/high registers */ 148 #define OWL_EMAC_REG_MAC_CSR16 0x0080 149 #define OWL_EMAC_REG_MAC_CSR17 0x0088 150 151 /* Pause time & cache thresholds register */ 152 #define OWL_EMAC_REG_MAC_CSR18 0x0090 153 #define OWL_EMAC_OFF_MAC_CSR18_CPTL 24 /* Cache pause threshold level */ 154 #define OWL_EMAC_OFF_MAC_CSR18_CRTL 16 /* Cache restart threshold level */ 155 #define OWL_EMAC_OFF_MAC_CSR18_PQT 0 /* Flow control pause quanta time */ 156 157 /* FIFO pause & restart threshold register */ 158 #define OWL_EMAC_REG_MAC_CSR19 0x0098 159 #define OWL_EMAC_OFF_MAC_CSR19_FPTL 16 /* FIFO pause threshold level */ 160 #define OWL_EMAC_OFF_MAC_CSR19_FRTL 0 /* FIFO restart threshold level */ 161 162 /* Flow control setup & status register */ 163 #define OWL_EMAC_REG_MAC_CSR20 0x00A0 164 #define OWL_EMAC_BIT_MAC_CSR20_FCE BIT(31) /* Flow Control Enable */ 165 #define OWL_EMAC_BIT_MAC_CSR20_TUE BIT(30) /* Transmit Un-pause frames Enable */ 166 #define OWL_EMAC_BIT_MAC_CSR20_TPE BIT(29) /* Transmit Pause frames Enable */ 167 #define OWL_EMAC_BIT_MAC_CSR20_RPE BIT(28) /* Receive Pause frames Enable */ 168 #define OWL_EMAC_BIT_MAC_CSR20_BPE BIT(27) /* Back pressure (half-duplex) Enable */ 169 170 /* MII control register */ 171 #define OWL_EMAC_REG_MAC_CTRL 0x00B0 172 #define OWL_EMAC_BIT_MAC_CTRL_RRSB BIT(8) /* RMII_REFCLK select bit */ 173 #define OWL_EMAC_OFF_MAC_CTRL_SSDC 4 /* SMII SYNC delay cycle */ 174 #define OWL_EMAC_BIT_MAC_CTRL_RCPS BIT(1) /* REF_CLK phase select */ 175 #define OWL_EMAC_BIT_MAC_CTRL_RSIS BIT(0) /* RMII/SMII interface select */ 176 177 /* Receive descriptor status field */ 178 #define OWL_EMAC_BIT_RDES0_OWN BIT(31) /* Ownership bit */ 179 #define OWL_EMAC_BIT_RDES0_FF BIT(30) /* Filtering fail */ 180 #define OWL_EMAC_MSK_RDES0_FL GENMASK(29, 16) /* Frame length */ 181 #define OWL_EMAC_OFF_RDES0_FL 16 182 #define OWL_EMAC_BIT_RDES0_ES BIT(15) /* Error summary */ 183 #define OWL_EMAC_BIT_RDES0_DE BIT(14) /* Descriptor error */ 184 #define OWL_EMAC_BIT_RDES0_RF BIT(11) /* Runt frame */ 185 #define OWL_EMAC_BIT_RDES0_MF BIT(10) /* Multicast frame */ 186 #define OWL_EMAC_BIT_RDES0_FS BIT(9) /* First descriptor */ 187 #define OWL_EMAC_BIT_RDES0_LS BIT(8) /* Last descriptor */ 188 #define OWL_EMAC_BIT_RDES0_TL BIT(7) /* Frame too long */ 189 #define OWL_EMAC_BIT_RDES0_CS BIT(6) /* Collision seen */ 190 #define OWL_EMAC_BIT_RDES0_FT BIT(5) /* Frame type */ 191 #define OWL_EMAC_BIT_RDES0_RE BIT(3) /* Report on MII error */ 192 #define OWL_EMAC_BIT_RDES0_DB BIT(2) /* Dribbling bit */ 193 #define OWL_EMAC_BIT_RDES0_CE BIT(1) /* CRC error */ 194 #define OWL_EMAC_BIT_RDES0_ZERO BIT(0) /* Legal frame length indicator */ 195 196 /* Receive descriptor control and count field */ 197 #define OWL_EMAC_BIT_RDES1_RER BIT(25) /* Receive end of ring */ 198 #define OWL_EMAC_MSK_RDES1_RBS1 GENMASK(10, 0) /* Buffer 1 size */ 199 200 /* Transmit descriptor status field */ 201 #define OWL_EMAC_BIT_TDES0_OWN BIT(31) /* Ownership bit */ 202 #define OWL_EMAC_BIT_TDES0_ES BIT(15) /* Error summary */ 203 #define OWL_EMAC_BIT_TDES0_LO BIT(11) /* Loss of carrier */ 204 #define OWL_EMAC_BIT_TDES0_NC BIT(10) /* No carrier */ 205 #define OWL_EMAC_BIT_TDES0_LC BIT(9) /* Late collision */ 206 #define OWL_EMAC_BIT_TDES0_EC BIT(8) /* Excessive collisions */ 207 #define OWL_EMAC_MSK_TDES0_CC GENMASK(6, 3) /* Collision count */ 208 #define OWL_EMAC_BIT_TDES0_UF BIT(1) /* Underflow error */ 209 #define OWL_EMAC_BIT_TDES0_DE BIT(0) /* Deferred */ 210 211 /* Transmit descriptor control and count field */ 212 #define OWL_EMAC_BIT_TDES1_IC BIT(31) /* Interrupt on completion */ 213 #define OWL_EMAC_BIT_TDES1_LS BIT(30) /* Last descriptor */ 214 #define OWL_EMAC_BIT_TDES1_FS BIT(29) /* First descriptor */ 215 #define OWL_EMAC_BIT_TDES1_FT1 BIT(28) /* Filtering type */ 216 #define OWL_EMAC_BIT_TDES1_SET BIT(27) /* Setup packet */ 217 #define OWL_EMAC_BIT_TDES1_AC BIT(26) /* Add CRC disable */ 218 #define OWL_EMAC_BIT_TDES1_TER BIT(25) /* Transmit end of ring */ 219 #define OWL_EMAC_BIT_TDES1_DPD BIT(23) /* Disabled padding */ 220 #define OWL_EMAC_BIT_TDES1_FT0 BIT(22) /* Filtering type */ 221 #define OWL_EMAC_MSK_TDES1_TBS1 GENMASK(10, 0) /* Buffer 1 size */ 222 223 static const char *const owl_emac_clk_names[] = { "eth", "rmii" }; 224 #define OWL_EMAC_NCLKS ARRAY_SIZE(owl_emac_clk_names) 225 226 enum owl_emac_clk_map { 227 OWL_EMAC_CLK_ETH = 0, 228 OWL_EMAC_CLK_RMII 229 }; 230 231 struct owl_emac_addr_list { 232 u8 addrs[OWL_EMAC_MAX_MULTICAST_ADDRS][ETH_ALEN]; 233 int count; 234 }; 235 236 /* TX/RX descriptors */ 237 struct owl_emac_ring_desc { 238 u32 status; 239 u32 control; 240 u32 buf_addr; 241 u32 reserved; /* 2nd buffer address is not used */ 242 }; 243 244 struct owl_emac_ring { 245 struct owl_emac_ring_desc *descs; 246 dma_addr_t descs_dma; 247 struct sk_buff **skbs; 248 dma_addr_t *skbs_dma; 249 unsigned int size; 250 unsigned int head; 251 unsigned int tail; 252 }; 253 254 struct owl_emac_priv { 255 struct net_device *netdev; 256 void __iomem *base; 257 258 struct clk_bulk_data clks[OWL_EMAC_NCLKS]; 259 struct reset_control *reset; 260 261 struct owl_emac_ring rx_ring; 262 struct owl_emac_ring tx_ring; 263 264 struct mii_bus *mii; 265 struct napi_struct napi; 266 267 phy_interface_t phy_mode; 268 unsigned int link; 269 int speed; 270 int duplex; 271 int pause; 272 struct owl_emac_addr_list mcaddr_list; 273 274 struct work_struct mac_reset_task; 275 276 u32 msg_enable; /* Debug message level */ 277 spinlock_t lock; /* Sync concurrent ring access */ 278 }; 279 280 #endif /* __OWL_EMAC_H__ */ 281