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 int iwl5000_apm_init(struct iwl_priv
*priv
);
89 extern void iwl5000_nic_config(struct iwl_priv
*priv
);
90 extern u16
iwl5000_eeprom_calib_version(struct iwl_priv
*priv
);
91 extern const u8
*iwl5000_eeprom_query_addr(const struct iwl_priv
*priv
,
93 extern void iwl5000_txq_update_byte_cnt_tbl(struct iwl_priv
*priv
,
94 struct iwl_tx_queue
*txq
,
96 extern void iwl5000_txq_inval_byte_cnt_tbl(struct iwl_priv
*priv
,
97 struct iwl_tx_queue
*txq
);
98 extern int iwl5000_load_ucode(struct iwl_priv
*priv
);
99 extern void iwl5000_init_alive_start(struct iwl_priv
*priv
);
100 extern int iwl5000_alive_notify(struct iwl_priv
*priv
);
101 extern int iwl5000_hw_set_hw_params(struct iwl_priv
*priv
);
102 extern int iwl5000_txq_agg_enable(struct iwl_priv
*priv
, int txq_id
,
103 int tx_fifo
, int sta_id
, int tid
, u16 ssn_idx
);
104 extern int iwl5000_txq_agg_disable(struct iwl_priv
*priv
, u16 txq_id
,
105 u16 ssn_idx
, u8 tx_fifo
);
106 extern void iwl5000_txq_set_sched(struct iwl_priv
*priv
, u32 mask
);
107 extern void iwl5000_setup_deferred_work(struct iwl_priv
*priv
);
108 extern void iwl5000_rx_handler_setup(struct iwl_priv
*priv
);
109 extern int iwl5000_hw_valid_rtc_data_addr(u32 addr
);
110 extern int iwl5000_send_tx_power(struct iwl_priv
*priv
);
111 extern void iwl5000_temperature(struct iwl_priv
*priv
);
113 /* CT-KILL constants */
114 #define CT_KILL_THRESHOLD_LEGACY 110 /* in Celsius */
115 #define CT_KILL_THRESHOLD 114 /* in Celsius */
116 #define CT_KILL_EXIT_THRESHOLD 95 /* in Celsius */
118 /* Default noise level to report when noise measurement is not available.
119 * This may be because we're:
120 * 1) Not associated (4965, no beacon statistics being sent to driver)
121 * 2) Scanning (noise measurement does not apply to associated channel)
122 * 3) Receiving CCK (3945 delivers noise info only for OFDM frames)
123 * Use default noise value of -127 ... this is below the range of measurable
124 * Rx dBm for either 3945 or 4965, so it can indicate "unmeasurable" to user.
125 * Also, -127 works better than 0 when averaging frames with/without
126 * noise info (e.g. averaging might be done in app); measured dBm values are
127 * always negative ... using a negative value as the default keeps all
128 * averages within an s8's (used in some apps) range of negative values. */
129 #define IWL_NOISE_MEAS_NOT_AVAILABLE (-127)
132 * RTS threshold here is total size [2347] minus 4 FCS bytes
134 * a value of 0 means RTS on all data/management packets
135 * a value > max MSDU size means no RTS
136 * else RTS for data/management frames where MPDU is larger
139 #define DEFAULT_RTS_THRESHOLD 2347U
140 #define MIN_RTS_THRESHOLD 0U
141 #define MAX_RTS_THRESHOLD 2347U
142 #define MAX_MSDU_SIZE 2304U
143 #define MAX_MPDU_SIZE 2346U
144 #define DEFAULT_BEACON_INTERVAL 100U
145 #define DEFAULT_SHORT_RETRY_LIMIT 7U
146 #define DEFAULT_LONG_RETRY_LIMIT 4U
148 struct iwl_rx_mem_buffer
{
149 dma_addr_t real_dma_addr
;
150 dma_addr_t aligned_dma_addr
;
152 struct list_head list
;
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 sk_buff
*skb
);
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
326 /* Power management (not Tx power) structures */
333 #define IEEE80211_DATA_LEN 2304
334 #define IEEE80211_4ADDR_LEN 30
335 #define IEEE80211_HLEN (IEEE80211_4ADDR_LEN)
336 #define IEEE80211_FRAME_LEN (IEEE80211_DATA_LEN + IEEE80211_HLEN)
340 struct ieee80211_hdr frame
;
341 struct iwl_tx_beacon_cmd beacon
;
342 u8 raw
[IEEE80211_FRAME_LEN
];
345 struct list_head list
;
348 #define SEQ_TO_SN(seq) (((seq) & IEEE80211_SCTL_SEQ) >> 4)
349 #define SN_TO_SEQ(ssn) (((ssn) << 4) & IEEE80211_SCTL_SEQ)
350 #define MAX_SN ((IEEE80211_SCTL_SEQ) >> 4)
356 CMD_SIZE_HUGE
= (1 << 0),
357 CMD_ASYNC
= (1 << 1),
358 CMD_WANT_SKB
= (1 << 2),
361 #define IWL_CMD_MAX_PAYLOAD 320
364 * struct iwl_device_cmd
366 * For allocation of the command and tx queues, this establishes the overall
367 * size of the largest command we send to uCode, except for a scan command
368 * (which is relatively huge; space is allocated separately).
370 struct iwl_device_cmd
{
371 struct iwl_cmd_header hdr
; /* uCode API */
377 struct iwl_tx_cmd tx
;
378 u8 payload
[IWL_CMD_MAX_PAYLOAD
];
379 } __attribute__ ((packed
)) cmd
;
380 } __attribute__ ((packed
));
382 #define TFD_MAX_PAYLOAD_SIZE (sizeof(struct iwl_device_cmd))
385 struct iwl_host_cmd
{
387 struct sk_buff
*reply_skb
;
388 void (*callback
)(struct iwl_priv
*priv
,
389 struct iwl_device_cmd
*cmd
,
390 struct sk_buff
*skb
);
397 * RX related structures and functions
399 #define RX_FREE_BUFFERS 64
400 #define RX_LOW_WATERMARK 8
402 #define SUP_RATE_11A_MAX_NUM_CHANNELS 8
403 #define SUP_RATE_11B_MAX_NUM_CHANNELS 4
404 #define SUP_RATE_11G_MAX_NUM_CHANNELS 12
407 * struct iwl_rx_queue - Rx queue
408 * @bd: driver's pointer to buffer of receive buffer descriptors (rbd)
409 * @dma_addr: bus address of buffer of receive buffer descriptors (rbd)
410 * @read: Shared index to newest available Rx buffer
411 * @write: Shared index to oldest written Rx packet
412 * @free_count: Number of pre-allocated buffers in rx_free
413 * @rx_free: list of free SKBs for use
414 * @rx_used: List of Rx buffers with no SKB
415 * @need_update: flag to indicate we need to update read/write index
416 * @rb_stts: driver's pointer to receive buffer status
417 * @rb_stts_dma: bus address of receive buffer status
419 * NOTE: rx_free and rx_used are used as a FIFO for iwl_rx_mem_buffers
421 struct iwl_rx_queue
{
424 struct iwl_rx_mem_buffer pool
[RX_QUEUE_SIZE
+ RX_FREE_BUFFERS
];
425 struct iwl_rx_mem_buffer
*queue
[RX_QUEUE_SIZE
];
430 struct list_head rx_free
;
431 struct list_head rx_used
;
433 struct iwl_rb_status
*rb_stts
;
434 dma_addr_t rb_stts_dma
;
438 #define IWL_SUPPORTED_RATES_IE_LEN 8
440 #define MAX_TID_COUNT 9
442 #define IWL_INVALID_RATE 0xFF
443 #define IWL_INVALID_VALUE -1
446 * struct iwl_ht_agg -- aggregation status while waiting for block-ack
447 * @txq_id: Tx queue used for Tx attempt
448 * @frame_count: # frames attempted by Tx command
449 * @wait_for_ba: Expect block-ack before next Tx reply
450 * @start_idx: Index of 1st Transmit Frame Descriptor (TFD) in Tx window
451 * @bitmap0: Low order bitmap, one bit for each frame pending ACK in Tx window
452 * @bitmap1: High order, one bit for each frame pending ACK in Tx window
453 * @rate_n_flags: Rate at which Tx was attempted
455 * If REPLY_TX indicates that aggregation was attempted, driver must wait
456 * for block ack (REPLY_COMPRESSED_BA). This struct stores tx reply info
457 * until block ack arrives.
466 #define IWL_AGG_OFF 0
468 #define IWL_EMPTYING_HW_QUEUE_ADDBA 2
469 #define IWL_EMPTYING_HW_QUEUE_DELBA 3
474 struct iwl_tid_data
{
477 struct iwl_ht_agg agg
;
481 enum ieee80211_key_alg alg
;
487 union iwl_ht_rate_supp
{
495 #define CFG_HT_RX_AMPDU_FACTOR_DEF (0x3)
498 * Maximal MPDU density for TX aggregation
504 #define CFG_HT_MPDU_DENSITY_4USEC (0x5)
505 #define CFG_HT_MPDU_DENSITY_DEF CFG_HT_MPDU_DENSITY_4USEC
507 struct iwl_ht_config
{
508 /* self configuration data */
511 bool single_chain_sufficient
;
512 /* BSS related data */
513 u8 extension_chan_offset
;
515 u8 non_GF_STA_present
;
518 union iwl_qos_capabity
{
520 u8 edca_count
:4; /* bit 0-3 */
521 u8 q_ack
:1; /* bit 4 */
522 u8 queue_request
:1; /* bit 5 */
523 u8 txop_request
:1; /* bit 6 */
524 u8 reserved
:1; /* bit 7 */
527 u8 acvo_APSD
:1; /* bit 0 */
528 u8 acvi_APSD
:1; /* bit 1 */
529 u8 ac_bk_APSD
:1; /* bit 2 */
530 u8 ac_be_APSD
:1; /* bit 3 */
531 u8 q_ack
:1; /* bit 4 */
532 u8 max_len
:2; /* bit 5-6 */
533 u8 more_data_ack
:1; /* bit 7 */
539 struct iwl_qos_info
{
541 union iwl_qos_capabity qos_cap
;
542 struct iwl_qosparam_cmd def_qos_parm
;
545 #define STA_PS_STATUS_WAKE 0
546 #define STA_PS_STATUS_SLEEP 1
549 struct iwl3945_station_entry
{
550 struct iwl3945_addsta_cmd sta
;
551 struct iwl_tid_data tid
[MAX_TID_COUNT
];
554 struct iwl_hw_key keyinfo
;
557 struct iwl_station_entry
{
558 struct iwl_addsta_cmd sta
;
559 struct iwl_tid_data tid
[MAX_TID_COUNT
];
562 struct iwl_hw_key keyinfo
;
565 /* one for each uCode image (inst/data, boot/init/runtime) */
567 void *v_addr
; /* access by driver */
568 dma_addr_t p_addr
; /* access by card's busmaster DMA */
572 /* uCode file layout */
573 struct iwl_ucode_header
{
574 __le32 ver
; /* major/minor/API/serial */
577 __le32 inst_size
; /* bytes of runtime code */
578 __le32 data_size
; /* bytes of runtime data */
579 __le32 init_size
; /* bytes of init code */
580 __le32 init_data_size
; /* bytes of init data */
581 __le32 boot_size
; /* bytes of bootstrap code */
582 u8 data
[0]; /* in same order as sizes */
585 __le32 build
; /* build number */
586 __le32 inst_size
; /* bytes of runtime code */
587 __le32 data_size
; /* bytes of runtime data */
588 __le32 init_size
; /* bytes of init code */
589 __le32 init_data_size
; /* bytes of init data */
590 __le32 boot_size
; /* bytes of bootstrap code */
591 u8 data
[0]; /* in same order as sizes */
595 #define UCODE_HEADER_SIZE(ver) ((ver) == 1 ? 24 : 28)
597 struct iwl4965_ibss_seq
{
601 unsigned long packet_time
;
602 struct list_head list
;
605 struct iwl_sensitivity_ranges
{
612 u16 auto_corr_min_ofdm
;
613 u16 auto_corr_min_ofdm_mrc
;
614 u16 auto_corr_min_ofdm_x1
;
615 u16 auto_corr_min_ofdm_mrc_x1
;
617 u16 auto_corr_max_ofdm
;
618 u16 auto_corr_max_ofdm_mrc
;
619 u16 auto_corr_max_ofdm_x1
;
620 u16 auto_corr_max_ofdm_mrc_x1
;
622 u16 auto_corr_max_cck
;
623 u16 auto_corr_max_cck_mrc
;
624 u16 auto_corr_min_cck
;
625 u16 auto_corr_min_cck_mrc
;
629 #define KELVIN_TO_CELSIUS(x) ((x)-273)
630 #define CELSIUS_TO_KELVIN(x) ((x)+273)
634 * struct iwl_hw_params
635 * @max_txq_num: Max # Tx queues supported
636 * @dma_chnl_num: Number of Tx DMA/FIFO channels
637 * @scd_bc_tbls_size: size of scheduler byte count tables
638 * @tfd_size: TFD size
639 * @tx/rx_chains_num: Number of TX/RX chains
640 * @valid_tx/rx_ant: usable antennas
641 * @max_rxq_size: Max # Rx frames in Rx queue (must be power-of-2)
642 * @max_rxq_log: Log-base-2 of max_rxq_size
643 * @rx_buf_size: Rx buffer size
644 * @rx_wrt_ptr_reg: FH{39}_RSCSR_CHNL0_WPTR
647 * @ht40_channel: is 40MHz width possible in band 2.4
648 * BIT(IEEE80211_BAND_5GHZ) BIT(IEEE80211_BAND_5GHZ)
649 * @sw_crypto: 0 for hw, 1 for sw
650 * @max_xxx_size: for ucode uses
651 * @ct_kill_threshold: temperature threshold
652 * @calib_init_cfg: setup initial calibrations for the hw
653 * @struct iwl_sensitivity_ranges: range of sensitivity values
655 struct iwl_hw_params
{
658 u16 scd_bc_tbls_size
;
672 u8 max_beacon_itrvl
; /* in 1024 ms */
676 u32 ct_kill_threshold
; /* value in hw-dependent units */
677 u32 ct_kill_exit_threshold
; /* value in hw-dependent units */
678 /* for 1000, 6000 series and up */
680 const struct iwl_sensitivity_ranges
*sens
;
684 /******************************************************************************
686 * Functions implemented in core module which are forward declared here
687 * for use by iwl-[4-5].c
689 * NOTE: The implementation of these functions are not hardware specific
690 * which is why they are in the core module files.
692 * Naming convention --
693 * iwl_ <-- Is part of iwlwifi
694 * iwlXXXX_ <-- Hardware specific (implemented in iwl-XXXX.c for XXXX)
695 * iwl4965_bg_ <-- Called from work queue context
696 * iwl4965_mac_ <-- mac80211 callback
698 ****************************************************************************/
699 extern void iwl_update_chain_flags(struct iwl_priv
*priv
);
700 extern int iwl_set_pwr_src(struct iwl_priv
*priv
, enum iwl_pwr_src src
);
701 extern const u8 iwl_bcast_addr
[ETH_ALEN
];
702 extern int iwl_rxq_stop(struct iwl_priv
*priv
);
703 extern void iwl_txq_ctx_stop(struct iwl_priv
*priv
);
704 extern int iwl_queue_space(const struct iwl_queue
*q
);
705 static inline int iwl_queue_used(const struct iwl_queue
*q
, int i
)
707 return q
->write_ptr
> q
->read_ptr
?
708 (i
>= q
->read_ptr
&& i
< q
->write_ptr
) :
709 !(i
< q
->read_ptr
&& i
>= q
->write_ptr
);
713 static inline u8
get_cmd_index(struct iwl_queue
*q
, u32 index
, int is_huge
)
715 /* This is for scan command, the big buffer at end of command array */
717 return q
->n_window
; /* must be power of 2 */
719 /* Otherwise, use normal size buffers */
720 return index
& (q
->n_window
- 1);
730 #define IWL_OPERATION_MODE_AUTO 0
731 #define IWL_OPERATION_MODE_HT_ONLY 1
732 #define IWL_OPERATION_MODE_MIXED 2
733 #define IWL_OPERATION_MODE_20MHZ 3
735 #define IWL_TX_CRC_SIZE 4
736 #define IWL_TX_DELIMITER_SIZE 4
738 #define TX_POWER_IWL_ILLEGAL_VOLTAGE -10000
740 /* Sensitivity and chain noise calibration */
741 #define INITIALIZATION_VALUE 0xFFFF
742 #define IWL4965_CAL_NUM_BEACONS 20
743 #define IWL_CAL_NUM_BEACONS 16
744 #define MAXIMUM_ALLOWED_PATHLOSS 15
746 #define CHAIN_NOISE_MAX_DELTA_GAIN_CODE 3
748 #define MAX_FA_OFDM 50
749 #define MIN_FA_OFDM 5
750 #define MAX_FA_CCK 50
753 #define AUTO_CORR_STEP_OFDM 1
755 #define AUTO_CORR_STEP_CCK 3
756 #define AUTO_CORR_MAX_TH_CCK 160
759 #define NRG_STEP_CCK 2
761 #define MAX_NUMBER_CCK_NO_FA 100
763 #define AUTO_CORR_CCK_MIN_VAL_DEF (125)
768 #define CHAIN_NOISE_DELTA_GAIN_INIT_VAL 4
769 #define ALL_BAND_FILTER 0xFF00
770 #define IN_BAND_FILTER 0xFF
771 #define MIN_AVERAGE_NOISE_MAX_VALUE 0xFFFFFFFF
773 #define NRG_NUM_PREV_STAT_L 20
774 #define NUM_RX_CHAINS 3
776 enum iwl4965_false_alarm_state
{
779 IWL_FA_GOOD_RANGE
= 2,
782 enum iwl4965_chain_noise_state
{
783 IWL_CHAIN_NOISE_ALIVE
= 0, /* must be 0 */
784 IWL_CHAIN_NOISE_ACCUMULATE
,
785 IWL_CHAIN_NOISE_CALIBRATED
,
786 IWL_CHAIN_NOISE_DONE
,
789 enum iwl4965_calib_enabled_state
{
790 IWL_CALIB_DISABLED
= 0, /* must be 0 */
791 IWL_CALIB_ENABLED
= 1,
797 * defines the order in which results of initial calibrations
798 * should be sent to the runtime uCode
805 IWL_CALIB_TX_IQ_PERD
,
810 /* Opaque calibration results */
811 struct iwl_calib_result
{
822 /* Sensitivity calib data */
823 struct iwl_sensitivity_data
{
825 u32 auto_corr_ofdm_mrc
;
826 u32 auto_corr_ofdm_x1
;
827 u32 auto_corr_ofdm_mrc_x1
;
829 u32 auto_corr_cck_mrc
;
831 u32 last_bad_plcp_cnt_ofdm
;
832 u32 last_fa_cnt_ofdm
;
833 u32 last_bad_plcp_cnt_cck
;
839 u8 nrg_silence_rssi
[NRG_NUM_PREV_STAT_L
];
844 s32 nrg_auto_corr_silence_diff
;
845 u32 num_in_cck_no_fa
;
849 /* Chain noise (differential Rx gain) calib data */
850 struct iwl_chain_noise_data
{
859 u8 disconn_array
[NUM_RX_CHAINS
];
860 u8 delta_gain_code
[NUM_RX_CHAINS
];
865 #define EEPROM_SEM_TIMEOUT 10 /* milliseconds */
866 #define EEPROM_SEM_RETRY_LIMIT 1000 /* number of attempts (not time) */
868 #define IWL_TRAFFIC_ENTRIES (256)
869 #define IWL_TRAFFIC_ENTRY_SIZE (64)
872 MEASUREMENT_READY
= (1 << 0),
873 MEASUREMENT_ACTIVE
= (1 << 1),
877 NVM_DEVICE_TYPE_EEPROM
= 0,
882 * Two types of OTP memory access modes
883 * IWL_OTP_ACCESS_ABSOLUTE - absolute address mode,
884 * based on physical memory addressing
885 * IWL_OTP_ACCESS_RELATIVE - relative address mode,
886 * based on logical memory addressing
888 enum iwl_access_mode
{
889 IWL_OTP_ACCESS_ABSOLUTE
,
890 IWL_OTP_ACCESS_RELATIVE
,
894 * enum iwl_pa_type - Power Amplifier type
895 * @IWL_PA_SYSTEM: based on uCode configuration
896 * @IWL_PA_HYBRID: use both Internal and external PA
897 * @IWL_PA_INTERNAL: use Internal only
905 /* interrupt statistics */
906 struct isr_statistics
{
916 u32 rx_handlers
[REPLY_MAX
];
921 #ifdef CONFIG_IWLWIFI_DEBUGFS
922 /* management statistics */
923 enum iwl_mgmt_stats
{
924 MANAGEMENT_ASSOC_REQ
= 0,
925 MANAGEMENT_ASSOC_RESP
,
926 MANAGEMENT_REASSOC_REQ
,
927 MANAGEMENT_REASSOC_RESP
,
928 MANAGEMENT_PROBE_REQ
,
929 MANAGEMENT_PROBE_RESP
,
938 /* control statistics */
939 enum iwl_ctrl_stats
{
940 CONTROL_BACK_REQ
= 0,
951 struct traffic_stats
{
952 u32 mgmt
[MANAGEMENT_MAX
];
953 u32 ctrl
[CONTROL_MAX
];
958 struct traffic_stats
{
963 #define IWL_MAX_NUM_QUEUES 20 /* FIXME: do dynamic allocation */
967 /* ieee device used by generic ieee processing code */
968 struct ieee80211_hw
*hw
;
969 struct ieee80211_channel
*ieee_channels
;
970 struct ieee80211_rate
*ieee_rates
;
973 /* temporary frame storage list */
974 struct list_head free_frames
;
977 enum ieee80211_band band
;
980 void (*rx_handlers
[REPLY_MAX
])(struct iwl_priv
*priv
,
981 struct iwl_rx_mem_buffer
*rxb
);
983 struct ieee80211_supported_band bands
[IEEE80211_NUM_BANDS
];
985 #if defined(CONFIG_IWLWIFI_SPECTRUM_MEASUREMENT) || defined(CONFIG_IWL3945_SPECTRUM_MEASUREMENT)
986 /* spectrum measurement report caching */
987 struct iwl_spectrum_notification measure_report
;
988 u8 measurement_status
;
990 /* ucode beacon time */
991 u32 ucode_beacon_time
;
993 /* we allocate array of iwl4965_channel_info for NIC's valid channels.
994 * Access via channel # using indirect index array */
995 struct iwl_channel_info
*channel_info
; /* channel info array */
996 u8 channel_count
; /* # of channels */
998 /* each calibration channel group in the EEPROM has a derived
999 * clip setting for each rate. 3945 only.*/
1000 const struct iwl3945_clip_group clip39_groups
[5];
1002 /* thermal calibration */
1003 s32 temperature
; /* degrees Kelvin */
1004 s32 last_temperature
;
1006 /* init calibration results */
1007 struct iwl_calib_result calib_results
[IWL_CALIB_MAX
];
1009 /* Scan related variables */
1010 unsigned long last_scan_jiffies
;
1011 unsigned long next_scan_jiffies
;
1012 unsigned long scan_start
;
1013 unsigned long scan_pass_start
;
1014 unsigned long scan_start_tsf
;
1017 struct cfg80211_scan_request
*scan_request
;
1018 u8 scan_tx_ant
[IEEE80211_NUM_BANDS
];
1022 spinlock_t lock
; /* protect general shared data */
1023 spinlock_t hcmd_lock
; /* protect hcmd */
1024 spinlock_t reg_lock
; /* protect hw register access */
1027 /* basic pci-network driver stuff */
1028 struct pci_dev
*pci_dev
;
1030 /* pci hardware address support */
1031 void __iomem
*hw_base
;
1036 /* uCode images, save to reload in case of failure */
1037 u32 ucode_ver
; /* version of ucode, copy of
1039 struct fw_desc ucode_code
; /* runtime inst */
1040 struct fw_desc ucode_data
; /* runtime data original */
1041 struct fw_desc ucode_data_backup
; /* runtime data save/restore */
1042 struct fw_desc ucode_init
; /* initialization inst */
1043 struct fw_desc ucode_init_data
; /* initialization data */
1044 struct fw_desc ucode_boot
; /* bootstrap inst */
1045 enum ucode_type ucode_type
;
1046 u8 ucode_write_complete
; /* the image write is complete */
1049 struct iwl_rxon_time_cmd rxon_timing
;
1051 /* We declare this const so it can only be
1052 * changed via explicit cast within the
1053 * routines that actually update the physical
1055 const struct iwl_rxon_cmd active_rxon
;
1056 struct iwl_rxon_cmd staging_rxon
;
1058 struct iwl_rxon_cmd recovery_rxon
;
1060 /* 1st responses from initialize and runtime uCode images.
1061 * 4965's initialize alive response contains some calibration data. */
1062 struct iwl_init_alive_resp card_alive_init
;
1063 struct iwl_alive_resp card_alive
;
1065 unsigned long last_blink_time
;
1071 u16 active_rate_basic
;
1073 u8 assoc_station_added
;
1075 struct iwl_sensitivity_data sensitivity_data
;
1076 struct iwl_chain_noise_data chain_noise_data
;
1077 __le16 sensitivity_tbl
[HD_TABLE_SIZE
];
1079 struct iwl_ht_config current_ht_config
;
1080 u8 last_phy_res
[100];
1082 /* Rate scaling data */
1083 s8 data_retry_limit
;
1086 wait_queue_head_t wait_command_queue
;
1088 int activity_timer_active
;
1090 /* Rx and Tx DMA processing queues */
1091 struct iwl_rx_queue rxq
;
1092 struct iwl_tx_queue txq
[IWL_MAX_NUM_QUEUES
];
1093 unsigned long txq_ctx_active_msk
;
1094 struct iwl_dma_ptr kw
; /* keep warm address */
1095 struct iwl_dma_ptr scd_bc_tbls
;
1097 u32 scd_base_addr
; /* scheduler sram base address */
1099 unsigned long status
;
1101 int last_rx_rssi
; /* From Rx packet statistics */
1102 int last_rx_noise
; /* From beacon statistics */
1104 /* counts mgmt, ctl, and data packets */
1105 struct traffic_stats tx_stats
;
1106 struct traffic_stats rx_stats
;
1108 /* counts interrupts */
1109 struct isr_statistics isr_stats
;
1111 struct iwl_power_mgr power_data
;
1112 struct iwl_tt_mgmt thermal_throttle
;
1114 struct iwl_notif_statistics statistics
;
1115 unsigned long last_statistics_time
;
1117 /* context information */
1122 u8 mac_addr
[ETH_ALEN
];
1124 /*station table variables */
1125 spinlock_t sta_lock
;
1127 struct iwl_station_entry stations
[IWL_STATION_COUNT
];
1128 struct iwl_wep_key wep_keys
[WEP_KEYS_MAX
];
1131 unsigned long ucode_key_table
;
1133 /* queue refcounts */
1134 #define IWL_MAX_HW_QUEUES 32
1135 unsigned long queue_stopped
[BITS_TO_LONGS(IWL_MAX_HW_QUEUES
)];
1137 atomic_t queue_stop_count
[4];
1139 /* Indication if ieee80211_ops->open has been called */
1142 u8 mac80211_registered
;
1144 /* Rx'd packet timing information */
1145 u32 last_beacon_time
;
1150 int nvm_device_type
;
1151 struct iwl_eeprom_calib_info
*calib_info
;
1153 enum nl80211_iftype iw_mode
;
1155 struct sk_buff
*ibss_beacon
;
1157 /* Last Rx'd beacon timestamp */
1160 struct ieee80211_vif
*vif
;
1164 dma_addr_t shared_phys
;
1166 struct iwl_hw_params hw_params
;
1170 dma_addr_t ict_tbl_dma
;
1171 dma_addr_t aligned_ict_tbl_dma
;
1178 /* Current association information needed to configure the
1181 u16 assoc_capability
;
1183 struct iwl_qos_info qos_data
;
1185 struct workqueue_struct
*workqueue
;
1187 struct work_struct up
;
1188 struct work_struct restart
;
1189 struct work_struct calibrated_work
;
1190 struct work_struct scan_completed
;
1191 struct work_struct rx_replenish
;
1192 struct work_struct abort_scan
;
1193 struct work_struct update_link_led
;
1194 struct work_struct auth_work
;
1195 struct work_struct report_work
;
1196 struct work_struct request_scan
;
1197 struct work_struct beacon_update
;
1198 struct work_struct tt_work
;
1199 struct work_struct ct_enter
;
1200 struct work_struct ct_exit
;
1202 struct tasklet_struct irq_tasklet
;
1204 struct delayed_work init_alive_start
;
1205 struct delayed_work alive_start
;
1206 struct delayed_work scan_check
;
1209 struct delayed_work thermal_periodic
;
1210 struct delayed_work rfkill_poll
;
1213 s8 tx_power_user_lmt
;
1214 s8 tx_power_device_lmt
;
1217 #ifdef CONFIG_IWLWIFI_DEBUG
1218 /* debugging info */
1219 u32 debug_level
; /* per device debugging will override global
1220 iwl_debug_level if set */
1222 atomic_t restrict_refcnt
;
1224 #ifdef CONFIG_IWLWIFI_DEBUGFS
1230 struct iwl_debugfs
*dbgfs
;
1231 #endif /* CONFIG_IWLWIFI_DEBUGFS */
1232 #endif /* CONFIG_IWLWIFI_DEBUG */
1234 struct work_struct txpower_work
;
1235 u32 disable_sens_cal
;
1236 u32 disable_chain_noise_cal
;
1237 u32 disable_tx_power_cal
;
1238 struct work_struct run_time_calib_work
;
1239 struct timer_list statistics_periodic
;
1242 #define IWL_DEFAULT_TX_POWER 0x0F
1244 struct iwl3945_notif_statistics statistics_39
;
1249 static inline void iwl_txq_ctx_activate(struct iwl_priv
*priv
, int txq_id
)
1251 set_bit(txq_id
, &priv
->txq_ctx_active_msk
);
1254 static inline void iwl_txq_ctx_deactivate(struct iwl_priv
*priv
, int txq_id
)
1256 clear_bit(txq_id
, &priv
->txq_ctx_active_msk
);
1259 #ifdef CONFIG_IWLWIFI_DEBUG
1260 const char *iwl_get_tx_fail_reason(u32 status
);
1262 * iwl_get_debug_level: Return active debug level for device
1264 * Using sysfs it is possible to set per device debug level. This debug
1265 * level will be used if set, otherwise the global debug level which can be
1266 * set via module parameter is used.
1268 static inline u32
iwl_get_debug_level(struct iwl_priv
*priv
)
1270 if (priv
->debug_level
)
1271 return priv
->debug_level
;
1273 return iwl_debug_level
;
1276 static inline const char *iwl_get_tx_fail_reason(u32 status
) { return ""; }
1278 static inline u32
iwl_get_debug_level(struct iwl_priv
*priv
)
1280 return iwl_debug_level
;
1285 static inline struct ieee80211_hdr
*iwl_tx_queue_get_hdr(struct iwl_priv
*priv
,
1286 int txq_id
, int idx
)
1288 if (priv
->txq
[txq_id
].txb
[idx
].skb
[0])
1289 return (struct ieee80211_hdr
*)priv
->txq
[txq_id
].
1290 txb
[idx
].skb
[0]->data
;
1295 static inline int iwl_is_associated(struct iwl_priv
*priv
)
1297 return (priv
->active_rxon
.filter_flags
& RXON_FILTER_ASSOC_MSK
) ? 1 : 0;
1300 static inline int is_channel_valid(const struct iwl_channel_info
*ch_info
)
1302 if (ch_info
== NULL
)
1304 return (ch_info
->flags
& EEPROM_CHANNEL_VALID
) ? 1 : 0;
1307 static inline int is_channel_radar(const struct iwl_channel_info
*ch_info
)
1309 return (ch_info
->flags
& EEPROM_CHANNEL_RADAR
) ? 1 : 0;
1312 static inline u8
is_channel_a_band(const struct iwl_channel_info
*ch_info
)
1314 return ch_info
->band
== IEEE80211_BAND_5GHZ
;
1317 static inline u8
is_channel_bg_band(const struct iwl_channel_info
*ch_info
)
1319 return ch_info
->band
== IEEE80211_BAND_2GHZ
;
1322 static inline int is_channel_passive(const struct iwl_channel_info
*ch
)
1324 return (!(ch
->flags
& EEPROM_CHANNEL_ACTIVE
)) ? 1 : 0;
1327 static inline int is_channel_ibss(const struct iwl_channel_info
*ch
)
1329 return ((ch
->flags
& EEPROM_CHANNEL_IBSS
)) ? 1 : 0;
1332 #endif /* __iwl_dev_h__ */