xref: /freebsd/sys/dev/iwi/if_iwivar.h (revision 7447ca0eb235974642312b9555caec00b57d8fc1)
1 /*	$FreeBSD$	*/
2 
3 /*-
4  * Copyright (c) 2004, 2005
5  *      Damien Bergamini <damien.bergamini@free.fr>. 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 unmodified, this list of conditions, and the following
12  *    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  *
17  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
18  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
21  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27  * SUCH DAMAGE.
28  */
29 
30 struct iwi_rx_radiotap_header {
31 	struct ieee80211_radiotap_header wr_ihdr;
32 	uint8_t		wr_flags;
33 	uint8_t		wr_rate;
34 	uint16_t	wr_chan_freq;
35 	uint16_t	wr_chan_flags;
36 	int8_t		wr_antsignal;
37 	int8_t		wr_antnoise;
38 	uint8_t		wr_antenna;
39 };
40 
41 #define IWI_RX_RADIOTAP_PRESENT						\
42 	((1 << IEEE80211_RADIOTAP_FLAGS) |				\
43 	 (1 << IEEE80211_RADIOTAP_RATE) |				\
44 	 (1 << IEEE80211_RADIOTAP_CHANNEL) |				\
45 	 (1 << IEEE80211_RADIOTAP_DBM_ANTSIGNAL) |			\
46 	 (1 << IEEE80211_RADIOTAP_DBM_ANTNOISE) |			\
47 	 (1 << IEEE80211_RADIOTAP_ANTENNA))
48 
49 struct iwi_tx_radiotap_header {
50 	struct ieee80211_radiotap_header wt_ihdr;
51 	uint8_t		wt_flags;
52 	uint16_t	wt_chan_freq;
53 	uint16_t	wt_chan_flags;
54 };
55 
56 #define IWI_TX_RADIOTAP_PRESENT						\
57 	((1 << IEEE80211_RADIOTAP_FLAGS) |				\
58 	 (1 << IEEE80211_RADIOTAP_CHANNEL))
59 
60 struct iwi_cmd_ring {
61 	bus_dma_tag_t		desc_dmat;
62 	bus_dmamap_t		desc_map;
63 	bus_addr_t		physaddr;
64 	struct iwi_cmd_desc	*desc;
65 	int			count;
66 	int			queued;
67 	int			cur;
68 	int			next;
69 };
70 
71 struct iwi_tx_data {
72 	bus_dmamap_t		map;
73 	struct mbuf		*m;
74 	struct ieee80211_node	*ni;
75 };
76 
77 struct iwi_tx_ring {
78 	bus_dma_tag_t		desc_dmat;
79 	bus_dma_tag_t		data_dmat;
80 	bus_dmamap_t		desc_map;
81 	bus_addr_t		physaddr;
82 	bus_addr_t		csr_ridx;
83 	bus_addr_t		csr_widx;
84 	struct iwi_tx_desc	*desc;
85 	struct iwi_tx_data	*data;
86 	int			count;
87 	int			queued;
88 	int			cur;
89 	int			next;
90 };
91 
92 struct iwi_rx_data {
93 	bus_dmamap_t	map;
94 	bus_addr_t	physaddr;
95 	uint32_t	reg;
96 	struct mbuf	*m;
97 };
98 
99 struct iwi_rx_ring {
100 	bus_dma_tag_t		data_dmat;
101 	struct iwi_rx_data	*data;
102 	int			count;
103 	int			cur;
104 };
105 
106 struct iwi_node {
107 	struct ieee80211_node	in_node;
108 	int			in_station;
109 #define IWI_MAX_IBSSNODE	32
110 };
111 
112 struct iwi_fw {
113 	const struct firmware	*fp;		/* image handle */
114 	const char		*data;		/* firmware image data */
115 	size_t			size;		/* firmware image size */
116 	const char		*name;		/* associated image name */
117 };
118 
119 struct iwi_vap {
120 	struct ieee80211vap	iwi_vap;
121 
122 	int			(*iwi_newstate)(struct ieee80211vap *,
123 				    enum ieee80211_state, int);
124 };
125 #define	IWI_VAP(vap)	((struct iwi_vap *)(vap))
126 
127 struct iwi_softc {
128 	struct mtx		sc_mtx;
129 	struct ieee80211com	sc_ic;
130 	struct mbufq		sc_snd;
131 	device_t		sc_dev;
132 
133 	void			(*sc_node_free)(struct ieee80211_node *);
134 
135 	uint8_t			sc_mcast[IEEE80211_ADDR_LEN];
136 	struct unrhdr		*sc_unr;
137 
138 	uint32_t		flags;
139 #define IWI_FLAG_FW_INITED	(1 << 0)
140 #define	IWI_FLAG_BUSY		(1 << 3)	/* busy sending a command */
141 #define	IWI_FLAG_ASSOCIATED	(1 << 4)	/* currently associated  */
142 #define IWI_FLAG_CHANNEL_SCAN	(1 << 5)
143 	uint32_t		fw_state;
144 #define IWI_FW_IDLE		0
145 #define IWI_FW_LOADING		1
146 #define IWI_FW_ASSOCIATING	2
147 #define IWI_FW_DISASSOCIATING	3
148 #define IWI_FW_SCANNING		4
149 	struct iwi_cmd_ring	cmdq;
150 	struct iwi_tx_ring	txq[WME_NUM_AC];
151 	struct iwi_rx_ring	rxq;
152 
153 	struct resource		*irq;
154 	struct resource		*mem;
155 	bus_space_tag_t		sc_st;
156 	bus_space_handle_t	sc_sh;
157 	void 			*sc_ih;
158 
159 	/*
160 	 * The card needs external firmware images to work, which is made of a
161 	 * bootloader, microcode and firmware proper. In version 3.00 and
162 	 * above, all pieces are contained in a single image, preceded by a
163 	 * struct iwi_firmware_hdr indicating the size of the 3 pieces.
164 	 * Old firmware < 3.0 has separate boot and ucode, so we need to
165 	 * load all of them explicitly.
166 	 * To avoid issues related to fragmentation, we keep the block of
167 	 * dma-ble memory around until detach time, and reallocate it when
168 	 * it becomes too small. fw_dma_size is the size currently allocated.
169 	 */
170 	int			fw_dma_size;
171 	uint32_t		fw_flags;	/* allocation status */
172 #define	IWI_FW_HAVE_DMAT	0x01
173 #define	IWI_FW_HAVE_MAP		0x02
174 #define	IWI_FW_HAVE_PHY		0x04
175 	bus_dma_tag_t		fw_dmat;
176 	bus_dmamap_t		fw_map;
177 	bus_addr_t		fw_physaddr;
178 	void			*fw_virtaddr;
179 	enum ieee80211_opmode	fw_mode;	/* mode of current firmware */
180 	struct iwi_fw		fw_boot;	/* boot firmware */
181 	struct iwi_fw		fw_uc;		/* microcode */
182 	struct iwi_fw		fw_fw;		/* operating mode support */
183 
184 	int			curchan;	/* current h/w channel # */
185 	int			antenna;
186 	int			bluetooth;
187 	struct iwi_associate	assoc;
188 	struct iwi_wme_params	wme[3];
189 	u_int			sc_scangen;
190 
191 	struct task		sc_radiontask;	/* radio on processing */
192 	struct task		sc_radiofftask;	/* radio off processing */
193 	struct task		sc_restarttask;	/* restart adapter processing */
194 	struct task		sc_disassoctask;
195 	struct task		sc_monitortask;
196 
197 	unsigned int		sc_running : 1,	/* initialized */
198 				sc_softled : 1,	/* enable LED gpio status */
199 				sc_ledstate: 1,	/* LED on/off state */
200 				sc_blinking: 1;	/* LED blink operation active */
201 	u_int			sc_nictype;	/* NIC type from EEPROM */
202 	u_int			sc_ledpin;	/* mask for activity LED */
203 	u_int			sc_ledidle;	/* idle polling interval */
204 	int			sc_ledevent;	/* time of last LED event */
205 	u_int8_t		sc_rxrate;	/* current rx rate for LED */
206 	u_int8_t		sc_rxrix;
207 	u_int8_t		sc_txrate;	/* current tx rate for LED */
208 	u_int8_t		sc_txrix;
209 	u_int16_t		sc_ledoff;	/* off time for current blink */
210 	struct callout		sc_ledtimer;	/* led off timer */
211 	struct callout		sc_wdtimer;	/* watchdog timer */
212 	struct callout		sc_rftimer;	/* rfkill timer */
213 
214 	int			sc_tx_timer;
215 	int			sc_state_timer;	/* firmware state timer */
216 	int			sc_busy_timer;	/* firmware cmd timer */
217 
218 	struct iwi_rx_radiotap_header sc_rxtap;
219 	struct iwi_tx_radiotap_header sc_txtap;
220 
221 	struct iwi_notif_link_quality sc_linkqual;
222 	int			sc_linkqual_valid;
223 };
224 
225 #define	IWI_STATE_BEGIN(_sc, _state)	do {			\
226 	KASSERT(_sc->fw_state == IWI_FW_IDLE,			\
227 	    ("iwi firmware not idle, state %s", iwi_fw_states[_sc->fw_state]));\
228 	_sc->fw_state = _state;					\
229 	_sc->sc_state_timer = 5;				\
230 	DPRINTF(("enter %s state\n", iwi_fw_states[_state]));	\
231 } while (0)
232 
233 #define	IWI_STATE_END(_sc, _state)	do {			\
234 	if (_sc->fw_state == _state)				\
235 		DPRINTF(("exit %s state\n", iwi_fw_states[_state])); \
236 	 else							\
237 		DPRINTF(("expected %s state, got %s\n",	\
238 		    iwi_fw_states[_state], iwi_fw_states[_sc->fw_state])); \
239 	_sc->fw_state = IWI_FW_IDLE;				\
240 	wakeup(_sc);						\
241 	_sc->sc_state_timer = 0;				\
242 } while (0)
243 /*
244  * NB.: This models the only instance of async locking in iwi_init_locked
245  *	and must be kept in sync.
246  */
247 #define	IWI_LOCK_INIT(sc) \
248 	mtx_init(&(sc)->sc_mtx, device_get_nameunit((sc)->sc_dev), \
249 	    MTX_NETWORK_LOCK, MTX_DEF)
250 #define	IWI_LOCK_DESTROY(sc)	mtx_destroy(&(sc)->sc_mtx)
251 #define	IWI_LOCK_DECL	int	__waslocked = 0
252 #define IWI_LOCK_ASSERT(sc)	mtx_assert(&(sc)->sc_mtx, MA_OWNED)
253 #define IWI_LOCK(sc)	do {				\
254 	if (!(__waslocked = mtx_owned(&(sc)->sc_mtx)))	\
255 		mtx_lock(&(sc)->sc_mtx);		\
256 } while (0)
257 #define IWI_UNLOCK(sc)	do {			\
258 	if (!__waslocked)			\
259 		mtx_unlock(&(sc)->sc_mtx);	\
260 } while (0)
261