xref: /freebsd/sys/dev/ipw/if_ipwvar.h (revision f0cfa1b168014f56c02b83e5f28412cc5f78d117)
1 /*      $FreeBSD$	*/
2 
3 /*-
4  * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
5  *
6  * Copyright (c) 2004-2006
7  *      Damien Bergamini <damien.bergamini@free.fr>. All rights reserved.
8  *
9  * Redistribution and use in source and binary forms, with or without
10  * modification, are permitted provided that the following conditions
11  * are met:
12  * 1. Redistributions of source code must retain the above copyright
13  *    notice unmodified, this list of conditions, and the following
14  *    disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in the
17  *    documentation and/or other materials provided with the distribution.
18  *
19  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
20  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
23  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29  * SUCH DAMAGE.
30  */
31 
32 #define IPW_MAX_NSEG	1
33 
34 struct ipw_soft_bd {
35 	struct ipw_bd	*bd;
36 	int		type;
37 #define IPW_SBD_TYPE_NOASSOC	0
38 #define IPW_SBD_TYPE_COMMAND	1
39 #define IPW_SBD_TYPE_HEADER	2
40 #define IPW_SBD_TYPE_DATA	3
41 	void		*priv;
42 };
43 
44 struct ipw_soft_hdr {
45 	struct ipw_hdr			hdr;
46 	bus_dmamap_t			map;
47 	SLIST_ENTRY(ipw_soft_hdr)	next;
48 };
49 
50 struct ipw_soft_buf {
51 	struct mbuf			*m;
52 	struct ieee80211_node		*ni;
53 	bus_dmamap_t			map;
54 	SLIST_ENTRY(ipw_soft_buf)	next;
55 };
56 
57 struct ipw_rx_radiotap_header {
58 	struct ieee80211_radiotap_header wr_ihdr;
59 	uint8_t		wr_flags;
60 	uint16_t	wr_chan_freq;
61 	uint16_t	wr_chan_flags;
62 	int8_t		wr_antsignal;
63 	int8_t		wr_antnoise;
64 };
65 
66 #define IPW_RX_RADIOTAP_PRESENT						\
67 	((1 << IEEE80211_RADIOTAP_FLAGS) |				\
68 	 (1 << IEEE80211_RADIOTAP_CHANNEL) |				\
69 	 (1 << IEEE80211_RADIOTAP_DB_ANTSIGNAL) |			\
70 	 (1 << IEEE80211_RADIOTAP_DB_ANTNOISE))
71 
72 struct ipw_tx_radiotap_header {
73 	struct ieee80211_radiotap_header wt_ihdr;
74 	uint8_t		wt_flags;
75 	uint16_t	wt_chan_freq;
76 	uint16_t	wt_chan_flags;
77 };
78 
79 #define IPW_TX_RADIOTAP_PRESENT						\
80 	((1 << IEEE80211_RADIOTAP_FLAGS) |				\
81 	 (1 << IEEE80211_RADIOTAP_CHANNEL))
82 
83 struct ipw_vap {
84 	struct ieee80211vap	vap;
85 
86 	int			(*newstate)(struct ieee80211vap *,
87 				    enum ieee80211_state, int);
88 };
89 #define	IPW_VAP(vap)	((struct ipw_vap *)(vap))
90 
91 struct ipw_softc {
92 	struct ieee80211com		sc_ic;
93 	struct mbufq			sc_snd;
94 	device_t			sc_dev;
95 
96 	struct mtx			sc_mtx;
97 	struct task			sc_init_task;
98 	struct callout			sc_wdtimer;	/* watchdog timer */
99 
100 	uint32_t			flags;
101 #define IPW_FLAG_FW_INITED		0x0001
102 #define IPW_FLAG_INIT_LOCKED		0x0002
103 #define IPW_FLAG_HAS_RADIO_SWITCH	0x0004
104 #define	IPW_FLAG_HACK			0x0008
105 #define	IPW_FLAG_SCANNING		0x0010
106 #define	IPW_FLAG_ENABLED		0x0020
107 #define	IPW_FLAG_BUSY			0x0040
108 #define	IPW_FLAG_ASSOCIATING		0x0080
109 #define	IPW_FLAG_ASSOCIATED		0x0100
110 #define	IPW_FLAG_RUNNING		0x0200
111 
112 	struct resource			*irq;
113 	struct resource			*mem;
114 	bus_space_tag_t			sc_st;
115 	bus_space_handle_t		sc_sh;
116 	void 				*sc_ih;
117 	const struct firmware		*sc_firmware;
118 
119 	int				sc_tx_timer;
120 	int				sc_scan_timer;
121 
122 	bus_dma_tag_t			parent_dmat;
123 	bus_dma_tag_t			tbd_dmat;
124 	bus_dma_tag_t			rbd_dmat;
125 	bus_dma_tag_t			status_dmat;
126 	bus_dma_tag_t			cmd_dmat;
127 	bus_dma_tag_t			hdr_dmat;
128 	bus_dma_tag_t			txbuf_dmat;
129 	bus_dma_tag_t			rxbuf_dmat;
130 
131 	bus_dmamap_t			tbd_map;
132 	bus_dmamap_t			rbd_map;
133 	bus_dmamap_t			status_map;
134 	bus_dmamap_t			cmd_map;
135 
136 	bus_addr_t			tbd_phys;
137 	bus_addr_t			rbd_phys;
138 	bus_addr_t			status_phys;
139 
140 	struct ipw_bd			*tbd_list;
141 	struct ipw_bd			*rbd_list;
142 	struct ipw_status		*status_list;
143 
144 	struct ipw_cmd			cmd;
145 	struct ipw_soft_bd		stbd_list[IPW_NTBD];
146 	struct ipw_soft_buf		tx_sbuf_list[IPW_NDATA];
147 	struct ipw_soft_hdr		shdr_list[IPW_NDATA];
148 	struct ipw_soft_bd		srbd_list[IPW_NRBD];
149 	struct ipw_soft_buf		rx_sbuf_list[IPW_NRBD];
150 
151 	SLIST_HEAD(, ipw_soft_hdr)	free_shdr;
152 	SLIST_HEAD(, ipw_soft_buf)	free_sbuf;
153 
154 	uint32_t			table1_base;
155 	uint32_t			table2_base;
156 
157 	uint32_t			txcur;
158 	uint32_t			txold;
159 	uint32_t			rxcur;
160 	int				txfree;
161 
162 	uint16_t			chanmask;
163 
164 	struct ipw_rx_radiotap_header	sc_rxtap;
165 	struct ipw_tx_radiotap_header	sc_txtap;
166 };
167 
168 /*
169  * NB.: This models the only instance of async locking in ipw_init_locked
170  *	and must be kept in sync.
171  */
172 #define IPW_LOCK(sc)		mtx_lock(&sc->sc_mtx);
173 #define IPW_UNLOCK(sc)		mtx_unlock(&sc->sc_mtx);
174 #define IPW_LOCK_ASSERT(sc)	mtx_assert(&(sc)->sc_mtx, MA_OWNED)
175