xref: /freebsd/sys/dev/ae/if_aevar.h (revision a90b9d0159070121c221b966469c3e36d912bf82)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause
3  *
4  * Copyright (c) 2008 Stanislav Sedov <stas@FreeBSD.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  *
16  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
17  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
18  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
19  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
20  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
21  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
25  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26  */
27 
28 #ifndef IF_AEVAR_H
29 #define IF_AEVAR_H
30 
31 /*
32  * Supported chips identifiers.
33 */
34 #define	VENDORID_ATTANSIC	0x1969
35 #define	DEVICEID_ATTANSIC_L2	0x2048
36 
37 /* How much to wait for reset to complete (10 microsecond units). */
38 #define	AE_RESET_TIMEOUT	100
39 
40 /* How much to wait for device to enter idle state (100 microsecond units). */
41 #define	AE_IDLE_TIMEOUT		100
42 
43 /* How much to wait for MDIO to do the work (2 microsecond units). */
44 #define	AE_MDIO_TIMEOUT		10
45 
46 /* How much to wait for VPD reading operation to complete (2 ms units). */
47 #define AE_VPD_TIMEOUT		10
48 
49 /* How much to wait for send operation to complete (HZ units). */
50 #define	AE_TX_TIMEOUT		5
51 
52 /* Default PHY address. */
53 #define	AE_PHYADDR_DEFAULT	0
54 
55 /* Tx packet descriptor header format. */
56 typedef struct ae_txd {
57 	uint16_t	len;
58 	uint16_t	vlan;
59 } __packed ae_txd_t;
60 
61 /* Tx status descriptor format. */
62 typedef struct ae_txs {
63 	uint16_t	len;
64 	uint16_t	flags;
65 } __packed ae_txs_t;
66 
67 /* Rx packet descriptor format. */
68 typedef struct ae_rxd {
69 	uint16_t	len;
70 	uint16_t	flags;
71 	uint16_t	vlan;
72 	uint16_t	__pad;
73 	uint8_t		data[1528];
74 } __packed ae_rxd_t;
75 
76 /* Statistics. */
77 typedef struct ae_stats {
78 	uint32_t	rx_bcast;
79 	uint32_t	rx_mcast;
80 	uint32_t	rx_pause;
81 	uint32_t	rx_ctrl;
82 	uint32_t	rx_crcerr;
83 	uint32_t	rx_codeerr;
84 	uint32_t	rx_runt;
85 	uint32_t	rx_frag;
86 	uint32_t	rx_trunc;
87 	uint32_t	rx_align;
88 	uint32_t	tx_bcast;
89 	uint32_t	tx_mcast;
90 	uint32_t	tx_pause;
91 	uint32_t	tx_ctrl;
92 	uint32_t	tx_defer;
93 	uint32_t	tx_excdefer;
94 	uint32_t	tx_singlecol;
95 	uint32_t	tx_multicol;
96 	uint32_t	tx_latecol;
97 	uint32_t	tx_abortcol;
98 	uint32_t	tx_underrun;
99 } ae_stats_t;
100 
101 /* Software state structure. */
102 typedef struct ae_softc	{
103 	if_t			ifp;
104 	device_t		dev;
105 	device_t		miibus;
106 	struct resource		*mem[1];
107 	struct resource_spec	*spec_mem;
108 	struct resource		*irq[1];
109 	struct resource_spec	*spec_irq;
110 	void			*intrhand;
111 
112 	struct mtx		mtx;
113 
114 	uint8_t			eaddr[ETHER_ADDR_LEN];
115 	uint8_t			flags;
116 	int			if_flags;
117 
118 	struct callout		tick_ch;
119 
120 	/* Tasks. */
121 	struct task		int_task;
122 	struct task		link_task;
123 	struct taskqueue	*tq;
124 
125 	/* DMA tags. */
126 	bus_dma_tag_t		dma_parent_tag;
127 	bus_dma_tag_t		dma_rxd_tag;
128 	bus_dma_tag_t		dma_txd_tag;
129 	bus_dma_tag_t		dma_txs_tag;
130 	bus_dmamap_t		dma_rxd_map;
131 	bus_dmamap_t		dma_txd_map;
132 	bus_dmamap_t		dma_txs_map;
133 
134 	bus_addr_t		dma_rxd_busaddr;
135 	bus_addr_t		dma_txd_busaddr;
136 	bus_addr_t		dma_txs_busaddr;
137 
138 	char			*rxd_base_dma;	/* Start of allocated area. */
139 	ae_rxd_t		*rxd_base;	/* Start of RxD ring. */
140 	char			*txd_base;	/* Start of TxD ring. */
141 	ae_txs_t		*txs_base;	/* Start of TxS ring. */
142 
143 	/* Ring pointers. */
144 	unsigned int		rxd_cur;
145 	unsigned int		txd_cur;
146 	unsigned int		txs_cur;
147 	unsigned int		txs_ack;
148 	unsigned int		txd_ack;
149 
150 	int			tx_inproc;	/* Active Tx frames in ring. */
151 	int			wd_timer;
152 
153 	ae_stats_t		stats;
154 } ae_softc_t;
155 
156 #define	AE_LOCK(_sc)		mtx_lock(&(_sc)->mtx)
157 #define	AE_UNLOCK(_sc)		mtx_unlock(&(_sc)->mtx)
158 #define	AE_LOCK_ASSERT(_sc)	mtx_assert(&(_sc)->mtx, MA_OWNED)
159 
160 #define	BUS_ADDR_LO(x)		((uint64_t) (x) & 0xFFFFFFFF)
161 #define	BUS_ADDR_HI(x)		((uint64_t) (x) >> 32)
162 
163 #define	AE_FLAG_LINK		0x01	/* Has link. */
164 #define	AE_FLAG_DETACH		0x02	/* Is detaching. */
165 #define	AE_FLAG_TXAVAIL		0x04	/* Tx'es available. */
166 #define	AE_FLAG_MSI		0x08	/* Using MSI. */
167 #define	AE_FLAG_PMG		0x10	/* Supports PCI power management. */
168 
169 #endif	/* IF_AEVAR_H */
170