xref: /freebsd/sys/dev/usb/net/if_auereg.h (revision 8ddb146abcdf061be9f2c0db7e391697dafad85c)
1 /*-
2  * SPDX-License-Identifier: BSD-4-Clause
3  *
4  * Copyright (c) 1997, 1998, 1999
5  *	Bill Paul <wpaul@ee.columbia.edu>.  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. All advertising materials mentioning features or use of this software
16  *    must display the following acknowledgement:
17  *	This product includes software developed by Bill Paul.
18  * 4. Neither the name of the author nor the names of any co-contributors
19  *    may be used to endorse or promote products derived from this software
20  *    without specific prior written permission.
21  *
22  * THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
23  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25  * ARE DISCLAIMED.  IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
26  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
27  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
28  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
29  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
30  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
31  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
32  * THE POSSIBILITY OF SUCH DAMAGE.
33  *
34  * $FreeBSD$
35  */
36 
37 /*
38  * Register definitions for ADMtek Pegasus AN986 USB to Ethernet
39  * chip. The Pegasus uses a total of four USB endpoints: the control
40  * endpoint (0), a bulk read endpoint for receiving packets (1),
41  * a bulk write endpoint for sending packets (2) and an interrupt
42  * endpoint for passing RX and TX status (3). Endpoint 0 is used
43  * to read and write the ethernet module's registers. All registers
44  * are 8 bits wide.
45  *
46  * Packet transfer is done in 64 byte chunks. The last chunk in a
47  * transfer is denoted by having a length less that 64 bytes. For
48  * the RX case, the data includes an optional RX status word.
49  */
50 
51 #define	AUE_UR_READREG		0xF0
52 #define	AUE_UR_WRITEREG		0xF1
53 
54 #define	AUE_CONFIG_INDEX	0	/* config number 1 */
55 #define	AUE_IFACE_IDX		0
56 
57 /*
58  * Note that while the ADMtek technically has four endpoints, the control
59  * endpoint (endpoint 0) is regarded as special by the USB code and drivers
60  * don't have direct access to it (we access it using usbd_do_request()
61  * when reading/writing registers.  Consequently, our endpoint indexes
62  * don't match those in the ADMtek Pegasus manual: we consider the RX data
63  * endpoint to be index 0 and work up from there.
64  */
65 enum {
66 	AUE_BULK_DT_WR,
67 	AUE_BULK_DT_RD,
68 	AUE_INTR_DT_RD,
69 	AUE_N_TRANSFER,
70 };
71 
72 #define	AUE_INTR_PKTLEN		0x8
73 
74 #define	AUE_CTL0		0x00
75 #define	AUE_CTL1		0x01
76 #define	AUE_CTL2		0x02
77 #define	AUE_MAR0		0x08
78 #define	AUE_MAR1		0x09
79 #define	AUE_MAR2		0x0A
80 #define	AUE_MAR3		0x0B
81 #define	AUE_MAR4		0x0C
82 #define	AUE_MAR5		0x0D
83 #define	AUE_MAR6		0x0E
84 #define	AUE_MAR7		0x0F
85 #define	AUE_MAR			AUE_MAR0
86 #define	AUE_PAR0		0x10
87 #define	AUE_PAR1		0x11
88 #define	AUE_PAR2		0x12
89 #define	AUE_PAR3		0x13
90 #define	AUE_PAR4		0x14
91 #define	AUE_PAR5		0x15
92 #define	AUE_PAR			AUE_PAR0
93 #define	AUE_PAUSE0		0x18
94 #define	AUE_PAUSE1		0x19
95 #define	AUE_PAUSE		AUE_PAUSE0
96 #define	AUE_RX_FLOWCTL_CNT	0x1A
97 #define	AUE_RX_FLOWCTL_FIFO	0x1B
98 #define	AUE_REG_1D		0x1D
99 #define	AUE_EE_REG		0x20
100 #define	AUE_EE_DATA0		0x21
101 #define	AUE_EE_DATA1		0x22
102 #define	AUE_EE_DATA		AUE_EE_DATA0
103 #define	AUE_EE_CTL		0x23
104 #define	AUE_PHY_ADDR		0x25
105 #define	AUE_PHY_DATA0		0x26
106 #define	AUE_PHY_DATA1		0x27
107 #define	AUE_PHY_DATA		AUE_PHY_DATA0
108 #define	AUE_PHY_CTL		0x28
109 #define	AUE_USB_STS		0x2A
110 #define	AUE_TXSTAT0		0x2B
111 #define	AUE_TXSTAT1		0x2C
112 #define	AUE_TXSTAT		AUE_TXSTAT0
113 #define	AUE_RXSTAT		0x2D
114 #define	AUE_PKTLOST0		0x2E
115 #define	AUE_PKTLOST1		0x2F
116 #define	AUE_PKTLOST		AUE_PKTLOST0
117 
118 #define	AUE_REG_7B		0x7B
119 #define	AUE_GPIO0		0x7E
120 #define	AUE_GPIO1		0x7F
121 #define	AUE_REG_81		0x81
122 
123 #define	AUE_CTL0_INCLUDE_RXCRC	0x01
124 #define	AUE_CTL0_ALLMULTI	0x02
125 #define	AUE_CTL0_STOP_BACKOFF	0x04
126 #define	AUE_CTL0_RXSTAT_APPEND	0x08
127 #define	AUE_CTL0_WAKEON_ENB	0x10
128 #define	AUE_CTL0_RXPAUSE_ENB	0x20
129 #define	AUE_CTL0_RX_ENB		0x40
130 #define	AUE_CTL0_TX_ENB		0x80
131 
132 #define	AUE_CTL1_HOMELAN	0x04
133 #define	AUE_CTL1_RESETMAC	0x08
134 #define	AUE_CTL1_SPEEDSEL	0x10	/* 0 = 10mbps, 1 = 100mbps */
135 #define	AUE_CTL1_DUPLEX		0x20	/* 0 = half, 1 = full */
136 #define	AUE_CTL1_DELAYHOME	0x40
137 
138 #define	AUE_CTL2_EP3_CLR	0x01	/* reading EP3 clrs status regs */
139 #define	AUE_CTL2_RX_BADFRAMES	0x02
140 #define	AUE_CTL2_RX_PROMISC	0x04
141 #define	AUE_CTL2_LOOPBACK	0x08
142 #define	AUE_CTL2_EEPROMWR_ENB	0x10
143 #define	AUE_CTL2_EEPROM_LOAD	0x20
144 
145 #define	AUE_EECTL_WRITE		0x01
146 #define	AUE_EECTL_READ		0x02
147 #define	AUE_EECTL_DONE		0x04
148 
149 #define	AUE_PHYCTL_PHYREG	0x1F
150 #define	AUE_PHYCTL_WRITE	0x20
151 #define	AUE_PHYCTL_READ		0x40
152 #define	AUE_PHYCTL_DONE		0x80
153 
154 #define	AUE_USBSTS_SUSPEND	0x01
155 #define	AUE_USBSTS_RESUME	0x02
156 
157 #define	AUE_TXSTAT0_JABTIMO	0x04
158 #define	AUE_TXSTAT0_CARLOSS	0x08
159 #define	AUE_TXSTAT0_NOCARRIER	0x10
160 #define	AUE_TXSTAT0_LATECOLL	0x20
161 #define	AUE_TXSTAT0_EXCESSCOLL	0x40
162 #define	AUE_TXSTAT0_UNDERRUN	0x80
163 
164 #define	AUE_TXSTAT1_PKTCNT	0x0F
165 #define	AUE_TXSTAT1_FIFO_EMPTY	0x40
166 #define	AUE_TXSTAT1_FIFO_FULL	0x80
167 
168 #define	AUE_RXSTAT_OVERRUN	0x01
169 #define	AUE_RXSTAT_PAUSE	0x02
170 
171 #define	AUE_GPIO_IN0		0x01
172 #define	AUE_GPIO_OUT0		0x02
173 #define	AUE_GPIO_SEL0		0x04
174 #define	AUE_GPIO_IN1		0x08
175 #define	AUE_GPIO_OUT1		0x10
176 #define	AUE_GPIO_SEL1		0x20
177 
178 #define	AUE_TIMEOUT		100	/* 10*ms */
179 #define	AUE_MIN_FRAMELEN	60
180 
181 #define	AUE_RXSTAT_MCAST	0x01
182 #define	AUE_RXSTAT_GIANT	0x02
183 #define	AUE_RXSTAT_RUNT		0x04
184 #define	AUE_RXSTAT_CRCERR	0x08
185 #define	AUE_RXSTAT_DRIBBLE	0x10
186 #define	AUE_RXSTAT_MASK		0x1E
187 
188 #define	GET_MII(sc)		uether_getmii(&(sc)->sc_ue)
189 
190 struct aue_intrpkt {
191 	uint8_t	aue_txstat0;
192 	uint8_t	aue_txstat1;
193 	uint8_t	aue_rxstat;
194 	uint8_t	aue_rxlostpkt0;
195 	uint8_t	aue_rxlostpkt1;
196 	uint8_t	aue_wakeupstat;
197 	uint8_t	aue_rsvd;
198 } __packed;
199 
200 struct aue_rxpkt {
201 	uint16_t aue_pktlen;
202 	uint8_t	aue_rxstat;
203 	uint8_t	pad;
204 } __packed;
205 
206 struct aue_softc {
207 	struct usb_ether	sc_ue;
208 	struct mtx		sc_mtx;
209 	struct usb_xfer	*sc_xfer[AUE_N_TRANSFER];
210 
211 	int			sc_flags;
212 #define	AUE_FLAG_LSYS		0x0001	/* use Linksys reset */
213 #define	AUE_FLAG_PNA		0x0002	/* has Home PNA */
214 #define	AUE_FLAG_PII		0x0004	/* Pegasus II chip */
215 #define	AUE_FLAG_LINK		0x0008	/* wait for link to come up */
216 #define	AUE_FLAG_VER_2		0x0200	/* chip is version 2 */
217 #define	AUE_FLAG_DUAL_PHY	0x0400	/* chip has two transcivers */
218 };
219 
220 #define	AUE_LOCK(_sc)		mtx_lock(&(_sc)->sc_mtx)
221 #define	AUE_UNLOCK(_sc)		mtx_unlock(&(_sc)->sc_mtx)
222 #define	AUE_LOCK_ASSERT(_sc, t)	mtx_assert(&(_sc)->sc_mtx, t)
223