xref: /NextBSD/sys/dev/txp/if_txpreg.h (revision eb1a5f8de9f7ea602c373a710f531abbf81141c4)
1 /*	$OpenBSD: if_txpreg.h,v 1.30 2001/06/23 04:18:02 jason Exp $ */
2 /*	$FreeBSD$ */
3 
4 /*-
5  * Copyright (c) 2001 Aaron Campbell <aaron@monkey.org>.
6  * All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  * 3. All advertising materials mentioning features or use of this software
17  *    must display the following acknowledgement:
18  *      This product includes software developed by Aaron Campbell.
19  * 4. The name of the author may not be used to endorse or promote products
20  *    derived from this software without specific prior written permission.
21  *
22  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
23  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
24  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
25  * IN NO EVENT SHALL THE AUTHOR OR HIS RELATIVES BE LIABLE FOR ANY DIRECT,
26  * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
27  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
28  * SERVICES; LOSS OF MIND, USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
30  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
31  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
32  * THE POSSIBILITY OF SUCH DAMAGE.
33  */
34 
35 /*
36  * Typhoon registers.
37  */
38 #define	TXP_SRR				0x00	/* soft reset register */
39 #define	TXP_ISR				0x04	/* interrupt status register */
40 #define	TXP_IER				0x08	/* interrupt enable register */
41 #define	TXP_IMR				0x0c	/* interrupt mask register */
42 #define	TXP_SIR				0x10	/* self interrupt register */
43 #define	TXP_H2A_7			0x14	/* host->arm comm 7 */
44 #define	TXP_H2A_6			0x18	/* host->arm comm 6 */
45 #define	TXP_H2A_5			0x1c	/* host->arm comm 5 */
46 #define	TXP_H2A_4			0x20	/* host->arm comm 4 */
47 #define	TXP_H2A_3			0x24	/* host->arm comm 3 */
48 #define	TXP_H2A_2			0x28	/* host->arm comm 2 */
49 #define	TXP_H2A_1			0x2c	/* host->arm comm 1 */
50 #define	TXP_H2A_0			0x30	/* host->arm comm 0 */
51 #define	TXP_A2H_3			0x34	/* arm->host comm 3 */
52 #define	TXP_A2H_2			0x38	/* arm->host comm 2 */
53 #define	TXP_A2H_1			0x3c	/* arm->host comm 1 */
54 #define	TXP_A2H_0			0x40	/* arm->host comm 0 */
55 
56 /*
57  * interrupt bits (IMR, ISR, IER)
58  */
59 #define	TXP_INT_RESERVED	0xffff0000
60 #define	TXP_INT_A2H_7		0x00008000	/* arm->host comm 7 */
61 #define	TXP_INT_A2H_6		0x00004000	/* arm->host comm 6 */
62 #define	TXP_INT_A2H_5		0x00002000	/* arm->host comm 5 */
63 #define	TXP_INT_A2H_4		0x00001000	/* arm->host comm 4 */
64 #define	TXP_INT_SELF		0x00000800	/* self interrupt */
65 #define	TXP_INT_PCI_TABORT	0x00000400	/* pci target abort */
66 #define	TXP_INT_PCI_MABORT	0x00000200	/* pci master abort */
67 #define	TXP_INT_DMA3		0x00000100	/* dma3 done */
68 #define	TXP_INT_DMA2		0x00000080	/* dma2 done */
69 #define	TXP_INT_DMA1		0x00000040	/* dma1 done */
70 #define	TXP_INT_DMA0		0x00000020	/* dma0 done */
71 #define	TXP_INT_A2H_3		0x00000010	/* arm->host comm 3 */
72 #define	TXP_INT_A2H_2		0x00000008	/* arm->host comm 2 */
73 #define	TXP_INT_A2H_1		0x00000004	/* arm->host comm 1 */
74 #define	TXP_INT_A2H_0		0x00000002	/* arm->host comm 0 */
75 #define	TXP_INT_LATCH		0x00000001	/* interrupt latch */
76 
77 /*
78  * Controller periodically generates TXP_INT_A2H_3 interrupt so
79  * we don't want to see them in interrupt handler.
80  */
81 #define	TXP_INTRS		0xFFFFFFEF
82 #define	TXP_INTR_ALL		0xFFFFFFFF
83 #define	TXP_INTR_NONE		0x00000000
84 
85 /*
86  * soft reset register (SRR)
87  */
88 #define	TXP_SRR_ALL		0x0000007f	/* full reset */
89 
90 /*
91  * Typhoon boot commands.
92  */
93 #define	TXP_BOOTCMD_NULL			0x00
94 #define	TXP_BOOTCMD_WAKEUP			0xfa
95 #define	TXP_BOOTCMD_DOWNLOAD_COMPLETE		0xfb
96 #define	TXP_BOOTCMD_SEGMENT_AVAILABLE		0xfc
97 #define	TXP_BOOTCMD_RUNTIME_IMAGE		0xfd
98 #define	TXP_BOOTCMD_REGISTER_BOOT_RECORD	0xff
99 
100 /*
101  * Typhoon runtime commands.
102  */
103 #define	TXP_CMD_GLOBAL_RESET			0x00
104 #define	TXP_CMD_TX_ENABLE			0x01
105 #define	TXP_CMD_TX_DISABLE			0x02
106 #define	TXP_CMD_RX_ENABLE			0x03
107 #define	TXP_CMD_RX_DISABLE			0x04
108 #define	TXP_CMD_RX_FILTER_WRITE			0x05
109 #define	TXP_CMD_RX_FILTER_READ			0x06
110 #define	TXP_CMD_READ_STATISTICS			0x07
111 #define	TXP_CMD_CYCLE_STATISTICS		0x08
112 #define	TXP_CMD_CLEAR_STATISTICS		0x09
113 #define	TXP_CMD_MEMORY_READ			0x0a
114 #define	TXP_CMD_MEMORY_WRITE_SINGLE		0x0b
115 #define	TXP_CMD_VARIABLE_SECTION_READ		0x0c
116 #define	TXP_CMD_VARIABLE_SECTION_WRITE		0x0d
117 #define	TXP_CMD_STATIC_SECTION_READ		0x0e
118 #define	TXP_CMD_STATIC_SECTION_WRITE		0x0f
119 #define	TXP_CMD_IMAGE_SECTION_PROGRAM		0x10
120 #define	TXP_CMD_NVRAM_PAGE_READ			0x11
121 #define	TXP_CMD_NVRAM_PAGE_WRITE		0x12
122 #define	TXP_CMD_XCVR_SELECT			0x13
123 #define	TXP_CMD_TEST_MUX			0x14
124 #define	TXP_CMD_PHYLOOPBACK_ENABLE		0x15
125 #define	TXP_CMD_PHYLOOPBACK_DISABLE		0x16
126 #define	TXP_CMD_MAC_CONTROL_READ		0x17
127 #define	TXP_CMD_MAC_CONTROL_WRITE		0x18
128 #define	TXP_CMD_MAX_PKT_SIZE_READ		0x19
129 #define	TXP_CMD_MAX_PKT_SIZE_WRITE		0x1a
130 #define	TXP_CMD_MEDIA_STATUS_READ		0x1b
131 #define	TXP_CMD_MEDIA_STATUS_WRITE		0x1c
132 #define	TXP_CMD_NETWORK_DIAGS_READ		0x1d
133 #define	TXP_CMD_NETWORK_DIAGS_WRITE		0x1e
134 #define	TXP_CMD_PHY_MGMT_READ			0x1f
135 #define	TXP_CMD_PHY_MGMT_WRITE			0x20
136 #define	TXP_CMD_VARIABLE_PARAMETER_READ		0x21
137 #define	TXP_CMD_VARIABLE_PARAMETER_WRITE	0x22
138 #define	TXP_CMD_GOTO_SLEEP			0x23
139 #define	TXP_CMD_FIREWALL_CONTROL		0x24
140 #define	TXP_CMD_MCAST_HASH_MASK_WRITE		0x25
141 #define	TXP_CMD_STATION_ADDRESS_WRITE		0x26
142 #define	TXP_CMD_STATION_ADDRESS_READ		0x27
143 #define	TXP_CMD_STATION_MASK_WRITE		0x28
144 #define	TXP_CMD_STATION_MASK_READ		0x29
145 #define	TXP_CMD_VLAN_ETHER_TYPE_READ		0x2a
146 #define	TXP_CMD_VLAN_ETHER_TYPE_WRITE		0x2b
147 #define	TXP_CMD_VLAN_MASK_READ			0x2c
148 #define	TXP_CMD_VLAN_MASK_WRITE			0x2d
149 #define	TXP_CMD_BCAST_THROTTLE_WRITE		0x2e
150 #define	TXP_CMD_BCAST_THROTTLE_READ		0x2f
151 #define	TXP_CMD_DHCP_PREVENT_WRITE		0x30
152 #define	TXP_CMD_DHCP_PREVENT_READ		0x31
153 #define	TXP_CMD_RECV_BUFFER_CONTROL		0x32
154 #define	TXP_CMD_SOFTWARE_RESET			0x33
155 #define	TXP_CMD_CREATE_SA			0x34
156 #define	TXP_CMD_DELETE_SA			0x35
157 #define	TXP_CMD_ENABLE_RX_IP_OPTION		0x36
158 #define	TXP_CMD_RANDOM_NUMBER_CONTROL		0x37
159 #define	TXP_CMD_RANDOM_NUMBER_READ		0x38
160 #define	TXP_CMD_MATRIX_TABLE_MODE_WRITE		0x39
161 #define	TXP_CMD_MATRIX_DETAIL_READ		0x3a
162 #define	TXP_CMD_FILTER_ARRAY_READ		0x3b
163 #define	TXP_CMD_FILTER_DETAIL_READ		0x3c
164 #define	TXP_CMD_FILTER_TABLE_MODE_WRITE		0x3d
165 #define	TXP_CMD_FILTER_TCL_WRITE		0x3e
166 #define	TXP_CMD_FILTER_TBL_READ			0x3f
167 #define	TXP_CMD_READ_VERSION			0x43
168 #define	TXP_CMD_FILTER_DEFINE			0x45
169 #define	TXP_CMD_ADD_WAKEUP_PKT			0x46
170 #define	TXP_CMD_ADD_SLEEP_PKT			0x47
171 #define	TXP_CMD_ENABLE_SLEEP_EVENTS		0x48
172 #define	TXP_CMD_ENABLE_WAKEUP_EVENTS		0x49
173 #define	TXP_CMD_GET_IP_ADDRESS			0x4a
174 #define	TXP_CMD_READ_PCI_REG			0x4c
175 #define	TXP_CMD_WRITE_PCI_REG			0x4d
176 #define	TXP_CMD_OFFLOAD_READ			0x4e
177 #define	TXP_CMD_OFFLOAD_WRITE			0x4f
178 #define	TXP_CMD_HELLO_RESPONSE			0x57
179 #define	TXP_CMD_ENABLE_RX_FILTER		0x58
180 #define	TXP_CMD_RX_FILTER_CAPABILITY		0x59
181 #define	TXP_CMD_HALT				0x5d
182 #define	TXP_CMD_READ_IPSEC_INFO			0x54
183 #define	TXP_CMD_GET_IPSEC_ENABLE		0x67
184 #define	TXP_CMD_INVALID				0xffff
185 
186 #define	TXP_FRAGMENT		0x0000
187 #define	TXP_TXFRAME		0x0001
188 #define	TXP_COMMAND		0x0002
189 #define	TXP_OPTION		0x0003
190 #define	TXP_RECEIVE		0x0004
191 #define	TXP_RESPONSE		0x0005
192 
193 #define	TXP_TYPE_IPSEC		0x0000
194 #define	TXP_TYPE_TCPSEGMENT	0x0001
195 
196 #define	TXP_PFLAG_NOCRC		0x0000
197 #define	TXP_PFLAG_IPCKSUM	0x0001
198 #define	TXP_PFLAG_TCPCKSUM	0x0002
199 #define	TXP_PFLAG_TCPSEGMENT	0x0004
200 #define	TXP_PFLAG_INSERTVLAN	0x0008
201 #define	TXP_PFLAG_IPSEC		0x0010
202 #define	TXP_PFLAG_PRIORITY	0x0020
203 #define	TXP_PFLAG_UDPCKSUM	0x0040
204 #define	TXP_PFLAG_PADFRAME	0x0080
205 
206 #define	TXP_MISC_FIRSTDESC	0x0000
207 #define	TXP_MISC_LASTDESC	0x0001
208 
209 #define	TXP_ERR_INTERNAL	0x0000
210 #define	TXP_ERR_FIFOUNDERRUN	0x0001
211 #define	TXP_ERR_BADSSD		0x0002
212 #define	TXP_ERR_RUNT		0x0003
213 #define	TXP_ERR_CRC		0x0004
214 #define	TXP_ERR_OVERSIZE	0x0005
215 #define	TXP_ERR_ALIGNMENT	0x0006
216 #define	TXP_ERR_DRIBBLEBIT	0x0007
217 
218 #define	TXP_PROTO_UNKNOWN	0x0000
219 #define	TXP_PROTO_IP		0x0001
220 #define	TXP_PROTO_IPX		0x0002
221 #define	TXP_PROTO_RESERVED	0x0003
222 
223 #define	TXP_STAT_PROTO		0x0001
224 #define	TXP_STAT_VLAN		0x0002
225 #define	TXP_STAT_IPFRAGMENT	0x0004
226 #define	TXP_STAT_IPSEC		0x0008
227 #define	TXP_STAT_IPCKSUMBAD	0x0010
228 #define	TXP_STAT_TCPCKSUMBAD	0x0020
229 #define	TXP_STAT_UDPCKSUMBAD	0x0040
230 #define	TXP_STAT_IPCKSUMGOOD	0x0080
231 #define	TXP_STAT_TCPCKSUMGOOD	0x0100
232 #define	TXP_STAT_UDPCKSUMGOOD	0x0200
233 
234 struct txp_tx_desc {
235 	uint8_t			tx_flags;	/* type/descriptor flags */
236 	uint8_t			tx_numdesc;	/* number of descriptors */
237 	uint16_t		tx_totlen;	/* total packet length */
238 	uint32_t		tx_addrlo;	/* virt addr low word */
239 	uint32_t		tx_addrhi;	/* virt addr high word */
240 	uint32_t		tx_pflags;	/* processing flags */
241 };
242 #define	TX_FLAGS_TYPE_M		0x07		/* type mask */
243 #define	TX_FLAGS_TYPE_FRAG	0x00		/* type: fragment */
244 #define	TX_FLAGS_TYPE_DATA	0x01		/* type: data frame */
245 #define	TX_FLAGS_TYPE_CMD	0x02		/* type: command frame */
246 #define	TX_FLAGS_TYPE_OPT	0x03		/* type: options */
247 #define	TX_FLAGS_TYPE_RX	0x04		/* type: command */
248 #define	TX_FLAGS_TYPE_RESP	0x05		/* type: response */
249 #define	TX_FLAGS_RESP		0x40		/* response requested */
250 #define	TX_FLAGS_VALID		0x80		/* valid descriptor */
251 
252 #define	TX_PFLAGS_DNAC		0x00000001	/* do not add crc */
253 #define	TX_PFLAGS_IPCKSUM	0x00000002	/* ip checksum */
254 #define	TX_PFLAGS_TCPCKSUM	0x00000004	/* tcp checksum */
255 #define	TX_PFLAGS_TCPSEG	0x00000008	/* tcp segmentation */
256 #define	TX_PFLAGS_VLAN		0x00000010	/* insert vlan */
257 #define	TX_PFLAGS_IPSEC		0x00000020	/* perform ipsec */
258 #define	TX_PFLAGS_PRIO		0x00000040	/* priority field valid */
259 #define	TX_PFLAGS_UDPCKSUM	0x00000080	/* udp checksum */
260 #define	TX_PFLAGS_PADFRAME	0x00000100	/* pad frame */
261 #define	TX_PFLAGS_VLANTAG_M	0x0ffff000	/* vlan tag mask */
262 #define	TX_PFLAGS_VLANPRI_M	0x00700000	/* vlan priority mask */
263 #define	TX_PFLAGS_VLANTAG_S	12		/* amount to shift tag */
264 
265 struct txp_rx_desc {
266 	uint8_t			rx_flags;	/* type/descriptor flags */
267 	uint8_t			rx_numdesc;	/* number of descriptors */
268 	uint16_t		rx_len;		/* frame length */
269 	uint32_t		rx_vaddrlo;	/* virtual address, lo word */
270 	uint32_t		rx_vaddrhi;	/* virtual address, hi word */
271 	uint32_t		rx_stat;	/* status */
272 	uint16_t		rx_filter;	/* filter status */
273 	uint16_t		rx_hash;	/* hash status */
274 	uint32_t		rx_vlan;	/* vlan tag/priority */
275 };
276 
277 /* txp_rx_desc.rx_flags */
278 #define	RX_FLAGS_TYPE_M		0x07		/* type mask */
279 #define	RX_FLAGS_TYPE_FRAG	0x00		/* type: fragment */
280 #define	RX_FLAGS_TYPE_DATA	0x01		/* type: data frame */
281 #define	RX_FLAGS_TYPE_CMD	0x02		/* type: command frame */
282 #define	RX_FLAGS_TYPE_OPT	0x03		/* type: options */
283 #define	RX_FLAGS_TYPE_RX	0x04		/* type: command */
284 #define	RX_FLAGS_TYPE_RESP	0x05		/* type: response */
285 #define	RX_FLAGS_RCV_TYPE_M	0x18		/* rcvtype mask */
286 #define	RX_FLAGS_RCV_TYPE_RX	0x00		/* rcvtype: receive */
287 #define	RX_FLAGS_RCV_TYPE_RSP	0x08		/* rcvtype: response */
288 #define	RX_FLAGS_ERROR		0x40		/* error in packet */
289 
290 /* txp_rx_desc.rx_stat (if rx_flags & RX_FLAGS_ERROR bit set) */
291 #define	RX_ERROR_ADAPTER	0x00000000	/* adapter internal error */
292 #define	RX_ERROR_FIFO		0x00000001	/* fifo underrun */
293 #define	RX_ERROR_BADSSD		0x00000002	/* bad ssd */
294 #define	RX_ERROR_RUNT		0x00000003	/* runt packet */
295 #define	RX_ERROR_CRC		0x00000004	/* bad crc */
296 #define	RX_ERROR_OVERSIZE	0x00000005	/* oversized packet */
297 #define	RX_ERROR_ALIGN		0x00000006	/* alignment error */
298 #define	RX_ERROR_DRIBBLE	0x00000007	/* dribble bit */
299 #define	RX_ERROR_MASK		0x07
300 
301 /* txp_rx_desc.rx_stat (if rx_flags & RX_FLAGS_ERROR not bit set) */
302 #define	RX_STAT_PROTO_M		0x00000003	/* protocol mask */
303 #define	RX_STAT_PROTO_UK	0x00000000	/* unknown protocol */
304 #define	RX_STAT_PROTO_IPX	0x00000001	/* IPX */
305 #define	RX_STAT_PROTO_IP	0x00000002	/* IP */
306 #define	RX_STAT_PROTO_RSV	0x00000003	/* reserved */
307 #define	RX_STAT_VLAN		0x00000004	/* vlan tag (in rxd) */
308 #define	RX_STAT_IPFRAG		0x00000008	/* fragment, ipsec not done */
309 #define	RX_STAT_IPSEC		0x00000010	/* ipsec decoded packet */
310 #define	RX_STAT_IPCKSUMBAD	0x00000020	/* ip checksum failed */
311 #define	RX_STAT_UDPCKSUMBAD	0x00000040	/* udp checksum failed */
312 #define	RX_STAT_TCPCKSUMBAD	0x00000080	/* tcp checksum failed */
313 #define	RX_STAT_IPCKSUMGOOD	0x00000100	/* ip checksum succeeded */
314 #define	RX_STAT_UDPCKSUMGOOD	0x00000200	/* udp checksum succeeded */
315 #define	RX_STAT_TCPCKSUMGOOD	0x00000400	/* tcp checksum succeeded */
316 
317 
318 struct txp_rxbuf_desc {
319 	uint32_t		rb_paddrlo;
320 	uint32_t		rb_paddrhi;
321 	uint32_t		rb_vaddrlo;
322 	uint32_t		rb_vaddrhi;
323 };
324 
325 /* Extension descriptor */
326 struct txp_ext_desc {
327 	uint32_t		ext_1;
328 	uint32_t		ext_2;
329 	uint32_t		ext_3;
330 	uint32_t		ext_4;
331 };
332 
333 struct txp_cmd_desc {
334 	uint8_t			cmd_flags;
335 	uint8_t			cmd_numdesc;
336 	uint16_t		cmd_id;
337 	uint16_t		cmd_seq;
338 	uint16_t		cmd_par1;
339 	uint32_t		cmd_par2;
340 	uint32_t		cmd_par3;
341 };
342 #define	CMD_FLAGS_TYPE_M	0x07		/* type mask */
343 #define	CMD_FLAGS_TYPE_FRAG	0x00		/* type: fragment */
344 #define	CMD_FLAGS_TYPE_DATA	0x01		/* type: data frame */
345 #define	CMD_FLAGS_TYPE_CMD	0x02		/* type: command frame */
346 #define	CMD_FLAGS_TYPE_OPT	0x03		/* type: options */
347 #define	CMD_FLAGS_TYPE_RX	0x04		/* type: command */
348 #define	CMD_FLAGS_TYPE_RESP	0x05		/* type: response */
349 #define	CMD_FLAGS_RESP		0x40		/* response requested */
350 #define	CMD_FLAGS_VALID		0x80		/* valid descriptor */
351 
352 struct txp_rsp_desc {
353 	uint8_t			rsp_flags;
354 	uint8_t			rsp_numdesc;
355 	uint16_t		rsp_id;
356 	uint16_t		rsp_seq;
357 	uint16_t		rsp_par1;
358 	uint32_t		rsp_par2;
359 	uint32_t		rsp_par3;
360 };
361 #define	RSP_FLAGS_TYPE_M	0x07		/* type mask */
362 #define	RSP_FLAGS_TYPE_FRAG	0x00		/* type: fragment */
363 #define	RSP_FLAGS_TYPE_DATA	0x01		/* type: data frame */
364 #define	RSP_FLAGS_TYPE_CMD	0x02		/* type: command frame */
365 #define	RSP_FLAGS_TYPE_OPT	0x03		/* type: options */
366 #define	RSP_FLAGS_TYPE_RX	0x04		/* type: command */
367 #define	RSP_FLAGS_TYPE_RESP	0x05		/* type: response */
368 #define	RSP_FLAGS_ERROR		0x40		/* response error */
369 
370 struct txp_frag_desc {
371 	uint8_t			frag_flags;	/* type/descriptor flags */
372 	uint8_t			frag_rsvd1;
373 	uint16_t		frag_len;	/* bytes in this fragment */
374 	uint32_t		frag_addrlo;	/* phys addr low word */
375 	uint32_t		frag_addrhi;	/* phys addr high word */
376 	uint32_t		frag_rsvd2;
377 };
378 #define	FRAG_FLAGS_TYPE_M	0x07		/* type mask */
379 #define	FRAG_FLAGS_TYPE_FRAG	0x00		/* type: fragment */
380 #define	FRAG_FLAGS_TYPE_DATA	0x01		/* type: data frame */
381 #define	FRAG_FLAGS_TYPE_CMD	0x02		/* type: command frame */
382 #define	FRAG_FLAGS_TYPE_OPT	0x03		/* type: options */
383 #define	FRAG_FLAGS_TYPE_RX	0x04		/* type: command */
384 #define	FRAG_FLAGS_TYPE_RESP	0x05		/* type: response */
385 
386 struct txp_opt_desc {
387 	uint8_t			opt_desctype:3,
388 				opt_rsvd:1,
389 				opt_type:4;
390 
391 	uint8_t			opt_num;
392 	uint16_t		opt_dep1;
393 	uint32_t		opt_dep2;
394 	uint32_t		opt_dep3;
395 	uint32_t		opt_dep4;
396 };
397 
398 struct txp_ipsec_desc {
399 	uint8_t			ipsec_desctpe:3,
400 				ipsec_rsvd:1,
401 				ipsec_type:4;
402 
403 	uint8_t			ipsec_num;
404 	uint16_t		ipsec_flags;
405 	uint16_t		ipsec_ah1;
406 	uint16_t		ipsec_esp1;
407 	uint16_t		ipsec_ah2;
408 	uint16_t		ipsec_esp2;
409 	uint32_t		ipsec_rsvd1;
410 };
411 
412 struct txp_tcpseg_desc {
413 	uint8_t			tcpseg_type;
414 	uint8_t			tcpseg_num;
415 	uint16_t		tcpseg_mss;
416 	uint32_t		tcpseg_respaddr;
417 	uint32_t		tcpseg_txbytes;
418 	uint32_t		tcpseg_lss;
419 };
420 #define	TCPSEG_DESC_TYPE_M	0x07		/* type mask */
421 #define	TCPSEG_DESC_TYPE_FRAG	0x00		/* type: fragment */
422 #define	TCPSEG_DESC_TYPE_DATA	0x01		/* type: data frame */
423 #define	TCPSEG_DESC_TYPE_CMD	0x02		/* type: command frame */
424 #define	TCPSEG_DESC_TYPE_OPT	0x03		/* type: options */
425 #define	TCPSEG_DESC_TYPE_RX	0x04		/* type: command */
426 #define	TCPSEG_DESC_TYPE_RESP	0x05		/* type: response */
427 #define	TCPSEG_OPT_IPSEC	0x00
428 #define	TCPSEG_OPT_TSO		0x10
429 #define	TCPSEG_MSS_MASK		0x0FFF
430 #define	TCPSEG_MSS_FIRST	0x1000
431 #define	TCPSEG_MSS_LAST		0x2000
432 
433 /*
434  * Transceiver types
435  */
436 #define	TXP_XCVR_10_HDX		0
437 #define	TXP_XCVR_10_FDX		1
438 #define	TXP_XCVR_100_HDX	2
439 #define	TXP_XCVR_100_FDX	3
440 #define	TXP_XCVR_AUTO		4
441 
442 #define TXP_MEDIA_CRC		0x0004	/* crc strip disable */
443 #define	TXP_MEDIA_CD		0x0010	/* collision detection */
444 #define	TXP_MEDIA_CS		0x0020	/* carrier sense */
445 #define	TXP_MEDIA_POL		0x0400	/* polarity reversed */
446 #define	TXP_MEDIA_NOLINK	0x0800	/* 0 = link, 1 = no link */
447 
448 /*
449  * receive filter bits (par1 to TXP_CMD_RX_FILTER_{READ|WRITE}
450  */
451 #define	TXP_RXFILT_DIRECT	0x0001	/* directed packets */
452 #define	TXP_RXFILT_ALLMULTI	0x0002	/* all multicast packets */
453 #define	TXP_RXFILT_BROADCAST	0x0004	/* broadcast packets */
454 #define	TXP_RXFILT_PROMISC	0x0008	/* promiscuous mode */
455 #define	TXP_RXFILT_HASHMULTI	0x0010	/* use multicast filter */
456 
457 /*
458  * boot record (pointers to rings)
459  */
460 struct txp_boot_record {
461 	uint32_t		br_hostvar_lo;		/* host ring pointer */
462 	uint32_t		br_hostvar_hi;
463 	uint32_t		br_txlopri_lo;		/* tx low pri ring */
464 	uint32_t		br_txlopri_hi;
465 	uint32_t		br_txlopri_siz;
466 	uint32_t		br_txhipri_lo;		/* tx high pri ring */
467 	uint32_t		br_txhipri_hi;
468 	uint32_t		br_txhipri_siz;
469 	uint32_t		br_rxlopri_lo;		/* rx low pri ring */
470 	uint32_t		br_rxlopri_hi;
471 	uint32_t		br_rxlopri_siz;
472 	uint32_t		br_rxbuf_lo;		/* rx buffer ring */
473 	uint32_t		br_rxbuf_hi;
474 	uint32_t		br_rxbuf_siz;
475 	uint32_t		br_cmd_lo;		/* command ring */
476 	uint32_t		br_cmd_hi;
477 	uint32_t		br_cmd_siz;
478 	uint32_t		br_resp_lo;		/* response ring */
479 	uint32_t		br_resp_hi;
480 	uint32_t		br_resp_siz;
481 	uint32_t		br_zero_lo;		/* zero word */
482 	uint32_t		br_zero_hi;
483 	uint32_t		br_rxhipri_lo;		/* rx high pri ring */
484 	uint32_t		br_rxhipri_hi;
485 	uint32_t		br_rxhipri_siz;
486 };
487 
488 /*
489  * hostvar structure (shared with typhoon)
490  */
491 struct txp_hostvar {
492 	uint32_t		hv_rx_hi_read_idx;	/* host->arm */
493 	uint32_t		hv_rx_lo_read_idx;	/* host->arm */
494 	uint32_t		hv_rx_buf_write_idx;	/* host->arm */
495 	uint32_t		hv_resp_read_idx;	/* host->arm */
496 	uint32_t		hv_tx_lo_desc_read_idx;	/* arm->host */
497 	uint32_t		hv_tx_hi_desc_read_idx;	/* arm->host */
498 	uint32_t		hv_rx_lo_write_idx;	/* arm->host */
499 	uint32_t		hv_rx_buf_read_idx;	/* arm->host */
500 	uint32_t		hv_cmd_read_idx;	/* arm->host */
501 	uint32_t		hv_resp_write_idx;	/* arm->host */
502 	uint32_t		hv_rx_hi_write_idx;	/* arm->host */
503 };
504 
505 /*
506  * TYPHOON status register state (in TXP_A2H_0)
507  */
508 #define	STAT_ROM_CODE			0x00000001
509 #define	STAT_ROM_EEPROM_LOAD		0x00000002
510 #define	STAT_WAITING_FOR_BOOT		0x00000007
511 #define	STAT_RUNNING			0x00000009
512 #define	STAT_WAITING_FOR_HOST_REQUEST	0x0000000d
513 #define	STAT_WAITING_FOR_SEGMENT	0x00000010
514 #define	STAT_SLEEPING			0x00000011
515 #define	STAT_HALTED			0x00000014
516 
517 #define	TX_ENTRIES			256
518 #define	RX_ENTRIES			128
519 #define	RXBUF_ENTRIES			256
520 #define	CMD_ENTRIES			32
521 #define	RSP_ENTRIES			32
522 
523 #define	OFFLOAD_TCPCKSUM		0x00000002	/* tcp checksum */
524 #define	OFFLOAD_UDPCKSUM		0x00000004	/* udp checksum */
525 #define	OFFLOAD_IPCKSUM			0x00000008	/* ip checksum */
526 #define	OFFLOAD_IPSEC			0x00000010	/* ipsec enable */
527 #define	OFFLOAD_BCAST			0x00000020	/* broadcast throttle */
528 #define	OFFLOAD_DHCP			0x00000040	/* dhcp prevention */
529 #define	OFFLOAD_VLAN			0x00000080	/* vlan enable */
530 #define	OFFLOAD_FILTER			0x00000100	/* filter enable */
531 #define	OFFLOAD_TCPSEG			0x00000200	/* tcp segmentation */
532 #define	OFFLOAD_MASK			0xfffffffe	/* mask off low bit */
533 
534 /*
535  * Macros for converting array indices to offsets within the descriptor
536  * arrays.  The chip operates on offsets, but it's much easier for us
537  * to operate on indices.  Assumes descriptor entries are 16 bytes.
538  */
539 #define	TXP_IDX2OFFSET(idx)	((idx) << 4)
540 #define	TXP_OFFSET2IDX(off)	((off) >> 4)
541 
542 struct txp_cmd_ring {
543 	struct txp_cmd_desc	*base;
544 	uint32_t		lastwrite;
545 	uint32_t		size;
546 };
547 
548 struct txp_rsp_ring {
549 	struct txp_rsp_desc	*base;
550 	uint32_t		lastwrite;
551 	uint32_t		size;
552 };
553 
554 struct txp_tx_ring {
555 	struct txp_tx_desc	*r_desc;	/* base address of descs */
556 	bus_dma_tag_t		r_tag;
557 	bus_dmamap_t		r_map;
558 	uint32_t		r_reg;		/* register to activate */
559 	uint32_t		r_prod;		/* producer */
560 	uint32_t		r_cons;		/* consumer */
561 	uint32_t		r_cnt;		/* # descs in use */
562 	uint32_t		*r_off;		/* hostvar index pointer */
563 };
564 
565 struct txp_swdesc {
566 	struct mbuf 		*sd_mbuf;
567 	bus_dmamap_t		sd_map;
568 };
569 
570 struct txp_rx_swdesc {
571 	TAILQ_ENTRY(txp_rx_swdesc)	sd_next;
572 	struct mbuf 		*sd_mbuf;
573 	bus_dmamap_t		sd_map;
574 };
575 
576 struct txp_rx_ring {
577 	struct txp_rx_desc	*r_desc;	/* base address of descs */
578 	bus_dma_tag_t		r_tag;
579 	bus_dmamap_t		r_map;
580 	uint32_t		*r_roff;	/* hv read offset ptr */
581 	uint32_t		*r_woff;	/* hv write offset ptr */
582 };
583 
584 struct txp_ldata {
585 	struct txp_boot_record	*txp_boot;
586 	bus_addr_t		txp_boot_paddr;
587 	struct txp_hostvar	*txp_hostvar;
588 	bus_addr_t		txp_hostvar_paddr;
589 	struct txp_tx_desc	*txp_txhiring;
590 	bus_addr_t		txp_txhiring_paddr;
591 	struct txp_tx_desc	*txp_txloring;
592 	bus_addr_t		txp_txloring_paddr;
593 	struct txp_rxbuf_desc	*txp_rxbufs;
594 	bus_addr_t		txp_rxbufs_paddr;
595 	struct txp_rx_desc	*txp_rxhiring;
596 	bus_addr_t		txp_rxhiring_paddr;
597 	struct txp_rx_desc	*txp_rxloring;
598 	bus_addr_t		txp_rxloring_paddr;
599 	struct txp_cmd_desc	*txp_cmdring;
600 	bus_addr_t		txp_cmdring_paddr;
601 	struct txp_rsp_desc	*txp_rspring;
602 	bus_addr_t		txp_rspring_paddr;
603 	uint32_t		*txp_zero;
604 	bus_addr_t		txp_zero_paddr;
605 };
606 
607 struct txp_chain_data {
608 	bus_dma_tag_t		txp_parent_tag;
609 	bus_dma_tag_t		txp_boot_tag;
610 	bus_dmamap_t		txp_boot_map;
611 	bus_dma_tag_t		txp_hostvar_tag;
612 	bus_dmamap_t		txp_hostvar_map;
613 	bus_dma_tag_t		txp_txhiring_tag;
614 	bus_dmamap_t		txp_txhiring_map;
615 	bus_dma_tag_t		txp_txloring_tag;
616 	bus_dmamap_t		txp_txloring_map;
617 	bus_dma_tag_t		txp_tx_tag;
618 	bus_dma_tag_t		txp_rx_tag;
619 	bus_dma_tag_t		txp_rxbufs_tag;
620 	bus_dmamap_t		txp_rxbufs_map;
621 	bus_dma_tag_t		txp_rxhiring_tag;
622 	bus_dmamap_t		txp_rxhiring_map;
623 	bus_dma_tag_t		txp_rxloring_tag;
624 	bus_dmamap_t		txp_rxloring_map;
625 	bus_dma_tag_t		txp_cmdring_tag;
626 	bus_dmamap_t		txp_cmdring_map;
627 	bus_dma_tag_t		txp_rspring_tag;
628 	bus_dmamap_t		txp_rspring_map;
629 	bus_dma_tag_t		txp_zero_tag;
630 	bus_dmamap_t		txp_zero_map;
631 };
632 
633 struct txp_hw_stats {
634 	uint32_t		tx_frames;
635 	uint64_t		tx_bytes;
636 	uint32_t		tx_deferred;
637 	uint32_t		tx_late_colls;
638 	uint32_t		tx_colls;
639 	uint32_t		tx_carrier_lost;
640 	uint32_t		tx_multi_colls;
641 	uint32_t		tx_excess_colls;
642 	uint32_t		tx_fifo_underruns;
643 	uint32_t		tx_mcast_oflows;
644 	uint32_t		tx_filtered;
645 	uint32_t		rx_frames;
646 	uint64_t		rx_bytes;
647 	uint32_t		rx_fifo_oflows;
648 	uint32_t		rx_badssd;
649 	uint32_t		rx_crcerrs;
650 	uint32_t		rx_lenerrs;
651 	uint32_t		rx_bcast_frames;
652 	uint32_t		rx_mcast_frames;
653 	uint32_t		rx_oflows;
654 	uint32_t		rx_filtered;
655 };
656 
657 struct txp_softc {
658 	struct ifnet		*sc_ifp;
659 	device_t		sc_dev;
660 	struct txp_hostvar	*sc_hostvar;
661 	struct txp_boot_record	*sc_boot;
662 	struct resource		*sc_res;
663 	int			sc_res_id;
664 	int			sc_res_type;
665 	struct resource		*sc_irq;
666 	void			*sc_intrhand;
667 	struct txp_chain_data	sc_cdata;
668 	struct txp_ldata	sc_ldata;
669 	int			sc_rxbufprod;
670 	int			sc_process_limit;
671 	struct txp_cmd_ring	sc_cmdring;
672 	struct txp_rsp_ring	sc_rspring;
673 	struct callout		sc_tick;
674 	struct ifmedia		sc_ifmedia;
675 	struct txp_hw_stats	sc_ostats;
676 	struct txp_hw_stats	sc_stats;
677 	struct txp_tx_ring	sc_txhir, sc_txlor;
678 	struct txp_swdesc	sc_txd[TX_ENTRIES];
679 	struct txp_rxbuf_desc	*sc_rxbufs;
680 	struct txp_rx_ring	sc_rxhir, sc_rxlor;
681 	uint16_t		sc_xcvr;
682 	uint16_t		sc_seq;
683 	int			sc_watchdog_timer;
684 	int			sc_if_flags;
685 	int			sc_flags;
686 #define	TXP_FLAG_DETACH		0x4000
687 #define	TXP_FLAG_LINK		0x8000
688 	TAILQ_HEAD(, txp_rx_swdesc)	sc_free_list;
689 	TAILQ_HEAD(, txp_rx_swdesc)	sc_busy_list;
690 	struct task		sc_int_task;
691 	struct taskqueue	*sc_tq;
692 	struct mtx		sc_mtx;
693 };
694 
695 struct txp_fw_file_header {
696 	uint8_t		magicid[8];	/* TYPHOON\0 */
697 	uint32_t	version;
698 	uint32_t	nsections;
699 	uint32_t	addr;
700 	uint32_t	hmac[5];
701 };
702 
703 struct txp_fw_section_header {
704 	uint32_t	nbytes;
705 	uint16_t	cksum;
706 	uint16_t	reserved;
707 	uint32_t	addr;
708 };
709 
710 #define	TXP_MAX_SEGLEN	0xffff
711 #define	TXP_MAX_PKTLEN	(ETHER_MAX_LEN + ETHER_VLAN_ENCAP_LEN)
712 
713 #define	WRITE_REG(sc, reg, val)		bus_write_4((sc)->sc_res, reg, val)
714 #define	READ_REG(sc, reg)		bus_read_4((sc)->sc_res, reg)
715 #define	TXP_BARRIER(sc, o, l, f)	bus_barrier((sc)->sc_res, (o), (l), (f))
716 
717 #define	TXP_LOCK(sc)		mtx_lock(&(sc)->sc_mtx)
718 #define	TXP_UNLOCK(sc)		mtx_unlock(&(sc)->sc_mtx)
719 #define	TXP_LOCK_ASSERT(sc)	mtx_assert(&(sc)->sc_mtx, MA_OWNED)
720 
721 #define	TXP_MAXTXSEGS		16
722 #define	TXP_RXBUF_ALIGN		(sizeof(uint32_t))
723 
724 #define	TXP_PROC_MIN		16
725 #define	TXP_PROC_MAX		RX_ENTRIES
726 #define	TXP_PROC_DEFAULT	(RX_ENTRIES / 2)
727 
728 #define	TXP_ADDR_HI(x)		((uint64_t)(x) >> 32)
729 #define	TXP_ADDR_LO(x)		((uint64_t)(x) & 0xffffffff)
730 
731 /*
732  * 3Com PCI vendor ID.
733  */
734 #define	TXP_VENDORID_3COM		0x10B7
735 
736 /*
737  * 3cR990 device IDs
738  */
739 #define TXP_DEVICEID_3CR990_TX_95	0x9902
740 #define TXP_DEVICEID_3CR990_TX_97	0x9903
741 #define TXP_DEVICEID_3CR990B_TXM	0x9904
742 #define TXP_DEVICEID_3CR990_SRV_95	0x9908
743 #define TXP_DEVICEID_3CR990_SRV_97	0x9909
744 #define TXP_DEVICEID_3CR990B_SRV	0x990A
745 
746 struct txp_type {
747 	uint16_t		txp_vid;
748 	uint16_t		txp_did;
749 	char			*txp_name;
750 };
751 
752 #define	TXP_TIMEOUT	10000
753 #define	TXP_CMD_NOWAIT	0
754 #define	TXP_CMD_WAIT	1
755 #define	TXP_TX_TIMEOUT	5
756 
757 /*
758  * Each frame requires one frame descriptor and one or more
759  * fragment descriptors. If TSO is used frame descriptor block
760  * requires one or two option frame descriptors depending on
761  * number of framents. Therefore we will consume three
762  * additional descriptors at most to use TSO for a frame and
763  * one reserved descriptor in order not to full Tx descriptor
764  * ring.
765  */
766 #define	TXP_TXD_RESERVED	4
767 
768 #define	TXP_DESC_INC(x, y)	((x) = ((x) + 1) % (y))
769