1 /* $FreeBSD$ */ 2 3 /*- 4 * Copyright (c) 2006,2007 5 * Damien Bergamini <damien.bergamini@free.fr> 6 * 7 * Permission to use, copy, modify, and distribute this software for any 8 * purpose with or without fee is hereby granted, provided that the above 9 * copyright notice and this permission notice appear in all copies. 10 * 11 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 12 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 13 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 14 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 15 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 16 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 17 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 18 */ 19 struct wpi_rx_radiotap_header { 20 struct ieee80211_radiotap_header wr_ihdr; 21 uint64_t wr_tsft; 22 uint8_t wr_flags; 23 uint8_t wr_rate; 24 uint16_t wr_chan_freq; 25 uint16_t wr_chan_flags; 26 int8_t wr_dbm_antsignal; 27 int8_t wr_dbm_antnoise; 28 uint8_t wr_antenna; 29 } __packed; 30 31 #define WPI_RX_RADIOTAP_PRESENT \ 32 ((1 << IEEE80211_RADIOTAP_TSFT) | \ 33 (1 << IEEE80211_RADIOTAP_FLAGS) | \ 34 (1 << IEEE80211_RADIOTAP_RATE) | \ 35 (1 << IEEE80211_RADIOTAP_CHANNEL) | \ 36 (1 << IEEE80211_RADIOTAP_DBM_ANTSIGNAL) | \ 37 (1 << IEEE80211_RADIOTAP_DBM_ANTNOISE) | \ 38 (1 << IEEE80211_RADIOTAP_ANTENNA)) 39 40 struct wpi_tx_radiotap_header { 41 struct ieee80211_radiotap_header wt_ihdr; 42 uint8_t wt_flags; 43 uint8_t wt_rate; 44 uint16_t wt_chan_freq; 45 uint16_t wt_chan_flags; 46 } __packed; 47 48 #define WPI_TX_RADIOTAP_PRESENT \ 49 ((1 << IEEE80211_RADIOTAP_FLAGS) | \ 50 (1 << IEEE80211_RADIOTAP_RATE) | \ 51 (1 << IEEE80211_RADIOTAP_CHANNEL)) 52 53 struct wpi_dma_info { 54 bus_dma_tag_t tag; 55 bus_dmamap_t map; 56 bus_addr_t paddr; 57 caddr_t vaddr; 58 bus_size_t size; 59 }; 60 61 struct wpi_tx_data { 62 bus_dmamap_t map; 63 bus_addr_t cmd_paddr; 64 struct mbuf *m; 65 struct ieee80211_node *ni; 66 }; 67 68 struct wpi_tx_ring { 69 struct wpi_dma_info desc_dma; 70 struct wpi_dma_info cmd_dma; 71 struct wpi_tx_desc *desc; 72 struct wpi_tx_cmd *cmd; 73 struct wpi_tx_data data[WPI_TX_RING_COUNT]; 74 bus_dma_tag_t data_dmat; 75 int qid; 76 int queued; 77 int cur; 78 int update; 79 }; 80 81 struct wpi_rx_data { 82 struct mbuf *m; 83 bus_dmamap_t map; 84 }; 85 86 struct wpi_rx_ring { 87 struct wpi_dma_info desc_dma; 88 uint32_t *desc; 89 struct wpi_rx_data data[WPI_RX_RING_COUNT]; 90 bus_dma_tag_t data_dmat; 91 int cur; 92 int update; 93 }; 94 95 struct wpi_node { 96 struct ieee80211_node ni; /* must be the first */ 97 uint8_t id; 98 }; 99 #define WPI_NODE(ni) ((struct wpi_node *)(ni)) 100 101 struct wpi_power_sample { 102 uint8_t index; 103 int8_t power; 104 }; 105 106 struct wpi_power_group { 107 #define WPI_SAMPLES_COUNT 5 108 struct wpi_power_sample samples[WPI_SAMPLES_COUNT]; 109 uint8_t chan; 110 int8_t maxpwr; 111 int16_t temp; 112 }; 113 114 struct wpi_buf { 115 uint8_t data[56]; /* sizeof(struct wpi_cmd_beacon) */ 116 struct ieee80211_node *ni; 117 struct mbuf *m; 118 size_t size; 119 int code; 120 int ac; 121 }; 122 123 struct wpi_vap { 124 struct ieee80211vap wv_vap; 125 126 struct wpi_buf wv_bcbuf; 127 struct ieee80211_beacon_offsets wv_boff; 128 struct mtx wv_mtx; 129 130 uint32_t wv_gtk; 131 #define WPI_VAP_KEY(kid) (1 << kid) 132 133 int (*wv_newstate)(struct ieee80211vap *, 134 enum ieee80211_state, int); 135 void (*wv_recv_mgmt)(struct ieee80211_node *, 136 struct mbuf *, int, int, int); 137 }; 138 #define WPI_VAP(vap) ((struct wpi_vap *)(vap)) 139 140 #define WPI_VAP_LOCK_INIT(_wvp) \ 141 mtx_init(&(_wvp)->wv_mtx, "lock for wv_bcbuf/wv_boff structures", \ 142 NULL, MTX_DEF) 143 #define WPI_VAP_LOCK(_wvp) mtx_lock(&(_wvp)->wv_mtx) 144 #define WPI_VAP_UNLOCK(_wvp) mtx_unlock(&(_wvp)->wv_mtx) 145 #define WPI_VAP_LOCK_ASSERT(_wvp) mtx_assert(&(_wvp)->wv_mtx, MA_OWNED) 146 #define WPI_VAP_LOCK_DESTROY(_wvp) mtx_destroy(&(_wvp)->wv_mtx) 147 148 struct wpi_fw_part { 149 const uint8_t *text; 150 uint32_t textsz; 151 const uint8_t *data; 152 uint32_t datasz; 153 }; 154 155 struct wpi_fw_info { 156 const uint8_t *data; 157 size_t size; 158 struct wpi_fw_part init; 159 struct wpi_fw_part main; 160 struct wpi_fw_part boot; 161 }; 162 163 struct wpi_softc { 164 device_t sc_dev; 165 166 struct ifnet *sc_ifp; 167 int sc_debug; 168 169 int sc_flags; 170 #define WPI_PS_PATH (1 << 0) 171 172 struct mtx sc_mtx; 173 struct mtx tx_mtx; 174 175 /* Shared area. */ 176 struct wpi_dma_info shared_dma; 177 struct wpi_shared *shared; 178 179 struct wpi_tx_ring txq[WPI_NTXQUEUES]; 180 struct mtx txq_mtx; 181 struct mtx txq_state_mtx; 182 uint32_t txq_active; 183 184 struct wpi_rx_ring rxq; 185 uint64_t rx_tstamp; 186 187 /* TX Thermal Callibration. */ 188 struct callout calib_to; 189 int calib_cnt; 190 191 struct callout scan_timeout; 192 struct callout tx_timeout; 193 194 /* Watch dog timer. */ 195 struct callout watchdog_rfkill; 196 197 /* Firmware image. */ 198 struct wpi_fw_info fw; 199 uint32_t errptr; 200 201 struct resource *irq; 202 struct resource *mem; 203 bus_space_tag_t sc_st; 204 bus_space_handle_t sc_sh; 205 void *sc_ih; 206 bus_size_t sc_sz; 207 int sc_cap_off; /* PCIe Capabilities. */ 208 209 struct wpi_rxon rxon; 210 struct mtx rxon_mtx; 211 212 int temp; 213 uint32_t qfullmsk; 214 215 uint32_t nodesmsk; 216 struct mtx nt_mtx; 217 218 void (*sc_node_free)(struct ieee80211_node *); 219 void (*sc_update_rx_ring)(struct wpi_softc *); 220 void (*sc_update_tx_ring)(struct wpi_softc *, 221 struct wpi_tx_ring *); 222 223 struct wpi_rx_radiotap_header sc_rxtap; 224 struct wpi_tx_radiotap_header sc_txtap; 225 226 /* Firmware image. */ 227 const struct firmware *fw_fp; 228 229 /* Firmware DMA transfer. */ 230 struct wpi_dma_info fw_dma; 231 232 /* Tasks used by the driver. */ 233 struct task sc_reinittask; 234 struct task sc_radiooff_task; 235 struct task sc_radioon_task; 236 struct task sc_start_task; 237 238 /* Taskqueue */ 239 struct taskqueue *sc_tq; 240 241 /* Eeprom info. */ 242 uint8_t cap; 243 uint16_t rev; 244 uint8_t type; 245 struct wpi_eeprom_chan 246 eeprom_channels[WPI_CHAN_BANDS_COUNT][WPI_MAX_CHAN_PER_BAND]; 247 struct wpi_power_group groups[WPI_POWER_GROUPS_COUNT]; 248 int8_t maxpwr[IEEE80211_CHAN_MAX]; 249 char domain[4]; /* Regulatory domain. */ 250 }; 251 252 /* 253 * Locking order: 254 * 1. WPI_LOCK; 255 * 2. WPI_RXON_LOCK; 256 * 3. WPI_TX_LOCK; 257 * 4. WPI_NT_LOCK / WPI_VAP_LOCK; 258 * 5. WPI_TXQ_LOCK; 259 * 6. WPI_TXQ_STATE_LOCK; 260 */ 261 262 #define WPI_LOCK_INIT(_sc) \ 263 mtx_init(&(_sc)->sc_mtx, device_get_nameunit((_sc)->sc_dev), \ 264 MTX_NETWORK_LOCK, MTX_DEF) 265 #define WPI_LOCK(_sc) mtx_lock(&(_sc)->sc_mtx) 266 #define WPI_UNLOCK(_sc) mtx_unlock(&(_sc)->sc_mtx) 267 #define WPI_LOCK_ASSERT(_sc) mtx_assert(&(_sc)->sc_mtx, MA_OWNED) 268 #define WPI_LOCK_DESTROY(_sc) mtx_destroy(&(_sc)->sc_mtx) 269 270 #define WPI_RXON_LOCK_INIT(_sc) \ 271 mtx_init(&(_sc)->rxon_mtx, "lock for wpi_rxon structure", NULL, MTX_DEF) 272 #define WPI_RXON_LOCK(_sc) mtx_lock(&(_sc)->rxon_mtx) 273 #define WPI_RXON_UNLOCK(_sc) mtx_unlock(&(_sc)->rxon_mtx) 274 #define WPI_RXON_LOCK_ASSERT(_sc) mtx_assert(&(_sc)->rxon_mtx, MA_OWNED) 275 #define WPI_RXON_LOCK_DESTROY(_sc) mtx_destroy(&(_sc)->rxon_mtx) 276 277 #define WPI_TX_LOCK_INIT(_sc) \ 278 mtx_init(&(_sc)->tx_mtx, "tx path lock", NULL, MTX_DEF) 279 #define WPI_TX_LOCK(_sc) mtx_lock(&(_sc)->tx_mtx) 280 #define WPI_TX_UNLOCK(_sc) mtx_unlock(&(_sc)->tx_mtx) 281 #define WPI_TX_LOCK_DESTROY(_sc) mtx_destroy(&(_sc)->tx_mtx) 282 283 #define WPI_NT_LOCK_INIT(_sc) \ 284 mtx_init(&(_sc)->nt_mtx, "node table lock", NULL, MTX_DEF) 285 #define WPI_NT_LOCK(_sc) mtx_lock(&(_sc)->nt_mtx) 286 #define WPI_NT_UNLOCK(_sc) mtx_unlock(&(_sc)->nt_mtx) 287 #define WPI_NT_LOCK_DESTROY(_sc) mtx_destroy(&(_sc)->nt_mtx) 288 289 #define WPI_TXQ_LOCK_INIT(_sc) \ 290 mtx_init(&(_sc)->txq_mtx, "txq/cmdq lock", NULL, MTX_DEF) 291 #define WPI_TXQ_LOCK(_sc) mtx_lock(&(_sc)->txq_mtx) 292 #define WPI_TXQ_UNLOCK(_sc) mtx_unlock(&(_sc)->txq_mtx) 293 #define WPI_TXQ_LOCK_DESTROY(_sc) mtx_destroy(&(_sc)->txq_mtx) 294 295 #define WPI_TXQ_STATE_LOCK_INIT(_sc) \ 296 mtx_init(&(_sc)->txq_state_mtx, "txq state lock", NULL, MTX_DEF) 297 #define WPI_TXQ_STATE_LOCK(_sc) mtx_lock(&(_sc)->txq_state_mtx) 298 #define WPI_TXQ_STATE_UNLOCK(_sc) mtx_unlock(&(_sc)->txq_state_mtx) 299 #define WPI_TXQ_STATE_LOCK_DESTROY(_sc) mtx_destroy(&(_sc)->txq_state_mtx) 300