1 /******************************************************************************
3 * Copyright(c) 2003 - 2010 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.
29 * Please use iwl-4965-hw.h for hardware-related definitions.
35 #include <linux/pci.h> /* for struct pci_device_id */
36 #include <linux/kernel.h>
37 #include <net/ieee80211_radiotap.h>
39 #include "iwl-eeprom.h"
43 #include "iwl-debug.h"
44 #include "iwl-4965-hw.h"
45 #include "iwl-3945-hw.h"
46 #include "iwl-agn-hw.h"
48 #include "iwl-power.h"
49 #include "iwl-agn-rs.h"
50 #include "iwl-agn-tt.h"
54 /* CT-KILL constants */
55 #define CT_KILL_THRESHOLD_LEGACY 110 /* in Celsius */
56 #define CT_KILL_THRESHOLD 114 /* in Celsius */
57 #define CT_KILL_EXIT_THRESHOLD 95 /* in Celsius */
59 /* Default noise level to report when noise measurement is not available.
60 * This may be because we're:
61 * 1) Not associated (4965, no beacon statistics being sent to driver)
62 * 2) Scanning (noise measurement does not apply to associated channel)
63 * 3) Receiving CCK (3945 delivers noise info only for OFDM frames)
64 * Use default noise value of -127 ... this is below the range of measurable
65 * Rx dBm for either 3945 or 4965, so it can indicate "unmeasurable" to user.
66 * Also, -127 works better than 0 when averaging frames with/without
67 * noise info (e.g. averaging might be done in app); measured dBm values are
68 * always negative ... using a negative value as the default keeps all
69 * averages within an s8's (used in some apps) range of negative values. */
70 #define IWL_NOISE_MEAS_NOT_AVAILABLE (-127)
73 * RTS threshold here is total size [2347] minus 4 FCS bytes
75 * a value of 0 means RTS on all data/management packets
76 * a value > max MSDU size means no RTS
77 * else RTS for data/management frames where MPDU is larger
80 #define DEFAULT_RTS_THRESHOLD 2347U
81 #define MIN_RTS_THRESHOLD 0U
82 #define MAX_RTS_THRESHOLD 2347U
83 #define MAX_MSDU_SIZE 2304U
84 #define MAX_MPDU_SIZE 2346U
85 #define DEFAULT_BEACON_INTERVAL 100U
86 #define DEFAULT_SHORT_RETRY_LIMIT 7U
87 #define DEFAULT_LONG_RETRY_LIMIT 4U
89 struct iwl_rx_mem_buffer
{
92 struct list_head list
;
95 #define rxb_addr(r) page_address(r->page)
98 struct iwl_device_cmd
;
100 struct iwl_cmd_meta
{
101 /* only for SYNC commands, iff the reply skb is wanted */
102 struct iwl_host_cmd
*source
;
104 * only for ASYNC commands
105 * (which is somewhat stupid -- look at iwl-sta.c for instance
106 * which duplicates a bunch of code because the callback isn't
107 * invoked for SYNC commands, if it were and its result passed
108 * through it would be simpler...)
110 void (*callback
)(struct iwl_priv
*priv
,
111 struct iwl_device_cmd
*cmd
,
112 struct iwl_rx_packet
*pkt
);
114 /* The CMD_SIZE_HUGE flag bit indicates that the command
115 * structure is stored at the end of the shared queue memory. */
118 DEFINE_DMA_UNMAP_ADDR(mapping
);
119 DEFINE_DMA_UNMAP_LEN(len
);
123 * Generic queue structure
125 * Contains common data for Rx and Tx queues
128 int n_bd
; /* number of BDs in this queue */
129 int write_ptr
; /* 1-st empty entry (index) host_w*/
130 int read_ptr
; /* last used entry (index) host_r*/
131 /* use for monitoring and recovering the stuck queue */
132 int last_read_ptr
; /* storing the last read_ptr */
133 /* number of time read_ptr and last_read_ptr are the same */
134 u8 repeat_same_read_ptr
;
135 dma_addr_t dma_addr
; /* physical addr for BD's */
136 int n_window
; /* safe queue window */
138 int low_mark
; /* low watermark, resume queue if free
139 * space more than this */
140 int high_mark
; /* high watermark, stop queue if free
141 * space less than this */
144 /* One for each TFD */
150 * struct iwl_tx_queue - Tx Queue for DMA
151 * @q: generic Rx/Tx queue descriptor
152 * @bd: base of circular buffer of TFDs
153 * @cmd: array of command/TX buffer pointers
154 * @meta: array of meta data for each command/tx buffer
155 * @dma_addr_cmd: physical address of cmd/tx buffer array
156 * @txb: array of per-TFD driver data
157 * @need_update: indicates need to update read/write index
158 * @sched_retry: indicates queue is high-throughput aggregation (HT AGG) enabled
160 * A Tx queue consists of circular buffer of BDs (a.k.a. TFDs, transmit frame
161 * descriptors) and required locking structures.
163 #define TFD_TX_CMD_SLOTS 256
164 #define TFD_CMD_SLOTS 32
166 struct iwl_tx_queue
{
169 struct iwl_device_cmd
**cmd
;
170 struct iwl_cmd_meta
*meta
;
171 struct iwl_tx_info
*txb
;
178 #define IWL_NUM_SCAN_RATES (2)
180 struct iwl4965_channel_tgd_info
{
185 struct iwl4965_channel_tgh_info
{
189 #define IWL4965_MAX_RATE (33)
191 struct iwl3945_clip_group
{
192 /* maximum power level to prevent clipping for each rate, derived by
193 * us from this band's saturation power in EEPROM */
194 const s8 clip_powers
[IWL_MAX_RATES
];
197 /* current Tx power values to use, one for each rate for each channel.
198 * requested power is limited by:
199 * -- regulatory EEPROM limits for this channel
200 * -- hardware capabilities (clip-powers)
201 * -- spectrum management
202 * -- user preference (e.g. iwconfig)
203 * when requested power is set, base power index must also be set. */
204 struct iwl3945_channel_power_info
{
205 struct iwl3945_tx_power tpc
; /* actual radio and DSP gain settings */
206 s8 power_table_index
; /* actual (compenst'd) index into gain table */
207 s8 base_power_index
; /* gain index for power at factory temp. */
208 s8 requested_power
; /* power (dBm) requested for this chnl/rate */
211 /* current scan Tx power values to use, one for each scan rate for each
213 struct iwl3945_scan_power_info
{
214 struct iwl3945_tx_power tpc
; /* actual radio and DSP gain settings */
215 s8 power_table_index
; /* actual (compenst'd) index into gain table */
216 s8 requested_power
; /* scan pwr (dBm) requested for chnl/rate */
220 * One for each channel, holds all channel setup data
221 * Some of the fields (e.g. eeprom and flags/max_power_avg) are redundant
224 struct iwl_channel_info
{
225 struct iwl4965_channel_tgd_info tgd
;
226 struct iwl4965_channel_tgh_info tgh
;
227 struct iwl_eeprom_channel eeprom
; /* EEPROM regulatory limit */
228 struct iwl_eeprom_channel ht40_eeprom
; /* EEPROM regulatory limit for
231 u8 channel
; /* channel number */
232 u8 flags
; /* flags copied from EEPROM */
233 s8 max_power_avg
; /* (dBm) regul. eeprom, normal Tx, any rate */
234 s8 curr_txpow
; /* (dBm) regulatory/spectrum/user (not h/w) limit */
235 s8 min_power
; /* always 0 */
236 s8 scan_power
; /* (dBm) regul. eeprom, direct scans, any rate */
238 u8 group_index
; /* 0-4, maps channel to group1/2/3/4/5 */
239 u8 band_index
; /* 0-4, maps channel to band1/2/3/4/5 */
240 enum ieee80211_band band
;
242 /* HT40 channel info */
243 s8 ht40_max_power_avg
; /* (dBm) regul. eeprom, normal Tx, any rate */
244 u8 ht40_flags
; /* flags copied from EEPROM */
245 u8 ht40_extension_channel
; /* HT_IE_EXT_CHANNEL_* */
247 /* Radio/DSP gain settings for each "normal" data Tx rate.
248 * These include, in addition to RF and DSP gain, a few fields for
249 * remembering/modifying gain settings (indexes). */
250 struct iwl3945_channel_power_info power_info
[IWL4965_MAX_RATE
];
252 /* Radio/DSP gain settings for each scan rate, for directed scans. */
253 struct iwl3945_scan_power_info scan_pwr_info
[IWL_NUM_SCAN_RATES
];
256 #define IWL_TX_FIFO_BK 0
257 #define IWL_TX_FIFO_BE 1
258 #define IWL_TX_FIFO_VI 2
259 #define IWL_TX_FIFO_VO 3
260 #define IWL_TX_FIFO_UNUSED -1
262 /* Minimum number of queues. MAX_NUM is defined in hw specific files.
263 * Set the minimum to accommodate the 4 standard TX queues, 1 command
264 * queue, 2 (unused) HCCA queues, and 4 HT queues (one for each AC) */
265 #define IWL_MIN_NUM_QUEUES 10
268 * Queue #4 is the command queue for 3945/4965/5x00/1000/6x00,
269 * the driver maps it into the appropriate device FIFO for the
272 #define IWL_CMD_QUEUE_NUM 4
274 /* Power management (not Tx power) structures */
281 #define IEEE80211_DATA_LEN 2304
282 #define IEEE80211_4ADDR_LEN 30
283 #define IEEE80211_HLEN (IEEE80211_4ADDR_LEN)
284 #define IEEE80211_FRAME_LEN (IEEE80211_DATA_LEN + IEEE80211_HLEN)
288 struct ieee80211_hdr frame
;
289 struct iwl_tx_beacon_cmd beacon
;
290 u8 raw
[IEEE80211_FRAME_LEN
];
293 struct list_head list
;
296 #define SEQ_TO_SN(seq) (((seq) & IEEE80211_SCTL_SEQ) >> 4)
297 #define SN_TO_SEQ(ssn) (((ssn) << 4) & IEEE80211_SCTL_SEQ)
298 #define MAX_SN ((IEEE80211_SCTL_SEQ) >> 4)
304 CMD_SIZE_HUGE
= (1 << 0),
305 CMD_ASYNC
= (1 << 1),
306 CMD_WANT_SKB
= (1 << 2),
309 #define DEF_CMD_PAYLOAD_SIZE 320
312 * struct iwl_device_cmd
314 * For allocation of the command and tx queues, this establishes the overall
315 * size of the largest command we send to uCode, except for a scan command
316 * (which is relatively huge; space is allocated separately).
318 struct iwl_device_cmd
{
319 struct iwl_cmd_header hdr
; /* uCode API */
325 struct iwl_tx_cmd tx
;
326 struct iwl6000_channel_switch_cmd chswitch
;
327 u8 payload
[DEF_CMD_PAYLOAD_SIZE
];
331 #define TFD_MAX_PAYLOAD_SIZE (sizeof(struct iwl_device_cmd))
334 struct iwl_host_cmd
{
336 unsigned long reply_page
;
337 void (*callback
)(struct iwl_priv
*priv
,
338 struct iwl_device_cmd
*cmd
,
339 struct iwl_rx_packet
*pkt
);
345 #define SUP_RATE_11A_MAX_NUM_CHANNELS 8
346 #define SUP_RATE_11B_MAX_NUM_CHANNELS 4
347 #define SUP_RATE_11G_MAX_NUM_CHANNELS 12
350 * struct iwl_rx_queue - Rx queue
351 * @bd: driver's pointer to buffer of receive buffer descriptors (rbd)
352 * @bd_dma: bus address of buffer of receive buffer descriptors (rbd)
353 * @read: Shared index to newest available Rx buffer
354 * @write: Shared index to oldest written Rx packet
355 * @free_count: Number of pre-allocated buffers in rx_free
356 * @rx_free: list of free SKBs for use
357 * @rx_used: List of Rx buffers with no SKB
358 * @need_update: flag to indicate we need to update read/write index
359 * @rb_stts: driver's pointer to receive buffer status
360 * @rb_stts_dma: bus address of receive buffer status
362 * NOTE: rx_free and rx_used are used as a FIFO for iwl_rx_mem_buffers
364 struct iwl_rx_queue
{
367 struct iwl_rx_mem_buffer pool
[RX_QUEUE_SIZE
+ RX_FREE_BUFFERS
];
368 struct iwl_rx_mem_buffer
*queue
[RX_QUEUE_SIZE
];
373 struct list_head rx_free
;
374 struct list_head rx_used
;
376 struct iwl_rb_status
*rb_stts
;
377 dma_addr_t rb_stts_dma
;
381 #define IWL_SUPPORTED_RATES_IE_LEN 8
383 #define MAX_TID_COUNT 9
385 #define IWL_INVALID_RATE 0xFF
386 #define IWL_INVALID_VALUE -1
389 * struct iwl_ht_agg -- aggregation status while waiting for block-ack
390 * @txq_id: Tx queue used for Tx attempt
391 * @frame_count: # frames attempted by Tx command
392 * @wait_for_ba: Expect block-ack before next Tx reply
393 * @start_idx: Index of 1st Transmit Frame Descriptor (TFD) in Tx window
394 * @bitmap0: Low order bitmap, one bit for each frame pending ACK in Tx window
395 * @bitmap1: High order, one bit for each frame pending ACK in Tx window
396 * @rate_n_flags: Rate at which Tx was attempted
398 * If REPLY_TX indicates that aggregation was attempted, driver must wait
399 * for block ack (REPLY_COMPRESSED_BA). This struct stores tx reply info
400 * until block ack arrives.
409 #define IWL_AGG_OFF 0
411 #define IWL_EMPTYING_HW_QUEUE_ADDBA 2
412 #define IWL_EMPTYING_HW_QUEUE_DELBA 3
417 struct iwl_tid_data
{
418 u16 seq_number
; /* agn only */
420 struct iwl_ht_agg agg
;
430 union iwl_ht_rate_supp
{
438 #define CFG_HT_RX_AMPDU_FACTOR_8K (0x0)
439 #define CFG_HT_RX_AMPDU_FACTOR_16K (0x1)
440 #define CFG_HT_RX_AMPDU_FACTOR_32K (0x2)
441 #define CFG_HT_RX_AMPDU_FACTOR_64K (0x3)
442 #define CFG_HT_RX_AMPDU_FACTOR_DEF CFG_HT_RX_AMPDU_FACTOR_64K
443 #define CFG_HT_RX_AMPDU_FACTOR_MAX CFG_HT_RX_AMPDU_FACTOR_64K
444 #define CFG_HT_RX_AMPDU_FACTOR_MIN CFG_HT_RX_AMPDU_FACTOR_8K
447 * Maximal MPDU density for TX aggregation
453 #define CFG_HT_MPDU_DENSITY_2USEC (0x4)
454 #define CFG_HT_MPDU_DENSITY_4USEC (0x5)
455 #define CFG_HT_MPDU_DENSITY_8USEC (0x6)
456 #define CFG_HT_MPDU_DENSITY_16USEC (0x7)
457 #define CFG_HT_MPDU_DENSITY_DEF CFG_HT_MPDU_DENSITY_4USEC
458 #define CFG_HT_MPDU_DENSITY_MAX CFG_HT_MPDU_DENSITY_16USEC
459 #define CFG_HT_MPDU_DENSITY_MIN (0x1)
461 struct iwl_ht_config
{
462 /* self configuration data */
465 bool single_chain_sufficient
;
466 enum ieee80211_smps_mode smps
; /* current smps mode */
467 /* BSS related data */
468 u8 extension_chan_offset
;
470 u8 non_GF_STA_present
;
474 struct iwl_qos_info
{
476 struct iwl_qosparam_cmd def_qos_parm
;
480 * Structure should be accessed with sta_lock held. When station addition
481 * is in progress (IWL_STA_UCODE_INPROGRESS) it is possible to access only
482 * the commands (iwl_addsta_cmd and iwl_link_quality_cmd) without sta_lock
485 struct iwl_station_entry
{
486 struct iwl_addsta_cmd sta
;
487 struct iwl_tid_data tid
[MAX_TID_COUNT
];
489 struct iwl_hw_key keyinfo
;
490 struct iwl_link_quality_cmd
*lq
;
493 struct iwl_station_priv_common
{
498 * iwl_station_priv: Driver's private station information
500 * When mac80211 creates a station it reserves some space (hw->sta_data_size)
501 * in the structure for use by driver. This structure is places in that
504 * The common struct MUST be first because it is shared between
507 struct iwl_station_priv
{
508 struct iwl_station_priv_common common
;
509 struct iwl_lq_sta lq_sta
;
510 atomic_t pending_frames
;
516 * struct iwl_vif_priv - driver's private per-interface information
518 * When mac80211 allocates a virtual interface, it can allocate
519 * space for us to put data into.
521 struct iwl_vif_priv
{
522 u8 ibss_bssid_sta_id
;
525 /* one for each uCode image (inst/data, boot/init/runtime) */
527 void *v_addr
; /* access by driver */
528 dma_addr_t p_addr
; /* access by card's busmaster DMA */
532 /* v1/v2 uCode file layout */
533 struct iwl_ucode_header
{
534 __le32 ver
; /* major/minor/API/serial */
537 __le32 inst_size
; /* bytes of runtime code */
538 __le32 data_size
; /* bytes of runtime data */
539 __le32 init_size
; /* bytes of init code */
540 __le32 init_data_size
; /* bytes of init data */
541 __le32 boot_size
; /* bytes of bootstrap code */
542 u8 data
[0]; /* in same order as sizes */
545 __le32 build
; /* build number */
546 __le32 inst_size
; /* bytes of runtime code */
547 __le32 data_size
; /* bytes of runtime data */
548 __le32 init_size
; /* bytes of init code */
549 __le32 init_data_size
; /* bytes of init data */
550 __le32 boot_size
; /* bytes of bootstrap code */
551 u8 data
[0]; /* in same order as sizes */
557 * new TLV uCode file layout
559 * The new TLV file format contains TLVs, that each specify
560 * some piece of data. To facilitate "groups", for example
561 * different instruction image with different capabilities,
562 * bundled with the same init image, an alternative mechanism
564 * When the alternative field is 0, that means that the item
565 * is always valid. When it is non-zero, then it is only
566 * valid in conjunction with items of the same alternative,
567 * in which case the driver (user) selects one alternative
571 enum iwl_ucode_tlv_type
{
572 IWL_UCODE_TLV_INVALID
= 0, /* unused */
573 IWL_UCODE_TLV_INST
= 1,
574 IWL_UCODE_TLV_DATA
= 2,
575 IWL_UCODE_TLV_INIT
= 3,
576 IWL_UCODE_TLV_INIT_DATA
= 4,
577 IWL_UCODE_TLV_BOOT
= 5,
578 IWL_UCODE_TLV_PROBE_MAX_LEN
= 6, /* a u32 value */
579 IWL_UCODE_TLV_RUNT_EVTLOG_PTR
= 8,
580 IWL_UCODE_TLV_RUNT_EVTLOG_SIZE
= 9,
581 IWL_UCODE_TLV_RUNT_ERRLOG_PTR
= 10,
582 IWL_UCODE_TLV_INIT_EVTLOG_PTR
= 11,
583 IWL_UCODE_TLV_INIT_EVTLOG_SIZE
= 12,
584 IWL_UCODE_TLV_INIT_ERRLOG_PTR
= 13,
585 IWL_UCODE_TLV_ENHANCE_SENS_TBL
= 14,
586 IWL_UCODE_TLV_PHY_CALIBRATION_SIZE
= 15,
589 struct iwl_ucode_tlv
{
590 __le16 type
; /* see above */
591 __le16 alternative
; /* see comment */
592 __le32 length
; /* not including type/length fields */
596 #define IWL_TLV_UCODE_MAGIC 0x0a4c5749
598 struct iwl_tlv_ucode_header
{
600 * The TLV style ucode header is distinguished from
601 * the v1/v2 style header by first four bytes being
602 * zero, as such is an invalid combination of
603 * major/minor/API/serial versions.
607 u8 human_readable
[64];
608 __le32 ver
; /* major/minor/API/serial */
610 __le64 alternatives
; /* bitmask of valid alternatives */
612 * The data contained herein has a TLV layout,
613 * see above for the TLV header and types.
614 * Note that each TLV is padded to a length
615 * that is a multiple of 4 for alignment.
620 struct iwl4965_ibss_seq
{
624 unsigned long packet_time
;
625 struct list_head list
;
628 struct iwl_sensitivity_ranges
{
635 u16 auto_corr_min_ofdm
;
636 u16 auto_corr_min_ofdm_mrc
;
637 u16 auto_corr_min_ofdm_x1
;
638 u16 auto_corr_min_ofdm_mrc_x1
;
640 u16 auto_corr_max_ofdm
;
641 u16 auto_corr_max_ofdm_mrc
;
642 u16 auto_corr_max_ofdm_x1
;
643 u16 auto_corr_max_ofdm_mrc_x1
;
645 u16 auto_corr_max_cck
;
646 u16 auto_corr_max_cck_mrc
;
647 u16 auto_corr_min_cck
;
648 u16 auto_corr_min_cck_mrc
;
650 u16 barker_corr_th_min
;
651 u16 barker_corr_th_min_mrc
;
656 #define KELVIN_TO_CELSIUS(x) ((x)-273)
657 #define CELSIUS_TO_KELVIN(x) ((x)+273)
661 * struct iwl_hw_params
662 * @max_txq_num: Max # Tx queues supported
663 * @dma_chnl_num: Number of Tx DMA/FIFO channels
664 * @scd_bc_tbls_size: size of scheduler byte count tables
665 * @tfd_size: TFD size
666 * @tx/rx_chains_num: Number of TX/RX chains
667 * @valid_tx/rx_ant: usable antennas
668 * @max_rxq_size: Max # Rx frames in Rx queue (must be power-of-2)
669 * @max_rxq_log: Log-base-2 of max_rxq_size
670 * @rx_page_order: Rx buffer page order
671 * @rx_wrt_ptr_reg: FH{39}_RSCSR_CHNL0_WPTR
674 * @ht40_channel: is 40MHz width possible in band 2.4
675 * BIT(IEEE80211_BAND_5GHZ) BIT(IEEE80211_BAND_5GHZ)
676 * @sw_crypto: 0 for hw, 1 for sw
677 * @max_xxx_size: for ucode uses
678 * @ct_kill_threshold: temperature threshold
679 * @beacon_time_tsf_bits: number of valid tsf bits for beacon time
680 * @calib_init_cfg: setup initial calibrations for the hw
681 * @struct iwl_sensitivity_ranges: range of sensitivity values
683 struct iwl_hw_params
{
686 u16 scd_bc_tbls_size
;
699 u8 max_beacon_itrvl
; /* in 1024 ms */
703 u32 ct_kill_threshold
; /* value in hw-dependent units */
704 u32 ct_kill_exit_threshold
; /* value in hw-dependent units */
705 /* for 1000, 6000 series and up */
706 u16 beacon_time_tsf_bits
;
708 const struct iwl_sensitivity_ranges
*sens
;
712 /******************************************************************************
714 * Functions implemented in core module which are forward declared here
715 * for use by iwl-[4-5].c
717 * NOTE: The implementation of these functions are not hardware specific
718 * which is why they are in the core module files.
720 * Naming convention --
721 * iwl_ <-- Is part of iwlwifi
722 * iwlXXXX_ <-- Hardware specific (implemented in iwl-XXXX.c for XXXX)
723 * iwl4965_bg_ <-- Called from work queue context
724 * iwl4965_mac_ <-- mac80211 callback
726 ****************************************************************************/
727 extern void iwl_update_chain_flags(struct iwl_priv
*priv
);
728 extern int iwl_set_pwr_src(struct iwl_priv
*priv
, enum iwl_pwr_src src
);
729 extern const u8 iwl_bcast_addr
[ETH_ALEN
];
730 extern int iwl_rxq_stop(struct iwl_priv
*priv
);
731 extern void iwl_txq_ctx_stop(struct iwl_priv
*priv
);
732 extern int iwl_queue_space(const struct iwl_queue
*q
);
733 static inline int iwl_queue_used(const struct iwl_queue
*q
, int i
)
735 return q
->write_ptr
>= q
->read_ptr
?
736 (i
>= q
->read_ptr
&& i
< q
->write_ptr
) :
737 !(i
< q
->read_ptr
&& i
>= q
->write_ptr
);
741 static inline u8
get_cmd_index(struct iwl_queue
*q
, u32 index
, int is_huge
)
744 * This is for init calibration result and scan command which
745 * required buffer > TFD_MAX_PAYLOAD_SIZE,
746 * the big buffer at end of command array
749 return q
->n_window
; /* must be power of 2 */
751 /* Otherwise, use normal size buffers */
752 return index
& (q
->n_window
- 1);
762 #define IWL_OPERATION_MODE_AUTO 0
763 #define IWL_OPERATION_MODE_HT_ONLY 1
764 #define IWL_OPERATION_MODE_MIXED 2
765 #define IWL_OPERATION_MODE_20MHZ 3
767 #define IWL_TX_CRC_SIZE 4
768 #define IWL_TX_DELIMITER_SIZE 4
770 #define TX_POWER_IWL_ILLEGAL_VOLTAGE -10000
772 /* Sensitivity and chain noise calibration */
773 #define INITIALIZATION_VALUE 0xFFFF
774 #define IWL4965_CAL_NUM_BEACONS 20
775 #define IWL_CAL_NUM_BEACONS 16
776 #define MAXIMUM_ALLOWED_PATHLOSS 15
778 #define CHAIN_NOISE_MAX_DELTA_GAIN_CODE 3
780 #define MAX_FA_OFDM 50
781 #define MIN_FA_OFDM 5
782 #define MAX_FA_CCK 50
785 #define AUTO_CORR_STEP_OFDM 1
787 #define AUTO_CORR_STEP_CCK 3
788 #define AUTO_CORR_MAX_TH_CCK 160
791 #define NRG_STEP_CCK 2
793 #define MAX_NUMBER_CCK_NO_FA 100
795 #define AUTO_CORR_CCK_MIN_VAL_DEF (125)
800 #define CHAIN_NOISE_DELTA_GAIN_INIT_VAL 4
801 #define ALL_BAND_FILTER 0xFF00
802 #define IN_BAND_FILTER 0xFF
803 #define MIN_AVERAGE_NOISE_MAX_VALUE 0xFFFFFFFF
805 #define NRG_NUM_PREV_STAT_L 20
806 #define NUM_RX_CHAINS 3
808 enum iwl4965_false_alarm_state
{
811 IWL_FA_GOOD_RANGE
= 2,
814 enum iwl4965_chain_noise_state
{
815 IWL_CHAIN_NOISE_ALIVE
= 0, /* must be 0 */
816 IWL_CHAIN_NOISE_ACCUMULATE
,
817 IWL_CHAIN_NOISE_CALIBRATED
,
818 IWL_CHAIN_NOISE_DONE
,
821 enum iwl4965_calib_enabled_state
{
822 IWL_CALIB_DISABLED
= 0, /* must be 0 */
823 IWL_CALIB_ENABLED
= 1,
829 * defines the order in which results of initial calibrations
830 * should be sent to the runtime uCode
837 IWL_CALIB_TX_IQ_PERD
,
842 /* Opaque calibration results */
843 struct iwl_calib_result
{
854 /* Sensitivity calib data */
855 struct iwl_sensitivity_data
{
857 u32 auto_corr_ofdm_mrc
;
858 u32 auto_corr_ofdm_x1
;
859 u32 auto_corr_ofdm_mrc_x1
;
861 u32 auto_corr_cck_mrc
;
863 u32 last_bad_plcp_cnt_ofdm
;
864 u32 last_fa_cnt_ofdm
;
865 u32 last_bad_plcp_cnt_cck
;
871 u8 nrg_silence_rssi
[NRG_NUM_PREV_STAT_L
];
876 s32 nrg_auto_corr_silence_diff
;
877 u32 num_in_cck_no_fa
;
880 u16 barker_corr_th_min
;
881 u16 barker_corr_th_min_mrc
;
885 /* Chain noise (differential Rx gain) calib data */
886 struct iwl_chain_noise_data
{
895 u8 disconn_array
[NUM_RX_CHAINS
];
896 u8 delta_gain_code
[NUM_RX_CHAINS
];
901 #define EEPROM_SEM_TIMEOUT 10 /* milliseconds */
902 #define EEPROM_SEM_RETRY_LIMIT 1000 /* number of attempts (not time) */
904 #define IWL_TRAFFIC_ENTRIES (256)
905 #define IWL_TRAFFIC_ENTRY_SIZE (64)
908 MEASUREMENT_READY
= (1 << 0),
909 MEASUREMENT_ACTIVE
= (1 << 1),
913 NVM_DEVICE_TYPE_EEPROM
= 0,
918 * Two types of OTP memory access modes
919 * IWL_OTP_ACCESS_ABSOLUTE - absolute address mode,
920 * based on physical memory addressing
921 * IWL_OTP_ACCESS_RELATIVE - relative address mode,
922 * based on logical memory addressing
924 enum iwl_access_mode
{
925 IWL_OTP_ACCESS_ABSOLUTE
,
926 IWL_OTP_ACCESS_RELATIVE
,
930 * enum iwl_pa_type - Power Amplifier type
931 * @IWL_PA_SYSTEM: based on uCode configuration
932 * @IWL_PA_INTERNAL: use Internal only
939 /* interrupt statistics */
940 struct isr_statistics
{
950 u32 rx_handlers
[REPLY_MAX
];
955 #ifdef CONFIG_IWLWIFI_DEBUGFS
956 /* management statistics */
957 enum iwl_mgmt_stats
{
958 MANAGEMENT_ASSOC_REQ
= 0,
959 MANAGEMENT_ASSOC_RESP
,
960 MANAGEMENT_REASSOC_REQ
,
961 MANAGEMENT_REASSOC_RESP
,
962 MANAGEMENT_PROBE_REQ
,
963 MANAGEMENT_PROBE_RESP
,
972 /* control statistics */
973 enum iwl_ctrl_stats
{
974 CONTROL_BACK_REQ
= 0,
985 struct traffic_stats
{
986 u32 mgmt
[MANAGEMENT_MAX
];
987 u32 ctrl
[CONTROL_MAX
];
992 struct traffic_stats
{
998 * iwl_switch_rxon: "channel switch" structure
1000 * @ switch_in_progress: channel switch in progress
1001 * @ channel: new channel
1003 struct iwl_switch_rxon
{
1004 bool switch_in_progress
;
1009 * schedule the timer to wake up every UCODE_TRACE_PERIOD milliseconds
1010 * to perform continuous uCode event logging operation if enabled
1012 #define UCODE_TRACE_PERIOD (100)
1015 * iwl_event_log: current uCode event log position
1017 * @ucode_trace: enable/disable ucode continuous trace timer
1018 * @num_wraps: how many times the event buffer wraps
1019 * @next_entry: the entry just before the next one that uCode would fill
1020 * @non_wraps_count: counter for no wrap detected when dump ucode events
1021 * @wraps_once_count: counter for wrap once detected when dump ucode events
1022 * @wraps_more_count: counter for wrap more than once detected
1023 * when dump ucode events
1025 struct iwl_event_log
{
1029 int non_wraps_count
;
1030 int wraps_once_count
;
1031 int wraps_more_count
;
1035 * host interrupt timeout value
1036 * used with setting interrupt coalescing timer
1037 * the CSR_INT_COALESCING is an 8 bit register in 32-usec unit
1039 * default interrupt coalescing timer is 64 x 32 = 2048 usecs
1040 * default interrupt coalescing calibration timer is 16 x 32 = 512 usecs
1042 #define IWL_HOST_INT_TIMEOUT_MAX (0xFF)
1043 #define IWL_HOST_INT_TIMEOUT_DEF (0x40)
1044 #define IWL_HOST_INT_TIMEOUT_MIN (0x0)
1045 #define IWL_HOST_INT_CALIB_TIMEOUT_MAX (0xFF)
1046 #define IWL_HOST_INT_CALIB_TIMEOUT_DEF (0x10)
1047 #define IWL_HOST_INT_CALIB_TIMEOUT_MIN (0x0)
1050 * This is the threshold value of plcp error rate per 100mSecs. It is
1051 * used to set and check for the validity of plcp_delta.
1053 #define IWL_MAX_PLCP_ERR_THRESHOLD_MIN (1)
1054 #define IWL_MAX_PLCP_ERR_THRESHOLD_DEF (50)
1055 #define IWL_MAX_PLCP_ERR_LONG_THRESHOLD_DEF (100)
1056 #define IWL_MAX_PLCP_ERR_EXT_LONG_THRESHOLD_DEF (200)
1057 #define IWL_MAX_PLCP_ERR_THRESHOLD_MAX (255)
1058 #define IWL_MAX_PLCP_ERR_THRESHOLD_DISABLE (0)
1060 #define IWL_DELAY_NEXT_FORCE_RF_RESET (HZ*3)
1061 #define IWL_DELAY_NEXT_FORCE_FW_RELOAD (HZ*5)
1063 /* timer constants use to monitor and recover stuck tx queues in mSecs */
1064 #define IWL_DEF_MONITORING_PERIOD (1000)
1065 #define IWL_LONG_MONITORING_PERIOD (5000)
1066 #define IWL_ONE_HUNDRED_MSECS (100)
1067 #define IWL_MAX_MONITORING_PERIOD (60000)
1069 /* BT Antenna Coupling Threshold (dB) */
1070 #define IWL_BT_ANTENNA_COUPLING_THRESHOLD (35)
1075 IWL_MAX_FORCE_RESET
,
1078 struct iwl_force_reset
{
1079 int reset_request_count
;
1080 int reset_success_count
;
1081 int reset_reject_count
;
1082 unsigned long reset_duration
;
1083 unsigned long last_force_reset_jiffies
;
1086 /* extend beacon time format bit shifting */
1089 * bits 31:24 - extended
1090 * bits 23:0 - interval
1092 #define IWL3945_EXT_BEACON_TIME_POS 24
1095 * bits 31:22 - extended
1096 * bits 21:0 - interval
1098 #define IWLAGN_EXT_BEACON_TIME_POS 22
1102 /* ieee device used by generic ieee processing code */
1103 struct ieee80211_hw
*hw
;
1104 struct ieee80211_channel
*ieee_channels
;
1105 struct ieee80211_rate
*ieee_rates
;
1106 struct iwl_cfg
*cfg
;
1108 /* temporary frame storage list */
1109 struct list_head free_frames
;
1112 enum ieee80211_band band
;
1115 void (*rx_handlers
[REPLY_MAX
])(struct iwl_priv
*priv
,
1116 struct iwl_rx_mem_buffer
*rxb
);
1118 struct ieee80211_supported_band bands
[IEEE80211_NUM_BANDS
];
1120 /* spectrum measurement report caching */
1121 struct iwl_spectrum_notification measure_report
;
1122 u8 measurement_status
;
1124 /* ucode beacon time */
1125 u32 ucode_beacon_time
;
1126 int missed_beacon_threshold
;
1128 /* track IBSS manager (last beacon) status */
1131 /* storing the jiffies when the plcp error rate is received */
1132 unsigned long plcp_jiffies
;
1135 struct iwl_force_reset force_reset
[IWL_MAX_FORCE_RESET
];
1137 /* we allocate array of iwl_channel_info for NIC's valid channels.
1138 * Access via channel # using indirect index array */
1139 struct iwl_channel_info
*channel_info
; /* channel info array */
1140 u8 channel_count
; /* # of channels */
1142 /* thermal calibration */
1143 s32 temperature
; /* degrees Kelvin */
1144 s32 last_temperature
;
1146 /* init calibration results */
1147 struct iwl_calib_result calib_results
[IWL_CALIB_MAX
];
1149 /* Scan related variables */
1150 unsigned long scan_start
;
1151 unsigned long scan_start_tsf
;
1153 enum ieee80211_band scan_band
;
1154 struct cfg80211_scan_request
*scan_request
;
1155 struct ieee80211_vif
*scan_vif
;
1156 bool is_internal_short_scan
;
1157 u8 scan_tx_ant
[IEEE80211_NUM_BANDS
];
1161 spinlock_t lock
; /* protect general shared data */
1162 spinlock_t hcmd_lock
; /* protect hcmd */
1163 spinlock_t reg_lock
; /* protect hw register access */
1165 struct mutex sync_cmd_mutex
; /* enable serialization of sync commands */
1167 /* basic pci-network driver stuff */
1168 struct pci_dev
*pci_dev
;
1170 /* pci hardware address support */
1171 void __iomem
*hw_base
;
1176 /* EEPROM MAC addresses */
1177 struct mac_address addresses
[2];
1179 /* uCode images, save to reload in case of failure */
1180 int fw_index
; /* firmware we're trying to load */
1181 u32 ucode_ver
; /* version of ucode, copy of
1183 struct fw_desc ucode_code
; /* runtime inst */
1184 struct fw_desc ucode_data
; /* runtime data original */
1185 struct fw_desc ucode_data_backup
; /* runtime data save/restore */
1186 struct fw_desc ucode_init
; /* initialization inst */
1187 struct fw_desc ucode_init_data
; /* initialization data */
1188 struct fw_desc ucode_boot
; /* bootstrap inst */
1189 enum ucode_type ucode_type
;
1190 u8 ucode_write_complete
; /* the image write is complete */
1191 char firmware_name
[25];
1194 struct iwl_rxon_time_cmd rxon_timing
;
1196 /* We declare this const so it can only be
1197 * changed via explicit cast within the
1198 * routines that actually update the physical
1200 const struct iwl_rxon_cmd active_rxon
;
1201 struct iwl_rxon_cmd staging_rxon
;
1203 struct iwl_switch_rxon switch_rxon
;
1205 /* 1st responses from initialize and runtime uCode images.
1206 * _agn's initialize alive response contains some calibration data. */
1207 struct iwl_init_alive_resp card_alive_init
;
1208 struct iwl_alive_resp card_alive
;
1210 unsigned long last_blink_time
;
1218 struct iwl_sensitivity_data sensitivity_data
;
1219 struct iwl_chain_noise_data chain_noise_data
;
1220 bool enhance_sensitivity_table
;
1221 __le16 sensitivity_tbl
[HD_TABLE_SIZE
];
1222 __le16 enhance_sensitivity_tbl
[ENHANCE_HD_TABLE_ENTRIES
];
1224 struct iwl_ht_config current_ht_config
;
1226 /* Rate scaling data */
1229 wait_queue_head_t wait_command_queue
;
1231 int activity_timer_active
;
1233 /* Rx and Tx DMA processing queues */
1234 struct iwl_rx_queue rxq
;
1235 struct iwl_tx_queue
*txq
;
1236 unsigned long txq_ctx_active_msk
;
1237 struct iwl_dma_ptr kw
; /* keep warm address */
1238 struct iwl_dma_ptr scd_bc_tbls
;
1240 u32 scd_base_addr
; /* scheduler sram base address */
1242 unsigned long status
;
1244 /* counts mgmt, ctl, and data packets */
1245 struct traffic_stats tx_stats
;
1246 struct traffic_stats rx_stats
;
1248 /* counts interrupts */
1249 struct isr_statistics isr_stats
;
1251 struct iwl_power_mgr power_data
;
1252 struct iwl_tt_mgmt thermal_throttle
;
1254 /* context information */
1255 u8 bssid
[ETH_ALEN
]; /* used only on 3945 but filled by core */
1257 /* station table variables */
1259 /* Note: if lock and sta_lock are needed, lock must be acquired first */
1260 spinlock_t sta_lock
;
1262 struct iwl_station_entry stations
[IWL_STATION_COUNT
];
1263 struct iwl_wep_key wep_keys
[WEP_KEYS_MAX
]; /* protected by mutex */
1265 unsigned long ucode_key_table
;
1267 /* queue refcounts */
1268 #define IWL_MAX_HW_QUEUES 32
1269 unsigned long queue_stopped
[BITS_TO_LONGS(IWL_MAX_HW_QUEUES
)];
1271 atomic_t queue_stop_count
[4];
1273 /* Indication if ieee80211_ops->open has been called */
1276 u8 mac80211_registered
;
1278 /* eeprom -- this is in the card's little endian byte order */
1280 int nvm_device_type
;
1281 struct iwl_eeprom_calib_info
*calib_info
;
1283 enum nl80211_iftype iw_mode
;
1285 struct sk_buff
*ibss_beacon
;
1287 /* Last Rx'd beacon timestamp */
1289 struct ieee80211_vif
*vif
;
1292 #if defined(CONFIG_IWL3945) || defined(CONFIG_IWL3945_MODULE)
1295 dma_addr_t shared_phys
;
1297 struct delayed_work thermal_periodic
;
1298 struct delayed_work rfkill_poll
;
1300 struct iwl3945_notif_statistics statistics
;
1301 #ifdef CONFIG_IWLWIFI_DEBUGFS
1302 struct iwl3945_notif_statistics accum_statistics
;
1303 struct iwl3945_notif_statistics delta_statistics
;
1304 struct iwl3945_notif_statistics max_delta
;
1308 int last_rx_rssi
; /* From Rx packet statistics */
1310 /* Rx'd packet timing information */
1311 u32 last_beacon_time
;
1315 * each calibration channel group in the
1316 * EEPROM has a derived clip setting for
1319 const struct iwl3945_clip_group clip_groups
[5];
1323 #if defined(CONFIG_IWLAGN) || defined(CONFIG_IWLAGN_MODULE)
1328 dma_addr_t ict_tbl_dma
;
1329 dma_addr_t aligned_ict_tbl_dma
;
1334 * reporting the number of tids has AGG on. 0 means
1339 struct iwl_rx_phy_res last_phy_res
;
1340 bool last_phy_res_valid
;
1342 struct completion firmware_loading_complete
;
1344 u32 init_evtlog_ptr
, init_evtlog_size
, init_errlog_ptr
;
1345 u32 inst_evtlog_ptr
, inst_evtlog_size
, inst_errlog_ptr
;
1348 * chain noise reset and gain commands are the
1349 * two extra calibration commands follows the standard
1350 * phy calibration commands
1352 u8 phy_calib_chain_noise_reset_cmd
;
1353 u8 phy_calib_chain_noise_gain_cmd
;
1355 struct iwl_notif_statistics statistics
;
1356 struct iwl_bt_notif_statistics statistics_bt
;
1357 #ifdef CONFIG_IWLWIFI_DEBUGFS
1358 struct iwl_notif_statistics accum_statistics
;
1359 struct iwl_notif_statistics delta_statistics
;
1360 struct iwl_notif_statistics max_delta
;
1361 struct iwl_bt_notif_statistics accum_statistics_bt
;
1362 struct iwl_bt_notif_statistics delta_statistics_bt
;
1363 struct iwl_bt_notif_statistics max_delta_bt
;
1369 u8 bt_traffic_load
, notif_bt_traffic_load
;
1371 bool bt_full_concurrent
;
1372 bool bt_ant_couple_ok
;
1373 u8 bt_ci_compliance
;
1374 struct work_struct bt_traffic_change_work
;
1376 struct iwl_hw_params hw_params
;
1380 struct iwl_qos_info qos_data
;
1382 struct workqueue_struct
*workqueue
;
1384 struct work_struct restart
;
1385 struct work_struct scan_completed
;
1386 struct work_struct rx_replenish
;
1387 struct work_struct abort_scan
;
1388 struct work_struct beacon_update
;
1389 struct work_struct tt_work
;
1390 struct work_struct ct_enter
;
1391 struct work_struct ct_exit
;
1392 struct work_struct start_internal_scan
;
1393 struct work_struct tx_flush
;
1394 struct work_struct bt_full_concurrency
;
1396 struct tasklet_struct irq_tasklet
;
1398 struct delayed_work init_alive_start
;
1399 struct delayed_work alive_start
;
1400 struct delayed_work scan_check
;
1403 s8 tx_power_user_lmt
;
1404 s8 tx_power_device_lmt
;
1405 s8 tx_power_lmt_in_half_dbm
; /* max tx power in half-dBm format */
1408 #ifdef CONFIG_IWLWIFI_DEBUG
1409 /* debugging info */
1410 u32 debug_level
; /* per device debugging will override global
1411 iwl_debug_level if set */
1412 #endif /* CONFIG_IWLWIFI_DEBUG */
1413 #ifdef CONFIG_IWLWIFI_DEBUGFS
1419 struct dentry
*debugfs_dir
;
1420 u32 dbgfs_sram_offset
, dbgfs_sram_len
;
1422 #endif /* CONFIG_IWLWIFI_DEBUGFS */
1424 struct work_struct txpower_work
;
1425 u32 disable_sens_cal
;
1426 u32 disable_chain_noise_cal
;
1427 u32 disable_tx_power_cal
;
1428 struct work_struct run_time_calib_work
;
1429 struct timer_list statistics_periodic
;
1430 struct timer_list ucode_trace
;
1431 struct timer_list monitor_recover
;
1434 struct iwl_event_log event_log
;
1437 static inline void iwl_txq_ctx_activate(struct iwl_priv
*priv
, int txq_id
)
1439 set_bit(txq_id
, &priv
->txq_ctx_active_msk
);
1442 static inline void iwl_txq_ctx_deactivate(struct iwl_priv
*priv
, int txq_id
)
1444 clear_bit(txq_id
, &priv
->txq_ctx_active_msk
);
1447 #ifdef CONFIG_IWLWIFI_DEBUG
1448 const char *iwl_get_tx_fail_reason(u32 status
);
1450 * iwl_get_debug_level: Return active debug level for device
1452 * Using sysfs it is possible to set per device debug level. This debug
1453 * level will be used if set, otherwise the global debug level which can be
1454 * set via module parameter is used.
1456 static inline u32
iwl_get_debug_level(struct iwl_priv
*priv
)
1458 if (priv
->debug_level
)
1459 return priv
->debug_level
;
1461 return iwl_debug_level
;
1464 static inline const char *iwl_get_tx_fail_reason(u32 status
) { return ""; }
1466 static inline u32
iwl_get_debug_level(struct iwl_priv
*priv
)
1468 return iwl_debug_level
;
1473 static inline struct ieee80211_hdr
*iwl_tx_queue_get_hdr(struct iwl_priv
*priv
,
1474 int txq_id
, int idx
)
1476 if (priv
->txq
[txq_id
].txb
[idx
].skb
)
1477 return (struct ieee80211_hdr
*)priv
->txq
[txq_id
].
1483 static inline int iwl_is_associated(struct iwl_priv
*priv
)
1485 return (priv
->active_rxon
.filter_flags
& RXON_FILTER_ASSOC_MSK
) ? 1 : 0;
1488 static inline int is_channel_valid(const struct iwl_channel_info
*ch_info
)
1490 if (ch_info
== NULL
)
1492 return (ch_info
->flags
& EEPROM_CHANNEL_VALID
) ? 1 : 0;
1495 static inline int is_channel_radar(const struct iwl_channel_info
*ch_info
)
1497 return (ch_info
->flags
& EEPROM_CHANNEL_RADAR
) ? 1 : 0;
1500 static inline u8
is_channel_a_band(const struct iwl_channel_info
*ch_info
)
1502 return ch_info
->band
== IEEE80211_BAND_5GHZ
;
1505 static inline u8
is_channel_bg_band(const struct iwl_channel_info
*ch_info
)
1507 return ch_info
->band
== IEEE80211_BAND_2GHZ
;
1510 static inline int is_channel_passive(const struct iwl_channel_info
*ch
)
1512 return (!(ch
->flags
& EEPROM_CHANNEL_ACTIVE
)) ? 1 : 0;
1515 static inline int is_channel_ibss(const struct iwl_channel_info
*ch
)
1517 return ((ch
->flags
& EEPROM_CHANNEL_IBSS
)) ? 1 : 0;
1520 static inline void __iwl_free_pages(struct iwl_priv
*priv
, struct page
*page
)
1522 __free_pages(page
, priv
->hw_params
.rx_page_order
);
1523 priv
->alloc_rxb_page
--;
1526 static inline void iwl_free_pages(struct iwl_priv
*priv
, unsigned long page
)
1528 free_pages(page
, priv
->hw_params
.rx_page_order
);
1529 priv
->alloc_rxb_page
--;
1531 #endif /* __iwl_dev_h__ */