1 /* 2 * Copyright (c) 2006-2021, RT-Thread Development Team 3 * 4 * SPDX-License-Identifier: Apache-2.0 5 * 6 * Change Logs: 7 * Date Author Notes 8 * 2013-05-19 Bernard porting from LPC17xx drivers. 9 */ 10 11 #ifndef DRV_EMAC_H__ 12 #define DRV_EMAC_H__ 13 14 #include "board.h" 15 16 /* EMAC Memory Buffer configuration for 16K Ethernet RAM. */ 17 #define NUM_RX_FRAG 4 /* Num.of RX Fragments 4*1536= 6.0kB */ 18 #define NUM_TX_FRAG 3 /* Num.of TX Fragments 3*1536= 4.6kB */ 19 #define ETH_FRAG_SIZE 1536 /* Packet Fragment size 1536 Bytes */ 20 21 #define ETH_MAX_FLEN 1536 /* Max. Ethernet Frame Size */ 22 23 /* MAC Configuration Register 1 */ 24 #define MAC1_REC_EN 0x00000001 /* Receive Enable */ 25 #define MAC1_PASS_ALL 0x00000002 /* Pass All Receive Frames */ 26 #define MAC1_RX_FLOWC 0x00000004 /* RX Flow Control */ 27 #define MAC1_TX_FLOWC 0x00000008 /* TX Flow Control */ 28 #define MAC1_LOOPB 0x00000010 /* Loop Back Mode */ 29 #define MAC1_RES_TX 0x00000100 /* Reset TX Logic */ 30 #define MAC1_RES_MCS_TX 0x00000200 /* Reset MAC TX Control Sublayer */ 31 #define MAC1_RES_RX 0x00000400 /* Reset RX Logic */ 32 #define MAC1_RES_MCS_RX 0x00000800 /* Reset MAC RX Control Sublayer */ 33 #define MAC1_SIM_RES 0x00004000 /* Simulation Reset */ 34 #define MAC1_SOFT_RES 0x00008000 /* Soft Reset MAC */ 35 36 /* MAC Configuration Register 2 */ 37 #define MAC2_FULL_DUP 0x00000001 /* Full Duplex Mode */ 38 #define MAC2_FRM_LEN_CHK 0x00000002 /* Frame Length Checking */ 39 #define MAC2_HUGE_FRM_EN 0x00000004 /* Huge Frame Enable */ 40 #define MAC2_DLY_CRC 0x00000008 /* Delayed CRC Mode */ 41 #define MAC2_CRC_EN 0x00000010 /* Append CRC to every Frame */ 42 #define MAC2_PAD_EN 0x00000020 /* Pad all Short Frames */ 43 #define MAC2_VLAN_PAD_EN 0x00000040 /* VLAN Pad Enable */ 44 #define MAC2_ADET_PAD_EN 0x00000080 /* Auto Detect Pad Enable */ 45 #define MAC2_PPREAM_ENF 0x00000100 /* Pure Preamble Enforcement */ 46 #define MAC2_LPREAM_ENF 0x00000200 /* Long Preamble Enforcement */ 47 #define MAC2_NO_BACKOFF 0x00001000 /* No Backoff Algorithm */ 48 #define MAC2_BACK_PRESSURE 0x00002000 /* Backoff Presurre / No Backoff */ 49 #define MAC2_EXCESS_DEF 0x00004000 /* Excess Defer */ 50 51 /* Back-to-Back Inter-Packet-Gap Register */ 52 #define IPGT_FULL_DUP 0x00000015 /* Recommended value for Full Duplex */ 53 #define IPGT_HALF_DUP 0x00000012 /* Recommended value for Half Duplex */ 54 55 /* Non Back-to-Back Inter-Packet-Gap Register */ 56 #define IPGR_DEF 0x00000012 /* Recommended value */ 57 58 /* Collision Window/Retry Register */ 59 #define CLRT_DEF 0x0000370F /* Default value */ 60 61 /* PHY Support Register */ 62 #define SUPP_SPEED 0x00000100 /* Reduced MII Logic Current Speed */ 63 #define SUPP_RES_RMII 0x00000800 /* Reset Reduced MII Logic */ 64 65 /* Test Register */ 66 #define TEST_SHCUT_PQUANTA 0x00000001 /* Shortcut Pause Quanta */ 67 #define TEST_TST_PAUSE 0x00000002 /* Test Pause */ 68 #define TEST_TST_BACKP 0x00000004 /* Test Back Pressure */ 69 70 /* MII Management Configuration Register */ 71 #define MCFG_SCAN_INC 0x00000001 /* Scan Increment PHY Address */ 72 #define MCFG_SUPP_PREAM 0x00000002 /* Suppress Preamble */ 73 #define MCFG_CLK_SEL 0x0000001C /* Clock Select Mask */ 74 #define MCFG_RES_MII 0x00008000 /* Reset MII Management Hardware */ 75 76 #define MCFG_CLK_DIV4 0x00000000 /* MDC = hclk / 4 */ 77 #define MCFG_CLK_DIV6 0x00000008 /* MDC = hclk / 6 */ 78 #define MCFG_CLK_DIV8 0x0000000C /* MDC = hclk / 8 */ 79 #define MCFG_CLK_DIV10 0x00000010 /* MDC = hclk / 10 */ 80 #define MCFG_CLK_DIV14 0x00000014 /* MDC = hclk / 14 */ 81 #define MCFG_CLK_DIV20 0x00000018 /* MDC = hclk / 20 */ 82 #define MCFG_CLK_DIV28 0x0000001C /* MDC = hclk / 28 */ 83 84 85 /* MII Management Command Register */ 86 #define MCMD_READ 0x00000001 /* MII Read */ 87 #define MCMD_SCAN 0x00000002 /* MII Scan continuously */ 88 89 #define MII_WR_TOUT 0x00050000 /* MII Write timeout count */ 90 #define MII_RD_TOUT 0x00050000 /* MII Read timeout count */ 91 92 /* MII Management Address Register */ 93 #define MADR_REG_ADR 0x0000001F /* MII Register Address Mask */ 94 #define MADR_PHY_ADR 0x00001F00 /* PHY Address Mask */ 95 96 /* MII Management Indicators Register */ 97 #define MIND_BUSY 0x00000001 /* MII is Busy */ 98 #define MIND_SCAN 0x00000002 /* MII Scanning in Progress */ 99 #define MIND_NOT_VAL 0x00000004 /* MII Read Data not valid */ 100 #define MIND_MII_LINK_FAIL 0x00000008 /* MII Link Failed */ 101 102 /* Command Register */ 103 #define CR_RX_EN 0x00000001 /* Enable Receive */ 104 #define CR_TX_EN 0x00000002 /* Enable Transmit */ 105 #define CR_REG_RES 0x00000008 /* Reset Host Registers */ 106 #define CR_TX_RES 0x00000010 /* Reset Transmit Datapath */ 107 #define CR_RX_RES 0x00000020 /* Reset Receive Datapath */ 108 #define CR_PASS_RUNT_FRM 0x00000040 /* Pass Runt Frames */ 109 #define CR_PASS_RX_FILT 0x00000080 /* Pass RX Filter */ 110 #define CR_TX_FLOW_CTRL 0x00000100 /* TX Flow Control */ 111 #define CR_RMII 0x00000200 /* Reduced MII Interface */ 112 #define CR_FULL_DUP 0x00000400 /* Full Duplex */ 113 114 /* Status Register */ 115 #define SR_RX_EN 0x00000001 /* Enable Receive */ 116 #define SR_TX_EN 0x00000002 /* Enable Transmit */ 117 118 /* Transmit Status Vector 0 Register */ 119 #define TSV0_CRC_ERR 0x00000001 /* CRC error */ 120 #define TSV0_LEN_CHKERR 0x00000002 /* Length Check Error */ 121 #define TSV0_LEN_OUTRNG 0x00000004 /* Length Out of Range */ 122 #define TSV0_DONE 0x00000008 /* Tramsmission Completed */ 123 #define TSV0_MCAST 0x00000010 /* Multicast Destination */ 124 #define TSV0_BCAST 0x00000020 /* Broadcast Destination */ 125 #define TSV0_PKT_DEFER 0x00000040 /* Packet Deferred */ 126 #define TSV0_EXC_DEFER 0x00000080 /* Excessive Packet Deferral */ 127 #define TSV0_EXC_COLL 0x00000100 /* Excessive Collision */ 128 #define TSV0_LATE_COLL 0x00000200 /* Late Collision Occured */ 129 #define TSV0_GIANT 0x00000400 /* Giant Frame */ 130 #define TSV0_UNDERRUN 0x00000800 /* Buffer Underrun */ 131 #define TSV0_BYTES 0x0FFFF000 /* Total Bytes Transferred */ 132 #define TSV0_CTRL_FRAME 0x10000000 /* Control Frame */ 133 #define TSV0_PAUSE 0x20000000 /* Pause Frame */ 134 #define TSV0_BACK_PRESS 0x40000000 /* Backpressure Method Applied */ 135 #define TSV0_VLAN 0x80000000 /* VLAN Frame */ 136 137 /* Transmit Status Vector 1 Register */ 138 #define TSV1_BYTE_CNT 0x0000FFFF /* Transmit Byte Count */ 139 #define TSV1_COLL_CNT 0x000F0000 /* Transmit Collision Count */ 140 141 /* Receive Status Vector Register */ 142 #define RSV_BYTE_CNT 0x0000FFFF /* Receive Byte Count */ 143 #define RSV_PKT_IGNORED 0x00010000 /* Packet Previously Ignored */ 144 #define RSV_RXDV_SEEN 0x00020000 /* RXDV Event Previously Seen */ 145 #define RSV_CARR_SEEN 0x00040000 /* Carrier Event Previously Seen */ 146 #define RSV_REC_CODEV 0x00080000 /* Receive Code Violation */ 147 #define RSV_CRC_ERR 0x00100000 /* CRC Error */ 148 #define RSV_LEN_CHKERR 0x00200000 /* Length Check Error */ 149 #define RSV_LEN_OUTRNG 0x00400000 /* Length Out of Range */ 150 #define RSV_REC_OK 0x00800000 /* Frame Received OK */ 151 #define RSV_MCAST 0x01000000 /* Multicast Frame */ 152 #define RSV_BCAST 0x02000000 /* Broadcast Frame */ 153 #define RSV_DRIB_NIBB 0x04000000 /* Dribble Nibble */ 154 #define RSV_CTRL_FRAME 0x08000000 /* Control Frame */ 155 #define RSV_PAUSE 0x10000000 /* Pause Frame */ 156 #define RSV_UNSUPP_OPC 0x20000000 /* Unsupported Opcode */ 157 #define RSV_VLAN 0x40000000 /* VLAN Frame */ 158 159 /* Flow Control Counter Register */ 160 #define FCC_MIRR_CNT 0x0000FFFF /* Mirror Counter */ 161 #define FCC_PAUSE_TIM 0xFFFF0000 /* Pause Timer */ 162 163 /* Flow Control Status Register */ 164 #define FCS_MIRR_CNT 0x0000FFFF /* Mirror Counter Current */ 165 166 /* Receive Filter Control Register */ 167 #define RFC_UCAST_EN 0x00000001 /* Accept Unicast Frames Enable */ 168 #define RFC_BCAST_EN 0x00000002 /* Accept Broadcast Frames Enable */ 169 #define RFC_MCAST_EN 0x00000004 /* Accept Multicast Frames Enable */ 170 #define RFC_UCAST_HASH_EN 0x00000008 /* Accept Unicast Hash Filter Frames */ 171 #define RFC_MCAST_HASH_EN 0x00000010 /* Accept Multicast Hash Filter Fram.*/ 172 #define RFC_PERFECT_EN 0x00000020 /* Accept Perfect Match Enable */ 173 #define RFC_MAGP_WOL_EN 0x00001000 /* Magic Packet Filter WoL Enable */ 174 #define RFC_PFILT_WOL_EN 0x00002000 /* Perfect Filter WoL Enable */ 175 176 /* Receive Filter WoL Status/Clear Registers */ 177 #define WOL_UCAST 0x00000001 /* Unicast Frame caused WoL */ 178 #define WOL_BCAST 0x00000002 /* Broadcast Frame caused WoL */ 179 #define WOL_MCAST 0x00000004 /* Multicast Frame caused WoL */ 180 #define WOL_UCAST_HASH 0x00000008 /* Unicast Hash Filter Frame WoL */ 181 #define WOL_MCAST_HASH 0x00000010 /* Multicast Hash Filter Frame WoL */ 182 #define WOL_PERFECT 0x00000020 /* Perfect Filter WoL */ 183 #define WOL_RX_FILTER 0x00000080 /* RX Filter caused WoL */ 184 #define WOL_MAG_PACKET 0x00000100 /* Magic Packet Filter caused WoL */ 185 186 /* Interrupt Status/Enable/Clear/Set Registers */ 187 #define INT_RX_OVERRUN 0x00000001 /* Overrun Error in RX Queue */ 188 #define INT_RX_ERR 0x00000002 /* Receive Error */ 189 #define INT_RX_FIN 0x00000004 /* RX Finished Process Descriptors */ 190 #define INT_RX_DONE 0x00000008 /* Receive Done */ 191 #define INT_TX_UNDERRUN 0x00000010 /* Transmit Underrun */ 192 #define INT_TX_ERR 0x00000020 /* Transmit Error */ 193 #define INT_TX_FIN 0x00000040 /* TX Finished Process Descriptors */ 194 #define INT_TX_DONE 0x00000080 /* Transmit Done */ 195 #define INT_SOFT_INT 0x00001000 /* Software Triggered Interrupt */ 196 #define INT_WAKEUP 0x00002000 /* Wakeup Event Interrupt */ 197 198 /* Power Down Register */ 199 #define PD_POWER_DOWN 0x80000000 /* Power Down MAC */ 200 201 /* RX Descriptor Control Word */ 202 #define RCTRL_SIZE 0x000007FF /* Buffer size mask */ 203 #define RCTRL_INT 0x80000000 /* Generate RxDone Interrupt */ 204 205 /* RX Status Hash CRC Word */ 206 #define RHASH_SA 0x000001FF /* Hash CRC for Source Address */ 207 #define RHASH_DA 0x001FF000 /* Hash CRC for Destination Address */ 208 209 /* RX Status Information Word */ 210 #define RINFO_SIZE 0x000007FF /* Data size in bytes */ 211 #define RINFO_CTRL_FRAME 0x00040000 /* Control Frame */ 212 #define RINFO_VLAN 0x00080000 /* VLAN Frame */ 213 #define RINFO_FAIL_FILT 0x00100000 /* RX Filter Failed */ 214 #define RINFO_MCAST 0x00200000 /* Multicast Frame */ 215 #define RINFO_BCAST 0x00400000 /* Broadcast Frame */ 216 #define RINFO_CRC_ERR 0x00800000 /* CRC Error in Frame */ 217 #define RINFO_SYM_ERR 0x01000000 /* Symbol Error from PHY */ 218 #define RINFO_LEN_ERR 0x02000000 /* Length Error */ 219 #define RINFO_RANGE_ERR 0x04000000 /* Range Error (exceeded max. size) */ 220 #define RINFO_ALIGN_ERR 0x08000000 /* Alignment Error */ 221 #define RINFO_OVERRUN 0x10000000 /* Receive overrun */ 222 #define RINFO_NO_DESCR 0x20000000 /* No new Descriptor available */ 223 #define RINFO_LAST_FLAG 0x40000000 /* Last Fragment in Frame */ 224 #define RINFO_ERR 0x80000000 /* Error Occured (OR of all errors) */ 225 226 #define RINFO_ERR_MASK (RINFO_FAIL_FILT | RINFO_CRC_ERR | RINFO_SYM_ERR | \ 227 RINFO_LEN_ERR | RINFO_ALIGN_ERR | RINFO_OVERRUN) 228 229 /* TX Descriptor Control Word */ 230 #define TCTRL_SIZE 0x000007FF /* Size of data buffer in bytes */ 231 #define TCTRL_OVERRIDE 0x04000000 /* Override Default MAC Registers */ 232 #define TCTRL_HUGE 0x08000000 /* Enable Huge Frame */ 233 #define TCTRL_PAD 0x10000000 /* Pad short Frames to 64 bytes */ 234 #define TCTRL_CRC 0x20000000 /* Append a hardware CRC to Frame */ 235 #define TCTRL_LAST 0x40000000 /* Last Descriptor for TX Frame */ 236 #define TCTRL_INT 0x80000000 /* Generate TxDone Interrupt */ 237 238 /* TX Status Information Word */ 239 #define TINFO_COL_CNT 0x01E00000 /* Collision Count */ 240 #define TINFO_DEFER 0x02000000 /* Packet Deferred (not an error) */ 241 #define TINFO_EXCESS_DEF 0x04000000 /* Excessive Deferral */ 242 #define TINFO_EXCESS_COL 0x08000000 /* Excessive Collision */ 243 #define TINFO_LATE_COL 0x10000000 /* Late Collision Occured */ 244 #define TINFO_UNDERRUN 0x20000000 /* Transmit Underrun */ 245 #define TINFO_NO_DESCR 0x40000000 /* No new Descriptor available */ 246 #define TINFO_ERR 0x80000000 /* Error Occured (OR of all errors) */ 247 248 /* ENET Device Revision ID */ 249 #define OLD_EMAC_MODULE_ID 0x39022000 /* Rev. ID for first rev '-' */ 250 251 /* DP83848C PHY Registers */ 252 #define PHY_REG_BMCR 0x00 /* Basic Mode Control Register */ 253 #define PHY_REG_BMSR 0x01 /* Basic Mode Status Register */ 254 #define PHY_REG_IDR1 0x02 /* PHY Identifier 1 */ 255 #define PHY_REG_IDR2 0x03 /* PHY Identifier 2 */ 256 #define PHY_REG_ANAR 0x04 /* Auto-Negotiation Advertisement */ 257 #define PHY_REG_ANLPAR 0x05 /* Auto-Neg. Link Partner Abitily */ 258 #define PHY_REG_ANER 0x06 /* Auto-Neg. Expansion Register */ 259 #define PHY_REG_ANNPTR 0x07 /* Auto-Neg. Next Page TX */ 260 261 /* PHY Extended Registers */ 262 #define PHY_REG_STS 0x10 /* Status Register */ 263 #define PHY_REG_MICR 0x11 /* MII Interrupt Control Register */ 264 #define PHY_REG_MISR 0x12 /* MII Interrupt Status Register */ 265 #define PHY_REG_FCSCR 0x14 /* False Carrier Sense Counter */ 266 #define PHY_REG_RECR 0x15 /* Receive Error Counter */ 267 #define PHY_REG_PCSR 0x16 /* PCS Sublayer Config. and Status */ 268 #define PHY_REG_RBR 0x17 /* RMII and Bypass Register */ 269 #define PHY_REG_LEDCR 0x18 /* LED Direct Control Register */ 270 #define PHY_REG_PHYCR 0x19 /* PHY Control Register */ 271 #define PHY_REG_10BTSCR 0x1A /* 10Base-T Status/Control Register */ 272 #define PHY_REG_CDCTRL1 0x1B /* CD Test Control and BIST Extens. */ 273 #define PHY_REG_EDCR 0x1D /* Energy Detect Control Register */ 274 275 #define PHY_FULLD_100M 0x2100 /* Full Duplex 100Mbit */ 276 #define PHY_HALFD_100M 0x2000 /* Half Duplex 100Mbit */ 277 #define PHY_FULLD_10M 0x0100 /* Full Duplex 10Mbit */ 278 #define PHY_HALFD_10M 0x0000 /* Half Duplex 10MBit */ 279 #define PHY_AUTO_NEG 0x3000 /* Select Auto Negotiation */ 280 281 #define DP83848C_DEF_ADR 0x0F00 /* Default PHY device address */ 282 #define DP83848C_ID 0x20005C90 /* PHY Identifier */ 283 284 int rt_hw_emac_init(void); 285 286 #endif /* DRV_EMAC_H__ */ 287