xref: /freebsd/sys/dev/usb/net/if_axereg.h (revision 884a2a699669ec61e2366e3e358342dbc94be24a)
1 /*-
2  * Copyright (c) 1997, 1998, 1999, 2000-2003
3  *	Bill Paul <wpaul@windriver.com>.  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$
33  */
34 
35 /*
36  * Definitions for the ASIX Electronics AX88172, AX88178
37  * and AX88772 to ethernet controllers.
38  */
39 
40 /*
41  * Vendor specific commands.  ASIX conveniently doesn't document the 'set
42  * NODEID' command in their datasheet (thanks a lot guys).
43  * To make handling these commands easier, I added some extra data which is
44  * decided by the axe_cmd() routine. Commands are encoded in 16 bits, with
45  * the format: LDCC. L and D are both nibbles in the high byte.  L represents
46  * the data length (0 to 15) and D represents the direction (0 for vendor read,
47  * 1 for vendor write).  CC is the command byte, as specified in the manual.
48  */
49 
50 #define	AXE_CMD_IS_WRITE(x)	(((x) & 0x0F00) >> 8)
51 #define	AXE_CMD_LEN(x)		(((x) & 0xF000) >> 12)
52 #define	AXE_CMD_CMD(x)		((x) & 0x00FF)
53 
54 #define	AXE_172_CMD_READ_RXTX_SRAM		0x2002
55 #define	AXE_182_CMD_READ_RXTX_SRAM		0x8002
56 #define	AXE_172_CMD_WRITE_RX_SRAM		0x0103
57 #define	AXE_182_CMD_WRITE_RXTX_SRAM		0x8103
58 #define	AXE_172_CMD_WRITE_TX_SRAM		0x0104
59 #define	AXE_CMD_MII_OPMODE_SW			0x0106
60 #define	AXE_CMD_MII_READ_REG			0x2007
61 #define	AXE_CMD_MII_WRITE_REG			0x2108
62 #define	AXE_CMD_MII_READ_OPMODE			0x1009
63 #define	AXE_CMD_MII_OPMODE_HW			0x010A
64 #define	AXE_CMD_SROM_READ			0x200B
65 #define	AXE_CMD_SROM_WRITE			0x010C
66 #define	AXE_CMD_SROM_WR_ENABLE			0x010D
67 #define	AXE_CMD_SROM_WR_DISABLE			0x010E
68 #define	AXE_CMD_RXCTL_READ			0x200F
69 #define	AXE_CMD_RXCTL_WRITE			0x0110
70 #define	AXE_CMD_READ_IPG012			0x3011
71 #define	AXE_172_CMD_WRITE_IPG0			0x0112
72 #define	AXE_178_CMD_WRITE_IPG012		0x0112
73 #define	AXE_172_CMD_WRITE_IPG1			0x0113
74 #define	AXE_178_CMD_READ_NODEID			0x6013
75 #define	AXE_172_CMD_WRITE_IPG2			0x0114
76 #define	AXE_178_CMD_WRITE_NODEID		0x6114
77 #define	AXE_CMD_READ_MCAST			0x8015
78 #define	AXE_CMD_WRITE_MCAST			0x8116
79 #define	AXE_172_CMD_READ_NODEID			0x6017
80 #define	AXE_172_CMD_WRITE_NODEID		0x6118
81 
82 #define	AXE_CMD_READ_PHYID			0x2019
83 #define	AXE_172_CMD_READ_MEDIA			0x101A
84 #define	AXE_178_CMD_READ_MEDIA			0x201A
85 #define	AXE_CMD_WRITE_MEDIA			0x011B
86 #define	AXE_CMD_READ_MONITOR_MODE		0x101C
87 #define	AXE_CMD_WRITE_MONITOR_MODE		0x011D
88 #define	AXE_CMD_READ_GPIO			0x101E
89 #define	AXE_CMD_WRITE_GPIO			0x011F
90 
91 #define	AXE_CMD_SW_RESET_REG			0x0120
92 #define	AXE_CMD_SW_PHY_STATUS			0x0021
93 #define	AXE_CMD_SW_PHY_SELECT			0x0122
94 
95 /* AX88772A and AX88772B only. */
96 #define	AXE_CMD_READ_VLAN_CTRL			0x4027
97 #define	AXE_CMD_WRITE_VLAN_CTRL			0x4028
98 
99 #define	AXE_SW_RESET_CLEAR			0x00
100 #define	AXE_SW_RESET_RR				0x01
101 #define	AXE_SW_RESET_RT				0x02
102 #define	AXE_SW_RESET_PRTE			0x04
103 #define	AXE_SW_RESET_PRL			0x08
104 #define	AXE_SW_RESET_BZ				0x10
105 #define	AXE_SW_RESET_IPRL			0x20
106 #define	AXE_SW_RESET_IPPD			0x40
107 
108 /* AX88178 documentation says to always write this bit... */
109 #define	AXE_178_RESET_MAGIC			0x40
110 
111 #define	AXE_178_MEDIA_GMII			0x0001
112 #define	AXE_MEDIA_FULL_DUPLEX			0x0002
113 #define	AXE_172_MEDIA_TX_ABORT_ALLOW		0x0004
114 
115 /* AX88178/88772 documentation says to always write 1 to bit 2 */
116 #define	AXE_178_MEDIA_MAGIC			0x0004
117 /* AX88772 documentation says to always write 0 to bit 3 */
118 #define	AXE_178_MEDIA_ENCK			0x0008
119 #define	AXE_172_MEDIA_FLOW_CONTROL_EN		0x0010
120 #define	AXE_178_MEDIA_RXFLOW_CONTROL_EN		0x0010
121 #define	AXE_178_MEDIA_TXFLOW_CONTROL_EN		0x0020
122 #define	AXE_178_MEDIA_JUMBO_EN			0x0040
123 #define	AXE_178_MEDIA_LTPF_ONLY			0x0080
124 #define	AXE_178_MEDIA_RX_EN			0x0100
125 #define	AXE_178_MEDIA_100TX			0x0200
126 #define	AXE_178_MEDIA_SBP			0x0800
127 #define	AXE_178_MEDIA_SUPERMAC			0x1000
128 
129 #define	AXE_RXCMD_PROMISC			0x0001
130 #define	AXE_RXCMD_ALLMULTI			0x0002
131 #define	AXE_172_RXCMD_UNICAST			0x0004
132 #define	AXE_178_RXCMD_KEEP_INVALID_CRC		0x0004
133 #define	AXE_RXCMD_BROADCAST			0x0008
134 #define	AXE_RXCMD_MULTICAST			0x0010
135 #define	AXE_RXCMD_ENABLE			0x0080
136 #define	AXE_178_RXCMD_MFB_MASK			0x0300
137 #define	AXE_178_RXCMD_MFB_2048			0x0000
138 #define	AXE_178_RXCMD_MFB_4096			0x0100
139 #define	AXE_178_RXCMD_MFB_8192			0x0200
140 #define	AXE_178_RXCMD_MFB_16384			0x0300
141 
142 #define	AXE_PHY_SEL_PRI		1
143 #define	AXE_PHY_SEL_SEC		0
144 #define	AXE_PHY_TYPE_MASK	0xE0
145 #define	AXE_PHY_TYPE_SHIFT	5
146 #define	AXE_PHY_TYPE(x)		\
147 	(((x) & AXE_PHY_TYPE_MASK) >> AXE_PHY_TYPE_SHIFT)
148 
149 #define	PHY_TYPE_100_HOME	0	/* 10/100 or 1M HOME PHY */
150 #define	PHY_TYPE_GIG		1	/* Gigabit PHY */
151 #define	PHY_TYPE_SPECIAL	4	/* Special case */
152 #define	PHY_TYPE_RSVD		5	/* Reserved */
153 #define	PHY_TYPE_NON_SUP	7	/* Non-supported PHY */
154 
155 #define	AXE_PHY_NO_MASK		0x1F
156 #define	AXE_PHY_NO(x)		((x) & AXE_PHY_NO_MASK)
157 
158 #define	AXE_772_PHY_NO_EPHY	0x10	/* Embedded 10/100 PHY of AX88772 */
159 
160 #define	AXE_GPIO0_EN		0x01
161 #define	AXE_GPIO0		0x02
162 #define	AXE_GPIO1_EN		0x04
163 #define	AXE_GPIO1		0x08
164 #define	AXE_GPIO2_EN		0x10
165 #define	AXE_GPIO2		0x20
166 #define	AXE_GPIO_RELOAD_EEPROM	0x80
167 
168 #define	AXE_PHY_MODE_MARVELL		0x00
169 #define	AXE_PHY_MODE_CICADA		0x01
170 #define	AXE_PHY_MODE_AGERE		0x02
171 #define	AXE_PHY_MODE_CICADA_V2		0x05
172 #define	AXE_PHY_MODE_AGERE_GMII		0x06
173 #define	AXE_PHY_MODE_CICADA_V2_ASIX	0x09
174 #define	AXE_PHY_MODE_REALTEK_8211CL	0x0C
175 #define	AXE_PHY_MODE_REALTEK_8211BN	0x0D
176 #define	AXE_PHY_MODE_REALTEK_8251CL	0x0E
177 #define	AXE_PHY_MODE_ATTANSIC		0x40
178 
179 /* AX88772A only. */
180 #define	AXE_SW_PHY_SELECT_EXT		0x0000
181 #define	AXE_SW_PHY_SELECT_EMBEDDED	0x0001
182 #define	AXE_SW_PHY_SELECT_AUTO		0x0002
183 #define	AXE_SW_PHY_SELECT_SS_MII	0x0004
184 #define	AXE_SW_PHY_SELECT_SS_RVRS_MII	0x0008
185 #define	AXE_SW_PHY_SELECT_SS_RVRS_RMII	0x000C
186 #define	AXE_SW_PHY_SELECT_SS_ENB	0x0010
187 
188 /* AX88772A/AX88772B VLAN control. */
189 #define	AXE_VLAN_CTRL_ENB		0x00001000
190 #define	AXE_VLAN_CTRL_STRIP		0x00002000
191 #define	AXE_VLAN_CTRL_VID1_MASK		0x00000FFF
192 #define	AXE_VLAN_CTRL_VID2_MASK		0x0FFF0000
193 
194 #define	AXE_BULK_BUF_SIZE	16384	/* bytes */
195 
196 #define	AXE_CTL_READ		0x01
197 #define	AXE_CTL_WRITE		0x02
198 
199 #define	AXE_CONFIG_IDX		0	/* config number 1 */
200 #define	AXE_IFACE_IDX		0
201 
202 struct axe_sframe_hdr {
203 	uint16_t len;
204 	uint16_t ilen;
205 } __packed;
206 
207 #define	GET_MII(sc)		uether_getmii(&(sc)->sc_ue)
208 
209 /* The interrupt endpoint is currently unused by the ASIX part. */
210 enum {
211 	AXE_BULK_DT_WR,
212 	AXE_BULK_DT_RD,
213 	AXE_N_TRANSFER,
214 };
215 
216 struct axe_softc {
217 	struct usb_ether	sc_ue;
218 	struct mtx		sc_mtx;
219 	struct usb_xfer	*sc_xfer[AXE_N_TRANSFER];
220 	int			sc_phyno;
221 
222 	int			sc_flags;
223 #define	AXE_FLAG_LINK		0x0001
224 #define	AXE_FLAG_772		0x1000	/* AX88772 */
225 #define	AXE_FLAG_772A		0x2000	/* AX88772A */
226 #define	AXE_FLAG_772B		0x4000	/* AX88772B */
227 #define	AXE_FLAG_178		0x8000	/* AX88178 */
228 
229 	uint8_t			sc_ipgs[3];
230 	uint8_t			sc_phyaddrs[2];
231 	int			sc_tx_bufsz;
232 };
233 
234 #define	AXE_IS_178_FAMILY(sc)						  \
235 	((sc)->sc_flags & (AXE_FLAG_772 | AXE_FLAG_772A | AXE_FLAG_772B | \
236 	AXE_FLAG_178))
237 
238 #define	AXE_IS_772(sc)							  \
239 	((sc)->sc_flags & (AXE_FLAG_772 | AXE_FLAG_772A | AXE_FLAG_772B))
240 
241 #define	AXE_LOCK(_sc)		mtx_lock(&(_sc)->sc_mtx)
242 #define	AXE_UNLOCK(_sc)		mtx_unlock(&(_sc)->sc_mtx)
243 #define	AXE_LOCK_ASSERT(_sc, t)	mtx_assert(&(_sc)->sc_mtx, t)
244