1 /******************************************************************************
3 * Copyright(c) 2003 - 2008 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 * James P. Ketrenos <ipw2100-admin@linux.intel.com>
23 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
25 *****************************************************************************/
27 * Please use this file (iwl-4965.h) for driver implementation definitions.
28 * Please use iwl-4965-commands.h for uCode API definitions.
29 * Please use iwl-4965-hw.h for hardware-related definitions.
32 #ifndef __iwl_4965_h__
33 #define __iwl_4965_h__
35 #include <linux/pci.h> /* for struct pci_device_id */
36 #include <linux/kernel.h>
37 #include <net/ieee80211_radiotap.h>
39 #define DRV_NAME "iwl4965"
40 #include "iwl-rfkill.h"
41 #include "iwl-eeprom.h"
42 #include "iwl-4965-hw.h"
45 #include "iwl-debug.h"
47 #include "iwl-power.h"
49 /* configuration for the iwl4965 */
50 extern struct iwl_cfg iwl4965_agn_cfg
;
52 /* Change firmware file name, using "-" and incrementing number,
53 * *only* when uCode interface or architecture changes so that it
54 * is not compatible with earlier drivers.
55 * This number will also appear in << 8 position of 1st dword of uCode file */
56 #define IWL4965_UCODE_API "-1"
58 /* CT-KILL constants */
59 #define CT_KILL_THRESHOLD 110 /* in Celsius */
61 /* Default noise level to report when noise measurement is not available.
62 * This may be because we're:
63 * 1) Not associated (4965, no beacon statistics being sent to driver)
64 * 2) Scanning (noise measurement does not apply to associated channel)
65 * 3) Receiving CCK (3945 delivers noise info only for OFDM frames)
66 * Use default noise value of -127 ... this is below the range of measurable
67 * Rx dBm for either 3945 or 4965, so it can indicate "unmeasurable" to user.
68 * Also, -127 works better than 0 when averaging frames with/without
69 * noise info (e.g. averaging might be done in app); measured dBm values are
70 * always negative ... using a negative value as the default keeps all
71 * averages within an s8's (used in some apps) range of negative values. */
72 #define IWL_NOISE_MEAS_NOT_AVAILABLE (-127)
75 * RTS threshold here is total size [2347] minus 4 FCS bytes
77 * a value of 0 means RTS on all data/management packets
78 * a value > max MSDU size means no RTS
79 * else RTS for data/management frames where MPDU is larger
82 #define DEFAULT_RTS_THRESHOLD 2347U
83 #define MIN_RTS_THRESHOLD 0U
84 #define MAX_RTS_THRESHOLD 2347U
85 #define MAX_MSDU_SIZE 2304U
86 #define MAX_MPDU_SIZE 2346U
87 #define DEFAULT_BEACON_INTERVAL 100U
88 #define DEFAULT_SHORT_RETRY_LIMIT 7U
89 #define DEFAULT_LONG_RETRY_LIMIT 4U
91 struct iwl4965_rx_mem_buffer
{
94 struct list_head list
;
98 * Generic queue structure
100 * Contains common data for Rx and Tx queues
102 struct iwl4965_queue
{
103 int n_bd
; /* number of BDs in this queue */
104 int write_ptr
; /* 1-st empty entry (index) host_w*/
105 int read_ptr
; /* last used entry (index) host_r*/
106 dma_addr_t dma_addr
; /* physical addr for BD's */
107 int n_window
; /* safe queue window */
109 int low_mark
; /* low watermark, resume queue if free
110 * space more than this */
111 int high_mark
; /* high watermark, stop queue if free
112 * space less than this */
113 } __attribute__ ((packed
));
115 #define MAX_NUM_OF_TBS (20)
117 /* One for each TFD */
118 struct iwl4965_tx_info
{
119 struct ieee80211_tx_status status
;
120 struct sk_buff
*skb
[MAX_NUM_OF_TBS
];
124 * struct iwl4965_tx_queue - Tx Queue for DMA
125 * @q: generic Rx/Tx queue descriptor
126 * @bd: base of circular buffer of TFDs
127 * @cmd: array of command/Tx buffers
128 * @dma_addr_cmd: physical address of cmd/tx buffer array
129 * @txb: array of per-TFD driver data
130 * @need_update: indicates need to update read/write index
131 * @sched_retry: indicates queue is high-throughput aggregation (HT AGG) enabled
133 * A Tx queue consists of circular buffer of BDs (a.k.a. TFDs, transmit frame
134 * descriptors) and required locking structures.
136 struct iwl4965_tx_queue
{
137 struct iwl4965_queue q
;
138 struct iwl4965_tfd_frame
*bd
;
140 dma_addr_t dma_addr_cmd
;
141 struct iwl4965_tx_info
*txb
;
147 #define IWL_NUM_SCAN_RATES (2)
149 struct iwl4965_channel_tgd_info
{
154 struct iwl4965_channel_tgh_info
{
158 /* current Tx power values to use, one for each rate for each channel.
159 * requested power is limited by:
160 * -- regulatory EEPROM limits for this channel
161 * -- hardware capabilities (clip-powers)
162 * -- spectrum management
163 * -- user preference (e.g. iwconfig)
164 * when requested power is set, base power index must also be set. */
165 struct iwl4965_channel_power_info
{
166 struct iwl4965_tx_power tpc
; /* actual radio and DSP gain settings */
167 s8 power_table_index
; /* actual (compenst'd) index into gain table */
168 s8 base_power_index
; /* gain index for power at factory temp. */
169 s8 requested_power
; /* power (dBm) requested for this chnl/rate */
172 /* current scan Tx power values to use, one for each scan rate for each
174 struct iwl4965_scan_power_info
{
175 struct iwl4965_tx_power tpc
; /* actual radio and DSP gain settings */
176 s8 power_table_index
; /* actual (compenst'd) index into gain table */
177 s8 requested_power
; /* scan pwr (dBm) requested for chnl/rate */
180 /* For fat_extension_channel */
182 HT_IE_EXT_CHANNEL_NONE
= 0,
183 HT_IE_EXT_CHANNEL_ABOVE
,
184 HT_IE_EXT_CHANNEL_INVALID
,
185 HT_IE_EXT_CHANNEL_BELOW
,
186 HT_IE_EXT_CHANNEL_MAX
190 * One for each channel, holds all channel setup data
191 * Some of the fields (e.g. eeprom and flags/max_power_avg) are redundant
194 #define IWL4965_MAX_RATE (33)
196 struct iwl_channel_info
{
197 struct iwl4965_channel_tgd_info tgd
;
198 struct iwl4965_channel_tgh_info tgh
;
199 struct iwl_eeprom_channel eeprom
; /* EEPROM regulatory limit */
200 struct iwl_eeprom_channel fat_eeprom
; /* EEPROM regulatory limit for
203 u8 channel
; /* channel number */
204 u8 flags
; /* flags copied from EEPROM */
205 s8 max_power_avg
; /* (dBm) regul. eeprom, normal Tx, any rate */
206 s8 curr_txpow
; /* (dBm) regulatory/spectrum/user (not h/w) limit */
207 s8 min_power
; /* always 0 */
208 s8 scan_power
; /* (dBm) regul. eeprom, direct scans, any rate */
210 u8 group_index
; /* 0-4, maps channel to group1/2/3/4/5 */
211 u8 band_index
; /* 0-4, maps channel to band1/2/3/4/5 */
212 enum ieee80211_band band
;
214 /* Radio/DSP gain settings for each "normal" data Tx rate.
215 * These include, in addition to RF and DSP gain, a few fields for
216 * remembering/modifying gain settings (indexes). */
217 struct iwl4965_channel_power_info power_info
[IWL4965_MAX_RATE
];
219 /* FAT channel info */
220 s8 fat_max_power_avg
; /* (dBm) regul. eeprom, normal Tx, any rate */
221 s8 fat_curr_txpow
; /* (dBm) regulatory/spectrum/user (not h/w) */
222 s8 fat_min_power
; /* always 0 */
223 s8 fat_scan_power
; /* (dBm) eeprom, direct scans, any rate */
224 u8 fat_flags
; /* flags copied from EEPROM */
225 u8 fat_extension_channel
; /* HT_IE_EXT_CHANNEL_* */
227 /* Radio/DSP gain settings for each scan rate, for directed scans. */
228 struct iwl4965_scan_power_info scan_pwr_info
[IWL_NUM_SCAN_RATES
];
231 struct iwl4965_clip_group
{
232 /* maximum power level to prevent clipping for each rate, derived by
233 * us from this band's saturation power in EEPROM */
234 const s8 clip_powers
[IWL_MAX_RATES
];
237 #include "iwl-4965-rs.h"
239 #define IWL_TX_FIFO_AC0 0
240 #define IWL_TX_FIFO_AC1 1
241 #define IWL_TX_FIFO_AC2 2
242 #define IWL_TX_FIFO_AC3 3
243 #define IWL_TX_FIFO_HCCA_1 5
244 #define IWL_TX_FIFO_HCCA_2 6
245 #define IWL_TX_FIFO_NONE 7
247 /* Minimum number of queues. MAX_NUM is defined in hw specific files */
248 #define IWL_MIN_NUM_QUEUES 4
250 /* Power management (not Tx power) structures */
257 #define IEEE80211_DATA_LEN 2304
258 #define IEEE80211_4ADDR_LEN 30
259 #define IEEE80211_HLEN (IEEE80211_4ADDR_LEN)
260 #define IEEE80211_FRAME_LEN (IEEE80211_DATA_LEN + IEEE80211_HLEN)
262 struct iwl4965_frame
{
264 struct ieee80211_hdr frame
;
265 struct iwl4965_tx_beacon_cmd beacon
;
266 u8 raw
[IEEE80211_FRAME_LEN
];
269 struct list_head list
;
272 #define SEQ_TO_QUEUE(x) ((x >> 8) & 0xbf)
273 #define QUEUE_TO_SEQ(x) ((x & 0xbf) << 8)
274 #define SEQ_TO_INDEX(x) ((u8)(x & 0xff))
275 #define INDEX_TO_SEQ(x) ((u8)(x & 0xff))
276 #define SEQ_HUGE_FRAME (0x4000)
277 #define SEQ_RX_FRAME __constant_cpu_to_le16(0x8000)
278 #define SEQ_TO_SN(seq) (((seq) & IEEE80211_SCTL_SEQ) >> 4)
279 #define SN_TO_SEQ(ssn) (((ssn) << 4) & IEEE80211_SCTL_SEQ)
280 #define MAX_SN ((IEEE80211_SCTL_SEQ) >> 4)
283 /* CMD_SIZE_NORMAL = 0, */
284 CMD_SIZE_HUGE
= (1 << 0),
286 CMD_ASYNC
= (1 << 1),
287 /* CMD_NO_SKB = 0, */
288 CMD_WANT_SKB
= (1 << 2),
294 struct iwl_cmd_meta
{
295 struct iwl_cmd_meta
*source
;
298 int (*callback
)(struct iwl_priv
*priv
,
299 struct iwl_cmd
*cmd
, struct sk_buff
*skb
);
300 } __attribute__ ((packed
)) u
;
302 /* The CMD_SIZE_HUGE flag bit indicates that the command
303 * structure is stored at the end of the shared queue memory. */
306 } __attribute__ ((packed
));
311 * For allocation of the command and tx queues, this establishes the overall
312 * size of the largest command we send to uCode, except for a scan command
313 * (which is relatively huge; space is allocated separately).
316 struct iwl_cmd_meta meta
; /* driver data */
317 struct iwl_cmd_header hdr
; /* uCode API */
319 struct iwl4965_addsta_cmd addsta
;
320 struct iwl4965_led_cmd led
;
325 struct iwl4965_bt_cmd bt
;
326 struct iwl4965_rxon_time_cmd rxon_time
;
327 struct iwl4965_powertable_cmd powertable
;
328 struct iwl4965_qosparam_cmd qosparam
;
329 struct iwl4965_tx_cmd tx
;
330 struct iwl4965_tx_beacon_cmd tx_beacon
;
331 struct iwl4965_rxon_assoc_cmd rxon_assoc
;
334 } __attribute__ ((packed
)) cmd
;
335 } __attribute__ ((packed
));
337 struct iwl_host_cmd
{
340 struct iwl_cmd_meta meta
;
344 #define TFD_MAX_PAYLOAD_SIZE (sizeof(struct iwl_cmd) - \
345 sizeof(struct iwl_cmd_meta))
348 * RX related structures and functions
350 #define RX_FREE_BUFFERS 64
351 #define RX_LOW_WATERMARK 8
353 #define SUP_RATE_11A_MAX_NUM_CHANNELS 8
354 #define SUP_RATE_11B_MAX_NUM_CHANNELS 4
355 #define SUP_RATE_11G_MAX_NUM_CHANNELS 12
358 * struct iwl4965_rx_queue - Rx queue
359 * @processed: Internal index to last handled Rx packet
360 * @read: Shared index to newest available Rx buffer
361 * @write: Shared index to oldest written Rx packet
362 * @free_count: Number of pre-allocated buffers in rx_free
363 * @rx_free: list of free SKBs for use
364 * @rx_used: List of Rx buffers with no SKB
365 * @need_update: flag to indicate we need to update read/write index
367 * NOTE: rx_free and rx_used are used as a FIFO for iwl4965_rx_mem_buffers
369 struct iwl4965_rx_queue
{
372 struct iwl4965_rx_mem_buffer pool
[RX_QUEUE_SIZE
+ RX_FREE_BUFFERS
];
373 struct iwl4965_rx_mem_buffer
*queue
[RX_QUEUE_SIZE
];
378 struct list_head rx_free
;
379 struct list_head rx_used
;
384 #define IWL_SUPPORTED_RATES_IE_LEN 8
386 #define SCAN_INTERVAL 100
388 #define MAX_A_CHANNELS 252
389 #define MIN_A_CHANNELS 7
391 #define MAX_B_CHANNELS 14
392 #define MIN_B_CHANNELS 1
394 #define MAX_TID_COUNT 9
396 #define IWL_INVALID_RATE 0xFF
397 #define IWL_INVALID_VALUE -1
399 #ifdef CONFIG_IWL4965_HT
401 * struct iwl4965_ht_agg -- aggregation status while waiting for block-ack
402 * @txq_id: Tx queue used for Tx attempt
403 * @frame_count: # frames attempted by Tx command
404 * @wait_for_ba: Expect block-ack before next Tx reply
405 * @start_idx: Index of 1st Transmit Frame Descriptor (TFD) in Tx window
406 * @bitmap0: Low order bitmap, one bit for each frame pending ACK in Tx window
407 * @bitmap1: High order, one bit for each frame pending ACK in Tx window
408 * @rate_n_flags: Rate at which Tx was attempted
410 * If REPLY_TX indicates that aggregation was attempted, driver must wait
411 * for block ack (REPLY_COMPRESSED_BA). This struct stores tx reply info
412 * until block ack arrives.
414 struct iwl4965_ht_agg
{
421 #define IWL_AGG_OFF 0
423 #define IWL_EMPTYING_HW_QUEUE_ADDBA 2
424 #define IWL_EMPTYING_HW_QUEUE_DELBA 3
428 #endif /* CONFIG_IWL4965_HT */
430 struct iwl4965_tid_data
{
433 #ifdef CONFIG_IWL4965_HT
434 struct iwl4965_ht_agg agg
;
435 #endif /* CONFIG_IWL4965_HT */
438 struct iwl4965_hw_key
{
439 enum ieee80211_key_alg alg
;
442 struct ieee80211_key_conf
*conf
;
446 union iwl4965_ht_rate_supp
{
454 #ifdef CONFIG_IWL4965_HT
455 #define CFG_HT_RX_AMPDU_FACTOR_DEF (0x3)
456 #define CFG_HT_MPDU_DENSITY_2USEC (0x5)
457 #define CFG_HT_MPDU_DENSITY_DEF CFG_HT_MPDU_DENSITY_2USEC
460 /* self configuration data */
462 u8 supported_chan_width
;
465 u8 sgf
; /* HT_SHORT_GI_* short guard interval */
470 /* BSS related data */
472 u8 extension_chan_offset
;
475 u8 non_GF_STA_present
;
477 #endif /*CONFIG_IWL4965_HT */
479 union iwl4965_qos_capabity
{
481 u8 edca_count
:4; /* bit 0-3 */
482 u8 q_ack
:1; /* bit 4 */
483 u8 queue_request
:1; /* bit 5 */
484 u8 txop_request
:1; /* bit 6 */
485 u8 reserved
:1; /* bit 7 */
488 u8 acvo_APSD
:1; /* bit 0 */
489 u8 acvi_APSD
:1; /* bit 1 */
490 u8 ac_bk_APSD
:1; /* bit 2 */
491 u8 ac_be_APSD
:1; /* bit 3 */
492 u8 q_ack
:1; /* bit 4 */
493 u8 max_len
:2; /* bit 5-6 */
494 u8 more_data_ack
:1; /* bit 7 */
500 struct iwl4965_qos_info
{
503 union iwl4965_qos_capabity qos_cap
;
504 struct iwl4965_qosparam_cmd def_qos_parm
;
507 #define STA_PS_STATUS_WAKE 0
508 #define STA_PS_STATUS_SLEEP 1
510 struct iwl4965_station_entry
{
511 struct iwl4965_addsta_cmd sta
;
512 struct iwl4965_tid_data tid
[MAX_TID_COUNT
];
515 struct iwl4965_hw_key keyinfo
;
518 /* one for each uCode image (inst/data, boot/init/runtime) */
520 void *v_addr
; /* access by driver */
521 dma_addr_t p_addr
; /* access by card's busmaster DMA */
525 /* uCode file layout */
526 struct iwl4965_ucode
{
527 __le32 ver
; /* major/minor/subminor */
528 __le32 inst_size
; /* bytes of runtime instructions */
529 __le32 data_size
; /* bytes of runtime data */
530 __le32 init_size
; /* bytes of initialization instructions */
531 __le32 init_data_size
; /* bytes of initialization data */
532 __le32 boot_size
; /* bytes of bootstrap instructions */
533 u8 data
[0]; /* data in same order as "size" elements */
536 #define IWL_IBSS_MAC_HASH_SIZE 32
538 struct iwl4965_ibss_seq
{
542 unsigned long packet_time
;
543 struct list_head list
;
546 struct iwl_sensitivity_ranges
{
553 u16 auto_corr_min_ofdm
;
554 u16 auto_corr_min_ofdm_mrc
;
555 u16 auto_corr_min_ofdm_x1
;
556 u16 auto_corr_min_ofdm_mrc_x1
;
558 u16 auto_corr_max_ofdm
;
559 u16 auto_corr_max_ofdm_mrc
;
560 u16 auto_corr_max_ofdm_x1
;
561 u16 auto_corr_max_ofdm_mrc_x1
;
563 u16 auto_corr_max_cck
;
564 u16 auto_corr_max_cck_mrc
;
565 u16 auto_corr_min_cck
;
566 u16 auto_corr_min_cck_mrc
;
570 #define IWL_FAT_CHANNEL_52 BIT(IEEE80211_BAND_5GHZ)
573 * struct iwl_hw_params
574 * @max_txq_num: Max # Tx queues supported
575 * @tx_cmd_len: Size of Tx command (but not including frame itself)
576 * @tx/rx_chains_num: Number of TX/RX chains
577 * @valid_tx/rx_ant: usable antennas
578 * @max_rxq_size: Max # Rx frames in Rx queue (must be power-of-2)
579 * @max_rxq_log: Log-base-2 of max_rxq_size
580 * @rx_buf_size: Rx buffer size
583 * @fat_channel: is 40MHz width possible in band 2.4
584 * BIT(IEEE80211_BAND_5GHZ) BIT(IEEE80211_BAND_5GHZ)
585 * @sw_crypto: 0 for hw, 1 for sw
586 * @max_xxx_size: for ucode uses
587 * @ct_kill_threshold: temperature threshold
588 * @struct iwl_sensitivity_ranges: range of sensitivity values
590 struct iwl_hw_params
{
608 u32 ct_kill_threshold
; /* value in hw-dependent units */
609 #ifdef CONFIG_IWLWIFI_RUN_TIME_CALIB
610 const struct iwl_sensitivity_ranges
*sens
;
614 #define HT_SHORT_GI_20MHZ_ONLY (1 << 0)
615 #define HT_SHORT_GI_40MHZ_ONLY (1 << 1)
618 #define IWL_RX_HDR(x) ((struct iwl4965_rx_frame_hdr *)(\
619 x->u.rx_frame.stats.payload + \
620 x->u.rx_frame.stats.phy_count))
621 #define IWL_RX_END(x) ((struct iwl4965_rx_frame_end *)(\
622 IWL_RX_HDR(x)->payload + \
623 le16_to_cpu(IWL_RX_HDR(x)->len)))
624 #define IWL_RX_STATS(x) (&x->u.rx_frame.stats)
625 #define IWL_RX_DATA(x) (IWL_RX_HDR(x)->payload)
628 /******************************************************************************
630 * Functions implemented in iwl-base.c which are forward declared here
633 *****************************************************************************/
634 struct iwl4965_addsta_cmd
;
635 extern int iwl4965_send_add_station(struct iwl_priv
*priv
,
636 struct iwl4965_addsta_cmd
*sta
, u8 flags
);
637 extern u8
iwl4965_add_station_flags(struct iwl_priv
*priv
, const u8
*addr
,
638 int is_ap
, u8 flags
, void *ht_data
);
639 extern int iwl4965_is_network_packet(struct iwl_priv
*priv
,
640 struct ieee80211_hdr
*header
);
641 extern int iwl4965_power_init_handle(struct iwl_priv
*priv
);
642 extern void iwl4965_handle_data_packet_monitor(struct iwl_priv
*priv
,
643 struct iwl4965_rx_mem_buffer
*rxb
,
644 void *data
, short len
,
645 struct ieee80211_rx_status
*stats
,
647 extern int iwl4965_is_duplicate_packet(struct iwl_priv
*priv
,
648 struct ieee80211_hdr
*header
);
649 extern int iwl4965_rx_queue_alloc(struct iwl_priv
*priv
);
650 extern void iwl4965_rx_queue_reset(struct iwl_priv
*priv
,
651 struct iwl4965_rx_queue
*rxq
);
652 extern int iwl4965_calc_db_from_ratio(int sig_ratio
);
653 extern int iwl4965_calc_sig_qual(int rssi_dbm
, int noise_dbm
);
654 extern int iwl4965_tx_queue_init(struct iwl_priv
*priv
,
655 struct iwl4965_tx_queue
*txq
, int count
, u32 id
);
656 extern void iwl4965_rx_replenish(void *data
);
657 extern void iwl4965_tx_queue_free(struct iwl_priv
*priv
, struct iwl4965_tx_queue
*txq
);
658 extern unsigned int iwl4965_fill_beacon_frame(struct iwl_priv
*priv
,
659 struct ieee80211_hdr
*hdr
,
660 const u8
*dest
, int left
);
661 extern int iwl4965_rx_queue_update_write_ptr(struct iwl_priv
*priv
,
662 struct iwl4965_rx_queue
*q
);
663 extern __le16
*ieee80211_get_qos_ctrl(struct ieee80211_hdr
*hdr
);
664 extern void iwl4965_update_chain_flags(struct iwl_priv
*priv
);
665 int iwl4965_set_pwr_src(struct iwl_priv
*priv
, enum iwl_pwr_src src
);
667 int iwl4965_init_geos(struct iwl_priv
*priv
);
668 void iwl4965_free_geos(struct iwl_priv
*priv
);
670 extern const u8 iwl4965_broadcast_addr
[ETH_ALEN
];
671 int iwl4965_enqueue_hcmd(struct iwl_priv
*priv
, struct iwl_host_cmd
*cmd
);
674 * Currently used by iwl-3945-rs... look at restructuring so that it doesn't
675 * call this... todo... fix that.
677 extern u8
iwl4965_sync_station(struct iwl_priv
*priv
, int sta_id
,
678 u16 tx_rate
, u8 flags
);
680 /******************************************************************************
682 * Functions implemented in iwl-[34]*.c which are forward declared here
683 * for use by iwl-base.c
685 * NOTE: The implementation of these functions are hardware specific
686 * which is why they are in the hardware specific files (vs. iwl-base.c)
688 * Naming convention --
689 * iwl4965_ <-- Its part of iwlwifi (should be changed to iwl4965_)
690 * iwl4965_hw_ <-- Hardware specific (implemented in iwl-XXXX.c by all HW)
691 * iwlXXXX_ <-- Hardware specific (implemented in iwl-XXXX.c for XXXX)
692 * iwl4965_bg_ <-- Called from work queue context
693 * iwl4965_mac_ <-- mac80211 callback
695 ****************************************************************************/
696 extern void iwl4965_hw_rx_handler_setup(struct iwl_priv
*priv
);
697 extern void iwl4965_hw_setup_deferred_work(struct iwl_priv
*priv
);
698 extern void iwl4965_hw_cancel_deferred_work(struct iwl_priv
*priv
);
699 extern int iwl4965_hw_rxq_stop(struct iwl_priv
*priv
);
700 extern int iwl4965_hw_set_hw_params(struct iwl_priv
*priv
);
701 extern int iwl4965_hw_nic_init(struct iwl_priv
*priv
);
702 extern int iwl4965_hw_nic_stop_master(struct iwl_priv
*priv
);
703 extern void iwl4965_hw_txq_ctx_free(struct iwl_priv
*priv
);
704 extern void iwl4965_hw_txq_ctx_stop(struct iwl_priv
*priv
);
705 extern int iwl4965_hw_nic_reset(struct iwl_priv
*priv
);
706 extern int iwl4965_hw_txq_attach_buf_to_tfd(struct iwl_priv
*priv
, void *tfd
,
707 dma_addr_t addr
, u16 len
);
708 extern int iwl4965_hw_txq_free_tfd(struct iwl_priv
*priv
, struct iwl4965_tx_queue
*txq
);
709 extern int iwl4965_hw_get_temperature(struct iwl_priv
*priv
);
710 extern int iwl4965_hw_tx_queue_init(struct iwl_priv
*priv
,
711 struct iwl4965_tx_queue
*txq
);
712 extern unsigned int iwl4965_hw_get_beacon_cmd(struct iwl_priv
*priv
,
713 struct iwl4965_frame
*frame
, u8 rate
);
714 extern int iwl4965_hw_get_rx_read(struct iwl_priv
*priv
);
715 extern void iwl4965_hw_build_tx_cmd_rate(struct iwl_priv
*priv
,
717 struct ieee80211_tx_control
*ctrl
,
718 struct ieee80211_hdr
*hdr
,
719 int sta_id
, int tx_id
);
720 extern int iwl4965_hw_reg_send_txpower(struct iwl_priv
*priv
);
721 extern int iwl4965_hw_reg_set_txpower(struct iwl_priv
*priv
, s8 power
);
722 extern void iwl4965_hw_rx_statistics(struct iwl_priv
*priv
,
723 struct iwl4965_rx_mem_buffer
*rxb
);
724 extern void iwl4965_disable_events(struct iwl_priv
*priv
);
725 extern int iwl4965_get_temperature(const struct iwl_priv
*priv
);
728 * iwl_find_station - Find station id for a given BSSID
729 * @bssid: MAC address of station ID to find
731 * NOTE: This should not be hardware specific but the code has
732 * not yet been merged into a single common layer for managing the
735 extern u8
iwl_find_station(struct iwl_priv
*priv
, const u8
*bssid
);
737 extern int iwl4965_hw_channel_switch(struct iwl_priv
*priv
, u16 channel
);
738 extern int iwl4965_tx_queue_reclaim(struct iwl_priv
*priv
, int txq_id
, int index
);
739 extern int iwl4965_queue_space(const struct iwl4965_queue
*q
);
742 extern void iwl4965_radio_kill_sw(struct iwl_priv
*priv
, int disable_radio
);
744 * Forward declare iwl-4965.c functions for iwl-base.c
746 extern int iwl4965_tx_queue_update_wr_ptr(struct iwl_priv
*priv
,
747 struct iwl4965_tx_queue
*txq
,
749 extern void iwl4965_add_station(struct iwl_priv
*priv
, const u8
*addr
,
751 extern void iwl4965_set_rxon_chain(struct iwl_priv
*priv
);
752 extern int iwl4965_alive_notify(struct iwl_priv
*priv
);
753 extern void iwl4965_update_rate_scaling(struct iwl_priv
*priv
, u8 mode
);
754 extern void iwl4965_rf_kill_ct_config(struct iwl_priv
*priv
);
755 extern void iwl4965_hwrate_to_tx_control(struct iwl_priv
*priv
,
757 struct ieee80211_tx_control
*control
);
759 #ifdef CONFIG_IWL4965_HT
760 extern void iwl4965_init_ht_hw_capab(const struct iwl_priv
*priv
,
761 struct ieee80211_ht_info
*ht_info
,
762 enum ieee80211_band band
);
763 void iwl4965_set_rxon_ht(struct iwl_priv
*priv
,
764 struct iwl_ht_info
*ht_info
);
765 void iwl4965_set_ht_add_station(struct iwl_priv
*priv
, u8 index
,
766 struct ieee80211_ht_info
*sta_ht_inf
);
767 int iwl4965_mac_ampdu_action(struct ieee80211_hw
*hw
,
768 enum ieee80211_ampdu_mlme_action action
,
769 const u8
*addr
, u16 tid
, u16
*ssn
);
770 int iwl4965_check_empty_hw_queue(struct iwl_priv
*priv
, int sta_id
,
773 static inline void iwl4965_init_ht_hw_capab(const struct iwl_priv
*priv
,
774 struct ieee80211_ht_info
*ht_info
,
775 enum ieee80211_band band
) {}
777 #endif /*CONFIG_IWL4965_HT */
778 /* Structures, enum, and defines specific to the 4965 */
780 #define IWL4965_KW_SIZE 0x1000 /*4k */
788 #define IWL_CHANNEL_WIDTH_20MHZ 0
789 #define IWL_CHANNEL_WIDTH_40MHZ 1
791 #define IWL_MIMO_PS_STATIC 0
792 #define IWL_MIMO_PS_NONE 3
793 #define IWL_MIMO_PS_DYNAMIC 1
794 #define IWL_MIMO_PS_INVALID 2
796 #define IWL_OPERATION_MODE_AUTO 0
797 #define IWL_OPERATION_MODE_HT_ONLY 1
798 #define IWL_OPERATION_MODE_MIXED 2
799 #define IWL_OPERATION_MODE_20MHZ 3
801 #define IWL_EXT_CHANNEL_OFFSET_NONE 0
802 #define IWL_EXT_CHANNEL_OFFSET_ABOVE 1
803 #define IWL_EXT_CHANNEL_OFFSET_RESERVE1 2
804 #define IWL_EXT_CHANNEL_OFFSET_BELOW 3
806 #define IWL_TX_CRC_SIZE 4
807 #define IWL_TX_DELIMITER_SIZE 4
809 #define TX_POWER_IWL_ILLEGAL_VOLTAGE -10000
811 struct iwl4965_lq_mngr
{
815 u8
*next_higher_rate
;
818 unsigned long stamp_last
;
824 /* Sensitivity and chain noise calibration */
825 #define INTERFERENCE_DATA_AVAILABLE __constant_cpu_to_le32(1)
826 #define INITIALIZATION_VALUE 0xFFFF
827 #define CAL_NUM_OF_BEACONS 20
828 #define MAXIMUM_ALLOWED_PATHLOSS 15
830 #define CHAIN_NOISE_MAX_DELTA_GAIN_CODE 3
832 #define MAX_FA_OFDM 50
833 #define MIN_FA_OFDM 5
834 #define MAX_FA_CCK 50
837 #define AUTO_CORR_STEP_OFDM 1
839 #define AUTO_CORR_STEP_CCK 3
840 #define AUTO_CORR_MAX_TH_CCK 160
843 #define NRG_STEP_CCK 2
845 #define MAX_NUMBER_CCK_NO_FA 100
847 #define AUTO_CORR_CCK_MIN_VAL_DEF (125)
852 #define CHAIN_NOISE_DELTA_GAIN_INIT_VAL 4
853 #define ALL_BAND_FILTER 0xFF00
854 #define IN_BAND_FILTER 0xFF
855 #define MIN_AVERAGE_NOISE_MAX_VALUE 0xFFFFFFFF
857 #define NRG_NUM_PREV_STAT_L 20
858 #define NUM_RX_CHAINS 3
860 enum iwl4965_false_alarm_state
{
863 IWL_FA_GOOD_RANGE
= 2,
866 enum iwl4965_chain_noise_state
{
867 IWL_CHAIN_NOISE_ALIVE
= 0, /* must be 0 */
868 IWL_CHAIN_NOISE_ACCUMULATE
= 1,
869 IWL_CHAIN_NOISE_CALIBRATED
= 2,
872 enum iwl4965_calib_enabled_state
{
873 IWL_CALIB_DISABLED
= 0, /* must be 0 */
874 IWL_CALIB_ENABLED
= 1,
877 struct statistics_general_data
{
878 u32 beacon_silence_rssi_a
;
879 u32 beacon_silence_rssi_b
;
880 u32 beacon_silence_rssi_c
;
886 #ifdef CONFIG_IWLWIFI_RUN_TIME_CALIB
887 /* Sensitivity calib data */
888 struct iwl_sensitivity_data
{
890 u32 auto_corr_ofdm_mrc
;
891 u32 auto_corr_ofdm_x1
;
892 u32 auto_corr_ofdm_mrc_x1
;
894 u32 auto_corr_cck_mrc
;
896 u32 last_bad_plcp_cnt_ofdm
;
897 u32 last_fa_cnt_ofdm
;
898 u32 last_bad_plcp_cnt_cck
;
904 u8 nrg_silence_rssi
[NRG_NUM_PREV_STAT_L
];
909 s32 nrg_auto_corr_silence_diff
;
910 u32 num_in_cck_no_fa
;
914 /* Chain noise (differential Rx gain) calib data */
915 struct iwl_chain_noise_data
{
924 u8 disconn_array
[NUM_RX_CHAINS
];
925 u8 delta_gain_code
[NUM_RX_CHAINS
];
928 #endif /* CONFIG_IWLWIFI_RUN_TIME_CALIB */
930 #define EEPROM_SEM_TIMEOUT 10 /* milliseconds */
931 #define EEPROM_SEM_RETRY_LIMIT 1000 /* number of attempts (not time) */
934 #ifdef CONFIG_IWL4965_SPECTRUM_MEASUREMENT
937 MEASUREMENT_READY
= (1 << 0),
938 MEASUREMENT_ACTIVE
= (1 << 1),
943 #define IWL_MAX_NUM_QUEUES 20 /* FIXME: do dynamic allocation */
947 /* ieee device used by generic ieee processing code */
948 struct ieee80211_hw
*hw
;
949 struct ieee80211_channel
*ieee_channels
;
950 struct ieee80211_rate
*ieee_rates
;
953 /* temporary frame storage list */
954 struct list_head free_frames
;
957 enum ieee80211_band band
;
961 void (*rx_handlers
[REPLY_MAX
])(struct iwl_priv
*priv
,
962 struct iwl4965_rx_mem_buffer
*rxb
);
964 struct ieee80211_supported_band bands
[IEEE80211_NUM_BANDS
];
966 #ifdef CONFIG_IWL4965_SPECTRUM_MEASUREMENT
967 /* spectrum measurement report caching */
968 struct iwl4965_spectrum_notification measure_report
;
969 u8 measurement_status
;
971 /* ucode beacon time */
972 u32 ucode_beacon_time
;
974 /* we allocate array of iwl4965_channel_info for NIC's valid channels.
975 * Access via channel # using indirect index array */
976 struct iwl_channel_info
*channel_info
; /* channel info array */
977 u8 channel_count
; /* # of channels */
979 /* each calibration channel group in the EEPROM has a derived
980 * clip setting for each rate. */
981 const struct iwl4965_clip_group clip_groups
[5];
983 /* thermal calibration */
984 s32 temperature
; /* degrees Kelvin */
985 s32 last_temperature
;
987 /* Scan related variables */
988 unsigned long last_scan_jiffies
;
989 unsigned long next_scan_jiffies
;
990 unsigned long scan_start
;
991 unsigned long scan_pass_start
;
992 unsigned long scan_start_tsf
;
996 u8 direct_ssid
[IW_ESSID_MAX_SIZE
];
997 struct iwl4965_scan_cmd
*scan
;
1000 spinlock_t lock
; /* protect general shared data */
1001 spinlock_t hcmd_lock
; /* protect hcmd */
1004 /* basic pci-network driver stuff */
1005 struct pci_dev
*pci_dev
;
1007 /* pci hardware address support */
1008 void __iomem
*hw_base
;
1013 /* uCode images, save to reload in case of failure */
1014 struct fw_desc ucode_code
; /* runtime inst */
1015 struct fw_desc ucode_data
; /* runtime data original */
1016 struct fw_desc ucode_data_backup
; /* runtime data save/restore */
1017 struct fw_desc ucode_init
; /* initialization inst */
1018 struct fw_desc ucode_init_data
; /* initialization data */
1019 struct fw_desc ucode_boot
; /* bootstrap inst */
1022 struct iwl4965_rxon_time_cmd rxon_timing
;
1024 /* We declare this const so it can only be
1025 * changed via explicit cast within the
1026 * routines that actually update the physical
1028 const struct iwl4965_rxon_cmd active_rxon
;
1029 struct iwl4965_rxon_cmd staging_rxon
;
1031 int error_recovering
;
1032 struct iwl4965_rxon_cmd recovery_rxon
;
1034 /* 1st responses from initialize and runtime uCode images.
1035 * 4965's initialize alive response contains some calibration data. */
1036 struct iwl4965_init_alive_resp card_alive_init
;
1037 struct iwl4965_alive_resp card_alive
;
1038 #ifdef CONFIG_IWLWIFI_RFKILL
1039 struct iwl_rfkill_mngr rfkill_mngr
;
1042 #ifdef CONFIG_IWLWIFI_LEDS
1043 struct iwl4965_led led
[IWL_LED_TRG_MAX
];
1044 unsigned long last_blink_time
;
1051 u16 active_rate_basic
;
1053 u8 assoc_station_added
;
1054 u8 use_ant_b_for_management_frame
; /* Tx antenna selection */
1056 #ifdef CONFIG_IWLWIFI_RUN_TIME_CALIB
1057 struct iwl_sensitivity_data sensitivity_data
;
1058 struct iwl_chain_noise_data chain_noise_data
;
1059 __le16 sensitivity_tbl
[HD_TABLE_SIZE
];
1060 #endif /*CONFIG_IWLWIFI_RUN_TIME_CALIB*/
1062 #ifdef CONFIG_IWL4965_HT
1063 struct iwl_ht_info current_ht_config
;
1065 u8 last_phy_res
[100];
1067 /* Rate scaling data */
1068 struct iwl4965_lq_mngr lq_mngr
;
1070 /* Rate scaling data */
1071 s8 data_retry_limit
;
1074 wait_queue_head_t wait_command_queue
;
1076 int activity_timer_active
;
1078 /* Rx and Tx DMA processing queues */
1079 struct iwl4965_rx_queue rxq
;
1080 struct iwl4965_tx_queue txq
[IWL_MAX_NUM_QUEUES
];
1081 unsigned long txq_ctx_active_msk
;
1082 struct iwl4965_kw kw
; /* keep warm address */
1083 u32 scd_base_addr
; /* scheduler sram base address */
1085 unsigned long status
;
1087 int last_rx_rssi
; /* From Rx packet statisitics */
1088 int last_rx_noise
; /* From beacon statistics */
1090 /* counts mgmt, ctl, and data packets */
1091 struct traffic_stats
{
1094 } tx_stats
[3], rx_stats
[3];
1096 struct iwl_power_mgr power_data
;
1098 struct iwl4965_notif_statistics statistics
;
1099 unsigned long last_statistics_time
;
1101 /* context information */
1102 u8 essid
[IW_ESSID_MAX_SIZE
];
1110 u8 mac_addr
[ETH_ALEN
];
1112 /*station table variables */
1113 spinlock_t sta_lock
;
1115 struct iwl4965_station_entry stations
[IWL_STATION_COUNT
];
1116 struct iwl_wep_key wep_keys
[WEP_KEYS_MAX
];
1119 unsigned long ucode_key_table
;
1121 /* Indication if ieee80211_ops->open has been called */
1124 u8 mac80211_registered
;
1126 u32 notif_missed_beacons
;
1128 /* Rx'd packet timing information */
1129 u32 last_beacon_time
;
1132 /* Duplicate packet detection */
1135 unsigned long last_packet_time
;
1137 /* Hash table for finding stations in IBSS network */
1138 struct list_head ibss_mac_hash
[IWL_IBSS_MAC_HASH_SIZE
];
1142 struct iwl_eeprom_calib_info
*calib_info
;
1144 enum ieee80211_if_types iw_mode
;
1146 struct sk_buff
*ibss_beacon
;
1148 /* Last Rx'd beacon timestamp */
1151 struct ieee80211_vif
*vif
;
1153 struct iwl_hw_params hw_params
;
1154 /* driver/uCode shared Tx Byte Counts and Rx status */
1156 /* Physical Pointer to Tx Byte Counts and Rx status */
1157 dma_addr_t shared_phys
;
1159 /* Current association information needed to configure the
1162 u16 assoc_capability
;
1165 struct iwl4965_qos_info qos_data
;
1167 struct workqueue_struct
*workqueue
;
1169 struct work_struct up
;
1170 struct work_struct restart
;
1171 struct work_struct calibrated_work
;
1172 struct work_struct scan_completed
;
1173 struct work_struct rx_replenish
;
1174 struct work_struct rf_kill
;
1175 struct work_struct abort_scan
;
1176 struct work_struct update_link_led
;
1177 struct work_struct auth_work
;
1178 struct work_struct report_work
;
1179 struct work_struct request_scan
;
1180 struct work_struct beacon_update
;
1182 struct tasklet_struct irq_tasklet
;
1184 struct delayed_work init_alive_start
;
1185 struct delayed_work alive_start
;
1186 struct delayed_work activity_timer
;
1187 struct delayed_work thermal_periodic
;
1188 struct delayed_work gather_stats
;
1189 struct delayed_work scan_check
;
1190 struct delayed_work post_associate
;
1192 #define IWL_DEFAULT_TX_POWER 0x0F
1193 s8 user_txpower_limit
;
1194 s8 max_channel_txpower_limit
;
1200 #ifdef CONFIG_IWLWIFI_DEBUG
1201 /* debugging info */
1203 atomic_t restrict_refcnt
;
1204 #ifdef CONFIG_IWLWIFI_DEBUGFS
1206 struct iwl_debugfs
*dbgfs
;
1207 #endif /* CONFIG_IWLWIFI_DEBUGFS */
1208 #endif /* CONFIG_IWLWIFI_DEBUG */
1210 struct work_struct txpower_work
;
1211 #ifdef CONFIG_IWL4965_RUN_TIME_CALIB
1212 struct work_struct sensitivity_work
;
1214 struct timer_list statistics_periodic
;
1217 static inline int iwl_is_associated(struct iwl_priv
*priv
)
1219 return (priv
->active_rxon
.filter_flags
& RXON_FILTER_ASSOC_MSK
) ? 1 : 0;
1222 static inline int is_channel_valid(const struct iwl_channel_info
*ch_info
)
1224 if (ch_info
== NULL
)
1226 return (ch_info
->flags
& EEPROM_CHANNEL_VALID
) ? 1 : 0;
1229 static inline int is_channel_radar(const struct iwl_channel_info
*ch_info
)
1231 return (ch_info
->flags
& EEPROM_CHANNEL_RADAR
) ? 1 : 0;
1234 static inline u8
is_channel_a_band(const struct iwl_channel_info
*ch_info
)
1236 return ch_info
->band
== IEEE80211_BAND_5GHZ
;
1239 static inline u8
is_channel_bg_band(const struct iwl_channel_info
*ch_info
)
1241 return ch_info
->band
== IEEE80211_BAND_2GHZ
;
1244 static inline int is_channel_passive(const struct iwl_channel_info
*ch
)
1246 return (!(ch
->flags
& EEPROM_CHANNEL_ACTIVE
)) ? 1 : 0;
1249 static inline int is_channel_ibss(const struct iwl_channel_info
*ch
)
1251 return ((ch
->flags
& EEPROM_CHANNEL_IBSS
)) ? 1 : 0;
1254 extern const struct iwl_channel_info
*iwl_get_channel_info(
1255 const struct iwl_priv
*priv
, enum ieee80211_band band
, u16 channel
);
1257 /* Requires full declaration of iwl_priv before including */
1259 #endif /* __iwl4965_4965_h__ */