if_txpreg.h revision 327589
1/*	$OpenBSD: if_txpreg.h,v 1.34 2001/11/05 17:25:58 art Exp $ */
2/*	$FreeBSD: stable/11/sys/dev/txp/if_txpreg.h 327589 2018-01-05 17:21:51Z pfg $ */
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_VERSIONS_READ			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
234struct 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
265struct 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
318struct 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 */
326struct 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
333struct 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
352struct 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
370struct 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#define	FRAG_FLAGS_VALID	0x80		/* valid descriptor */
386
387struct txp_opt_desc {
388	uint8_t			opt_desctype:3,
389				opt_rsvd:1,
390				opt_type:4;
391
392	uint8_t			opt_num;
393	uint16_t		opt_dep1;
394	uint32_t		opt_dep2;
395	uint32_t		opt_dep3;
396	uint32_t		opt_dep4;
397};
398
399struct txp_ipsec_desc {
400	uint8_t			ipsec_desctpe:3,
401				ipsec_rsvd:1,
402				ipsec_type:4;
403
404	uint8_t			ipsec_num;
405	uint16_t		ipsec_flags;
406	uint16_t		ipsec_ah1;
407	uint16_t		ipsec_esp1;
408	uint16_t		ipsec_ah2;
409	uint16_t		ipsec_esp2;
410	uint32_t		ipsec_rsvd1;
411};
412
413struct txp_tcpseg_desc {
414	uint8_t			tcpseg_type;
415	uint8_t			tcpseg_num;
416	uint16_t		tcpseg_mss;
417	uint32_t		tcpseg_respaddr;
418	uint32_t		tcpseg_txbytes;
419	uint32_t		tcpseg_lss;
420};
421#define	TCPSEG_DESC_TYPE_M	0x07		/* type mask */
422#define	TCPSEG_DESC_TYPE_FRAG	0x00		/* type: fragment */
423#define	TCPSEG_DESC_TYPE_DATA	0x01		/* type: data frame */
424#define	TCPSEG_DESC_TYPE_CMD	0x02		/* type: command frame */
425#define	TCPSEG_DESC_TYPE_OPT	0x03		/* type: options */
426#define	TCPSEG_DESC_TYPE_RX	0x04		/* type: command */
427#define	TCPSEG_DESC_TYPE_RESP	0x05		/* type: response */
428#define	TCPSEG_OPT_IPSEC	0x00
429#define	TCPSEG_OPT_TSO		0x10
430#define	TCPSEG_MSS_MASK		0x0FFF
431#define	TCPSEG_MSS_FIRST	0x1000
432#define	TCPSEG_MSS_LAST		0x2000
433
434/*
435 * Transceiver types
436 */
437#define	TXP_XCVR_10_HDX		0
438#define	TXP_XCVR_10_FDX		1
439#define	TXP_XCVR_100_HDX	2
440#define	TXP_XCVR_100_FDX	3
441#define	TXP_XCVR_AUTO		4
442
443#define TXP_MEDIA_CRC		0x0004	/* crc strip disable */
444#define	TXP_MEDIA_CD		0x0010	/* collision detection */
445#define	TXP_MEDIA_CS		0x0020	/* carrier sense */
446#define	TXP_MEDIA_POL		0x0400	/* polarity reversed */
447#define	TXP_MEDIA_NOLINK	0x0800	/* 0 = link, 1 = no link */
448
449/*
450 * receive filter bits (par1 to TXP_CMD_RX_FILTER_{READ|WRITE}
451 */
452#define	TXP_RXFILT_DIRECT	0x0001	/* directed packets */
453#define	TXP_RXFILT_ALLMULTI	0x0002	/* all multicast packets */
454#define	TXP_RXFILT_BROADCAST	0x0004	/* broadcast packets */
455#define	TXP_RXFILT_PROMISC	0x0008	/* promiscuous mode */
456#define	TXP_RXFILT_HASHMULTI	0x0010	/* use multicast filter */
457
458/*
459 * boot record (pointers to rings)
460 */
461struct txp_boot_record {
462	uint32_t		br_hostvar_lo;		/* host ring pointer */
463	uint32_t		br_hostvar_hi;
464	uint32_t		br_txlopri_lo;		/* tx low pri ring */
465	uint32_t		br_txlopri_hi;
466	uint32_t		br_txlopri_siz;
467	uint32_t		br_txhipri_lo;		/* tx high pri ring */
468	uint32_t		br_txhipri_hi;
469	uint32_t		br_txhipri_siz;
470	uint32_t		br_rxlopri_lo;		/* rx low pri ring */
471	uint32_t		br_rxlopri_hi;
472	uint32_t		br_rxlopri_siz;
473	uint32_t		br_rxbuf_lo;		/* rx buffer ring */
474	uint32_t		br_rxbuf_hi;
475	uint32_t		br_rxbuf_siz;
476	uint32_t		br_cmd_lo;		/* command ring */
477	uint32_t		br_cmd_hi;
478	uint32_t		br_cmd_siz;
479	uint32_t		br_resp_lo;		/* response ring */
480	uint32_t		br_resp_hi;
481	uint32_t		br_resp_siz;
482	uint32_t		br_zero_lo;		/* zero word */
483	uint32_t		br_zero_hi;
484	uint32_t		br_rxhipri_lo;		/* rx high pri ring */
485	uint32_t		br_rxhipri_hi;
486	uint32_t		br_rxhipri_siz;
487};
488
489/*
490 * hostvar structure (shared with typhoon)
491 */
492struct txp_hostvar {
493	uint32_t		hv_rx_hi_read_idx;	/* host->arm */
494	uint32_t		hv_rx_lo_read_idx;	/* host->arm */
495	uint32_t		hv_rx_buf_write_idx;	/* host->arm */
496	uint32_t		hv_resp_read_idx;	/* host->arm */
497	uint32_t		hv_tx_lo_desc_read_idx;	/* arm->host */
498	uint32_t		hv_tx_hi_desc_read_idx;	/* arm->host */
499	uint32_t		hv_rx_lo_write_idx;	/* arm->host */
500	uint32_t		hv_rx_buf_read_idx;	/* arm->host */
501	uint32_t		hv_cmd_read_idx;	/* arm->host */
502	uint32_t		hv_resp_write_idx;	/* arm->host */
503	uint32_t		hv_rx_hi_write_idx;	/* arm->host */
504};
505
506/*
507 * TYPHOON status register state (in TXP_A2H_0)
508 */
509#define	STAT_ROM_CODE			0x00000001
510#define	STAT_ROM_EEPROM_LOAD		0x00000002
511#define	STAT_WAITING_FOR_BOOT		0x00000007
512#define	STAT_RUNNING			0x00000009
513#define	STAT_WAITING_FOR_HOST_REQUEST	0x0000000d
514#define	STAT_WAITING_FOR_SEGMENT	0x00000010
515#define	STAT_SLEEPING			0x00000011
516#define	STAT_HALTED			0x00000014
517
518#define	TX_ENTRIES			256
519#define	RX_ENTRIES			128
520#define	RXBUF_ENTRIES			256
521#define	CMD_ENTRIES			32
522#define	RSP_ENTRIES			32
523
524#define	OFFLOAD_TCPCKSUM		0x00000002	/* tcp checksum */
525#define	OFFLOAD_UDPCKSUM		0x00000004	/* udp checksum */
526#define	OFFLOAD_IPCKSUM			0x00000008	/* ip checksum */
527#define	OFFLOAD_IPSEC			0x00000010	/* ipsec enable */
528#define	OFFLOAD_BCAST			0x00000020	/* broadcast throttle */
529#define	OFFLOAD_DHCP			0x00000040	/* dhcp prevention */
530#define	OFFLOAD_VLAN			0x00000080	/* vlan enable */
531#define	OFFLOAD_FILTER			0x00000100	/* filter enable */
532#define	OFFLOAD_TCPSEG			0x00000200	/* tcp segmentation */
533#define	OFFLOAD_MASK			0xfffffffe	/* mask off low bit */
534
535/*
536 * Macros for converting array indices to offsets within the descriptor
537 * arrays.  The chip operates on offsets, but it's much easier for us
538 * to operate on indices.  Assumes descriptor entries are 16 bytes.
539 */
540#define	TXP_IDX2OFFSET(idx)	((idx) << 4)
541#define	TXP_OFFSET2IDX(off)	((off) >> 4)
542
543struct txp_cmd_ring {
544	struct txp_cmd_desc	*base;
545	uint32_t		lastwrite;
546	uint32_t		size;
547};
548
549struct txp_rsp_ring {
550	struct txp_rsp_desc	*base;
551	uint32_t		lastwrite;
552	uint32_t		size;
553};
554
555struct txp_tx_ring {
556	struct txp_tx_desc	*r_desc;	/* base address of descs */
557	bus_dma_tag_t		r_tag;
558	bus_dmamap_t		r_map;
559	uint32_t		r_reg;		/* register to activate */
560	uint32_t		r_prod;		/* producer */
561	uint32_t		r_cons;		/* consumer */
562	uint32_t		r_cnt;		/* # descs in use */
563	uint32_t		*r_off;		/* hostvar index pointer */
564};
565
566struct txp_swdesc {
567	struct mbuf 		*sd_mbuf;
568	bus_dmamap_t		sd_map;
569};
570
571struct txp_rx_swdesc {
572	TAILQ_ENTRY(txp_rx_swdesc)	sd_next;
573	struct mbuf 		*sd_mbuf;
574	bus_dmamap_t		sd_map;
575};
576
577struct txp_rx_ring {
578	struct txp_rx_desc	*r_desc;	/* base address of descs */
579	bus_dma_tag_t		r_tag;
580	bus_dmamap_t		r_map;
581	uint32_t		*r_roff;	/* hv read offset ptr */
582	uint32_t		*r_woff;	/* hv write offset ptr */
583};
584
585struct txp_ldata {
586	struct txp_boot_record	*txp_boot;
587	bus_addr_t		txp_boot_paddr;
588	struct txp_hostvar	*txp_hostvar;
589	bus_addr_t		txp_hostvar_paddr;
590	struct txp_tx_desc	*txp_txhiring;
591	bus_addr_t		txp_txhiring_paddr;
592	struct txp_tx_desc	*txp_txloring;
593	bus_addr_t		txp_txloring_paddr;
594	struct txp_rxbuf_desc	*txp_rxbufs;
595	bus_addr_t		txp_rxbufs_paddr;
596	struct txp_rx_desc	*txp_rxhiring;
597	bus_addr_t		txp_rxhiring_paddr;
598	struct txp_rx_desc	*txp_rxloring;
599	bus_addr_t		txp_rxloring_paddr;
600	struct txp_cmd_desc	*txp_cmdring;
601	bus_addr_t		txp_cmdring_paddr;
602	struct txp_rsp_desc	*txp_rspring;
603	bus_addr_t		txp_rspring_paddr;
604	uint32_t		*txp_zero;
605	bus_addr_t		txp_zero_paddr;
606};
607
608struct txp_chain_data {
609	bus_dma_tag_t		txp_parent_tag;
610	bus_dma_tag_t		txp_boot_tag;
611	bus_dmamap_t		txp_boot_map;
612	bus_dma_tag_t		txp_hostvar_tag;
613	bus_dmamap_t		txp_hostvar_map;
614	bus_dma_tag_t		txp_txhiring_tag;
615	bus_dmamap_t		txp_txhiring_map;
616	bus_dma_tag_t		txp_txloring_tag;
617	bus_dmamap_t		txp_txloring_map;
618	bus_dma_tag_t		txp_tx_tag;
619	bus_dma_tag_t		txp_rx_tag;
620	bus_dma_tag_t		txp_rxbufs_tag;
621	bus_dmamap_t		txp_rxbufs_map;
622	bus_dma_tag_t		txp_rxhiring_tag;
623	bus_dmamap_t		txp_rxhiring_map;
624	bus_dma_tag_t		txp_rxloring_tag;
625	bus_dmamap_t		txp_rxloring_map;
626	bus_dma_tag_t		txp_cmdring_tag;
627	bus_dmamap_t		txp_cmdring_map;
628	bus_dma_tag_t		txp_rspring_tag;
629	bus_dmamap_t		txp_rspring_map;
630	bus_dma_tag_t		txp_zero_tag;
631	bus_dmamap_t		txp_zero_map;
632};
633
634struct txp_hw_stats {
635	uint32_t		tx_frames;
636	uint64_t		tx_bytes;
637	uint32_t		tx_deferred;
638	uint32_t		tx_late_colls;
639	uint32_t		tx_colls;
640	uint32_t		tx_carrier_lost;
641	uint32_t		tx_multi_colls;
642	uint32_t		tx_excess_colls;
643	uint32_t		tx_fifo_underruns;
644	uint32_t		tx_mcast_oflows;
645	uint32_t		tx_filtered;
646	uint32_t		rx_frames;
647	uint64_t		rx_bytes;
648	uint32_t		rx_fifo_oflows;
649	uint32_t		rx_badssd;
650	uint32_t		rx_crcerrs;
651	uint32_t		rx_lenerrs;
652	uint32_t		rx_bcast_frames;
653	uint32_t		rx_mcast_frames;
654	uint32_t		rx_oflows;
655	uint32_t		rx_filtered;
656};
657
658struct txp_softc {
659	struct ifnet		*sc_ifp;
660	device_t		sc_dev;
661	struct txp_hostvar	*sc_hostvar;
662	struct txp_boot_record	*sc_boot;
663	struct resource		*sc_res;
664	int			sc_res_id;
665	int			sc_res_type;
666	struct resource		*sc_irq;
667	void			*sc_intrhand;
668	struct txp_chain_data	sc_cdata;
669	struct txp_ldata	sc_ldata;
670	int			sc_rxbufprod;
671	int			sc_process_limit;
672	struct txp_cmd_ring	sc_cmdring;
673	struct txp_rsp_ring	sc_rspring;
674	struct callout		sc_tick;
675	struct ifmedia		sc_ifmedia;
676	struct txp_hw_stats	sc_ostats;
677	struct txp_hw_stats	sc_stats;
678	struct txp_tx_ring	sc_txhir, sc_txlor;
679	struct txp_swdesc	sc_txd[TX_ENTRIES];
680	struct txp_rxbuf_desc	*sc_rxbufs;
681	struct txp_rx_ring	sc_rxhir, sc_rxlor;
682	uint16_t		sc_xcvr;
683	uint16_t		sc_seq;
684	int			sc_watchdog_timer;
685	int			sc_if_flags;
686	int			sc_flags;
687#define	TXP_FLAG_DETACH		0x4000
688#define	TXP_FLAG_LINK		0x8000
689	TAILQ_HEAD(, txp_rx_swdesc)	sc_free_list;
690	TAILQ_HEAD(, txp_rx_swdesc)	sc_busy_list;
691	struct task		sc_int_task;
692	struct taskqueue	*sc_tq;
693	struct mtx		sc_mtx;
694};
695
696struct txp_fw_file_header {
697	uint8_t		magicid[8];	/* TYPHOON\0 */
698	uint32_t	version;
699	uint32_t	nsections;
700	uint32_t	addr;
701	uint32_t	hmac[5];
702};
703
704struct txp_fw_section_header {
705	uint32_t	nbytes;
706	uint16_t	cksum;
707	uint16_t	reserved;
708	uint32_t	addr;
709};
710
711#define	TXP_MAX_SEGLEN	0xffff
712#define	TXP_MAX_PKTLEN	(ETHER_MAX_LEN + ETHER_VLAN_ENCAP_LEN)
713
714#define	WRITE_REG(sc, reg, val)		bus_write_4((sc)->sc_res, reg, val)
715#define	READ_REG(sc, reg)		bus_read_4((sc)->sc_res, reg)
716#define	TXP_BARRIER(sc, o, l, f)	bus_barrier((sc)->sc_res, (o), (l), (f))
717
718#define	TXP_LOCK(sc)		mtx_lock(&(sc)->sc_mtx)
719#define	TXP_UNLOCK(sc)		mtx_unlock(&(sc)->sc_mtx)
720#define	TXP_LOCK_ASSERT(sc)	mtx_assert(&(sc)->sc_mtx, MA_OWNED)
721
722#define	TXP_MAXTXSEGS		16
723#define	TXP_RXBUF_ALIGN		(sizeof(uint32_t))
724
725#define	TXP_PROC_MIN		16
726#define	TXP_PROC_MAX		RX_ENTRIES
727#define	TXP_PROC_DEFAULT	(RX_ENTRIES / 2)
728
729#define	TXP_ADDR_HI(x)		((uint64_t)(x) >> 32)
730#define	TXP_ADDR_LO(x)		((uint64_t)(x) & 0xffffffff)
731
732/*
733 * 3Com PCI vendor ID.
734 */
735#define	TXP_VENDORID_3COM		0x10B7
736
737/*
738 * 3cR990 device IDs
739 */
740#define TXP_DEVICEID_3CR990_TX_95	0x9902
741#define TXP_DEVICEID_3CR990_TX_97	0x9903
742#define TXP_DEVICEID_3CR990B_TXM	0x9904
743#define TXP_DEVICEID_3CR990_SRV_95	0x9908
744#define TXP_DEVICEID_3CR990_SRV_97	0x9909
745#define TXP_DEVICEID_3CR990B_SRV	0x990A
746
747struct txp_type {
748	uint16_t		txp_vid;
749	uint16_t		txp_did;
750	char			*txp_name;
751};
752
753#define	TXP_TIMEOUT	10000
754#define	TXP_CMD_NOWAIT	0
755#define	TXP_CMD_WAIT	1
756#define	TXP_TX_TIMEOUT	5
757
758/*
759 * Each frame requires one frame descriptor and one or more
760 * fragment descriptors. If TSO is used frame descriptor block
761 * requires one or two option frame descriptors depending on
762 * number of framents. Therefore we will consume three
763 * additional descriptors at most to use TSO for a frame and
764 * one reserved descriptor in order not to full Tx descriptor
765 * ring.
766 */
767#define	TXP_TXD_RESERVED	4
768
769#define	TXP_DESC_INC(x, y)	((x) = ((x) + 1) % (y))
770