6 * VIA Rhine network driver
10 FILE_LICENCE ( GPL2_OR_LATER );
13 #define RHINE_BAR_SIZE 256
15 /** Default timeout */
16 #define RHINE_TIMEOUT_US 10000
18 /** Rhine descriptor format */
19 struct rhine_descriptor {
24 } __attribute__ (( packed ));
26 #define RHINE_DES0_OWN (1 << 31) /*< Owned descriptor */
27 #define RHINE_DES1_IC (1 << 23) /*< Generate interrupt */
28 #define RHINE_TDES1_EDP (1 << 22) /*< End of packet */
29 #define RHINE_TDES1_STP (1 << 21) /*< Start of packet */
30 #define RHINE_TDES1_TCPCK (1 << 20) /*< HW TCP checksum */
31 #define RHINE_TDES1_UDPCK (1 << 19) /*< HW UDP checksum */
32 #define RHINE_TDES1_IPCK (1 << 18) /*< HW IP checksum */
33 #define RHINE_TDES1_TAG (1 << 17) /*< Tagged frame */
34 #define RHINE_TDES1_CRC (1 << 16) /*< No CRC */
35 #define RHINE_DES1_CHAIN (1 << 15) /*< Chained descriptor */
36 #define RHINE_DES1_SIZE(_x) ((_x) & 0x7ff) /*< Frame size */
37 #define RHINE_DES0_GETSIZE(_x) (((_x) >> 16) & 0x7ff)
39 #define RHINE_RDES0_RXOK (1 << 15)
40 #define RHINE_RDES0_VIDHIT (1 << 14)
41 #define RHINE_RDES0_MAR (1 << 13)
42 #define RHINE_RDES0_BAR (1 << 12)
43 #define RHINE_RDES0_PHY (1 << 11)
44 #define RHINE_RDES0_CHN (1 << 10)
45 #define RHINE_RDES0_STP (1 << 9)
46 #define RHINE_RDES0_EDP (1 << 8)
47 #define RHINE_RDES0_BUFF (1 << 7)
48 #define RHINE_RDES0_FRAG (1 << 6)
49 #define RHINE_RDES0_RUNT (1 << 5)
50 #define RHINE_RDES0_LONG (1 << 4)
51 #define RHINE_RDES0_FOV (1 << 3)
52 #define RHINE_RDES0_FAE (1 << 2)
53 #define RHINE_RDES0_CRCE (1 << 1)
54 #define RHINE_RDES0_RERR (1 << 0)
56 #define RHINE_TDES0_TERR (1 << 15)
57 #define RHINE_TDES0_UDF (1 << 11)
58 #define RHINE_TDES0_CRS (1 << 10)
59 #define RHINE_TDES0_OWC (1 << 9)
60 #define RHINE_TDES0_ABT (1 << 8)
61 #define RHINE_TDES0_CDH (1 << 7)
62 #define RHINE_TDES0_COLS (1 << 4)
63 #define RHINE_TDES0_NCR(_x) ((_x) & 0xf)
65 #define RHINE_RING_ALIGN 4
67 /** Rhine descriptor rings sizes */
68 #define RHINE_RXDESC_NUM 4
69 #define RHINE_TXDESC_NUM 8
70 #define RHINE_RX_MAX_LEN 1536
72 /** Rhine MAC address registers */
73 #define RHINE_MAC 0x00
75 /** Receive control register */
76 #define RHINE_RCR 0x06
77 #define RHINE_RCR_FIFO_TRSH(_x) (((_x) & 0x7) << 5) /*< RX FIFO threshold */
78 #define RHINE_RCR_PHYS_ACCEPT (1 << 4) /*< Accept matching PA */
79 #define RHINE_RCR_BCAST_ACCEPT (1 << 3) /*< Accept broadcast */
80 #define RHINE_RCR_MCAST_ACCEPT (1 << 2) /*< Accept multicast */
81 #define RHINE_RCR_RUNT_ACCEPT (1 << 1) /*< Accept runt frames */
82 #define RHINE_RCR_ERR_ACCEPT (1 << 0) /*< Accept erroneous frames */
84 /** Transmit control register */
85 #define RHINE_TCR 0x07
86 #define RHINE_TCR_LOOPBACK(_x) (((_x) & 0x3) << 1) /*< Transmit loop mode */
87 #define RHINE_TCR_TAGGING (1 << 0) /*< 802.1P/Q packet tagging */
89 /** Command 0 register */
90 #define RHINE_CR0 0x08
91 #define RHINE_CR0_RXSTART (1 << 6)
92 #define RHINE_CR0_TXSTART (1 << 5)
93 #define RHINE_CR0_TXEN (1 << 4) /*< Transmit enable */
94 #define RHINE_CR0_RXEN (1 << 3) /*< Receive enable */
95 #define RHINE_CR0_STOPNIC (1 << 2) /*< Stop NIC */
96 #define RHINE_CR0_STARTNIC (1 << 1) /*< Start NIC */
98 /** Command 1 register */
99 #define RHINE_CR1 0x09
100 #define RHINE_CR1_RESET (1 << 7) /*< Software reset */
101 #define RHINE_CR1_RXPOLL (1 << 6) /*< Receive poll demand */
102 #define RHINE_CR1_TXPOLL (1 << 5) /*< Xmit poll demand */
103 #define RHINE_CR1_AUTOPOLL (1 << 3) /*< Disable autopoll */
104 #define RHINE_CR1_FDX (1 << 2) /*< Full duplex */
105 #define RIHNE_CR1_ACCUNI (1 << 1) /*< Disable accept unicast */
107 /** Transmit queue wake register */
108 #define RHINE_TXQUEUE_WAKE 0x0a
110 /** Interrupt service 0 */
111 #define RHINE_ISR0 0x0c
112 #define RHINE_ISR0_MIBOVFL (1 << 7)
113 #define RHINE_ISR0_PCIERR (1 << 6)
114 #define RHINE_ISR0_RXRINGERR (1 << 5)
115 #define RHINE_ISR0_TXRINGERR (1 << 4)
116 #define RHINE_ISR0_TXERR (1 << 3)
117 #define RHINE_ISR0_RXERR (1 << 2)
118 #define RHINE_ISR0_TXDONE (1 << 1)
119 #define RHINE_ISR0_RXDONE (1 << 0)
121 /** Interrupt service 1 */
122 #define RHINE_ISR1 0x0d
123 #define RHINE_ISR1_GPI (1 << 7)
124 #define RHINE_ISR1_PORTSTATE (1 << 6)
125 #define RHINE_ISR1_TXABORT (1 << 5)
126 #define RHINE_ISR1_RXNOBUF (1 << 4)
127 #define RHINE_ISR1_RXFIFOOVFL (1 << 3)
128 #define RHINE_ISR1_RXFIFOUNFL (1 << 2)
129 #define RHINE_ISR1_TXFIFOUNFL (1 << 1)
130 #define RHINE_ISR1_EARLYRX (1 << 0)
132 /** Interrupt enable mask register 0 */
133 #define RHINE_IMR0 0x0e
135 /** Interrupt enable mask register 1 */
136 #define RHINE_IMR1 0x0f
138 /** RX queue descriptor base address */
139 #define RHINE_RXQUEUE_BASE 0x18
141 /** TX queue 0 descriptor base address */
142 #define RHINE_TXQUEUE_BASE 0x1c
144 /** MII configuration */
145 #define RHINE_MII_CFG 0x6c
147 /** MII status register */
148 #define RHINE_MII_SR 0x6d
149 #define RHINE_MII_SR_PHYRST (1 << 7) /*< PHY reset */
150 #define RHINE_MII_SR_LINKNWAY (1 << 4) /*< Link status after N-Way */
151 #define RHINE_MII_SR_PHYERR (1 << 3) /*< PHY device error */
152 #define RHINE_MII_SR_DUPLEX (1 << 2) /*< Duplex mode after N-Way */
153 #define RHINE_MII_SR_LINKPOLL (1 << 1) /*< Link status after poll */
154 #define RHINE_MII_SR_LINKSPD (1 << 0) /*< Link speed after N-Way */
156 /** MII bus control 0 register */
157 #define RHINE_MII_BCR0 0x6e
159 /** MII bus control 1 register */
160 #define RHINE_MII_BCR1 0x6f
162 /** MII control register */
163 #define RHINE_MII_CR 0x70
164 #define RHINE_MII_CR_AUTOPOLL (1 << 7) /*< MII auto polling */
165 #define RHINE_MII_CR_RDEN (1 << 6) /*< PHY read enable */
166 #define RHINE_MII_CR_WREN (1 << 5) /*< PHY write enable */
167 #define RHINE_MII_CR_DIRECT (1 << 4) /*< Direct programming mode */
168 #define RHINE_MII_CR_MDIOOUT (1 << 3) /*< MDIO output enable */
170 /** MII port address */
171 #define RHINE_MII_ADDR 0x71
172 #define RHINE_MII_ADDR_MSRCEN (1 << 6)
173 #define RHINE_MII_ADDR_MDONE (1 << 5)
175 /** MII read/write data */
176 #define RHINE_MII_RDWR 0x72
178 /** EERPOM control/status register */
179 #define RHINE_EEPROM_CTRL 0x74
180 #define RHINE_EEPROM_CTRL_STATUS (1 << 7) /*< EEPROM status */
181 #define RHINE_EEPROM_CTRL_RELOAD (1 << 5) /*< EEPROM reload */
183 /** Chip configuration A */
184 #define RHINE_CHIPCFG_A 0x78
185 /* MMIO enable. Only valid for Rhine I. Reserved on later boards */
186 #define RHINE_CHIPCFG_A_MMIO (1 << 5)
188 /** Chip configuration B */
189 #define RHINE_CHIPCFG_B 0x79
191 /** Chip configuation C */
192 #define RHINE_CHIPCFG_C 0x7a
194 /** Chip configuration D */
195 #define RHINE_CHIPCFG_D 0x7b
196 /* MMIO enable. Only valid on Rhine II and later. GPIOEN on Rhine I */
197 #define RHINE_CHIPCFG_D_MMIO (1 << 7)
199 #define RHINE_REVISION_OLD 0x20
201 /** A VIA Rhine descriptor ring */
204 struct rhine_descriptor *desc;
205 /** Producer index */
207 /** Consumer index */
210 /** Number of descriptors */
212 /** Register address */
217 * Initialise descriptor ring
219 * @v ring Descriptor ring
220 * @v count Number of descriptors (must be a power of 2)
221 * @v reg Register address
223 static inline __attribute__ (( always_inline)) void
224 rhine_init_ring ( struct rhine_ring *ring, unsigned int count,
230 /** A VIA Rhine network card */
232 /** I/O address (some PIO access is always required) */
233 unsigned long ioaddr;
236 /** Cached value of CR1 (to avoid read-modify-write on fast path) */
240 struct mii_interface mii;
242 /** Transmit descriptor ring */
243 struct rhine_ring tx;
244 /** Receive descriptor ring */
245 struct rhine_ring rx;
246 /** Receive I/O buffers */
247 struct io_buffer *rx_iobuf[RHINE_RXDESC_NUM];
250 #endif /* _RHINE_H */