1/*
2 * Solaris DLPI driver for ethernet cards based on the ADMtek Centaur
3 *
4 * Copyright (c) 2007 by Garrett D'Amore <garrett@damore.org>.
5 * All rights reserved.
6 *
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
9 * are met:
10 * 1. Redistributions of source code must retain the above copyright
11 *    notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 *    notice, this list of conditions and the following disclaimer in the
14 *    documentation and/or other materials provided with the distribution.
15 * 3. Neither the name of the author nor the names of any co-contributors
16 *    may be used to endorse or promote products derived from this software
17 *    without specific prior written permission.
18 *
19 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS ``AS IS''
20 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22 * ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
23 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29 * POSSIBILITY OF SUCH DAMAGE.
30 */
31/*
32 * Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
33 * Use is subject to license terms.
34 */
35
36#ifndef	_AFE_H
37#define	_AFE_H
38
39#ifdef	__cplusplus
40extern "C" {
41#endif
42
43/*
44 * Registers and values are here, becuase they can be exported to userland
45 * via the AFEIOC_GETCSR and friends ioctls.  These are private to this
46 * driver and the bundled diagnostic utility, and should not be used by
47 * end user application programs.
48 */
49
50/*
51 * AFE register definitions.
52 */
53/* PCI configuration registers */
54#define	PCI_VID		0x00	/* Loaded vendor ID */
55#define	PCI_DID		0x02	/* Loaded device ID */
56#define	PCI_CMD		0x04	/* Configuration command register */
57#define	PCI_STAT	0x06	/* Configuration status register */
58#define	PCI_RID		0x08	/* Revision ID */
59#define	PCI_CLS		0x0c	/* Cache line size */
60#define	PCI_SVID	0x2c	/* Subsystem vendor ID */
61#define	PCI_SSID	0x2e	/* Subsystem ID */
62#define	PCI_MINGNT	0x3e	/* Minimum Grant */
63#define	PCI_MAXLAT	0x3f	/* Maximum latency */
64#define	PCI_SIG		0x80	/* Signature of AN983 */
65#define	PCI_PMR0	0xc0	/* Power Management Register 0 */
66#define	PCI_PMR1	0xc4	/* Power Management Register 1 */
67
68/*
69 * Bits for PCI command register.
70 */
71#define	PCI_CMD_MWIE	0x0010	/* memory write-invalidate enable */
72#define	PCI_CMD_BME	0x0004	/* bus master enable */
73#define	PCI_CMD_MAE	0x0002	/* memory access enable */
74#define	PCI_CMD_IOE	0x0001	/* I/O access enable */
75
76/*
77 * Signature values for PCI_SIG
78 */
79#define	SIG_AN983	0x09811317
80#define	SIG_AN985	0x09851317
81#define	SIG_ADM9511	0x69851317
82
83/* Ordinary control/status registers */
84#define	CSR_PAR		0x00	/* PCI access register */
85#define	CSR_TDR		0x08	/* Transmit demand register */
86#define	CSR_RDR		0x10	/* Receive demand register */
87#define	CSR_RDB		0x18	/* Receive descriptor base address */
88#define	CSR_TDB		0x20	/* Transmit descriptor base address */
89#define	CSR_SR		0x28	/* Status register */
90#define	CSR_NAR		0x30	/* Network access register */
91#define	CSR_IER		0x38	/* Interrupt enable register */
92#define	CSR_LPC		0x40	/* Lost packet counter */
93#define	CSR_SPR		0x48	/* Serial port register */
94#define	CSR_TIMER	0x58	/* Timer */
95#define	CSR_SR2		0x80	/* Status register 2 */
96#define	CSR_IER2	0x84	/* Interrupt enable register 2 */
97#define	CSR_CR		0x88	/* Command register */
98#define	CSR_PMCSR	0x90	/* Power Management Command and Status */
99#define	CSR_PAR0	0xa4	/* Physical address register 0 */
100#define	CSR_PAR1	0xa8	/* Physical address register 1 */
101#define	CSR_MAR0	0xac	/* Multicast address hash table register 0 */
102#define	CSR_MAR1	0xb0	/* Multicast address hash table register 1 */
103#define	CSR_BMCR	0xb4	/* PHY BMCR (comet only) */
104#define	CSR_BMSR	0xb8	/* PHY BMSR (comet only) */
105#define	CSR_PHYIDR1	0xbc	/* PHY PHYIDR1 (comet only) */
106#define	CSR_PHYIDR2	0xc0	/* PHY PHYIDR2 (comet only) */
107#define	CSR_ANAR	0xc4	/* PHY ANAR (comet only) */
108#define	CSR_ANLPAR	0xc8	/* PHY ANLPAR (comet only) */
109#define	CSR_ANER	0xcc	/* PHY ANER (comet only) */
110#define	CSR_XMC		0xd0	/* XCVR mode control (comet only) */
111#define	CSR_XCIIS	0xd4	/* XCVR config info/int status (comet only) */
112#define	CSR_XIE		0xd8	/* XCVR interupt enable (comet only) */
113#define	CSR_OPM		0xfc	/* Opmode register (centaur only) */
114
115/*
116 * Bits for PCI access register.
117 */
118#define	PAR_RESET	0x00000001U	/* Reset the entire chip */
119#define	PAR_MWIE	0x01000000U	/* PCI memory-write-invalidate */
120#define	PAR_MRLE	0x00800000U	/* PCI memory-read-line */
121#define	PAR_MRME	0x00200000U	/* PCI memory-read-multiple */
122#define	PAR_TXHIPRI	0x00000002U	/* Transmit higher priority */
123#define	PAR_DESCSKIP	0x0000007cU	/* Descriptor skip length in DW */
124#define	PAR_BIGENDIAN	0x00000080U	/* Use big endian data buffers */
125#define	PAR_TXAUTOPOLL	0x00060000U	/* Programmable TX autopoll interval */
126#define	PAR_RXFIFO_100	0x00009000U	/* RX FIFO control, Centaur only */
127#define	PAR_RXFIFO_10	0x00002800U	/* RX FIFO control, Centaur only */
128#define	PAR_CALIGN_NONE	0x00000000U	/* No cache alignment, Comet */
129#define	PAR_CALIGN_8	0x00004000U	/* 8 DW cache alignment, Comet */
130#define	PAR_CALIGN_16	0x00008000U	/* 16 DW cache alignment, Comet */
131#define	PAR_CALIGN_32	0x0000c000U	/* 32 DW cache alignment, Comet */
132#define	PAR_BURSTLEN	0x00003F00U	/* Programmable burst length, Comet */
133#define	PAR_BURSTUNL	0x00000000U	/* Unlimited burst length, Comet */
134#define	PAR_BURST_1	0x00000100U	/* 1 DW burst length, Comet */
135#define	PAR_BURST_2	0x00000200U	/* 2 DW burst length, Comet */
136#define	PAR_BURST_4	0x00000400U	/* 4 DW burst length, Comet */
137#define	PAR_BURST_8	0x00000800U	/* 8 DW burst length, Comet */
138#define	PAR_BURST_16	0x00001000U	/* 16 DW burst length, Comet */
139#define	PAR_BURST_32	0x00002000U	/* 32 DW burst length, Comet */
140
141/*
142 * Bits for status register.
143 */
144#define	SR_BERR_TYPE		0x03800000U	/* bus error type */
145#define	SR_BERR_PARITY		0x00000000U	/* parity error */
146#define	SR_BERR_TARGET_ABORT	0x01000000U	/* target abort */
147#define	SR_BERR_MASTER_ABORT	0x00800000U	/* master abort */
148#define	SR_TX_STATE		0x00700000U	/* transmit state */
149#define	SR_RX_STATE		0x000E0000U	/* receive state */
150
151/*
152 * Interrupts.  These are in IER2 and SR2.  Some of them also appear
153 * in SR and IER, but we only use the ADMtek specific IER2 and SR2.
154 */
155#define	INT_TXEARLY		0x80000000U	/* transmit early interrupt */
156#define	INT_RXEARLY		0x40000000U	/* receive early interrupt */
157#define	INT_LINKCHG		0x20000000U	/* link status changed */
158#define	INT_TXDEFER		0x10000000U	/* transmit defer interrupt */
159#define	INT_PAUSE		0x04000000U	/* pause frame received */
160#define	INT_NORMAL		0x00010000U	/* normal interrupt */
161#define	INT_ABNORMAL		0x00008000U	/* abnormal interrupt */
162#define	INT_BUSERR		0x00002000U	/* fatal bus error */
163#define	INT_TIMER		0x00000800U	/* onboard timer */
164#define	INT_RXJABBER		0x00000200U	/* receive watchdog */
165#define	INT_RXSTOPPED		0x00000100U	/* receive stopped */
166#define	INT_RXNOBUF		0x00000080U	/* no rcv descriptor */
167#define	INT_RXOK		0x00000040U	/* receive complete */
168#define	INT_TXUNDERFLOW		0x00000020U	/* transmit underflow */
169#define	INT_TXJABBER		0x00000008U	/* transmit jabber timeout */
170#define	INT_TXNOBUF		0x00000004U	/* no xmt descriptor */
171#define	INT_TXSTOPPED		0x00000002U	/* transmit stopped */
172#define	INT_TXOK		0x00000001U	/* transmit ok interrupt */
173
174#define	INT_NONE		0x00000000U	/* no interrupts */
175#define	INT_ALL			0xf401abefU	/* all interrupts */
176#define	INT_WANTED		(INT_NORMAL | INT_ABNORMAL | \
177				INT_BUSERR | INT_RXJABBER | \
178				INT_RXOK | INT_RXNOBUF | \
179				INT_TIMER | INT_LINKCHG | \
180				INT_RXSTOPPED | INT_TXSTOPPED | \
181				INT_TXUNDERFLOW | INT_TXJABBER)
182
183/*
184 * Bits for network access register.
185 */
186#define	NAR_TX_ENABLE	0x00002000U	/* Enable transmit */
187#define	NAR_RX_MULTI	0x00000080U	/* Receive all multicast packets */
188#define	NAR_RX_PROMISC	0x00000040U	/* Receive any good packet */
189#define	NAR_RX_BAD	0x00000008U	/* Pass bad packets */
190#define	NAR_RX_ENABLE	0x00000002U	/* Enable receive */
191#define	NAR_TR		0x0000c000U	/* Transmit threshold mask */
192#define	NAR_TR_72	0x00000000U	/* 72 B (128 @ 100Mbps) tx thresh */
193#define	NAR_TR_96	0x00004000U	/* 96 B (256 @ 100Mbps) tx thresh */
194#define	NAR_TR_128	0x00008000U	/* 128 B (512 @ 100Mbps) tx thresh */
195#define	NAR_TR_160	0x0000c000U	/* 160 B (1K @ 100Mbsp) tx thresh */
196#define	NAR_SF		0x00200000U	/* store and forward */
197#define	NAR_HBD		0x00080000U	/* Disable SQE heartbeat */
198#define	NAR_FCOLL	0x00001000U	/* force collision */
199#define	NAR_MODE	0x00000c00U	/* mode (loopback, etc.) */
200#define	NAR_MACLOOP	0x00000400U	/* mac loop back */
201
202/*
203 * Bits for lost packet counter.
204 */
205#define	LPC_COUNT	0x0000FFFFU	/* Count of missed frames */
206#define	LPC_OFLOW	0x00010000U	/* Counter overflow bit */
207
208/*
209 * Bits for CSR_SPR (MII and SROM access)
210 */
211#define	SPR_MII_DIN	0x00080000U	/* MII data input */
212#define	SPR_MII_CTRL	0x00040000U	/* MII management control, 1=read */
213#define	SPR_MII_DOUT	0x00020000U	/* MII data output */
214#define	SPR_MII_CLOCK	0x00010000U	/* MII data clock */
215#define	SPR_SROM_READ	0x00004000U	/* Serial EEPROM read control */
216#define	SPR_SROM_WRITE	0x00002000U	/* Serial EEPROM write control */
217#define	SPR_SROM_SEL	0x00000800U	/* Serial EEPROM select */
218#define	SPR_SROM_DOUT	0x00000008U	/* Serial EEPROM data out */
219#define	SPR_SROM_DIN	0x00000004U	/* Serial EEPROM data in */
220#define	SPR_SROM_CLOCK	0x00000002U	/* Serial EEPROM clock */
221#define	SPR_SROM_CHIP	0x00000001U	/* Serial EEPROM chip select */
222#define	SROM_ENADDR		0x4	/* Offset of ethernet address */
223#define	SROM_READCMD		0x6	/* command to read SROM */
224
225/*
226 * Bits for CSR_TIMER
227 */
228#define	TIMER_LOOP	0x00010000U	/* continuous operating mode */
229#define	TIMER_USEC		204		/* usecs per timer count */
230
231/*
232 * Bits for CSR_CR
233 */
234#define	CR_PAUSE	0x00000020U	/* enable pause flow control */
235#define	CR_TXURAUTOR	0x00000001U	/* transmit underrun auto recovery */
236
237/*
238 * Bits for XMC (Comet specific)
239 */
240#define	XMC_LDIS	0x0800		/* long distance 10Base-T cable */
241
242/*
243 * Bits for XCIIS (Comet specific)
244 */
245#define	XCIIS_SPEED		0x0200	/* 100 Mbps mode */
246#define	XCIIS_DUPLEX		0x0100	/* full duplex mode */
247#define	XCIIS_FLOWCTL		0x0080	/* flow control support */
248#define	XCIIS_ANC		0x0040	/* autonegotiation complete */
249#define	XCIIS_RF		0x0020	/* remote fault detected */
250#define	XCIIS_LFAIL		0x0010	/* link fail */
251#define	XCIIS_ANLPAR		0x0008	/* anar received from link partner */
252#define	XCIIS_PDF		0x0004	/* parallel detection fault */
253#define	XCIIS_ANPR		0x0002	/* autoneg. page received */
254#define	XCIIS_REF		0x0001	/* receive error counter full */
255
256/*
257 * Bits for XIE (Comet specific)
258 */
259#define	XIE_ANCE		0x0040	/* aneg complete interrupt enable */
260#define	XIE_RFE			0x0020	/* remote fault interrupt enable */
261#define	XIE_LDE			0x0010	/* link fail interrupt enable */
262#define	XIE_ANAE		0x0008	/* aneg. ack. interrupt enable */
263#define	XIE_PDFE		0x0004	/* parallel det. fault int. enable */
264#define	XIE_ANPE		0x0002	/* autoneg. page rec'd int. enable */
265#define	XIE_REFE		0x0001	/* receive error full int. enable */
266
267/*
268 * Centaur 1.1 extensions to MII.
269 */
270#define	PHY_PILR	0x10		/* an983b 1.1 - polarity/int lvl */
271#define	PHY_MCR		0x15		/* an983b 1.1 - mode control */
272
273#define	PILR_NOSQE	0x0800		/* disable 10BaseT SQE */
274#define	MCR_FIBER	0x0001		/* enable fiber */
275
276/*
277 * Bits for Opmode (Centaur specific)
278 */
279#define	OPM_SPEED	0x80000000U	/* 100 Mbps */
280#define	OPM_DUPLEX	0x40000000U	/* full duplex */
281#define	OPM_LINK	0x20000000U	/* link up? */
282#define	OPM_MODE	0x00000007U	/* mode mask */
283#define	OPM_INTPHY	0x00000007U	/* single chip mode, internal PHY */
284#define	OPM_MACONLY	0x00000004U	/* MAC ony mode, external PHY */
285
286#ifdef	_KERNEL
287/*
288 * Put exported kernel interfaces here.  (There should be none.)
289 */
290#endif	/* _KERNEL */
291
292#ifdef __cplusplus
293}
294#endif
295
296#endif	/* _AFE_H */
297