Initial import from FreeBSD RELENG_4:
[dragonfly.git] / sys / dev / netif / wb / if_wbreg.h
1 /*
2  * Copyright (c) 1997, 1998
3  *      Bill Paul <wpaul@ctr.columbia.edu>.  All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  * 3. All advertising materials mentioning features or use of this software
14  *    must display the following acknowledgement:
15  *      This product includes software developed by Bill Paul.
16  * 4. Neither the name of the author nor the names of any co-contributors
17  *    may be used to endorse or promote products derived from this software
18  *    without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
21  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23  * ARE DISCLAIMED.  IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
24  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
30  * THE POSSIBILITY OF SUCH DAMAGE.
31  *
32  * $FreeBSD: src/sys/pci/if_wbreg.h,v 1.7 1999/08/30 23:08:30 wpaul Exp $
33  */
34
35 /*
36  * Winbond register definitions.
37  */
38
39 #define WB_BUSCTL               0x00    /* bus control */
40 #define WB_TXSTART              0x04    /* tx start demand */
41 #define WB_RXSTART              0x08    /* rx start demand */
42 #define WB_RXADDR               0x0C    /* rx descriptor list start addr */
43 #define WB_TXADDR               0x10    /* tx descriptor list start addr */
44 #define WB_ISR                  0x14    /* interrupt status register */
45 #define WB_NETCFG               0x18    /* network config register */
46 #define WB_IMR                  0x1C    /* interrupt mask */
47 #define WB_FRAMESDISCARDED      0x20    /* # of discarded frames */
48 #define WB_SIO                  0x24    /* MII and ROM/EEPROM access */
49 #define WB_BOOTROMADDR          0x28
50 #define WB_TIMER                0x2C    /* general timer */
51 #define WB_CURRXCTL             0x30    /* current RX descriptor */
52 #define WB_CURRXBUF             0x34    /* current RX buffer */
53 #define WB_MAR0                 0x38    /* multicast filter 0 */
54 #define WB_MAR1                 0x3C    /* multicast filter 1 */
55 #define WB_NODE0                0x40    /* station address 0 */
56 #define WB_NODE1                0x44    /* station address 1 */
57 #define WB_BOOTROMSIZE          0x48    /* boot ROM size */
58 #define WB_CURTXCTL             0x4C    /* current TX descriptor */
59 #define WB_CURTXBUF             0x50    /* current TX buffer */
60
61 /*
62  * Bus control bits.
63  */
64 #define WB_BUSCTL_RESET         0x00000001
65 #define WB_BUSCTL_ARBITRATION   0x00000002
66 #define WB_BUSCTL_SKIPLEN       0x0000007C
67 #define WB_BUSCTL_BUF_BIGENDIAN 0x00000080
68 #define WB_BUSCTL_BURSTLEN      0x00003F00
69 #define WB_BUSCTL_CACHEALIGN    0x0000C000
70 #define WB_BUSCTL_DES_BIGENDIAN 0x00100000
71 #define WB_BUSCTL_WAIT          0x00200000
72 #define WB_BUSCTL_MUSTBEONE     0x00400000
73
74 #define WB_SKIPLEN_1LONG        0x00000004
75 #define WB_SKIPLEN_2LONG        0x00000008
76 #define WB_SKIPLEN_3LONG        0x00000010
77 #define WB_SKIPLEN_4LONG        0x00000020
78 #define WB_SKIPLEN_5LONG        0x00000040
79
80 #define WB_CACHEALIGN_NONE      0x00000000
81 #define WB_CACHEALIGN_8LONG     0x00004000
82 #define WB_CACHEALIGN_16LONG    0x00008000
83 #define WB_CACHEALIGN_32LONG    0x0000C000
84
85 #define WB_BURSTLEN_USECA       0x00000000
86 #define WB_BURSTLEN_1LONG       0x00000100
87 #define WB_BURSTLEN_2LONG       0x00000200
88 #define WB_BURSTLEN_4LONG       0x00000400
89 #define WB_BURSTLEN_8LONG       0x00000800
90 #define WB_BURSTLEN_16LONG      0x00001000
91 #define WB_BURSTLEN_32LONG      0x00002000
92
93 #define WB_BUSCTL_CONFIG        (WB_CACHEALIGN_8LONG|WB_SKIPLEN_3LONG| \
94                                         WB_BURSTLEN_8LONG)
95
96 /*
97  * Interrupt status bits.
98  */
99 #define WB_ISR_TX_OK            0x00000001
100 #define WB_ISR_TX_IDLE          0x00000002
101 #define WB_ISR_TX_NOBUF         0x00000004
102 #define WB_ISR_RX_EARLY         0x00000008
103 #define WB_ISR_RX_ERR           0x00000010
104 #define WB_ISR_TX_UNDERRUN      0x00000020
105 #define WB_ISR_RX_OK            0x00000040
106 #define WB_ISR_RX_NOBUF         0x00000080
107 #define WB_ISR_RX_IDLE          0x00000100
108 #define WB_ISR_TX_EARLY         0x00000400
109 #define WB_ISR_TIMER_EXPIRED    0x00000800
110 #define WB_ISR_BUS_ERR          0x00002000
111 #define WB_ISR_ABNORMAL         0x00008000
112 #define WB_ISR_NORMAL           0x00010000
113 #define WB_ISR_RX_STATE         0x000E0000
114 #define WB_ISR_TX_STATE         0x00700000
115 #define WB_ISR_BUSERRTYPE       0x03800000
116
117 /*
118  * The RX_STATE and TX_STATE fields are not described anywhere in the
119  * Winbond datasheet, however it appears that the Winbond chip is an
120  * attempt at a DEC 'tulip' clone, hence the ISR register is identical
121  * to that of the tulip chip and we can steal the bit definitions from
122  * the tulip documentation.
123  */
124 #define WB_RXSTATE_STOPPED      0x00000000      /* 000 - Stopped */
125 #define WB_RXSTATE_FETCH        0x00020000      /* 001 - Fetching descriptor */
126 #define WB_RXSTATE_ENDCHECK     0x00040000      /* 010 - check for rx end */
127 #define WB_RXSTATE_WAIT         0x00060000      /* 011 - waiting for packet */
128 #define WB_RXSTATE_SUSPEND      0x00080000      /* 100 - suspend rx */
129 #define WB_RXSTATE_CLOSE        0x000A0000      /* 101 - close tx desc */
130 #define WB_RXSTATE_FLUSH        0x000C0000      /* 110 - flush from FIFO */
131 #define WB_RXSTATE_DEQUEUE      0x000E0000      /* 111 - dequeue from FIFO */
132
133 #define WB_TXSTATE_RESET        0x00000000      /* 000 - reset */
134 #define WB_TXSTATE_FETCH        0x00100000      /* 001 - fetching descriptor */
135 #define WB_TXSTATE_WAITEND      0x00200000      /* 010 - wait for tx end */
136 #define WB_TXSTATE_READING      0x00300000      /* 011 - read and enqueue */
137 #define WB_TXSTATE_RSVD         0x00400000      /* 100 - reserved */
138 #define WB_TXSTATE_SETUP        0x00500000      /* 101 - setup packet */
139 #define WB_TXSTATE_SUSPEND      0x00600000      /* 110 - suspend tx */
140 #define WB_TXSTATE_CLOSE        0x00700000      /* 111 - close tx desc */
141
142 /*
143  * Network config bits.
144  */
145 #define WB_NETCFG_RX_ON         0x00000002
146 #define WB_NETCFG_RX_ALLPHYS    0x00000008
147 #define WB_NETCFG_RX_MULTI      0x00000010
148 #define WB_NETCFG_RX_BROAD      0x00000020
149 #define WB_NETCFG_RX_RUNT       0x00000040
150 #define WB_NETCFG_RX_ERR        0x00000080
151 #define WB_NETCFG_FULLDUPLEX    0x00000200
152 #define WB_NETCFG_LOOPBACK      0x00000C00
153 #define WB_NETCFG_TX_ON         0x00002000
154 #define WB_NETCFG_TX_THRESH     0x001FC000
155 #define WB_NETCFG_RX_EARLYTHRSH 0x1FE00000
156 #define WB_NETCFG_100MBPS       0x20000000
157 #define WB_NETCFG_TX_EARLY_ON   0x40000000
158 #define WB_NETCFG_RX_EARLY_ON   0x80000000
159
160 /*
161  * The tx threshold can be adjusted in increments of 32 bytes.
162  */
163 #define WB_TXTHRESH(x)          ((x >> 5) << 14)
164 #define WB_TXTHRESH_CHUNK       32
165 #define WB_TXTHRESH_INIT        0 /*72*/
166  
167 /*
168  * Interrupt mask bits.
169  */
170 #define WB_IMR_TX_OK            0x00000001
171 #define WB_IMR_TX_IDLE          0x00000002
172 #define WB_IMR_TX_NOBUF         0x00000004
173 #define WB_IMR_RX_EARLY         0x00000008
174 #define WB_IMR_RX_ERR           0x00000010
175 #define WB_IMR_TX_UNDERRUN      0x00000020
176 #define WB_IMR_RX_OK            0x00000040
177 #define WB_IMR_RX_NOBUF         0x00000080
178 #define WB_IMR_RX_IDLE          0x00000100
179 #define WB_IMR_TX_EARLY         0x00000400
180 #define WB_IMR_TIMER_EXPIRED    0x00000800
181 #define WB_IMR_BUS_ERR          0x00002000
182 #define WB_IMR_ABNORMAL         0x00008000
183 #define WB_IMR_NORMAL           0x00010000
184
185 #define WB_INTRS        \
186         (WB_IMR_RX_OK|WB_IMR_TX_OK|WB_IMR_RX_NOBUF|WB_IMR_RX_ERR|       \
187         WB_IMR_TX_NOBUF|WB_IMR_TX_UNDERRUN|WB_IMR_BUS_ERR|              \
188         WB_IMR_ABNORMAL|WB_IMR_NORMAL|WB_IMR_TX_EARLY)
189 /*
190  * Serial I/O (EEPROM/ROM) bits.
191  */
192 #define WB_SIO_EE_CS            0x00000001      /* EEPROM chip select */
193 #define WB_SIO_EE_CLK           0x00000002      /* EEPROM clock */
194 #define WB_SIO_EE_DATAIN        0x00000004      /* EEPROM data output */
195 #define WB_SIO_EE_DATAOUT       0x00000008      /* EEPROM data input */
196 #define WB_SIO_ROMDATA4         0x00000010
197 #define WB_SIO_ROMDATA5         0x00000020
198 #define WB_SIO_ROMDATA6         0x00000040
199 #define WB_SIO_ROMDATA7         0x00000080
200 #define WB_SIO_ROMCTL_WRITE     0x00000200
201 #define WB_SIO_ROMCTL_READ      0x00000400
202 #define WB_SIO_EESEL            0x00000800
203 #define WB_SIO_MII_CLK          0x00010000      /* MDIO clock */
204 #define WB_SIO_MII_DATAIN       0x00020000      /* MDIO data out */
205 #define WB_SIO_MII_DIR          0x00040000      /* MDIO dir */
206 #define WB_SIO_MII_DATAOUT      0x00080000      /* MDIO data in */
207
208 #define WB_EECMD_WRITE          0x140
209 #define WB_EECMD_READ           0x180
210 #define WB_EECMD_ERASE          0x1c0
211
212 /*
213  * Winbond TX/RX descriptor structure.
214  */
215
216 struct wb_desc {
217         u_int32_t               wb_status;
218         u_int32_t               wb_ctl;
219         u_int32_t               wb_ptr1;
220         u_int32_t               wb_ptr2;
221 };
222
223 #define wb_data         wb_ptr1
224 #define wb_next         wb_ptr2
225
226 #define WB_RXSTAT_CRCERR        0x00000002
227 #define WB_RXSTAT_DRIBBLE       0x00000004
228 #define WB_RXSTAT_MIIERR        0x00000008
229 #define WB_RXSTAT_LATEEVENT     0x00000040
230 #define WB_RXSTAT_GIANT         0x00000080
231 #define WB_RXSTAT_LASTFRAG      0x00000100
232 #define WB_RXSTAT_FIRSTFRAG     0x00000200
233 #define WB_RXSTAT_MULTICAST     0x00000400
234 #define WB_RXSTAT_RUNT          0x00000800
235 #define WB_RXSTAT_RXTYPE        0x00003000
236 #define WB_RXSTAT_RXERR         0x00008000
237 #define WB_RXSTAT_RXLEN         0x3FFF0000
238 #define WB_RXSTAT_RXCMP         0x40000000
239 #define WB_RXSTAT_OWN           0x80000000
240
241 #define WB_RXBYTES(x)           ((x & WB_RXSTAT_RXLEN) >> 16)
242 #define WB_RXSTAT (WB_RXSTAT_FIRSTFRAG|WB_RXSTAT_LASTFRAG|WB_RXSTAT_OWN)
243
244 #define WB_RXCTL_BUFLEN1        0x00000FFF
245 #define WB_RXCTL_BUFLEN2        0x00FFF000
246 #define WB_RXCTL_RLINK          0x01000000
247 #define WB_RXCTL_RLAST          0x02000000
248
249 #define WB_TXSTAT_DEFER         0x00000001
250 #define WB_TXSTAT_UNDERRUN      0x00000002
251 #define WB_TXSTAT_COLLCNT       0x00000078
252 #define WB_TXSTAT_SQE           0x00000080
253 #define WB_TXSTAT_ABORT         0x00000100
254 #define WB_TXSTAT_LATECOLL      0x00000200
255 #define WB_TXSTAT_NOCARRIER     0x00000400
256 #define WB_TXSTAT_CARRLOST      0x00000800
257 #define WB_TXSTAT_TXERR         0x00001000
258 #define WB_TXSTAT_OWN           0x80000000
259
260 #define WB_TXCTL_BUFLEN1        0x000007FF
261 #define WB_TXCTL_BUFLEN2        0x003FF800
262 #define WB_TXCTL_PAD            0x00800000
263 #define WB_TXCTL_TLINK          0x01000000
264 #define WB_TXCTL_TLAST          0x02000000
265 #define WB_TXCTL_NOCRC          0x08000000
266 #define WB_TXCTL_FIRSTFRAG      0x20000000
267 #define WB_TXCTL_LASTFRAG       0x40000000
268 #define WB_TXCTL_FINT           0x80000000
269
270 #define WB_MAXFRAGS             16
271 #define WB_RX_LIST_CNT          64
272 #define WB_TX_LIST_CNT          128
273 #define WB_MIN_FRAMELEN         60
274 #define ETHER_ALIGN             2
275
276 /*
277  * A transmit 'super descriptor' is actually WB_MAXFRAGS regular
278  * descriptors clumped together. The idea here is to emulate the
279  * multi-fragment descriptor layout found in devices such as the
280  * Texas Instruments ThunderLAN and 3Com boomerang and cylone chips.
281  * The advantage to using this scheme is that it avoids buffer copies.
282  * The disadvantage is that there's a certain amount of overhead due
283  * to the fact that each 'fragment' is 16 bytes long. In my tests,
284  * this limits top speed to about 10.5MB/sec. It should be more like
285  * 11.5MB/sec. However, the upshot is that you can achieve better
286  * results on slower machines: a Pentium 200 can pump out packets at
287  * same speed as a PII 400.
288  */
289 struct wb_txdesc {
290         struct wb_desc          wb_frag[WB_MAXFRAGS];
291 };
292
293 #define WB_TXNEXT(x)    x->wb_ptr->wb_frag[x->wb_lastdesc].wb_next
294 #define WB_TXSTATUS(x)  x->wb_ptr->wb_frag[x->wb_lastdesc].wb_status
295 #define WB_TXCTL(x)     x->wb_ptr->wb_frag[x->wb_lastdesc].wb_ctl
296 #define WB_TXDATA(x)    x->wb_ptr->wb_frag[x->wb_lastdesc].wb_data
297
298 #define WB_TXOWN(x)     x->wb_ptr->wb_frag[0].wb_status
299
300 #define WB_UNSENT       0x1234
301
302 #define WB_BUFBYTES     (1024 * sizeof(u_int32_t))
303
304 struct wb_buf {
305         u_int32_t               wb_data[1024];
306 };
307
308 struct wb_list_data {
309         struct wb_buf           wb_rxbufs[WB_RX_LIST_CNT];
310         struct wb_desc          wb_rx_list[WB_RX_LIST_CNT];
311         struct wb_txdesc        wb_tx_list[WB_TX_LIST_CNT];
312 };
313
314 struct wb_chain {
315         struct wb_txdesc        *wb_ptr;
316         struct mbuf             *wb_mbuf;
317         struct wb_chain         *wb_nextdesc;
318         u_int8_t                wb_lastdesc;
319 };
320
321 struct wb_chain_onefrag {
322         struct wb_desc          *wb_ptr;
323         struct mbuf             *wb_mbuf;
324         void                    *wb_buf;
325         struct wb_chain_onefrag *wb_nextdesc;
326         u_int8_t                wb_rlast;
327 };
328
329 struct wb_chain_data {
330         u_int8_t                wb_pad[WB_MIN_FRAMELEN];
331         struct wb_chain_onefrag wb_rx_chain[WB_RX_LIST_CNT];
332         struct wb_chain         wb_tx_chain[WB_TX_LIST_CNT];
333
334         struct wb_chain_onefrag *wb_rx_head;
335
336         struct wb_chain         *wb_tx_head;
337         struct wb_chain         *wb_tx_tail;
338         struct wb_chain         *wb_tx_free;
339 };
340
341 struct wb_type {
342         u_int16_t               wb_vid;
343         u_int16_t               wb_did;
344         char                    *wb_name;
345 };
346
347 struct wb_mii_frame {
348         u_int8_t                mii_stdelim;
349         u_int8_t                mii_opcode;
350         u_int8_t                mii_phyaddr;
351         u_int8_t                mii_regaddr;
352         u_int8_t                mii_turnaround;
353         u_int16_t               mii_data;
354 };
355
356 /*
357  * MII constants
358  */
359 #define WB_MII_STARTDELIM       0x01
360 #define WB_MII_READOP           0x02
361 #define WB_MII_WRITEOP          0x01
362 #define WB_MII_TURNAROUND       0x02
363
364 struct wb_softc {
365         struct arpcom           arpcom;         /* interface info */
366         device_t                wb_miibus;
367         bus_space_handle_t      wb_bhandle;
368         bus_space_tag_t         wb_btag;
369         struct resource         *wb_res;
370         struct resource         *wb_irq;
371         void                    *wb_intrhand;
372         struct wb_type          *wb_info;       /* Winbond adapter info */
373         u_int8_t                wb_unit;        /* interface number */
374         u_int8_t                wb_type;
375         u_int16_t               wb_txthresh;
376         int                     wb_cachesize;
377         caddr_t                 wb_ldata_ptr;
378         struct wb_list_data     *wb_ldata;
379         struct wb_chain_data    wb_cdata;
380         struct callout_handle   wb_stat_ch;
381 };
382
383 /*
384  * register space access macros
385  */
386 #define CSR_WRITE_4(sc, reg, val)       \
387         bus_space_write_4(sc->wb_btag, sc->wb_bhandle, reg, val)
388 #define CSR_WRITE_2(sc, reg, val)       \
389         bus_space_write_2(sc->wb_btag, sc->wb_bhandle, reg, val)
390 #define CSR_WRITE_1(sc, reg, val)       \
391         bus_space_write_1(sc->wb_btag, sc->wb_bhandle, reg, val)
392
393 #define CSR_READ_4(sc, reg)     \
394         bus_space_read_4(sc->wb_btag, sc->wb_bhandle, reg)
395 #define CSR_READ_2(sc, reg)     \
396         bus_space_read_2(sc->wb_btag, sc->wb_bhandle, reg)
397 #define CSR_READ_1(sc, reg)     \
398         bus_space_read_1(sc->wb_btag, sc->wb_bhandle, reg)
399
400 #define WB_TIMEOUT              1000
401
402 /*
403  * General constants that are fun to know.
404  *
405  * Winbond PCI vendor ID
406  */
407 #define WB_VENDORID             0x1050
408
409 /*
410  * Winbond device IDs.
411  */
412 #define WB_DEVICEID_840F        0x0840
413
414 /*
415  * Compex vendor ID.
416  */
417 #define CP_VENDORID             0x11F6
418
419 /*
420  * Compex device IDs.
421  */
422 #define CP_DEVICEID_RL100       0x2011
423
424 /*
425  * PCI low memory base and low I/O base register, and
426  * other PCI registers.
427  */
428
429 #define WB_PCI_VENDOR_ID        0x00
430 #define WB_PCI_DEVICE_ID        0x02
431 #define WB_PCI_COMMAND          0x04
432 #define WB_PCI_STATUS           0x06
433 #define WB_PCI_CLASSCODE        0x09
434 #define WB_PCI_CACHELEN         0x0C
435 #define WB_PCI_LATENCY_TIMER    0x0D
436 #define WB_PCI_HEADER_TYPE      0x0E
437 #define WB_PCI_LOIO             0x10
438 #define WB_PCI_LOMEM            0x14
439 #define WB_PCI_BIOSROM          0x30
440 #define WB_PCI_INTLINE          0x3C
441 #define WB_PCI_INTPIN           0x3D
442 #define WB_PCI_MINGNT           0x3E
443 #define WB_PCI_MINLAT           0x0F
444 #define WB_PCI_RESETOPT         0x48
445 #define WB_PCI_EEPROM_DATA      0x4C
446
447 /* power management registers */
448 #define WB_PCI_CAPID            0xDC /* 8 bits */
449 #define WB_PCI_NEXTPTR          0xDD /* 8 bits */
450 #define WB_PCI_PWRMGMTCAP       0xDE /* 16 bits */
451 #define WB_PCI_PWRMGMTCTRL      0xE0 /* 16 bits */
452
453 #define WB_PSTATE_MASK          0x0003
454 #define WB_PSTATE_D0            0x0000
455 #define WB_PSTATE_D1            0x0002
456 #define WB_PSTATE_D2            0x0002
457 #define WB_PSTATE_D3            0x0003
458 #define WB_PME_EN               0x0010
459 #define WB_PME_STATUS           0x8000
460
461 #ifdef __alpha__
462 #undef vtophys
463 #define vtophys(va)             alpha_XXX_dmamap((vm_offset_t)va)
464 #endif