1 /******************************************************************************
3 * Copyright(c) 2003 - 2009 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"
47 #include "iwl-power.h"
48 #include "iwl-agn-rs.h"
50 /* configuration for the iwl4965 */
51 extern struct iwl_cfg iwl4965_agn_cfg;
52 extern struct iwl_cfg iwl5300_agn_cfg;
53 extern struct iwl_cfg iwl5100_agn_cfg;
54 extern struct iwl_cfg iwl5350_agn_cfg;
55 extern struct iwl_cfg iwl5100_bg_cfg;
56 extern struct iwl_cfg iwl5100_abg_cfg;
57 extern struct iwl_cfg iwl5150_agn_cfg;
58 extern struct iwl_cfg iwl6000h_2agn_cfg;
59 extern struct iwl_cfg iwl6000h_2abg_cfg;
60 extern struct iwl_cfg iwl6000h_2bg_cfg;
61 extern struct iwl_cfg iwl6000i_2agn_cfg;
62 extern struct iwl_cfg iwl6000i_2abg_cfg;
63 extern struct iwl_cfg iwl6000i_2bg_cfg;
64 extern struct iwl_cfg iwl6000_3agn_cfg;
65 extern struct iwl_cfg iwl6050_2agn_cfg;
66 extern struct iwl_cfg iwl6050_2abg_cfg;
67 extern struct iwl_cfg iwl6050_3agn_cfg;
68 extern struct iwl_cfg iwl1000_bgn_cfg;
69 extern struct iwl_cfg iwl1000_bg_cfg;
73 /* shared structures from iwl-5000.c */
74 extern struct iwl_mod_params iwl50_mod_params;
75 extern struct iwl_ucode_ops iwl5000_ucode;
76 extern struct iwl_lib_ops iwl5000_lib;
77 extern struct iwl_hcmd_ops iwl5000_hcmd;
78 extern struct iwl_hcmd_utils_ops iwl5000_hcmd_utils;
80 /* shared functions from iwl-5000.c */
81 extern u16 iwl5000_get_hcmd_size(u8 cmd_id, u16 len);
82 extern u16 iwl5000_build_addsta_hcmd(const struct iwl_addsta_cmd *cmd,
84 extern void iwl5000_rts_tx_cmd_flag(struct ieee80211_tx_info *info,
86 extern int iwl5000_calc_rssi(struct iwl_priv *priv,
87 struct iwl_rx_phy_res *rx_resp);
88 extern void iwl5000_nic_config(struct iwl_priv *priv);
89 extern u16 iwl5000_eeprom_calib_version(struct iwl_priv *priv);
90 extern const u8 *iwl5000_eeprom_query_addr(const struct iwl_priv *priv,
92 extern void iwl5000_txq_update_byte_cnt_tbl(struct iwl_priv *priv,
93 struct iwl_tx_queue *txq,
95 extern void iwl5000_txq_inval_byte_cnt_tbl(struct iwl_priv *priv,
96 struct iwl_tx_queue *txq);
97 extern int iwl5000_load_ucode(struct iwl_priv *priv);
98 extern void iwl5000_init_alive_start(struct iwl_priv *priv);
99 extern int iwl5000_alive_notify(struct iwl_priv *priv);
100 extern int iwl5000_hw_set_hw_params(struct iwl_priv *priv);
101 extern int iwl5000_txq_agg_enable(struct iwl_priv *priv, int txq_id,
102 int tx_fifo, int sta_id, int tid, u16 ssn_idx);
103 extern int iwl5000_txq_agg_disable(struct iwl_priv *priv, u16 txq_id,
104 u16 ssn_idx, u8 tx_fifo);
105 extern void iwl5000_txq_set_sched(struct iwl_priv *priv, u32 mask);
106 extern void iwl5000_setup_deferred_work(struct iwl_priv *priv);
107 extern void iwl5000_rx_handler_setup(struct iwl_priv *priv);
108 extern int iwl5000_hw_valid_rtc_data_addr(u32 addr);
109 extern int iwl5000_send_tx_power(struct iwl_priv *priv);
110 extern void iwl5000_temperature(struct iwl_priv *priv);
112 /* CT-KILL constants */
113 #define CT_KILL_THRESHOLD_LEGACY 110 /* in Celsius */
114 #define CT_KILL_THRESHOLD 114 /* in Celsius */
115 #define CT_KILL_EXIT_THRESHOLD 95 /* in Celsius */
117 /* Default noise level to report when noise measurement is not available.
118 * This may be because we're:
119 * 1) Not associated (4965, no beacon statistics being sent to driver)
120 * 2) Scanning (noise measurement does not apply to associated channel)
121 * 3) Receiving CCK (3945 delivers noise info only for OFDM frames)
122 * Use default noise value of -127 ... this is below the range of measurable
123 * Rx dBm for either 3945 or 4965, so it can indicate "unmeasurable" to user.
124 * Also, -127 works better than 0 when averaging frames with/without
125 * noise info (e.g. averaging might be done in app); measured dBm values are
126 * always negative ... using a negative value as the default keeps all
127 * averages within an s8's (used in some apps) range of negative values. */
128 #define IWL_NOISE_MEAS_NOT_AVAILABLE (-127)
131 * RTS threshold here is total size [2347] minus 4 FCS bytes
133 * a value of 0 means RTS on all data/management packets
134 * a value > max MSDU size means no RTS
135 * else RTS for data/management frames where MPDU is larger
138 #define DEFAULT_RTS_THRESHOLD 2347U
139 #define MIN_RTS_THRESHOLD 0U
140 #define MAX_RTS_THRESHOLD 2347U
141 #define MAX_MSDU_SIZE 2304U
142 #define MAX_MPDU_SIZE 2346U
143 #define DEFAULT_BEACON_INTERVAL 100U
144 #define DEFAULT_SHORT_RETRY_LIMIT 7U
145 #define DEFAULT_LONG_RETRY_LIMIT 4U
147 struct iwl_rx_mem_buffer {
150 struct list_head list;
153 #define rxb_addr(r) page_address(r->page)
156 struct iwl_device_cmd;
158 struct iwl_cmd_meta {
159 /* only for SYNC commands, iff the reply skb is wanted */
160 struct iwl_host_cmd *source;
162 * only for ASYNC commands
163 * (which is somewhat stupid -- look at iwl-sta.c for instance
164 * which duplicates a bunch of code because the callback isn't
165 * invoked for SYNC commands, if it were and its result passed
166 * through it would be simpler...)
168 void (*callback)(struct iwl_priv *priv,
169 struct iwl_device_cmd *cmd,
170 struct iwl_rx_packet *pkt);
172 /* The CMD_SIZE_HUGE flag bit indicates that the command
173 * structure is stored at the end of the shared queue memory. */
176 DECLARE_PCI_UNMAP_ADDR(mapping)
177 DECLARE_PCI_UNMAP_LEN(len)
181 * Generic queue structure
183 * Contains common data for Rx and Tx queues
186 int n_bd; /* number of BDs in this queue */
187 int write_ptr; /* 1-st empty entry (index) host_w*/
188 int read_ptr; /* last used entry (index) host_r*/
189 dma_addr_t dma_addr; /* physical addr for BD's */
190 int n_window; /* safe queue window */
192 int low_mark; /* low watermark, resume queue if free
193 * space more than this */
194 int high_mark; /* high watermark, stop queue if free
195 * space less than this */
196 } __attribute__ ((packed));
198 /* One for each TFD */
200 struct sk_buff *skb[IWL_NUM_OF_TBS - 1];
204 * struct iwl_tx_queue - Tx Queue for DMA
205 * @q: generic Rx/Tx queue descriptor
206 * @bd: base of circular buffer of TFDs
207 * @cmd: array of command/TX buffer pointers
208 * @meta: array of meta data for each command/tx buffer
209 * @dma_addr_cmd: physical address of cmd/tx buffer array
210 * @txb: array of per-TFD driver data
211 * @need_update: indicates need to update read/write index
212 * @sched_retry: indicates queue is high-throughput aggregation (HT AGG) enabled
214 * A Tx queue consists of circular buffer of BDs (a.k.a. TFDs, transmit frame
215 * descriptors) and required locking structures.
217 #define TFD_TX_CMD_SLOTS 256
218 #define TFD_CMD_SLOTS 32
220 struct iwl_tx_queue {
223 struct iwl_device_cmd **cmd;
224 struct iwl_cmd_meta *meta;
225 struct iwl_tx_info *txb;
232 #define IWL_NUM_SCAN_RATES (2)
234 struct iwl4965_channel_tgd_info {
239 struct iwl4965_channel_tgh_info {
243 #define IWL4965_MAX_RATE (33)
245 struct iwl3945_clip_group {
246 /* maximum power level to prevent clipping for each rate, derived by
247 * us from this band's saturation power in EEPROM */
248 const s8 clip_powers[IWL_MAX_RATES];
251 /* current Tx power values to use, one for each rate for each channel.
252 * requested power is limited by:
253 * -- regulatory EEPROM limits for this channel
254 * -- hardware capabilities (clip-powers)
255 * -- spectrum management
256 * -- user preference (e.g. iwconfig)
257 * when requested power is set, base power index must also be set. */
258 struct iwl3945_channel_power_info {
259 struct iwl3945_tx_power tpc; /* actual radio and DSP gain settings */
260 s8 power_table_index; /* actual (compenst'd) index into gain table */
261 s8 base_power_index; /* gain index for power at factory temp. */
262 s8 requested_power; /* power (dBm) requested for this chnl/rate */
265 /* current scan Tx power values to use, one for each scan rate for each
267 struct iwl3945_scan_power_info {
268 struct iwl3945_tx_power tpc; /* actual radio and DSP gain settings */
269 s8 power_table_index; /* actual (compenst'd) index into gain table */
270 s8 requested_power; /* scan pwr (dBm) requested for chnl/rate */
274 * One for each channel, holds all channel setup data
275 * Some of the fields (e.g. eeprom and flags/max_power_avg) are redundant
278 struct iwl_channel_info {
279 struct iwl4965_channel_tgd_info tgd;
280 struct iwl4965_channel_tgh_info tgh;
281 struct iwl_eeprom_channel eeprom; /* EEPROM regulatory limit */
282 struct iwl_eeprom_channel ht40_eeprom; /* EEPROM regulatory limit for
285 u8 channel; /* channel number */
286 u8 flags; /* flags copied from EEPROM */
287 s8 max_power_avg; /* (dBm) regul. eeprom, normal Tx, any rate */
288 s8 curr_txpow; /* (dBm) regulatory/spectrum/user (not h/w) limit */
289 s8 min_power; /* always 0 */
290 s8 scan_power; /* (dBm) regul. eeprom, direct scans, any rate */
292 u8 group_index; /* 0-4, maps channel to group1/2/3/4/5 */
293 u8 band_index; /* 0-4, maps channel to band1/2/3/4/5 */
294 enum ieee80211_band band;
296 /* HT40 channel info */
297 s8 ht40_max_power_avg; /* (dBm) regul. eeprom, normal Tx, any rate */
298 s8 ht40_curr_txpow; /* (dBm) regulatory/spectrum/user (not h/w) */
299 s8 ht40_min_power; /* always 0 */
300 s8 ht40_scan_power; /* (dBm) eeprom, direct scans, any rate */
301 u8 ht40_flags; /* flags copied from EEPROM */
302 u8 ht40_extension_channel; /* HT_IE_EXT_CHANNEL_* */
304 /* Radio/DSP gain settings for each "normal" data Tx rate.
305 * These include, in addition to RF and DSP gain, a few fields for
306 * remembering/modifying gain settings (indexes). */
307 struct iwl3945_channel_power_info power_info[IWL4965_MAX_RATE];
309 /* Radio/DSP gain settings for each scan rate, for directed scans. */
310 struct iwl3945_scan_power_info scan_pwr_info[IWL_NUM_SCAN_RATES];
313 #define IWL_TX_FIFO_AC0 0
314 #define IWL_TX_FIFO_AC1 1
315 #define IWL_TX_FIFO_AC2 2
316 #define IWL_TX_FIFO_AC3 3
317 #define IWL_TX_FIFO_HCCA_1 5
318 #define IWL_TX_FIFO_HCCA_2 6
319 #define IWL_TX_FIFO_NONE 7
321 /* Minimum number of queues. MAX_NUM is defined in hw specific files.
322 * Set the minimum to accommodate the 4 standard TX queues, 1 command
323 * queue, 2 (unused) HCCA queues, and 4 HT queues (one for each AC) */
324 #define IWL_MIN_NUM_QUEUES 10
327 * Queue #4 is the command queue for 3945/4965/5x00/1000/6x00,
328 * the driver maps it into the appropriate device FIFO for the
331 #define IWL_CMD_QUEUE_NUM 4
333 /* Power management (not Tx power) structures */
340 #define IEEE80211_DATA_LEN 2304
341 #define IEEE80211_4ADDR_LEN 30
342 #define IEEE80211_HLEN (IEEE80211_4ADDR_LEN)
343 #define IEEE80211_FRAME_LEN (IEEE80211_DATA_LEN + IEEE80211_HLEN)
347 struct ieee80211_hdr frame;
348 struct iwl_tx_beacon_cmd beacon;
349 u8 raw[IEEE80211_FRAME_LEN];
352 struct list_head list;
355 #define SEQ_TO_SN(seq) (((seq) & IEEE80211_SCTL_SEQ) >> 4)
356 #define SN_TO_SEQ(ssn) (((ssn) << 4) & IEEE80211_SCTL_SEQ)
357 #define MAX_SN ((IEEE80211_SCTL_SEQ) >> 4)
363 CMD_SIZE_HUGE = (1 << 0),
364 CMD_ASYNC = (1 << 1),
365 CMD_WANT_SKB = (1 << 2),
368 #define DEF_CMD_PAYLOAD_SIZE 320
371 * IWL_LINK_HDR_MAX should include ieee80211_hdr, radiotap header,
372 * SNAP header and alignment. It should also be big enough for 802.11
375 #define IWL_LINK_HDR_MAX 64
378 * struct iwl_device_cmd
380 * For allocation of the command and tx queues, this establishes the overall
381 * size of the largest command we send to uCode, except for a scan command
382 * (which is relatively huge; space is allocated separately).
384 struct iwl_device_cmd {
385 struct iwl_cmd_header hdr; /* uCode API */
391 struct iwl_tx_cmd tx;
392 struct iwl6000_channel_switch_cmd chswitch;
393 u8 payload[DEF_CMD_PAYLOAD_SIZE];
394 } __attribute__ ((packed)) cmd;
395 } __attribute__ ((packed));
397 #define TFD_MAX_PAYLOAD_SIZE (sizeof(struct iwl_device_cmd))
400 struct iwl_host_cmd {
402 unsigned long reply_page;
403 void (*callback)(struct iwl_priv *priv,
404 struct iwl_device_cmd *cmd,
405 struct iwl_rx_packet *pkt);
411 #define SUP_RATE_11A_MAX_NUM_CHANNELS 8
412 #define SUP_RATE_11B_MAX_NUM_CHANNELS 4
413 #define SUP_RATE_11G_MAX_NUM_CHANNELS 12
416 * struct iwl_rx_queue - Rx queue
417 * @bd: driver's pointer to buffer of receive buffer descriptors (rbd)
418 * @dma_addr: bus address of buffer of receive buffer descriptors (rbd)
419 * @read: Shared index to newest available Rx buffer
420 * @write: Shared index to oldest written Rx packet
421 * @free_count: Number of pre-allocated buffers in rx_free
422 * @rx_free: list of free SKBs for use
423 * @rx_used: List of Rx buffers with no SKB
424 * @need_update: flag to indicate we need to update read/write index
425 * @rb_stts: driver's pointer to receive buffer status
426 * @rb_stts_dma: bus address of receive buffer status
428 * NOTE: rx_free and rx_used are used as a FIFO for iwl_rx_mem_buffers
430 struct iwl_rx_queue {
433 struct iwl_rx_mem_buffer pool[RX_QUEUE_SIZE + RX_FREE_BUFFERS];
434 struct iwl_rx_mem_buffer *queue[RX_QUEUE_SIZE];
439 struct list_head rx_free;
440 struct list_head rx_used;
442 struct iwl_rb_status *rb_stts;
443 dma_addr_t rb_stts_dma;
447 #define IWL_SUPPORTED_RATES_IE_LEN 8
449 #define MAX_TID_COUNT 9
451 #define IWL_INVALID_RATE 0xFF
452 #define IWL_INVALID_VALUE -1
455 * struct iwl_ht_agg -- aggregation status while waiting for block-ack
456 * @txq_id: Tx queue used for Tx attempt
457 * @frame_count: # frames attempted by Tx command
458 * @wait_for_ba: Expect block-ack before next Tx reply
459 * @start_idx: Index of 1st Transmit Frame Descriptor (TFD) in Tx window
460 * @bitmap0: Low order bitmap, one bit for each frame pending ACK in Tx window
461 * @bitmap1: High order, one bit for each frame pending ACK in Tx window
462 * @rate_n_flags: Rate at which Tx was attempted
464 * If REPLY_TX indicates that aggregation was attempted, driver must wait
465 * for block ack (REPLY_COMPRESSED_BA). This struct stores tx reply info
466 * until block ack arrives.
475 #define IWL_AGG_OFF 0
477 #define IWL_EMPTYING_HW_QUEUE_ADDBA 2
478 #define IWL_EMPTYING_HW_QUEUE_DELBA 3
483 struct iwl_tid_data {
486 struct iwl_ht_agg agg;
490 enum ieee80211_key_alg alg;
496 union iwl_ht_rate_supp {
504 #define CFG_HT_RX_AMPDU_FACTOR_DEF (0x3)
507 * Maximal MPDU density for TX aggregation
513 #define CFG_HT_MPDU_DENSITY_4USEC (0x5)
514 #define CFG_HT_MPDU_DENSITY_DEF CFG_HT_MPDU_DENSITY_4USEC
516 struct iwl_ht_config {
517 /* self configuration data */
520 bool single_chain_sufficient;
522 /* BSS related data */
523 u8 extension_chan_offset;
525 u8 non_GF_STA_present;
528 union iwl_qos_capabity {
530 u8 edca_count:4; /* bit 0-3 */
531 u8 q_ack:1; /* bit 4 */
532 u8 queue_request:1; /* bit 5 */
533 u8 txop_request:1; /* bit 6 */
534 u8 reserved:1; /* bit 7 */
537 u8 acvo_APSD:1; /* bit 0 */
538 u8 acvi_APSD:1; /* bit 1 */
539 u8 ac_bk_APSD:1; /* bit 2 */
540 u8 ac_be_APSD:1; /* bit 3 */
541 u8 q_ack:1; /* bit 4 */
542 u8 max_len:2; /* bit 5-6 */
543 u8 more_data_ack:1; /* bit 7 */
549 struct iwl_qos_info {
551 union iwl_qos_capabity qos_cap;
552 struct iwl_qosparam_cmd def_qos_parm;
555 #define STA_PS_STATUS_WAKE 0
556 #define STA_PS_STATUS_SLEEP 1
559 struct iwl3945_station_entry {
560 struct iwl3945_addsta_cmd sta;
561 struct iwl_tid_data tid[MAX_TID_COUNT];
564 struct iwl_hw_key keyinfo;
567 struct iwl_station_entry {
568 struct iwl_addsta_cmd sta;
569 struct iwl_tid_data tid[MAX_TID_COUNT];
572 struct iwl_hw_key keyinfo;
576 * iwl_station_priv: Driver's private station information
578 * When mac80211 creates a station it reserves some space (hw->sta_data_size)
579 * in the structure for use by driver. This structure is places in that
582 * At the moment use it for the station's rate scaling information.
584 struct iwl_station_priv {
585 struct iwl_lq_sta lq_sta;
588 /* one for each uCode image (inst/data, boot/init/runtime) */
590 void *v_addr; /* access by driver */
591 dma_addr_t p_addr; /* access by card's busmaster DMA */
595 /* uCode file layout */
596 struct iwl_ucode_header {
597 __le32 ver; /* major/minor/API/serial */
600 __le32 inst_size; /* bytes of runtime code */
601 __le32 data_size; /* bytes of runtime data */
602 __le32 init_size; /* bytes of init code */
603 __le32 init_data_size; /* bytes of init data */
604 __le32 boot_size; /* bytes of bootstrap code */
605 u8 data[0]; /* in same order as sizes */
608 __le32 build; /* build number */
609 __le32 inst_size; /* bytes of runtime code */
610 __le32 data_size; /* bytes of runtime data */
611 __le32 init_size; /* bytes of init code */
612 __le32 init_data_size; /* bytes of init data */
613 __le32 boot_size; /* bytes of bootstrap code */
614 u8 data[0]; /* in same order as sizes */
618 #define UCODE_HEADER_SIZE(ver) ((ver) == 1 ? 24 : 28)
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 * @calib_init_cfg: setup initial calibrations for the hw
680 * @struct iwl_sensitivity_ranges: range of sensitivity values
682 struct iwl_hw_params {
685 u16 scd_bc_tbls_size;
698 u8 max_beacon_itrvl; /* in 1024 ms */
702 u32 ct_kill_threshold; /* value in hw-dependent units */
703 u32 ct_kill_exit_threshold; /* value in hw-dependent units */
704 /* for 1000, 6000 series and up */
706 const struct iwl_sensitivity_ranges *sens;
710 /******************************************************************************
712 * Functions implemented in core module which are forward declared here
713 * for use by iwl-[4-5].c
715 * NOTE: The implementation of these functions are not hardware specific
716 * which is why they are in the core module files.
718 * Naming convention --
719 * iwl_ <-- Is part of iwlwifi
720 * iwlXXXX_ <-- Hardware specific (implemented in iwl-XXXX.c for XXXX)
721 * iwl4965_bg_ <-- Called from work queue context
722 * iwl4965_mac_ <-- mac80211 callback
724 ****************************************************************************/
725 extern void iwl_update_chain_flags(struct iwl_priv *priv);
726 extern int iwl_set_pwr_src(struct iwl_priv *priv, enum iwl_pwr_src src);
727 extern const u8 iwl_bcast_addr[ETH_ALEN];
728 extern int iwl_rxq_stop(struct iwl_priv *priv);
729 extern void iwl_txq_ctx_stop(struct iwl_priv *priv);
730 extern int iwl_queue_space(const struct iwl_queue *q);
731 static inline int iwl_queue_used(const struct iwl_queue *q, int i)
733 return q->write_ptr > q->read_ptr ?
734 (i >= q->read_ptr && i < q->write_ptr) :
735 !(i < q->read_ptr && i >= q->write_ptr);
739 static inline u8 get_cmd_index(struct iwl_queue *q, u32 index, int is_huge)
742 * This is for init calibration result and scan command which
743 * required buffer > TFD_MAX_PAYLOAD_SIZE,
744 * the big buffer at end of command array
747 return q->n_window; /* must be power of 2 */
749 /* Otherwise, use normal size buffers */
750 return index & (q->n_window - 1);
760 #define IWL_OPERATION_MODE_AUTO 0
761 #define IWL_OPERATION_MODE_HT_ONLY 1
762 #define IWL_OPERATION_MODE_MIXED 2
763 #define IWL_OPERATION_MODE_20MHZ 3
765 #define IWL_TX_CRC_SIZE 4
766 #define IWL_TX_DELIMITER_SIZE 4
768 #define TX_POWER_IWL_ILLEGAL_VOLTAGE -10000
770 /* Sensitivity and chain noise calibration */
771 #define INITIALIZATION_VALUE 0xFFFF
772 #define IWL4965_CAL_NUM_BEACONS 20
773 #define IWL_CAL_NUM_BEACONS 16
774 #define MAXIMUM_ALLOWED_PATHLOSS 15
776 #define CHAIN_NOISE_MAX_DELTA_GAIN_CODE 3
778 #define MAX_FA_OFDM 50
779 #define MIN_FA_OFDM 5
780 #define MAX_FA_CCK 50
783 #define AUTO_CORR_STEP_OFDM 1
785 #define AUTO_CORR_STEP_CCK 3
786 #define AUTO_CORR_MAX_TH_CCK 160
789 #define NRG_STEP_CCK 2
791 #define MAX_NUMBER_CCK_NO_FA 100
793 #define AUTO_CORR_CCK_MIN_VAL_DEF (125)
798 #define CHAIN_NOISE_DELTA_GAIN_INIT_VAL 4
799 #define ALL_BAND_FILTER 0xFF00
800 #define IN_BAND_FILTER 0xFF
801 #define MIN_AVERAGE_NOISE_MAX_VALUE 0xFFFFFFFF
803 #define NRG_NUM_PREV_STAT_L 20
804 #define NUM_RX_CHAINS 3
806 enum iwl4965_false_alarm_state {
809 IWL_FA_GOOD_RANGE = 2,
812 enum iwl4965_chain_noise_state {
813 IWL_CHAIN_NOISE_ALIVE = 0, /* must be 0 */
814 IWL_CHAIN_NOISE_ACCUMULATE,
815 IWL_CHAIN_NOISE_CALIBRATED,
816 IWL_CHAIN_NOISE_DONE,
819 enum iwl4965_calib_enabled_state {
820 IWL_CALIB_DISABLED = 0, /* must be 0 */
821 IWL_CALIB_ENABLED = 1,
827 * defines the order in which results of initial calibrations
828 * should be sent to the runtime uCode
835 IWL_CALIB_TX_IQ_PERD,
840 /* Opaque calibration results */
841 struct iwl_calib_result {
852 /* Sensitivity calib data */
853 struct iwl_sensitivity_data {
855 u32 auto_corr_ofdm_mrc;
856 u32 auto_corr_ofdm_x1;
857 u32 auto_corr_ofdm_mrc_x1;
859 u32 auto_corr_cck_mrc;
861 u32 last_bad_plcp_cnt_ofdm;
862 u32 last_fa_cnt_ofdm;
863 u32 last_bad_plcp_cnt_cck;
869 u8 nrg_silence_rssi[NRG_NUM_PREV_STAT_L];
874 s32 nrg_auto_corr_silence_diff;
875 u32 num_in_cck_no_fa;
878 u16 barker_corr_th_min;
879 u16 barker_corr_th_min_mrc;
883 /* Chain noise (differential Rx gain) calib data */
884 struct iwl_chain_noise_data {
893 u8 disconn_array[NUM_RX_CHAINS];
894 u8 delta_gain_code[NUM_RX_CHAINS];
899 #define EEPROM_SEM_TIMEOUT 10 /* milliseconds */
900 #define EEPROM_SEM_RETRY_LIMIT 1000 /* number of attempts (not time) */
902 #define IWL_TRAFFIC_ENTRIES (256)
903 #define IWL_TRAFFIC_ENTRY_SIZE (64)
906 MEASUREMENT_READY = (1 << 0),
907 MEASUREMENT_ACTIVE = (1 << 1),
911 NVM_DEVICE_TYPE_EEPROM = 0,
916 * Two types of OTP memory access modes
917 * IWL_OTP_ACCESS_ABSOLUTE - absolute address mode,
918 * based on physical memory addressing
919 * IWL_OTP_ACCESS_RELATIVE - relative address mode,
920 * based on logical memory addressing
922 enum iwl_access_mode {
923 IWL_OTP_ACCESS_ABSOLUTE,
924 IWL_OTP_ACCESS_RELATIVE,
928 * enum iwl_pa_type - Power Amplifier type
929 * @IWL_PA_SYSTEM: based on uCode configuration
930 * @IWL_PA_HYBRID: use both Internal and external PA
931 * @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;
1010 /* ieee device used by generic ieee processing code */
1011 struct ieee80211_hw *hw;
1012 struct ieee80211_channel *ieee_channels;
1013 struct ieee80211_rate *ieee_rates;
1014 struct iwl_cfg *cfg;
1016 /* temporary frame storage list */
1017 struct list_head free_frames;
1020 enum ieee80211_band band;
1023 void (*rx_handlers[REPLY_MAX])(struct iwl_priv *priv,
1024 struct iwl_rx_mem_buffer *rxb);
1026 struct ieee80211_supported_band bands[IEEE80211_NUM_BANDS];
1028 #if defined(CONFIG_IWLWIFI_SPECTRUM_MEASUREMENT) || defined(CONFIG_IWL3945_SPECTRUM_MEASUREMENT)
1029 /* spectrum measurement report caching */
1030 struct iwl_spectrum_notification measure_report;
1031 u8 measurement_status;
1033 /* ucode beacon time */
1034 u32 ucode_beacon_time;
1036 /* we allocate array of iwl4965_channel_info for NIC's valid channels.
1037 * Access via channel # using indirect index array */
1038 struct iwl_channel_info *channel_info; /* channel info array */
1039 u8 channel_count; /* # of channels */
1041 /* each calibration channel group in the EEPROM has a derived
1042 * clip setting for each rate. 3945 only.*/
1043 const struct iwl3945_clip_group clip39_groups[5];
1045 /* thermal calibration */
1046 s32 temperature; /* degrees Kelvin */
1047 s32 last_temperature;
1049 /* init calibration results */
1050 struct iwl_calib_result calib_results[IWL_CALIB_MAX];
1052 /* Scan related variables */
1053 unsigned long last_scan_jiffies;
1054 unsigned long next_scan_jiffies;
1055 unsigned long scan_start;
1056 unsigned long scan_pass_start;
1057 unsigned long scan_start_tsf;
1060 struct cfg80211_scan_request *scan_request;
1061 u8 scan_tx_ant[IEEE80211_NUM_BANDS];
1065 spinlock_t lock; /* protect general shared data */
1066 spinlock_t hcmd_lock; /* protect hcmd */
1067 spinlock_t reg_lock; /* protect hw register access */
1070 /* basic pci-network driver stuff */
1071 struct pci_dev *pci_dev;
1073 /* pci hardware address support */
1074 void __iomem *hw_base;
1079 /* uCode images, save to reload in case of failure */
1080 u32 ucode_ver; /* version of ucode, copy of
1082 struct fw_desc ucode_code; /* runtime inst */
1083 struct fw_desc ucode_data; /* runtime data original */
1084 struct fw_desc ucode_data_backup; /* runtime data save/restore */
1085 struct fw_desc ucode_init; /* initialization inst */
1086 struct fw_desc ucode_init_data; /* initialization data */
1087 struct fw_desc ucode_boot; /* bootstrap inst */
1088 enum ucode_type ucode_type;
1089 u8 ucode_write_complete; /* the image write is complete */
1092 struct iwl_rxon_time_cmd rxon_timing;
1094 /* We declare this const so it can only be
1095 * changed via explicit cast within the
1096 * routines that actually update the physical
1098 const struct iwl_rxon_cmd active_rxon;
1099 struct iwl_rxon_cmd staging_rxon;
1101 struct iwl_switch_rxon switch_rxon;
1103 /* 1st responses from initialize and runtime uCode images.
1104 * 4965's initialize alive response contains some calibration data. */
1105 struct iwl_init_alive_resp card_alive_init;
1106 struct iwl_alive_resp card_alive;
1108 unsigned long last_blink_time;
1114 u16 active_rate_basic;
1116 u8 assoc_station_added;
1118 struct iwl_sensitivity_data sensitivity_data;
1119 struct iwl_chain_noise_data chain_noise_data;
1120 __le16 sensitivity_tbl[HD_TABLE_SIZE];
1122 struct iwl_ht_config current_ht_config;
1123 u8 last_phy_res[100];
1125 /* Rate scaling data */
1128 wait_queue_head_t wait_command_queue;
1130 int activity_timer_active;
1132 /* Rx and Tx DMA processing queues */
1133 struct iwl_rx_queue rxq;
1134 struct iwl_tx_queue *txq;
1135 unsigned long txq_ctx_active_msk;
1136 struct iwl_dma_ptr kw; /* keep warm address */
1137 struct iwl_dma_ptr scd_bc_tbls;
1139 u32 scd_base_addr; /* scheduler sram base address */
1141 unsigned long status;
1143 int last_rx_rssi; /* From Rx packet statistics */
1144 int last_rx_noise; /* From beacon statistics */
1146 /* counts mgmt, ctl, and data packets */
1147 struct traffic_stats tx_stats;
1148 struct traffic_stats rx_stats;
1150 /* counts interrupts */
1151 struct isr_statistics isr_stats;
1153 struct iwl_power_mgr power_data;
1154 struct iwl_tt_mgmt thermal_throttle;
1156 struct iwl_notif_statistics statistics;
1157 #ifdef CONFIG_IWLWIFI_DEBUG
1158 struct iwl_notif_statistics accum_statistics;
1161 /* context information */
1166 u8 mac_addr[ETH_ALEN];
1168 /*station table variables */
1169 spinlock_t sta_lock;
1171 struct iwl_station_entry stations[IWL_STATION_COUNT];
1172 struct iwl_wep_key wep_keys[WEP_KEYS_MAX];
1175 unsigned long ucode_key_table;
1177 /* queue refcounts */
1178 #define IWL_MAX_HW_QUEUES 32
1179 unsigned long queue_stopped[BITS_TO_LONGS(IWL_MAX_HW_QUEUES)];
1181 atomic_t queue_stop_count[4];
1183 /* Indication if ieee80211_ops->open has been called */
1186 u8 mac80211_registered;
1188 /* Rx'd packet timing information */
1189 u32 last_beacon_time;
1194 int nvm_device_type;
1195 struct iwl_eeprom_calib_info *calib_info;
1197 enum nl80211_iftype iw_mode;
1199 struct sk_buff *ibss_beacon;
1201 /* Last Rx'd beacon timestamp */
1204 struct ieee80211_vif *vif;
1208 dma_addr_t shared_phys;
1210 struct iwl_hw_params hw_params;
1214 dma_addr_t ict_tbl_dma;
1215 dma_addr_t aligned_ict_tbl_dma;
1222 /* Current association information needed to configure the
1225 u16 assoc_capability;
1227 struct iwl_qos_info qos_data;
1229 struct workqueue_struct *workqueue;
1231 struct work_struct up;
1232 struct work_struct restart;
1233 struct work_struct calibrated_work;
1234 struct work_struct scan_completed;
1235 struct work_struct rx_replenish;
1236 struct work_struct abort_scan;
1237 struct work_struct update_link_led;
1238 struct work_struct auth_work;
1239 struct work_struct report_work;
1240 struct work_struct request_scan;
1241 struct work_struct beacon_update;
1242 struct work_struct tt_work;
1243 struct work_struct ct_enter;
1244 struct work_struct ct_exit;
1246 struct tasklet_struct irq_tasklet;
1248 struct delayed_work init_alive_start;
1249 struct delayed_work alive_start;
1250 struct delayed_work scan_check;
1253 struct delayed_work thermal_periodic;
1254 struct delayed_work rfkill_poll;
1257 s8 tx_power_user_lmt;
1258 s8 tx_power_device_lmt;
1261 #ifdef CONFIG_IWLWIFI_DEBUG
1262 /* debugging info */
1263 u32 debug_level; /* per device debugging will override global
1264 iwl_debug_level if set */
1266 atomic_t restrict_refcnt;
1268 #ifdef CONFIG_IWLWIFI_DEBUGFS
1274 struct iwl_debugfs *dbgfs;
1275 #endif /* CONFIG_IWLWIFI_DEBUGFS */
1276 #endif /* CONFIG_IWLWIFI_DEBUG */
1278 struct work_struct txpower_work;
1279 u32 disable_sens_cal;
1280 u32 disable_chain_noise_cal;
1281 u32 disable_tx_power_cal;
1282 struct work_struct run_time_calib_work;
1283 struct timer_list statistics_periodic;
1286 #define IWL_DEFAULT_TX_POWER 0x0F
1288 struct iwl3945_notif_statistics statistics_39;
1293 static inline void iwl_txq_ctx_activate(struct iwl_priv *priv, int txq_id)
1295 set_bit(txq_id, &priv->txq_ctx_active_msk);
1298 static inline void iwl_txq_ctx_deactivate(struct iwl_priv *priv, int txq_id)
1300 clear_bit(txq_id, &priv->txq_ctx_active_msk);
1303 #ifdef CONFIG_IWLWIFI_DEBUG
1304 const char *iwl_get_tx_fail_reason(u32 status);
1306 * iwl_get_debug_level: Return active debug level for device
1308 * Using sysfs it is possible to set per device debug level. This debug
1309 * level will be used if set, otherwise the global debug level which can be
1310 * set via module parameter is used.
1312 static inline u32 iwl_get_debug_level(struct iwl_priv *priv)
1314 if (priv->debug_level)
1315 return priv->debug_level;
1317 return iwl_debug_level;
1320 static inline const char *iwl_get_tx_fail_reason(u32 status) { return ""; }
1322 static inline u32 iwl_get_debug_level(struct iwl_priv *priv)
1324 return iwl_debug_level;
1329 static inline struct ieee80211_hdr *iwl_tx_queue_get_hdr(struct iwl_priv *priv,
1330 int txq_id, int idx)
1332 if (priv->txq[txq_id].txb[idx].skb[0])
1333 return (struct ieee80211_hdr *)priv->txq[txq_id].
1334 txb[idx].skb[0]->data;
1339 static inline int iwl_is_associated(struct iwl_priv *priv)
1341 return (priv->active_rxon.filter_flags & RXON_FILTER_ASSOC_MSK) ? 1 : 0;
1344 static inline int is_channel_valid(const struct iwl_channel_info *ch_info)
1346 if (ch_info == NULL)
1348 return (ch_info->flags & EEPROM_CHANNEL_VALID) ? 1 : 0;
1351 static inline int is_channel_radar(const struct iwl_channel_info *ch_info)
1353 return (ch_info->flags & EEPROM_CHANNEL_RADAR) ? 1 : 0;
1356 static inline u8 is_channel_a_band(const struct iwl_channel_info *ch_info)
1358 return ch_info->band == IEEE80211_BAND_5GHZ;
1361 static inline u8 is_channel_bg_band(const struct iwl_channel_info *ch_info)
1363 return ch_info->band == IEEE80211_BAND_2GHZ;
1366 static inline int is_channel_passive(const struct iwl_channel_info *ch)
1368 return (!(ch->flags & EEPROM_CHANNEL_ACTIVE)) ? 1 : 0;
1371 static inline int is_channel_ibss(const struct iwl_channel_info *ch)
1373 return ((ch->flags & EEPROM_CHANNEL_IBSS)) ? 1 : 0;
1376 #endif /* __iwl_dev_h__ */