1 /******************************************************************************
3 * Copyright(c) 2003 - 2011 Intel Corporation. All rights reserved.
5 * This program is free software; you can redistribute it and/or modify it
6 * under the terms of version 2 of the GNU General Public License as
7 * published by the Free Software Foundation.
9 * This program is distributed in the hope that it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
14 * You should have received a copy of the GNU General Public License along with
15 * this program; if not, write to the Free Software Foundation, Inc.,
16 * 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA
18 * The full GNU General Public License is included in this distribution in the
19 * file called LICENSE.
21 * Contact Information:
22 * Intel Linux Wireless <ilw@linux.intel.com>
23 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
25 *****************************************************************************/
27 * Please use this file (iwl-dev.h) for driver implementation definitions.
28 * Please use iwl-commands.h for uCode API definitions.
34 #include <linux/interrupt.h>
35 #include <linux/pci.h> /* for struct pci_device_id */
36 #include <linux/kernel.h>
37 #include <linux/wait.h>
38 #include <linux/leds.h>
39 #include <net/ieee80211_radiotap.h>
41 #include "iwl-eeprom.h"
45 #include "iwl-debug.h"
46 #include "iwl-agn-hw.h"
48 #include "iwl-power.h"
49 #include "iwl-agn-rs.h"
50 #include "iwl-agn-tt.h"
52 #include "iwl-trans.h"
53 #include "iwl-shared.h"
55 #define DRV_NAME "iwlagn"
59 /* CT-KILL constants */
60 #define CT_KILL_THRESHOLD_LEGACY 110 /* in Celsius */
61 #define CT_KILL_THRESHOLD 114 /* in Celsius */
62 #define CT_KILL_EXIT_THRESHOLD 95 /* in Celsius */
64 /* Default noise level to report when noise measurement is not available.
65 * This may be because we're:
66 * 1) Not associated (4965, no beacon statistics being sent to driver)
67 * 2) Scanning (noise measurement does not apply to associated channel)
68 * 3) Receiving CCK (3945 delivers noise info only for OFDM frames)
69 * Use default noise value of -127 ... this is below the range of measurable
70 * Rx dBm for either 3945 or 4965, so it can indicate "unmeasurable" to user.
71 * Also, -127 works better than 0 when averaging frames with/without
72 * noise info (e.g. averaging might be done in app); measured dBm values are
73 * always negative ... using a negative value as the default keeps all
74 * averages within an s8's (used in some apps) range of negative values. */
75 #define IWL_NOISE_MEAS_NOT_AVAILABLE (-127)
78 * RTS threshold here is total size [2347] minus 4 FCS bytes
80 * a value of 0 means RTS on all data/management packets
81 * a value > max MSDU size means no RTS
82 * else RTS for data/management frames where MPDU is larger
85 #define DEFAULT_RTS_THRESHOLD 2347U
86 #define MIN_RTS_THRESHOLD 0U
87 #define MAX_RTS_THRESHOLD 2347U
88 #define MAX_MSDU_SIZE 2304U
89 #define MAX_MPDU_SIZE 2346U
90 #define DEFAULT_BEACON_INTERVAL 200U
91 #define DEFAULT_SHORT_RETRY_LIMIT 7U
92 #define DEFAULT_LONG_RETRY_LIMIT 4U
95 struct iwl_device_cmd
;
98 /* only for SYNC commands, iff the reply skb is wanted */
99 struct iwl_host_cmd
*source
;
101 * only for ASYNC commands
102 * (which is somewhat stupid -- look at iwl-sta.c for instance
103 * which duplicates a bunch of code because the callback isn't
104 * invoked for SYNC commands, if it were and its result passed
105 * through it would be simpler...)
107 void (*callback
)(struct iwl_priv
*priv
,
108 struct iwl_device_cmd
*cmd
,
109 struct iwl_rx_packet
*pkt
);
113 DEFINE_DMA_UNMAP_ADDR(mapping
);
114 DEFINE_DMA_UNMAP_LEN(len
);
118 * Generic queue structure
120 * Contains common data for Rx and Tx queues.
122 * Note the difference between n_bd and n_window: the hardware
123 * always assumes 256 descriptors, so n_bd is always 256 (unless
124 * there might be HW changes in the future). For the normal TX
125 * queues, n_window, which is the size of the software queue data
126 * is also 256; however, for the command queue, n_window is only
127 * 32 since we don't need so many commands pending. Since the HW
128 * still uses 256 BDs for DMA though, n_bd stays 256. As a result,
129 * the software buffers (in the variables @meta, @txb in struct
130 * iwl_tx_queue) only have 32 entries, while the HW buffers (@tfds
131 * in the same struct) have 256.
132 * This means that we end up with the following:
133 * HW entries: | 0 | ... | N * 32 | ... | N * 32 + 31 | ... | 255 |
134 * SW entries: | 0 | ... | 31 |
135 * where N is a number between 0 and 7. This means that the SW
136 * data is a window overlayed over the HW queue.
139 int n_bd
; /* number of BDs in this queue */
140 int write_ptr
; /* 1-st empty entry (index) host_w*/
141 int read_ptr
; /* last used entry (index) host_r*/
142 /* use for monitoring and recovering the stuck queue */
143 dma_addr_t dma_addr
; /* physical addr for BD's */
144 int n_window
; /* safe queue window */
146 int low_mark
; /* low watermark, resume queue if free
147 * space more than this */
148 int high_mark
; /* high watermark, stop queue if free
149 * space less than this */
152 /* One for each TFD */
155 struct iwl_rxon_context
*ctx
;
159 * struct iwl_tx_queue - Tx Queue for DMA
160 * @q: generic Rx/Tx queue descriptor
161 * @bd: base of circular buffer of TFDs
162 * @cmd: array of command/TX buffer pointers
163 * @meta: array of meta data for each command/tx buffer
164 * @dma_addr_cmd: physical address of cmd/tx buffer array
165 * @txb: array of per-TFD driver data
166 * @time_stamp: time (in jiffies) of last read_ptr change
167 * @need_update: indicates need to update read/write index
168 * @sched_retry: indicates queue is high-throughput aggregation (HT AGG) enabled
169 * @sta_id: valid if sched_retry is set
170 * @tid: valid if sched_retry is set
172 * A Tx queue consists of circular buffer of BDs (a.k.a. TFDs, transmit frame
173 * descriptors) and required locking structures.
175 #define TFD_TX_CMD_SLOTS 256
176 #define TFD_CMD_SLOTS 32
178 struct iwl_tx_queue
{
180 struct iwl_tfd
*tfds
;
181 struct iwl_device_cmd
**cmd
;
182 struct iwl_cmd_meta
*meta
;
183 struct iwl_tx_info
*txb
;
184 unsigned long time_stamp
;
194 #define IWL_NUM_SCAN_RATES (2)
197 * One for each channel, holds all channel setup data
198 * Some of the fields (e.g. eeprom and flags/max_power_avg) are redundant
201 struct iwl_channel_info
{
202 struct iwl_eeprom_channel eeprom
; /* EEPROM regulatory limit */
203 struct iwl_eeprom_channel ht40_eeprom
; /* EEPROM regulatory limit for
206 u8 channel
; /* channel number */
207 u8 flags
; /* flags copied from EEPROM */
208 s8 max_power_avg
; /* (dBm) regul. eeprom, normal Tx, any rate */
209 s8 curr_txpow
; /* (dBm) regulatory/spectrum/user (not h/w) limit */
210 s8 min_power
; /* always 0 */
211 s8 scan_power
; /* (dBm) regul. eeprom, direct scans, any rate */
213 u8 group_index
; /* 0-4, maps channel to group1/2/3/4/5 */
214 u8 band_index
; /* 0-4, maps channel to band1/2/3/4/5 */
215 enum ieee80211_band band
;
217 /* HT40 channel info */
218 s8 ht40_max_power_avg
; /* (dBm) regul. eeprom, normal Tx, any rate */
219 u8 ht40_flags
; /* flags copied from EEPROM */
220 u8 ht40_extension_channel
; /* HT_IE_EXT_CHANNEL_* */
223 #define IWL_TX_FIFO_BK 0 /* shared */
224 #define IWL_TX_FIFO_BE 1
225 #define IWL_TX_FIFO_VI 2 /* shared */
226 #define IWL_TX_FIFO_VO 3
227 #define IWL_TX_FIFO_BK_IPAN IWL_TX_FIFO_BK
228 #define IWL_TX_FIFO_BE_IPAN 4
229 #define IWL_TX_FIFO_VI_IPAN IWL_TX_FIFO_VI
230 #define IWL_TX_FIFO_VO_IPAN 5
231 /* re-uses the VO FIFO, uCode will properly flush/schedule */
232 #define IWL_TX_FIFO_AUX 5
233 #define IWL_TX_FIFO_UNUSED -1
235 /* AUX (TX during scan dwell) queue */
236 #define IWL_AUX_QUEUE 10
239 * Minimum number of queues. MAX_NUM is defined in hw specific files.
240 * Set the minimum to accommodate
241 * - 4 standard TX queues
242 * - the command queue
244 * - the PAN multicast queue, and
245 * - the AUX (TX during scan dwell) queue.
247 #define IWL_MIN_NUM_QUEUES 11
250 * Command queue depends on iPAN support.
252 #define IWL_DEFAULT_CMD_QUEUE_NUM 4
253 #define IWL_IPAN_CMD_QUEUE_NUM 9
256 * This queue number is required for proper operation
257 * because the ucode will stop/start the scheduler as
260 #define IWL_IPAN_MCAST_QUEUE 8
262 #define IEEE80211_DATA_LEN 2304
263 #define IEEE80211_4ADDR_LEN 30
264 #define IEEE80211_HLEN (IEEE80211_4ADDR_LEN)
265 #define IEEE80211_FRAME_LEN (IEEE80211_DATA_LEN + IEEE80211_HLEN)
268 #define SEQ_TO_SN(seq) (((seq) & IEEE80211_SCTL_SEQ) >> 4)
269 #define SN_TO_SEQ(ssn) (((ssn) << 4) & IEEE80211_SCTL_SEQ)
270 #define MAX_SN ((IEEE80211_SCTL_SEQ) >> 4)
275 CMD_WANT_SKB
= BIT(1),
276 CMD_ON_DEMAND
= BIT(2),
279 #define DEF_CMD_PAYLOAD_SIZE 320
282 * struct iwl_device_cmd
284 * For allocation of the command and tx queues, this establishes the overall
285 * size of the largest command we send to uCode, except for commands that
286 * aren't fully copied and use other TFD space.
288 struct iwl_device_cmd
{
289 struct iwl_cmd_header hdr
; /* uCode API */
295 struct iwl_tx_cmd tx
;
296 struct iwl6000_channel_switch_cmd chswitch
;
297 u8 payload
[DEF_CMD_PAYLOAD_SIZE
];
301 #define TFD_MAX_PAYLOAD_SIZE (sizeof(struct iwl_device_cmd))
303 #define IWL_MAX_CMD_TFDS 2
305 enum iwl_hcmd_dataflag
{
306 IWL_HCMD_DFL_NOCOPY
= BIT(0),
310 * struct iwl_host_cmd - Host command to the uCode
311 * @data: array of chunks that composes the data of the host command
312 * @reply_page: pointer to the page that holds the response to the host command
314 * @flags: can be CMD_* note CMD_WANT_SKB is incompatible withe CMD_ASYNC
315 * @len: array of the lenths of the chunks in data
317 * @id: id of the host command
319 struct iwl_host_cmd
{
320 const void *data
[IWL_MAX_CMD_TFDS
];
321 unsigned long reply_page
;
322 void (*callback
)(struct iwl_priv
*priv
,
323 struct iwl_device_cmd
*cmd
,
324 struct iwl_rx_packet
*pkt
);
326 u16 len
[IWL_MAX_CMD_TFDS
];
327 u8 dataflags
[IWL_MAX_CMD_TFDS
];
331 #define SUP_RATE_11A_MAX_NUM_CHANNELS 8
332 #define SUP_RATE_11B_MAX_NUM_CHANNELS 4
333 #define SUP_RATE_11G_MAX_NUM_CHANNELS 12
335 #define IWL_SUPPORTED_RATES_IE_LEN 8
337 #define MAX_TID_COUNT 9
339 #define IWL_INVALID_RATE 0xFF
340 #define IWL_INVALID_VALUE -1
343 * struct iwl_ht_agg -- aggregation status while waiting for block-ack
344 * @txq_id: Tx queue used for Tx attempt
345 * @frame_count: # frames attempted by Tx command
346 * @wait_for_ba: Expect block-ack before next Tx reply
347 * @start_idx: Index of 1st Transmit Frame Descriptor (TFD) in Tx window
348 * @bitmap0: Low order bitmap, one bit for each frame pending ACK in Tx window
349 * @bitmap1: High order, one bit for each frame pending ACK in Tx window
350 * @rate_n_flags: Rate at which Tx was attempted
352 * If REPLY_TX indicates that aggregation was attempted, driver must wait
353 * for block ack (REPLY_COMPRESSED_BA). This struct stores tx reply info
354 * until block ack arrives.
363 #define IWL_AGG_OFF 0
365 #define IWL_EMPTYING_HW_QUEUE_ADDBA 2
366 #define IWL_EMPTYING_HW_QUEUE_DELBA 3
372 struct iwl_tid_data
{
373 u16 seq_number
; /* agn only */
375 struct iwl_ht_agg agg
;
378 union iwl_ht_rate_supp
{
386 #define CFG_HT_RX_AMPDU_FACTOR_8K (0x0)
387 #define CFG_HT_RX_AMPDU_FACTOR_16K (0x1)
388 #define CFG_HT_RX_AMPDU_FACTOR_32K (0x2)
389 #define CFG_HT_RX_AMPDU_FACTOR_64K (0x3)
390 #define CFG_HT_RX_AMPDU_FACTOR_DEF CFG_HT_RX_AMPDU_FACTOR_64K
391 #define CFG_HT_RX_AMPDU_FACTOR_MAX CFG_HT_RX_AMPDU_FACTOR_64K
392 #define CFG_HT_RX_AMPDU_FACTOR_MIN CFG_HT_RX_AMPDU_FACTOR_8K
395 * Maximal MPDU density for TX aggregation
401 #define CFG_HT_MPDU_DENSITY_2USEC (0x4)
402 #define CFG_HT_MPDU_DENSITY_4USEC (0x5)
403 #define CFG_HT_MPDU_DENSITY_8USEC (0x6)
404 #define CFG_HT_MPDU_DENSITY_16USEC (0x7)
405 #define CFG_HT_MPDU_DENSITY_DEF CFG_HT_MPDU_DENSITY_4USEC
406 #define CFG_HT_MPDU_DENSITY_MAX CFG_HT_MPDU_DENSITY_16USEC
407 #define CFG_HT_MPDU_DENSITY_MIN (0x1)
409 struct iwl_ht_config
{
410 bool single_chain_sufficient
;
411 enum ieee80211_smps_mode smps
; /* current smps mode */
415 struct iwl_qos_info
{
417 struct iwl_qosparam_cmd def_qos_parm
;
421 * Structure should be accessed with sta_lock held. When station addition
422 * is in progress (IWL_STA_UCODE_INPROGRESS) it is possible to access only
423 * the commands (iwl_addsta_cmd and iwl_link_quality_cmd) without sta_lock
426 struct iwl_station_entry
{
427 struct iwl_addsta_cmd sta
;
428 struct iwl_tid_data tid
[MAX_TID_COUNT
];
430 struct iwl_link_quality_cmd
*lq
;
433 struct iwl_station_priv_common
{
434 struct iwl_rxon_context
*ctx
;
439 * iwl_station_priv: Driver's private station information
441 * When mac80211 creates a station it reserves some space (hw->sta_data_size)
442 * in the structure for use by driver. This structure is places in that
445 struct iwl_station_priv
{
446 struct iwl_station_priv_common common
;
447 struct iwl_lq_sta lq_sta
;
448 atomic_t pending_frames
;
455 * struct iwl_vif_priv - driver's private per-interface information
457 * When mac80211 allocates a virtual interface, it can allocate
458 * space for us to put data into.
460 struct iwl_vif_priv
{
461 struct iwl_rxon_context
*ctx
;
462 u8 ibss_bssid_sta_id
;
465 /* one for each uCode image (inst/data, boot/init/runtime) */
467 void *v_addr
; /* access by driver */
468 dma_addr_t p_addr
; /* access by card's busmaster DMA */
473 struct fw_desc code
, data
;
476 /* v1/v2 uCode file layout */
477 struct iwl_ucode_header
{
478 __le32 ver
; /* major/minor/API/serial */
481 __le32 inst_size
; /* bytes of runtime code */
482 __le32 data_size
; /* bytes of runtime data */
483 __le32 init_size
; /* bytes of init code */
484 __le32 init_data_size
; /* bytes of init data */
485 __le32 boot_size
; /* bytes of bootstrap code */
486 u8 data
[0]; /* in same order as sizes */
489 __le32 build
; /* build number */
490 __le32 inst_size
; /* bytes of runtime code */
491 __le32 data_size
; /* bytes of runtime data */
492 __le32 init_size
; /* bytes of init code */
493 __le32 init_data_size
; /* bytes of init data */
494 __le32 boot_size
; /* bytes of bootstrap code */
495 u8 data
[0]; /* in same order as sizes */
501 * new TLV uCode file layout
503 * The new TLV file format contains TLVs, that each specify
504 * some piece of data. To facilitate "groups", for example
505 * different instruction image with different capabilities,
506 * bundled with the same init image, an alternative mechanism
508 * When the alternative field is 0, that means that the item
509 * is always valid. When it is non-zero, then it is only
510 * valid in conjunction with items of the same alternative,
511 * in which case the driver (user) selects one alternative
515 enum iwl_ucode_tlv_type
{
516 IWL_UCODE_TLV_INVALID
= 0, /* unused */
517 IWL_UCODE_TLV_INST
= 1,
518 IWL_UCODE_TLV_DATA
= 2,
519 IWL_UCODE_TLV_INIT
= 3,
520 IWL_UCODE_TLV_INIT_DATA
= 4,
521 IWL_UCODE_TLV_BOOT
= 5,
522 IWL_UCODE_TLV_PROBE_MAX_LEN
= 6, /* a u32 value */
523 IWL_UCODE_TLV_PAN
= 7,
524 IWL_UCODE_TLV_RUNT_EVTLOG_PTR
= 8,
525 IWL_UCODE_TLV_RUNT_EVTLOG_SIZE
= 9,
526 IWL_UCODE_TLV_RUNT_ERRLOG_PTR
= 10,
527 IWL_UCODE_TLV_INIT_EVTLOG_PTR
= 11,
528 IWL_UCODE_TLV_INIT_EVTLOG_SIZE
= 12,
529 IWL_UCODE_TLV_INIT_ERRLOG_PTR
= 13,
530 IWL_UCODE_TLV_ENHANCE_SENS_TBL
= 14,
531 IWL_UCODE_TLV_PHY_CALIBRATION_SIZE
= 15,
532 IWL_UCODE_TLV_WOWLAN_INST
= 16,
533 IWL_UCODE_TLV_WOWLAN_DATA
= 17,
534 IWL_UCODE_TLV_FLAGS
= 18,
538 * enum iwl_ucode_tlv_flag - ucode API flags
539 * @IWL_UCODE_TLV_FLAGS_PAN: This is PAN capable microcode; this previously
540 * was a separate TLV but moved here to save space.
541 * @IWL_UCODE_TLV_FLAGS_NEWSCAN: new uCode scan behaviour on hidden SSID,
542 * treats good CRC threshold as a boolean
543 * @IWL_UCODE_TLV_FLAGS_MFP: This uCode image supports MFP (802.11w).
544 * @IWL_UCODE_TLV_FLAGS_P2P: This uCode image supports P2P.
546 enum iwl_ucode_tlv_flag
{
547 IWL_UCODE_TLV_FLAGS_PAN
= BIT(0),
548 IWL_UCODE_TLV_FLAGS_NEWSCAN
= BIT(1),
549 IWL_UCODE_TLV_FLAGS_MFP
= BIT(2),
550 IWL_UCODE_TLV_FLAGS_P2P
= BIT(3),
553 struct iwl_ucode_tlv
{
554 __le16 type
; /* see above */
555 __le16 alternative
; /* see comment */
556 __le32 length
; /* not including type/length fields */
560 #define IWL_TLV_UCODE_MAGIC 0x0a4c5749
562 struct iwl_tlv_ucode_header
{
564 * The TLV style ucode header is distinguished from
565 * the v1/v2 style header by first four bytes being
566 * zero, as such is an invalid combination of
567 * major/minor/API/serial versions.
571 u8 human_readable
[64];
572 __le32 ver
; /* major/minor/API/serial */
574 __le64 alternatives
; /* bitmask of valid alternatives */
576 * The data contained herein has a TLV layout,
577 * see above for the TLV header and types.
578 * Note that each TLV is padded to a length
579 * that is a multiple of 4 for alignment.
584 struct iwl_sensitivity_ranges
{
591 u16 auto_corr_min_ofdm
;
592 u16 auto_corr_min_ofdm_mrc
;
593 u16 auto_corr_min_ofdm_x1
;
594 u16 auto_corr_min_ofdm_mrc_x1
;
596 u16 auto_corr_max_ofdm
;
597 u16 auto_corr_max_ofdm_mrc
;
598 u16 auto_corr_max_ofdm_x1
;
599 u16 auto_corr_max_ofdm_mrc_x1
;
601 u16 auto_corr_max_cck
;
602 u16 auto_corr_max_cck_mrc
;
603 u16 auto_corr_min_cck
;
604 u16 auto_corr_min_cck_mrc
;
606 u16 barker_corr_th_min
;
607 u16 barker_corr_th_min_mrc
;
612 #define KELVIN_TO_CELSIUS(x) ((x)-273)
613 #define CELSIUS_TO_KELVIN(x) ((x)+273)
616 /******************************************************************************
618 * Functions implemented in core module which are forward declared here
619 * for use by iwl-[4-5].c
621 * NOTE: The implementation of these functions are not hardware specific
622 * which is why they are in the core module files.
624 * Naming convention --
625 * iwl_ <-- Is part of iwlwifi
626 * iwlXXXX_ <-- Hardware specific (implemented in iwl-XXXX.c for XXXX)
628 ****************************************************************************/
629 extern void iwl_update_chain_flags(struct iwl_priv
*priv
);
630 extern const u8 iwl_bcast_addr
[ETH_ALEN
];
631 extern int iwl_queue_space(const struct iwl_queue
*q
);
632 static inline int iwl_queue_used(const struct iwl_queue
*q
, int i
)
634 return q
->write_ptr
>= q
->read_ptr
?
635 (i
>= q
->read_ptr
&& i
< q
->write_ptr
) :
636 !(i
< q
->read_ptr
&& i
>= q
->write_ptr
);
640 static inline u8
get_cmd_index(struct iwl_queue
*q
, u32 index
)
642 return index
& (q
->n_window
- 1);
652 #define IWL_OPERATION_MODE_AUTO 0
653 #define IWL_OPERATION_MODE_HT_ONLY 1
654 #define IWL_OPERATION_MODE_MIXED 2
655 #define IWL_OPERATION_MODE_20MHZ 3
657 #define IWL_TX_CRC_SIZE 4
658 #define IWL_TX_DELIMITER_SIZE 4
660 #define TX_POWER_IWL_ILLEGAL_VOLTAGE -10000
662 /* Sensitivity and chain noise calibration */
663 #define INITIALIZATION_VALUE 0xFFFF
664 #define IWL_CAL_NUM_BEACONS 16
665 #define MAXIMUM_ALLOWED_PATHLOSS 15
667 #define CHAIN_NOISE_MAX_DELTA_GAIN_CODE 3
669 #define MAX_FA_OFDM 50
670 #define MIN_FA_OFDM 5
671 #define MAX_FA_CCK 50
674 #define AUTO_CORR_STEP_OFDM 1
676 #define AUTO_CORR_STEP_CCK 3
677 #define AUTO_CORR_MAX_TH_CCK 160
680 #define NRG_STEP_CCK 2
682 #define MAX_NUMBER_CCK_NO_FA 100
684 #define AUTO_CORR_CCK_MIN_VAL_DEF (125)
689 #define CHAIN_NOISE_DELTA_GAIN_INIT_VAL 4
690 #define ALL_BAND_FILTER 0xFF00
691 #define IN_BAND_FILTER 0xFF
692 #define MIN_AVERAGE_NOISE_MAX_VALUE 0xFFFFFFFF
694 #define NRG_NUM_PREV_STAT_L 20
695 #define NUM_RX_CHAINS 3
697 enum iwlagn_false_alarm_state
{
700 IWL_FA_GOOD_RANGE
= 2,
703 enum iwlagn_chain_noise_state
{
704 IWL_CHAIN_NOISE_ALIVE
= 0, /* must be 0 */
705 IWL_CHAIN_NOISE_ACCUMULATE
,
706 IWL_CHAIN_NOISE_CALIBRATED
,
707 IWL_CHAIN_NOISE_DONE
,
713 * defines the order in which results of initial calibrations
714 * should be sent to the runtime uCode
721 IWL_CALIB_TX_IQ_PERD
,
723 IWL_CALIB_TEMP_OFFSET
,
727 /* Opaque calibration results */
728 struct iwl_calib_result
{
733 /* Sensitivity calib data */
734 struct iwl_sensitivity_data
{
736 u32 auto_corr_ofdm_mrc
;
737 u32 auto_corr_ofdm_x1
;
738 u32 auto_corr_ofdm_mrc_x1
;
740 u32 auto_corr_cck_mrc
;
742 u32 last_bad_plcp_cnt_ofdm
;
743 u32 last_fa_cnt_ofdm
;
744 u32 last_bad_plcp_cnt_cck
;
750 u8 nrg_silence_rssi
[NRG_NUM_PREV_STAT_L
];
755 s32 nrg_auto_corr_silence_diff
;
756 u32 num_in_cck_no_fa
;
759 u16 barker_corr_th_min
;
760 u16 barker_corr_th_min_mrc
;
764 /* Chain noise (differential Rx gain) calib data */
765 struct iwl_chain_noise_data
{
774 u8 disconn_array
[NUM_RX_CHAINS
];
775 u8 delta_gain_code
[NUM_RX_CHAINS
];
780 #define EEPROM_SEM_TIMEOUT 10 /* milliseconds */
781 #define EEPROM_SEM_RETRY_LIMIT 1000 /* number of attempts (not time) */
783 #define IWL_TRAFFIC_ENTRIES (256)
784 #define IWL_TRAFFIC_ENTRY_SIZE (64)
787 MEASUREMENT_READY
= (1 << 0),
788 MEASUREMENT_ACTIVE
= (1 << 1),
792 NVM_DEVICE_TYPE_EEPROM
= 0,
797 * Two types of OTP memory access modes
798 * IWL_OTP_ACCESS_ABSOLUTE - absolute address mode,
799 * based on physical memory addressing
800 * IWL_OTP_ACCESS_RELATIVE - relative address mode,
801 * based on logical memory addressing
803 enum iwl_access_mode
{
804 IWL_OTP_ACCESS_ABSOLUTE
,
805 IWL_OTP_ACCESS_RELATIVE
,
809 * enum iwl_pa_type - Power Amplifier type
810 * @IWL_PA_SYSTEM: based on uCode configuration
811 * @IWL_PA_INTERNAL: use Internal only
818 /* reply_tx_statistics (for _agn devices) */
819 struct reply_tx_error_statistics
{
825 u32 int_crossed_retry
;
841 u32 sta_color_mismatch
;
845 /* reply_agg_tx_statistics (for _agn devices) */
846 struct reply_agg_tx_error_statistics
{
853 u32 last_sent_bt_kill
;
862 /* management statistics */
863 enum iwl_mgmt_stats
{
864 MANAGEMENT_ASSOC_REQ
= 0,
865 MANAGEMENT_ASSOC_RESP
,
866 MANAGEMENT_REASSOC_REQ
,
867 MANAGEMENT_REASSOC_RESP
,
868 MANAGEMENT_PROBE_REQ
,
869 MANAGEMENT_PROBE_RESP
,
878 /* control statistics */
879 enum iwl_ctrl_stats
{
880 CONTROL_BACK_REQ
= 0,
891 struct traffic_stats
{
892 #ifdef CONFIG_IWLWIFI_DEBUGFS
893 u32 mgmt
[MANAGEMENT_MAX
];
894 u32 ctrl
[CONTROL_MAX
];
901 * schedule the timer to wake up every UCODE_TRACE_PERIOD milliseconds
902 * to perform continuous uCode event logging operation if enabled
904 #define UCODE_TRACE_PERIOD (100)
907 * iwl_event_log: current uCode event log position
909 * @ucode_trace: enable/disable ucode continuous trace timer
910 * @num_wraps: how many times the event buffer wraps
911 * @next_entry: the entry just before the next one that uCode would fill
912 * @non_wraps_count: counter for no wrap detected when dump ucode events
913 * @wraps_once_count: counter for wrap once detected when dump ucode events
914 * @wraps_more_count: counter for wrap more than once detected
915 * when dump ucode events
917 struct iwl_event_log
{
922 int wraps_once_count
;
923 int wraps_more_count
;
927 * host interrupt timeout value
928 * used with setting interrupt coalescing timer
929 * the CSR_INT_COALESCING is an 8 bit register in 32-usec unit
931 * default interrupt coalescing timer is 64 x 32 = 2048 usecs
932 * default interrupt coalescing calibration timer is 16 x 32 = 512 usecs
934 #define IWL_HOST_INT_TIMEOUT_MAX (0xFF)
935 #define IWL_HOST_INT_TIMEOUT_DEF (0x40)
936 #define IWL_HOST_INT_TIMEOUT_MIN (0x0)
937 #define IWL_HOST_INT_CALIB_TIMEOUT_MAX (0xFF)
938 #define IWL_HOST_INT_CALIB_TIMEOUT_DEF (0x10)
939 #define IWL_HOST_INT_CALIB_TIMEOUT_MIN (0x0)
942 * This is the threshold value of plcp error rate per 100mSecs. It is
943 * used to set and check for the validity of plcp_delta.
945 #define IWL_MAX_PLCP_ERR_THRESHOLD_MIN (1)
946 #define IWL_MAX_PLCP_ERR_THRESHOLD_DEF (50)
947 #define IWL_MAX_PLCP_ERR_LONG_THRESHOLD_DEF (100)
948 #define IWL_MAX_PLCP_ERR_EXT_LONG_THRESHOLD_DEF (200)
949 #define IWL_MAX_PLCP_ERR_THRESHOLD_MAX (255)
950 #define IWL_MAX_PLCP_ERR_THRESHOLD_DISABLE (0)
952 #define IWL_DELAY_NEXT_FORCE_RF_RESET (HZ*3)
953 #define IWL_DELAY_NEXT_FORCE_FW_RELOAD (HZ*5)
955 /* TX queue watchdog timeouts in mSecs */
956 #define IWL_DEF_WD_TIMEOUT (2000)
957 #define IWL_LONG_WD_TIMEOUT (10000)
958 #define IWL_MAX_WD_TIMEOUT (120000)
960 /* BT Antenna Coupling Threshold (dB) */
961 #define IWL_BT_ANTENNA_COUPLING_THRESHOLD (35)
963 /* Firmware reload counter and Timestamp */
964 #define IWL_MIN_RELOAD_DURATION 1000 /* 1000 ms */
965 #define IWL_MAX_CONTINUE_RELOAD_CNT 4
974 struct iwl_force_reset
{
975 int reset_request_count
;
976 int reset_success_count
;
977 int reset_reject_count
;
978 unsigned long reset_duration
;
979 unsigned long last_force_reset_jiffies
;
982 /* extend beacon time format bit shifting */
985 * bits 31:22 - extended
986 * bits 21:0 - interval
988 #define IWLAGN_EXT_BEACON_TIME_POS 22
991 * struct iwl_notification_wait - notification wait entry
992 * @list: list head for global list
993 * @fn: function called with the notification
996 * This structure is not used directly, to wait for a
997 * notification declare it on the stack, and call
998 * iwlagn_init_notification_wait() with appropriate
999 * parameters. Then do whatever will cause the ucode
1000 * to notify the driver, and to wait for that then
1001 * call iwlagn_wait_notification().
1003 * Each notification is one-shot. If at some point we
1004 * need to support multi-shot notifications (which
1005 * can't be allocated on the stack) we need to modify
1006 * the code for them.
1008 struct iwl_notification_wait
{
1009 struct list_head list
;
1011 void (*fn
)(struct iwl_priv
*priv
, struct iwl_rx_packet
*pkt
,
1016 bool triggered
, aborted
;
1019 enum iwl_rxon_context_id
{
1026 struct iwl_rxon_context
{
1027 struct ieee80211_vif
*vif
;
1029 const u8
*ac_to_fifo
;
1030 const u8
*ac_to_queue
;
1034 * We could use the vif to indicate active, but we
1035 * also need it to be active during disabling when
1036 * we already removed the vif for type setting.
1038 bool always_active
, is_active
;
1040 bool ht_need_multiple_chains
;
1042 enum iwl_rxon_context_id ctxid
;
1044 u32 interface_modes
, exclusive_interface_modes
;
1045 u8 unused_devtype
, ap_devtype
, ibss_devtype
, station_devtype
;
1048 * We declare this const so it can only be
1049 * changed via explicit cast within the
1050 * routines that actually update the physical
1053 const struct iwl_rxon_cmd active
;
1054 struct iwl_rxon_cmd staging
;
1056 struct iwl_rxon_time_cmd timing
;
1058 struct iwl_qos_info qos_data
;
1060 u8 bcast_sta_id
, ap_sta_id
;
1062 u8 rxon_cmd
, rxon_assoc_cmd
, rxon_timing_cmd
;
1066 struct iwl_wep_key wep_keys
[WEP_KEYS_MAX
];
1067 u8 key_mapping_keys
;
1069 __le32 station_flags
;
1074 bool non_gf_sta_present
;
1076 bool enabled
, is_40mhz
;
1077 u8 extension_chan_offset
;
1080 bool last_tx_rejected
;
1083 enum iwl_scan_type
{
1085 IWL_SCAN_RADIO_RESET
,
1089 enum iwlagn_ucode_type
{
1096 #ifdef CONFIG_IWLWIFI_DEVICE_SVTOOL
1097 struct iwl_testmode_trace
{
1103 dma_addr_t dma_addr
;
1108 /* uCode ownership */
1109 #define IWL_OWNERSHIP_DRIVER 0
1110 #define IWL_OWNERSHIP_TM 1
1114 /*data shared among all the driver's layers */
1115 struct iwl_shared _shrd
;
1116 struct iwl_shared
*shrd
;
1118 /* ieee device used by generic ieee processing code */
1119 struct ieee80211_hw
*hw
;
1120 struct ieee80211_channel
*ieee_channels
;
1121 struct ieee80211_rate
*ieee_rates
;
1122 struct iwl_cfg
*cfg
;
1124 enum ieee80211_band band
;
1126 void (*pre_rx_handler
)(struct iwl_priv
*priv
,
1127 struct iwl_rx_mem_buffer
*rxb
);
1128 void (*rx_handlers
[REPLY_MAX
])(struct iwl_priv
*priv
,
1129 struct iwl_rx_mem_buffer
*rxb
);
1131 struct ieee80211_supported_band bands
[IEEE80211_NUM_BANDS
];
1133 /* spectrum measurement report caching */
1134 struct iwl_spectrum_notification measure_report
;
1135 u8 measurement_status
;
1137 /* ucode beacon time */
1138 u32 ucode_beacon_time
;
1139 int missed_beacon_threshold
;
1141 /* track IBSS manager (last beacon) status */
1144 /* jiffies when last recovery from statistics was performed */
1145 unsigned long rx_statistics_jiffies
;
1148 u32 rx_handlers_stats
[REPLY_MAX
];
1151 struct iwl_force_reset force_reset
[IWL_MAX_FORCE_RESET
];
1153 /* firmware reload counter and timestamp */
1154 unsigned long reload_jiffies
;
1157 /* we allocate array of iwl_channel_info for NIC's valid channels.
1158 * Access via channel # using indirect index array */
1159 struct iwl_channel_info
*channel_info
; /* channel info array */
1160 u8 channel_count
; /* # of channels */
1162 /* thermal calibration */
1163 s32 temperature
; /* degrees Kelvin */
1164 s32 last_temperature
;
1166 /* init calibration results */
1167 struct iwl_calib_result calib_results
[IWL_CALIB_MAX
];
1169 /* Scan related variables */
1170 unsigned long scan_start
;
1171 unsigned long scan_start_tsf
;
1173 enum ieee80211_band scan_band
;
1174 struct cfg80211_scan_request
*scan_request
;
1175 struct ieee80211_vif
*scan_vif
;
1176 enum iwl_scan_type scan_type
;
1177 u8 scan_tx_ant
[IEEE80211_NUM_BANDS
];
1181 spinlock_t hcmd_lock
; /* protect hcmd */
1182 spinlock_t reg_lock
; /* protect hw register access */
1184 /*TODO: remove these pointers - use bus(priv) instead */
1185 struct iwl_bus
*bus
; /* bus specific data */
1187 /* microcode/device supports multiple contexts */
1190 /* max number of station keys */
1193 bool new_scan_threshold_behaviour
;
1195 /* EEPROM MAC addresses */
1196 struct mac_address addresses
[2];
1198 /* uCode images, save to reload in case of failure */
1199 int fw_index
; /* firmware we're trying to load */
1200 u32 ucode_ver
; /* version of ucode, copy of
1203 /* uCode owner: default: IWL_OWNERSHIP_DRIVER */
1206 struct fw_img ucode_rt
;
1207 struct fw_img ucode_init
;
1208 struct fw_img ucode_wowlan
;
1210 enum iwlagn_ucode_type ucode_type
;
1211 u8 ucode_write_complete
; /* the image write is complete */
1212 char firmware_name
[25];
1214 struct iwl_rxon_context contexts
[NUM_IWL_RXON_CTX
];
1216 __le16 switch_channel
;
1219 u32 error_event_table
;
1220 u32 log_event_table
;
1226 struct iwl_sensitivity_data sensitivity_data
;
1227 struct iwl_chain_noise_data chain_noise_data
;
1228 bool enhance_sensitivity_table
;
1229 __le16 sensitivity_tbl
[HD_TABLE_SIZE
];
1230 __le16 enhance_sensitivity_tbl
[ENHANCE_HD_TABLE_ENTRIES
];
1232 struct iwl_ht_config current_ht_config
;
1234 /* Rate scaling data */
1237 wait_queue_head_t wait_command_queue
;
1239 int activity_timer_active
;
1241 /* Tx DMA processing queues */
1242 struct iwl_tx_queue
*txq
;
1243 unsigned long txq_ctx_active_msk
;
1244 struct iwl_dma_ptr kw
; /* keep warm address */
1246 /* counts mgmt, ctl, and data packets */
1247 struct traffic_stats tx_stats
;
1248 struct traffic_stats rx_stats
;
1250 struct iwl_power_mgr power_data
;
1251 struct iwl_tt_mgmt thermal_throttle
;
1253 /* station table variables */
1255 struct iwl_station_entry stations
[IWLAGN_STATION_COUNT
];
1256 unsigned long ucode_key_table
;
1258 /* queue refcounts */
1259 #define IWL_MAX_HW_QUEUES 32
1260 unsigned long queue_stopped
[BITS_TO_LONGS(IWL_MAX_HW_QUEUES
)];
1262 atomic_t queue_stop_count
[4];
1264 /* Indication if ieee80211_ops->open has been called */
1267 u8 mac80211_registered
;
1269 /* eeprom -- this is in the card's little endian byte order */
1271 int nvm_device_type
;
1272 struct iwl_eeprom_calib_info
*calib_info
;
1274 enum nl80211_iftype iw_mode
;
1276 /* Last Rx'd beacon timestamp */
1281 struct statistics_general_common common
;
1282 struct statistics_rx_non_phy rx_non_phy
;
1283 struct statistics_rx_phy rx_ofdm
;
1284 struct statistics_rx_ht_phy rx_ofdm_ht
;
1285 struct statistics_rx_phy rx_cck
;
1286 struct statistics_tx tx
;
1287 #ifdef CONFIG_IWLWIFI_DEBUGFS
1288 struct statistics_bt_activity bt_activity
;
1289 __le32 num_bt_kills
, accum_num_bt_kills
;
1292 #ifdef CONFIG_IWLWIFI_DEBUGFS
1294 struct statistics_general_common common
;
1295 struct statistics_rx_non_phy rx_non_phy
;
1296 struct statistics_rx_phy rx_ofdm
;
1297 struct statistics_rx_ht_phy rx_ofdm_ht
;
1298 struct statistics_rx_phy rx_cck
;
1299 struct statistics_tx tx
;
1300 struct statistics_bt_activity bt_activity
;
1301 } accum_stats
, delta_stats
, max_delta_stats
;
1305 * reporting the number of tids has AGG on. 0 means
1310 struct iwl_rx_phy_res last_phy_res
;
1311 bool last_phy_res_valid
;
1313 struct completion firmware_loading_complete
;
1315 u32 init_evtlog_ptr
, init_evtlog_size
, init_errlog_ptr
;
1316 u32 inst_evtlog_ptr
, inst_evtlog_size
, inst_errlog_ptr
;
1319 * chain noise reset and gain commands are the
1320 * two extra calibration commands follows the standard
1321 * phy calibration commands
1323 u8 phy_calib_chain_noise_reset_cmd
;
1324 u8 phy_calib_chain_noise_gain_cmd
;
1326 /* counts reply_tx error */
1327 struct reply_tx_error_statistics reply_tx_stats
;
1328 struct reply_agg_tx_error_statistics reply_agg_tx_stats
;
1329 /* notification wait support */
1330 struct list_head notif_waits
;
1331 spinlock_t notif_wait_lock
;
1332 wait_queue_head_t notif_waitq
;
1334 /* remain-on-channel offload support */
1335 struct ieee80211_channel
*hw_roc_channel
;
1336 struct delayed_work hw_roc_disable_work
;
1337 enum nl80211_channel_type hw_roc_chantype
;
1338 int hw_roc_duration
;
1344 u8 bt_traffic_load
, last_bt_traffic_load
;
1345 bool bt_ch_announce
;
1346 bool bt_full_concurrent
;
1347 bool bt_ant_couple_ok
;
1348 __le32 kill_ack_mask
;
1349 __le32 kill_cts_mask
;
1353 u16 dynamic_frag_thresh
;
1354 u8 bt_ci_compliance
;
1355 struct work_struct bt_traffic_change_work
;
1356 bool bt_enable_pspoll
;
1357 struct iwl_rxon_context
*cur_rssi_ctx
;
1360 struct work_struct restart
;
1361 struct work_struct scan_completed
;
1362 struct work_struct abort_scan
;
1364 struct work_struct beacon_update
;
1365 struct iwl_rxon_context
*beacon_ctx
;
1366 struct sk_buff
*beacon_skb
;
1369 struct work_struct tt_work
;
1370 struct work_struct ct_enter
;
1371 struct work_struct ct_exit
;
1372 struct work_struct start_internal_scan
;
1373 struct work_struct tx_flush
;
1374 struct work_struct bt_full_concurrency
;
1375 struct work_struct bt_runtime_config
;
1377 struct delayed_work scan_check
;
1380 s8 tx_power_user_lmt
;
1381 s8 tx_power_device_lmt
;
1382 s8 tx_power_lmt_in_half_dbm
; /* max tx power in half-dBm format */
1385 #ifdef CONFIG_IWLWIFI_DEBUGFS
1391 struct dentry
*debugfs_dir
;
1392 u32 dbgfs_sram_offset
, dbgfs_sram_len
;
1395 #endif /* CONFIG_IWLWIFI_DEBUGFS */
1397 struct work_struct txpower_work
;
1398 u32 disable_sens_cal
;
1399 u32 disable_chain_noise_cal
;
1400 struct work_struct run_time_calib_work
;
1401 struct timer_list statistics_periodic
;
1402 struct timer_list ucode_trace
;
1403 struct timer_list watchdog
;
1405 struct iwl_event_log event_log
;
1407 struct led_classdev led
;
1408 unsigned long blink_on
, blink_off
;
1409 bool led_registered
;
1410 #ifdef CONFIG_IWLWIFI_DEVICE_SVTOOL
1411 struct iwl_testmode_trace testmode_trace
;
1415 /* WoWLAN GTK rekey data */
1416 u8 kck
[NL80211_KCK_LEN
], kek
[NL80211_KEK_LEN
];
1418 __le16 last_seq_ctl
;
1419 bool have_rekey_data
;
1422 static inline void iwl_txq_ctx_activate(struct iwl_priv
*priv
, int txq_id
)
1424 set_bit(txq_id
, &priv
->txq_ctx_active_msk
);
1427 static inline void iwl_txq_ctx_deactivate(struct iwl_priv
*priv
, int txq_id
)
1429 clear_bit(txq_id
, &priv
->txq_ctx_active_msk
);
1432 extern struct iwl_mod_params iwlagn_mod_params
;
1434 static inline struct ieee80211_hdr
*iwl_tx_queue_get_hdr(struct iwl_priv
*priv
,
1435 int txq_id
, int idx
)
1437 if (priv
->txq
[txq_id
].txb
[idx
].skb
)
1438 return (struct ieee80211_hdr
*)priv
->txq
[txq_id
].
1443 static inline struct iwl_rxon_context
*
1444 iwl_rxon_ctx_from_vif(struct ieee80211_vif
*vif
)
1446 struct iwl_vif_priv
*vif_priv
= (void *)vif
->drv_priv
;
1448 return vif_priv
->ctx
;
1451 #define for_each_context(priv, ctx) \
1452 for (ctx = &priv->contexts[IWL_RXON_CTX_BSS]; \
1453 ctx < &priv->contexts[NUM_IWL_RXON_CTX]; ctx++) \
1454 if (priv->valid_contexts & BIT(ctx->ctxid))
1456 static inline int iwl_is_associated_ctx(struct iwl_rxon_context
*ctx
)
1458 return (ctx
->active
.filter_flags
& RXON_FILTER_ASSOC_MSK
) ? 1 : 0;
1461 static inline int iwl_is_associated(struct iwl_priv
*priv
,
1462 enum iwl_rxon_context_id ctxid
)
1464 return iwl_is_associated_ctx(&priv
->contexts
[ctxid
]);
1467 static inline int iwl_is_any_associated(struct iwl_priv
*priv
)
1469 struct iwl_rxon_context
*ctx
;
1470 for_each_context(priv
, ctx
)
1471 if (iwl_is_associated_ctx(ctx
))
1476 static inline int is_channel_valid(const struct iwl_channel_info
*ch_info
)
1478 if (ch_info
== NULL
)
1480 return (ch_info
->flags
& EEPROM_CHANNEL_VALID
) ? 1 : 0;
1483 static inline int is_channel_radar(const struct iwl_channel_info
*ch_info
)
1485 return (ch_info
->flags
& EEPROM_CHANNEL_RADAR
) ? 1 : 0;
1488 static inline u8
is_channel_a_band(const struct iwl_channel_info
*ch_info
)
1490 return ch_info
->band
== IEEE80211_BAND_5GHZ
;
1493 static inline u8
is_channel_bg_band(const struct iwl_channel_info
*ch_info
)
1495 return ch_info
->band
== IEEE80211_BAND_2GHZ
;
1498 static inline int is_channel_passive(const struct iwl_channel_info
*ch
)
1500 return (!(ch
->flags
& EEPROM_CHANNEL_ACTIVE
)) ? 1 : 0;
1503 static inline int is_channel_ibss(const struct iwl_channel_info
*ch
)
1505 return ((ch
->flags
& EEPROM_CHANNEL_IBSS
)) ? 1 : 0;
1508 #endif /* __iwl_dev_h__ */