iwl-dev.h 30.7 KB
Newer Older
1
2
/******************************************************************************
 *
3
 * Copyright(c) 2003 - 2009 Intel Corporation. All rights reserved.
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
 *
 * This program is free software; you can redistribute it and/or modify it
 * under the terms of version 2 of the GNU General Public License as
 * published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
 * more details.
 *
 * You should have received a copy of the GNU General Public License along with
 * this program; if not, write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA
 *
 * The full GNU General Public License is included in this distribution in the
 * file called LICENSE.
 *
 * Contact Information:
22
 *  Intel Linux Wireless <ilw@linux.intel.com>
23
24
25
 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
 *
 *****************************************************************************/
26
/*
27
 * Please use this file (iwl-dev.h) for driver implementation definitions.
28
 * Please use iwl-commands.h for uCode API definitions.
29
30
31
 * Please use iwl-4965-hw.h for hardware-related definitions.
 */

32
33
#ifndef __iwl_dev_h__
#define __iwl_dev_h__
34

35
36
37
38
#include <linux/pci.h> /* for struct pci_device_id */
#include <linux/kernel.h>
#include <net/ieee80211_radiotap.h>

39
#include "iwl-eeprom.h"
Tomas Winkler's avatar
Tomas Winkler committed
40
#include "iwl-csr.h"
41
#include "iwl-prph.h"
Winkler, Tomas's avatar
Winkler, Tomas committed
42
#include "iwl-fh.h"
43
#include "iwl-debug.h"
Winkler, Tomas's avatar
Winkler, Tomas committed
44
45
46
47
#include "iwl-rfkill.h"
#include "iwl-4965-hw.h"
#include "iwl-3945-hw.h"
#include "iwl-3945-led.h"
Mohamed Abbas's avatar
Mohamed Abbas committed
48
#include "iwl-led.h"
49
#include "iwl-power.h"
50
#include "iwl-agn-rs.h"
51

52
53
/* configuration for the iwl4965 */
extern struct iwl_cfg iwl4965_agn_cfg;
54
55
56
extern struct iwl_cfg iwl5300_agn_cfg;
extern struct iwl_cfg iwl5100_agn_cfg;
extern struct iwl_cfg iwl5350_agn_cfg;
57
58
extern struct iwl_cfg iwl5100_bg_cfg;
extern struct iwl_cfg iwl5100_abg_cfg;
59
extern struct iwl_cfg iwl5150_agn_cfg;
60
61
62
63
64
extern struct iwl_cfg iwl6000_2ag_cfg;
extern struct iwl_cfg iwl6000_2agn_cfg;
extern struct iwl_cfg iwl6000_3agn_cfg;
extern struct iwl_cfg iwl6050_2agn_cfg;
extern struct iwl_cfg iwl6050_3agn_cfg;
65
extern struct iwl_cfg iwl100_bgn_cfg;
66

67
68
69
/* shared structures from iwl-5000.c */
extern struct iwl_mod_params iwl50_mod_params;
extern struct iwl_ops iwl5000_ops;
70
71
72
73
74
75
76
77
78
79
80
81
extern struct iwl_lib_ops iwl5000_lib;
extern struct iwl_hcmd_ops iwl5000_hcmd;
extern struct iwl_hcmd_utils_ops iwl5000_hcmd_utils;

/* shared functions from iwl-5000.c */
extern u16 iwl5000_get_hcmd_size(u8 cmd_id, u16 len);
extern u16 iwl5000_build_addsta_hcmd(const struct iwl_addsta_cmd *cmd,
				     u8 *data);
extern void iwl5000_rts_tx_cmd_flag(struct ieee80211_tx_info *info,
				    __le32 *tx_flags);
extern int iwl5000_calc_rssi(struct iwl_priv *priv,
			     struct iwl_rx_phy_res *rx_resp);
82

83
84
/* CT-KILL constants */
#define CT_KILL_THRESHOLD	110 /* in Celsius */
85

86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
/* Default noise level to report when noise measurement is not available.
 *   This may be because we're:
 *   1)  Not associated (4965, no beacon statistics being sent to driver)
 *   2)  Scanning (noise measurement does not apply to associated channel)
 *   3)  Receiving CCK (3945 delivers noise info only for OFDM frames)
 * Use default noise value of -127 ... this is below the range of measurable
 *   Rx dBm for either 3945 or 4965, so it can indicate "unmeasurable" to user.
 *   Also, -127 works better than 0 when averaging frames with/without
 *   noise info (e.g. averaging might be done in app); measured dBm values are
 *   always negative ... using a negative value as the default keeps all
 *   averages within an s8's (used in some apps) range of negative values. */
#define IWL_NOISE_MEAS_NOT_AVAILABLE (-127)

/*
 * RTS threshold here is total size [2347] minus 4 FCS bytes
 * Per spec:
 *   a value of 0 means RTS on all data/management packets
 *   a value > max MSDU size means no RTS
 * else RTS for data/management frames where MPDU is larger
 *   than RTS value.
 */
#define DEFAULT_RTS_THRESHOLD     2347U
#define MIN_RTS_THRESHOLD         0U
#define MAX_RTS_THRESHOLD         2347U
#define MAX_MSDU_SIZE		  2304U
#define MAX_MPDU_SIZE		  2346U
#define DEFAULT_BEACON_INTERVAL   100U
#define	DEFAULT_SHORT_RETRY_LIMIT 7U
#define	DEFAULT_LONG_RETRY_LIMIT  4U

116
struct iwl_rx_mem_buffer {
Johannes Berg's avatar
Johannes Berg committed
117
118
	dma_addr_t real_dma_addr;
	dma_addr_t aligned_dma_addr;
119
120
121
122
123
124
125
126
127
	struct sk_buff *skb;
	struct list_head list;
};

/*
 * Generic queue structure
 *
 * Contains common data for Rx and Tx queues
 */
128
struct iwl_queue {
129
130
131
132
133
134
135
136
137
138
139
140
	int n_bd;              /* number of BDs in this queue */
	int write_ptr;       /* 1-st empty entry (index) host_w*/
	int read_ptr;         /* last used entry (index) host_r*/
	dma_addr_t dma_addr;   /* physical addr for BD's */
	int n_window;	       /* safe queue window */
	u32 id;
	int low_mark;	       /* low watermark, resume queue if free
				* space more than this */
	int high_mark;         /* high watermark, stop queue if free
				* space less than this */
} __attribute__ ((packed));

141
/* One for each TFD */
142
struct iwl_tx_info {
143
	struct sk_buff *skb[IWL_NUM_OF_TBS - 1];
144
145
146
};

/**
147
 * struct iwl_tx_queue - Tx Queue for DMA
148
149
150
151
152
153
154
 * @q: generic Rx/Tx queue descriptor
 * @bd: base of circular buffer of TFDs
 * @cmd: array of command/Tx buffers
 * @dma_addr_cmd: physical address of cmd/tx buffer array
 * @txb: array of per-TFD driver data
 * @need_update: indicates need to update read/write index
 * @sched_retry: indicates queue is high-throughput aggregation (HT AGG) enabled
155
 *
156
157
 * A Tx queue consists of circular buffer of BDs (a.k.a. TFDs, transmit frame
 * descriptors) and required locking structures.
158
 */
159
160
161
#define TFD_TX_CMD_SLOTS 256
#define TFD_CMD_SLOTS 32

162
struct iwl_tx_queue {
163
	struct iwl_queue q;
164
	void *tfds;
165
	struct iwl_cmd *cmd[TFD_TX_CMD_SLOTS];
166
	struct iwl_tx_info *txb;
167
168
169
170
	u8 need_update;
	u8 sched_retry;
	u8 active;
	u8 swq_id;
171
172
173
174
};

#define IWL_NUM_SCAN_RATES         (2)

Christoph Hellwig's avatar
Christoph Hellwig committed
175
struct iwl4965_channel_tgd_info {
176
177
178
179
	u8 type;
	s8 max_power;
};

Christoph Hellwig's avatar
Christoph Hellwig committed
180
struct iwl4965_channel_tgh_info {
181
182
183
	s64 last_radar_time;
};

184
185
#define IWL4965_MAX_RATE (33)

186
187
188
189
190
191
struct iwl3945_clip_group {
	/* maximum power level to prevent clipping for each rate, derived by
	 *   us from this band's saturation power in EEPROM */
	const s8 clip_powers[IWL_MAX_RATES];
};

192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
/* current Tx power values to use, one for each rate for each channel.
 * requested power is limited by:
 * -- regulatory EEPROM limits for this channel
 * -- hardware capabilities (clip-powers)
 * -- spectrum management
 * -- user preference (e.g. iwconfig)
 * when requested power is set, base power index must also be set. */
struct iwl3945_channel_power_info {
	struct iwl3945_tx_power tpc;	/* actual radio and DSP gain settings */
	s8 power_table_index;	/* actual (compenst'd) index into gain table */
	s8 base_power_index;	/* gain index for power at factory temp. */
	s8 requested_power;	/* power (dBm) requested for this chnl/rate */
};

/* current scan Tx power values to use, one for each scan rate for each
 * channel. */
struct iwl3945_scan_power_info {
	struct iwl3945_tx_power tpc;	/* actual radio and DSP gain settings */
	s8 power_table_index;	/* actual (compenst'd) index into gain table */
	s8 requested_power;	/* scan pwr (dBm) requested for chnl/rate */
};

214
215
216
217
218
/*
 * One for each channel, holds all channel setup data
 * Some of the fields (e.g. eeprom and flags/max_power_avg) are redundant
 *     with one another!
 */
219
struct iwl_channel_info {
Christoph Hellwig's avatar
Christoph Hellwig committed
220
221
	struct iwl4965_channel_tgd_info tgd;
	struct iwl4965_channel_tgh_info tgh;
222
223
224
	struct iwl_eeprom_channel eeprom;	/* EEPROM regulatory limit */
	struct iwl_eeprom_channel fat_eeprom;	/* EEPROM regulatory limit for
						 * FAT channel */
225
226
227
228

	u8 channel;	  /* channel number */
	u8 flags;	  /* flags copied from EEPROM */
	s8 max_power_avg; /* (dBm) regul. eeprom, normal Tx, any rate */
229
	s8 curr_txpow;	  /* (dBm) regulatory/spectrum/user (not h/w) limit */
230
231
232
233
234
	s8 min_power;	  /* always 0 */
	s8 scan_power;	  /* (dBm) regul. eeprom, direct scans, any rate */

	u8 group_index;	  /* 0-4, maps channel to group1/2/3/4/5 */
	u8 band_index;	  /* 0-4, maps channel to band1/2/3/4/5 */
235
	enum ieee80211_band band;
236
237
238
239
240
241
242

	/* FAT channel info */
	s8 fat_max_power_avg;	/* (dBm) regul. eeprom, normal Tx, any rate */
	s8 fat_curr_txpow;	/* (dBm) regulatory/spectrum/user (not h/w) */
	s8 fat_min_power;	/* always 0 */
	s8 fat_scan_power;	/* (dBm) eeprom, direct scans, any rate */
	u8 fat_flags;		/* flags copied from EEPROM */
243
	u8 fat_extension_channel; /* HT_IE_EXT_CHANNEL_* */
244
245
246
247
248
249
250
251

	/* Radio/DSP gain settings for each "normal" data Tx rate.
	 * These include, in addition to RF and DSP gain, a few fields for
	 *   remembering/modifying gain settings (indexes). */
	struct iwl3945_channel_power_info power_info[IWL4965_MAX_RATE];

	/* Radio/DSP gain settings for each scan rate, for directed scans. */
	struct iwl3945_scan_power_info scan_pwr_info[IWL_NUM_SCAN_RATES];
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
};

#define IWL_TX_FIFO_AC0	0
#define IWL_TX_FIFO_AC1	1
#define IWL_TX_FIFO_AC2	2
#define IWL_TX_FIFO_AC3	3
#define IWL_TX_FIFO_HCCA_1	5
#define IWL_TX_FIFO_HCCA_2	6
#define IWL_TX_FIFO_NONE	7

/* Minimum number of queues. MAX_NUM is defined in hw specific files */
#define IWL_MIN_NUM_QUEUES	4

/* Power management (not Tx power) structures */

Tomas Winkler's avatar
Tomas Winkler committed
267
268
269
270
271
enum iwl_pwr_src {
	IWL_PWR_SRC_VMAIN,
	IWL_PWR_SRC_VAUX,
};

272
273
274
275
276
#define IEEE80211_DATA_LEN              2304
#define IEEE80211_4ADDR_LEN             30
#define IEEE80211_HLEN                  (IEEE80211_4ADDR_LEN)
#define IEEE80211_FRAME_LEN             (IEEE80211_DATA_LEN + IEEE80211_HLEN)

277
struct iwl_frame {
278
279
	union {
		struct ieee80211_hdr frame;
280
		struct iwl_tx_beacon_cmd beacon;
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
		u8 raw[IEEE80211_FRAME_LEN];
		u8 cmd[360];
	} u;
	struct list_head list;
};

#define SEQ_TO_SN(seq) (((seq) & IEEE80211_SCTL_SEQ) >> 4)
#define SN_TO_SEQ(ssn) (((ssn) << 4) & IEEE80211_SCTL_SEQ)
#define MAX_SN ((IEEE80211_SCTL_SEQ) >> 4)

enum {
	/* CMD_SIZE_NORMAL = 0, */
	CMD_SIZE_HUGE = (1 << 0),
	/* CMD_SYNC = 0, */
	CMD_ASYNC = (1 << 1),
	/* CMD_NO_SKB = 0, */
	CMD_WANT_SKB = (1 << 2),
};

300
struct iwl_cmd;
301
struct iwl_priv;
302

303
304
struct iwl_cmd_meta {
	struct iwl_cmd_meta *source;
305
306
	union {
		struct sk_buff *skb;
307
		int (*callback)(struct iwl_priv *priv,
308
				struct iwl_cmd *cmd, struct sk_buff *skb);
309
310
311
312
313
	} __attribute__ ((packed)) u;

	/* The CMD_SIZE_HUGE flag bit indicates that the command
	 * structure is stored at the end of the shared queue memory. */
	u32 flags;
314
315
	DECLARE_PCI_UNMAP_ADDR(mapping)
	DECLARE_PCI_UNMAP_LEN(len)
316
317
} __attribute__ ((packed));

318
#define IWL_CMD_MAX_PAYLOAD 320
319

320
/**
321
 * struct iwl_cmd
322
323
324
325
326
 *
 * For allocation of the command and tx queues, this establishes the overall
 * size of the largest command we send to uCode, except for a scan command
 * (which is relatively huge; space is allocated separately).
 */
327
328
329
struct iwl_cmd {
	struct iwl_cmd_meta meta;	/* driver data */
	struct iwl_cmd_header hdr;	/* uCode API */
330
331
332
333
334
	union {
		u32 flags;
		u8 val8;
		u16 val16;
		u32 val32;
335
		struct iwl_tx_cmd tx;
336
		u8 payload[IWL_CMD_MAX_PAYLOAD];
337
338
339
	} __attribute__ ((packed)) cmd;
} __attribute__ ((packed));

340

341
struct iwl_host_cmd {
342
343
	u8 id;
	u16 len;
344
	struct iwl_cmd_meta meta;
345
346
347
	const void *data;
};

348
349
#define TFD_MAX_PAYLOAD_SIZE (sizeof(struct iwl_cmd) - \
			      sizeof(struct iwl_cmd_meta))
350
351
352
353
354
355
356
357
358
359
360
361

/*
 * RX related structures and functions
 */
#define RX_FREE_BUFFERS 64
#define RX_LOW_WATERMARK 8

#define SUP_RATE_11A_MAX_NUM_CHANNELS  8
#define SUP_RATE_11B_MAX_NUM_CHANNELS  4
#define SUP_RATE_11G_MAX_NUM_CHANNELS  12

/**
362
 * struct iwl_rx_queue - Rx queue
363
364
365
366
367
368
369
 * @read: Shared index to newest available Rx buffer
 * @write: Shared index to oldest written Rx packet
 * @free_count: Number of pre-allocated buffers in rx_free
 * @rx_free: list of free SKBs for use
 * @rx_used: List of Rx buffers with no SKB
 * @need_update: flag to indicate we need to update read/write index
 *
370
 * NOTE:  rx_free and rx_used are used as a FIFO for iwl_rx_mem_buffers
371
 */
372
struct iwl_rx_queue {
373
374
	__le32 *bd;
	dma_addr_t dma_addr;
375
376
	struct iwl_rx_mem_buffer pool[RX_QUEUE_SIZE + RX_FREE_BUFFERS];
	struct iwl_rx_mem_buffer *queue[RX_QUEUE_SIZE];
377
378
379
380
381
382
	u32 read;
	u32 write;
	u32 free_count;
	struct list_head rx_free;
	struct list_head rx_used;
	int need_update;
383
384
	struct iwl_rb_status *rb_stts;
	dma_addr_t rb_stts_dma;
385
386
387
388
389
390
391
392
393
394
	spinlock_t lock;
};

#define IWL_SUPPORTED_RATES_IE_LEN         8

#define MAX_TID_COUNT        9

#define IWL_INVALID_RATE     0xFF
#define IWL_INVALID_VALUE    -1

395
/**
396
 * struct iwl_ht_agg -- aggregation status while waiting for block-ack
397
398
399
400
401
402
403
404
405
406
407
408
 * @txq_id: Tx queue used for Tx attempt
 * @frame_count: # frames attempted by Tx command
 * @wait_for_ba: Expect block-ack before next Tx reply
 * @start_idx: Index of 1st Transmit Frame Descriptor (TFD) in Tx window
 * @bitmap0: Low order bitmap, one bit for each frame pending ACK in Tx window
 * @bitmap1: High order, one bit for each frame pending ACK in Tx window
 * @rate_n_flags: Rate at which Tx was attempted
 *
 * If REPLY_TX indicates that aggregation was attempted, driver must wait
 * for block ack (REPLY_COMPRESSED_BA).  This struct stores tx reply info
 * until block ack arrives.
 */
409
struct iwl_ht_agg {
410
411
412
413
	u16 txq_id;
	u16 frame_count;
	u16 wait_for_ba;
	u16 start_idx;
414
	u64 bitmap;
415
	u32 rate_n_flags;
416
417
418
419
420
#define IWL_AGG_OFF 0
#define IWL_AGG_ON 1
#define IWL_EMPTYING_HW_QUEUE_ADDBA 2
#define IWL_EMPTYING_HW_QUEUE_DELBA 3
	u8 state;
421
};
422

423

424
struct iwl_tid_data {
425
	u16 seq_number;
426
	u16 tfds_in_queue;
427
	struct iwl_ht_agg agg;
428
429
};

430
struct iwl_hw_key {
431
432
	enum ieee80211_key_alg alg;
	int keylen;
433
	u8 keyidx;
434
435
436
	u8 key[32];
};

437
union iwl_ht_rate_supp {
438
439
440
441
442
443
444
445
446
447
448
	u16 rates;
	struct {
		u8 siso_rate;
		u8 mimo_rate;
	};
};

#define CFG_HT_RX_AMPDU_FACTOR_DEF  (0x3)
#define CFG_HT_MPDU_DENSITY_2USEC   (0x5)
#define CFG_HT_MPDU_DENSITY_DEF CFG_HT_MPDU_DENSITY_2USEC

449
450
struct iwl_ht_info {
	/* self configuration data */
451
	u8 is_ht;
452
	u8 supported_chan_width;
453
	u8 sm_ps;
454
	u8 is_green_field;
Tomas Winkler's avatar
Tomas Winkler committed
455
	u8 sgf;			/* HT_SHORT_GI_* short guard interval */
456
457
458
	u8 max_amsdu_size;
	u8 ampdu_factor;
	u8 mpdu_density;
459
	struct ieee80211_mcs_info mcs;
460
	/* BSS related data */
461
462
	u8 extension_chan_offset;
	u8 tx_chan_width;
463
464
	u8 ht_protection;
	u8 non_GF_STA_present;
465
466
};

467
union iwl_qos_capabity {
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
	struct {
		u8 edca_count:4;	/* bit 0-3 */
		u8 q_ack:1;		/* bit 4 */
		u8 queue_request:1;	/* bit 5 */
		u8 txop_request:1;	/* bit 6 */
		u8 reserved:1;		/* bit 7 */
	} q_AP;
	struct {
		u8 acvo_APSD:1;		/* bit 0 */
		u8 acvi_APSD:1;		/* bit 1 */
		u8 ac_bk_APSD:1;	/* bit 2 */
		u8 ac_be_APSD:1;	/* bit 3 */
		u8 q_ack:1;		/* bit 4 */
		u8 max_len:2;		/* bit 5-6 */
		u8 more_data_ack:1;	/* bit 7 */
	} q_STA;
	u8 val;
};

/* QoS structures */
488
struct iwl_qos_info {
489
	int qos_active;
490
491
	union iwl_qos_capabity qos_cap;
	struct iwl_qosparam_cmd def_qos_parm;
492
493
494
495
496
};

#define STA_PS_STATUS_WAKE             0
#define STA_PS_STATUS_SLEEP            1

497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
struct iwl3945_tid_data {
	u16 seq_number;
};

struct iwl3945_hw_key {
	enum ieee80211_key_alg alg;
	int keylen;
	u8 key[32];
};

struct iwl3945_station_entry {
	struct iwl3945_addsta_cmd sta;
	struct iwl3945_tid_data tid[MAX_TID_COUNT];
	u8 used;
	u8 ps_status;
	struct iwl3945_hw_key keyinfo;
};

515
struct iwl_station_entry {
516
	struct iwl_addsta_cmd sta;
517
	struct iwl_tid_data tid[MAX_TID_COUNT];
518
519
	u8 used;
	u8 ps_status;
520
	struct iwl_hw_key keyinfo;
521
522
523
524
525
526
527
528
529
530
};

/* one for each uCode image (inst/data, boot/init/runtime) */
struct fw_desc {
	void *v_addr;		/* access by driver */
	dma_addr_t p_addr;	/* access by card's busmaster DMA */
	u32 len;		/* bytes */
};

/* uCode file layout */
531
struct iwl_ucode {
532
	__le32 ver;		/* major/minor/API/serial */
533
534
535
536
537
538
539
540
	__le32 inst_size;	/* bytes of runtime instructions */
	__le32 data_size;	/* bytes of runtime data */
	__le32 init_size;	/* bytes of initialization instructions */
	__le32 init_data_size;	/* bytes of initialization data */
	__le32 boot_size;	/* bytes of bootstrap instructions */
	u8 data[0];		/* data in same order as "size" elements */
};

Christoph Hellwig's avatar
Christoph Hellwig committed
541
struct iwl4965_ibss_seq {
542
543
544
545
546
547
548
	u8 mac[ETH_ALEN];
	u16 seq_num;
	u16 frag_num;
	unsigned long packet_time;
	struct list_head list;
};

549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
struct iwl_sensitivity_ranges {
	u16 min_nrg_cck;
	u16 max_nrg_cck;

	u16 nrg_th_cck;
	u16 nrg_th_ofdm;

	u16 auto_corr_min_ofdm;
	u16 auto_corr_min_ofdm_mrc;
	u16 auto_corr_min_ofdm_x1;
	u16 auto_corr_min_ofdm_mrc_x1;

	u16 auto_corr_max_ofdm;
	u16 auto_corr_max_ofdm_mrc;
	u16 auto_corr_max_ofdm_x1;
	u16 auto_corr_max_ofdm_mrc_x1;

	u16 auto_corr_max_cck;
	u16 auto_corr_max_cck_mrc;
	u16 auto_corr_min_cck;
	u16 auto_corr_min_cck_mrc;
};

572

573
574
575
576
#define KELVIN_TO_CELSIUS(x) ((x)-273)
#define CELSIUS_TO_KELVIN(x) ((x)+273)


577
/**
Tomas Winkler's avatar
Tomas Winkler committed
578
 * struct iwl_hw_params
579
 * @max_txq_num: Max # Tx queues supported
580
 * @dma_chnl_num: Number of Tx DMA/FIFO channels
581
 * @scd_bc_tbls_size: size of scheduler byte count tables
582
 * @tfd_size: TFD size
583
584
 * @tx/rx_chains_num: Number of TX/RX chains
 * @valid_tx/rx_ant: usable antennas
585
586
 * @max_rxq_size: Max # Rx frames in Rx queue (must be power-of-2)
 * @max_rxq_log: Log-base-2 of max_rxq_size
587
 * @rx_buf_size: Rx buffer size
588
 * @rx_wrt_ptr_reg: FH{39}_RSCSR_CHNL0_WPTR
589
590
 * @max_stations:
 * @bcast_sta_id:
591
592
593
594
595
 * @fat_channel: is 40MHz width possible in band 2.4
 * BIT(IEEE80211_BAND_5GHZ) BIT(IEEE80211_BAND_5GHZ)
 * @sw_crypto: 0 for hw, 1 for sw
 * @max_xxx_size: for ucode uses
 * @ct_kill_threshold: temperature threshold
596
 * @calib_init_cfg: setup initial calibrations for the hw
597
 * @struct iwl_sensitivity_ranges: range of sensitivity values
598
 */
Tomas Winkler's avatar
Tomas Winkler committed
599
struct iwl_hw_params {
600
601
	u8 max_txq_num;
	u8 dma_chnl_num;
602
	u16 scd_bc_tbls_size;
603
	u32 tfd_size;
604
605
606
607
	u8  tx_chains_num;
	u8  rx_chains_num;
	u8  valid_tx_ant;
	u8  valid_rx_ant;
608
	u16 max_rxq_size;
609
	u16 max_rxq_log;
610
	u32 rx_buf_size;
611
	u32 rx_wrt_ptr_reg;
612
	u32 max_pkt_size;
613
614
	u8  max_stations;
	u8  bcast_sta_id;
615
616
617
618
619
620
	u8 fat_channel;
	u8 sw_crypto;
	u32 max_inst_size;
	u32 max_data_size;
	u32 max_bsm_size;
	u32 ct_kill_threshold; /* value in hw-dependent units */
621
	u32 calib_init_cfg;
622
	const struct iwl_sensitivity_ranges *sens;
623
624
625
626
627
};


/******************************************************************************
 *
628
629
 * Functions implemented in core module which are forward declared here
 * for use by iwl-[4-5].c
630
 *
631
632
 * NOTE:  The implementation of these functions are not hardware specific
 * which is why they are in the core module files.
633
634
 *
 * Naming convention --
635
 * iwl_         <-- Is part of iwlwifi
636
 * iwlXXXX_     <-- Hardware specific (implemented in iwl-XXXX.c for XXXX)
Christoph Hellwig's avatar
Christoph Hellwig committed
637
638
 * iwl4965_bg_      <-- Called from work queue context
 * iwl4965_mac_     <-- mac80211 callback
639
640
 *
 ****************************************************************************/
641
642
extern void iwl_update_chain_flags(struct iwl_priv *priv);
extern int iwl_set_pwr_src(struct iwl_priv *priv, enum iwl_pwr_src src);
643
extern const u8 iwl_bcast_addr[ETH_ALEN];
644
extern int iwl_rxq_stop(struct iwl_priv *priv);
645
extern void iwl_txq_ctx_stop(struct iwl_priv *priv);
646
extern int iwl_queue_space(const struct iwl_queue *q);
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
static inline int iwl_queue_used(const struct iwl_queue *q, int i)
{
	return q->write_ptr > q->read_ptr ?
		(i >= q->read_ptr && i < q->write_ptr) :
		!(i < q->read_ptr && i >= q->write_ptr);
}


static inline u8 get_cmd_index(struct iwl_queue *q, u32 index, int is_huge)
{
	/* This is for scan command, the big buffer at end of command array */
	if (is_huge)
		return q->n_window;	/* must be power of 2 */

	/* Otherwise, use normal size buffers */
	return index & (q->n_window - 1);
}


666
667
668
struct iwl_dma_ptr {
	dma_addr_t dma;
	void *addr;
669
670
671
	size_t size;
};

Winkler, Tomas's avatar
Winkler, Tomas committed
672
673
674
#define HT_SHORT_GI_20MHZ	(1 << 0)
#define HT_SHORT_GI_40MHZ	(1 << 1)

675
676
677
678
679
680
681
682
#define IWL_CHANNEL_WIDTH_20MHZ   0
#define IWL_CHANNEL_WIDTH_40MHZ   1

#define IWL_OPERATION_MODE_AUTO     0
#define IWL_OPERATION_MODE_HT_ONLY  1
#define IWL_OPERATION_MODE_MIXED    2
#define IWL_OPERATION_MODE_20MHZ    3

683
684
#define IWL_TX_CRC_SIZE 4
#define IWL_TX_DELIMITER_SIZE 4
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719

#define TX_POWER_IWL_ILLEGAL_VOLTAGE -10000

/* Sensitivity and chain noise calibration */
#define INITIALIZATION_VALUE		0xFFFF
#define CAL_NUM_OF_BEACONS		20
#define MAXIMUM_ALLOWED_PATHLOSS	15

#define CHAIN_NOISE_MAX_DELTA_GAIN_CODE 3

#define MAX_FA_OFDM  50
#define MIN_FA_OFDM  5
#define MAX_FA_CCK   50
#define MIN_FA_CCK   5

#define AUTO_CORR_STEP_OFDM       1

#define AUTO_CORR_STEP_CCK     3
#define AUTO_CORR_MAX_TH_CCK   160

#define NRG_DIFF               2
#define NRG_STEP_CCK           2
#define NRG_MARGIN             8
#define MAX_NUMBER_CCK_NO_FA 100

#define AUTO_CORR_CCK_MIN_VAL_DEF    (125)

#define CHAIN_A             0
#define CHAIN_B             1
#define CHAIN_C             2
#define CHAIN_NOISE_DELTA_GAIN_INIT_VAL 4
#define ALL_BAND_FILTER			0xFF00
#define IN_BAND_FILTER			0xFF
#define MIN_AVERAGE_NOISE_MAX_VALUE	0xFFFFFFFF

720
721
722
#define NRG_NUM_PREV_STAT_L     20
#define NUM_RX_CHAINS           3

Christoph Hellwig's avatar
Christoph Hellwig committed
723
enum iwl4965_false_alarm_state {
724
725
726
727
728
	IWL_FA_TOO_MANY = 0,
	IWL_FA_TOO_FEW = 1,
	IWL_FA_GOOD_RANGE = 2,
};

Christoph Hellwig's avatar
Christoph Hellwig committed
729
enum iwl4965_chain_noise_state {
730
	IWL_CHAIN_NOISE_ALIVE = 0,  /* must be 0 */
731
732
733
	IWL_CHAIN_NOISE_ACCUMULATE,
	IWL_CHAIN_NOISE_CALIBRATED,
	IWL_CHAIN_NOISE_DONE,
734
735
};

Christoph Hellwig's avatar
Christoph Hellwig committed
736
enum iwl4965_calib_enabled_state {
737
738
739
740
	IWL_CALIB_DISABLED = 0,  /* must be 0 */
	IWL_CALIB_ENABLED = 1,
};

741
742
743
744
745
746
747
748

/*
 * enum iwl_calib
 * defines the order in which results of initial calibrations
 * should be sent to the runtime uCode
 */
enum iwl_calib {
	IWL_CALIB_XTAL,
749
	IWL_CALIB_DC,
750
751
752
	IWL_CALIB_LO,
	IWL_CALIB_TX_IQ,
	IWL_CALIB_TX_IQ_PERD,
753
	IWL_CALIB_BASE_BAND,
754
755
756
	IWL_CALIB_MAX
};

757
758
759
760
/* Opaque calibration results */
struct iwl_calib_result {
	void *buf;
	size_t buf_len;
761
762
};

763
764
765
766
767
768
enum ucode_type {
	UCODE_NONE = 0,
	UCODE_INIT,
	UCODE_RT
};

769
/* Sensitivity calib data */
770
struct iwl_sensitivity_data {
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
	u32 auto_corr_ofdm;
	u32 auto_corr_ofdm_mrc;
	u32 auto_corr_ofdm_x1;
	u32 auto_corr_ofdm_mrc_x1;
	u32 auto_corr_cck;
	u32 auto_corr_cck_mrc;

	u32 last_bad_plcp_cnt_ofdm;
	u32 last_fa_cnt_ofdm;
	u32 last_bad_plcp_cnt_cck;
	u32 last_fa_cnt_cck;

	u32 nrg_curr_state;
	u32 nrg_prev_state;
	u32 nrg_value[10];
	u8  nrg_silence_rssi[NRG_NUM_PREV_STAT_L];
	u32 nrg_silence_ref;
	u32 nrg_energy_idx;
	u32 nrg_silence_idx;
	u32 nrg_th_cck;
	s32 nrg_auto_corr_silence_diff;
	u32 num_in_cck_no_fa;
	u32 nrg_th_ofdm;
};

/* Chain noise (differential Rx gain) calib data */
797
struct iwl_chain_noise_data {
798
	u32 active_chains;
799
800
801
802
803
804
	u32 chain_noise_a;
	u32 chain_noise_b;
	u32 chain_noise_c;
	u32 chain_signal_a;
	u32 chain_signal_b;
	u32 chain_signal_c;
805
	u16 beacon_count;
806
807
808
	u8 disconn_array[NUM_RX_CHAINS];
	u8 delta_gain_code[NUM_RX_CHAINS];
	u8 radio_write;
809
	u8 state;
810
811
};

812
813
#define	EEPROM_SEM_TIMEOUT 10		/* milliseconds */
#define EEPROM_SEM_RETRY_LIMIT 1000	/* number of attempts (not time) */
814

815
816
817
818
819
820
821

enum {
	MEASUREMENT_READY = (1 << 0),
	MEASUREMENT_ACTIVE = (1 << 1),
};


822
823
#define IWL_MAX_NUM_QUEUES	20 /* FIXME: do dynamic allocation */

824
struct iwl_priv {
825
826
827
828
829

	/* ieee device used by generic ieee processing code */
	struct ieee80211_hw *hw;
	struct ieee80211_channel *ieee_channels;
	struct ieee80211_rate *ieee_rates;
Tomas Winkler's avatar
Tomas Winkler committed
830
	struct iwl_cfg *cfg;
831
832
833
834
835

	/* temporary frame storage list */
	struct list_head free_frames;
	int frames_count;

836
	enum ieee80211_band band;
837
838
	int alloc_rxb_skb;

839
	void (*rx_handlers[REPLY_MAX])(struct iwl_priv *priv,
840
				       struct iwl_rx_mem_buffer *rxb);
841

842
	struct ieee80211_supported_band bands[IEEE80211_NUM_BANDS];
843

844
#if defined(CONFIG_IWLWIFI_SPECTRUM_MEASUREMENT) || defined(CONFIG_IWL3945_SPECTRUM_MEASUREMENT)
845
	/* spectrum measurement report caching */
846
	struct iwl_spectrum_notification measure_report;
847
848
849
850
851
	u8 measurement_status;
#endif
	/* ucode beacon time */
	u32 ucode_beacon_time;

Christoph Hellwig's avatar
Christoph Hellwig committed
852
	/* we allocate array of iwl4965_channel_info for NIC's valid channels.
853
	 *    Access via channel # using indirect index array */
854
	struct iwl_channel_info *channel_info;	/* channel info array */
855
856
	u8 channel_count;	/* # of channels */

857
858
859
860
	/* each calibration channel group in the EEPROM has a derived
	 * clip setting for each rate. 3945 only.*/
	const struct iwl3945_clip_group clip39_groups[5];

861
862
863
864
	/* thermal calibration */
	s32 temperature;	/* degrees Kelvin */
	s32 last_temperature;

865
	/* init calibration results */
866
	struct iwl_calib_result calib_results[IWL_CALIB_MAX];
867

868
869
	/* Scan related variables */
	unsigned long last_scan_jiffies;
870
	unsigned long next_scan_jiffies;
871
872
873
	unsigned long scan_start;
	unsigned long scan_pass_start;
	unsigned long scan_start_tsf;
Winkler, Tomas's avatar
Winkler, Tomas committed
874
	void *scan;
875
876
877
878
	int scan_bands;
	int one_direct_scan;
	u8 direct_ssid_len;
	u8 direct_ssid[IW_ESSID_MAX_SIZE];
879
880
	u8 scan_tx_ant[IEEE80211_NUM_BANDS];
	u8 mgmt_tx_ant;
881
882
883
884
885
886
887
888
889
890
891

	/* spinlock */
	spinlock_t lock;	/* protect general shared data */
	spinlock_t hcmd_lock;	/* protect hcmd */
	struct mutex mutex;

	/* basic pci-network driver stuff */
	struct pci_dev *pci_dev;

	/* pci hardware address support */
	void __iomem *hw_base;
892
893
894
	u32  hw_rev;
	u32  hw_wa_rev;
	u8   rev_id;
895
896

	/* uCode images, save to reload in case of failure */
897
898
	u32 ucode_ver;			/* version of ucode, copy of
					   iwl_ucode.ver */
899
900
901
902
903
904
	struct fw_desc ucode_code;	/* runtime inst */
	struct fw_desc ucode_data;	/* runtime data original */
	struct fw_desc ucode_data_backup;	/* runtime data save/restore */
	struct fw_desc ucode_init;	/* initialization inst */
	struct fw_desc ucode_init_data;	/* initialization data */
	struct fw_desc ucode_boot;	/* bootstrap inst */
905
906
	enum ucode_type ucode_type;
	u8 ucode_write_complete;	/* the image write is complete */
907
908


909
	struct iwl_rxon_time_cmd rxon_timing;
910
911
912
913
914

	/* We declare this const so it can only be
	 * changed via explicit cast within the
	 * routines that actually update the physical
	 * hardware */
Gregory Greenman's avatar
Gregory Greenman committed
915
916
	const struct iwl_rxon_cmd active_rxon;
	struct iwl_rxon_cmd staging_rxon;
917
918

	int error_recovering;
Gregory Greenman's avatar
Gregory Greenman committed
919
	struct iwl_rxon_cmd recovery_rxon;
920
921
922

	/* 1st responses from initialize and runtime uCode images.
	 * 4965's initialize alive response contains some calibration data. */
923
924
	struct iwl_init_alive_resp card_alive_init;
	struct iwl_alive_resp card_alive;
925
#if defined(CONFIG_IWLWIFI_RFKILL)
926
	struct rfkill *rfkill;
927
#endif
928

929
#if defined(CONFIG_IWLWIFI_LEDS) || defined(CONFIG_IWL3945_LEDS)
Mohamed Abbas's avatar
Mohamed Abbas committed
930
931
932
933
	unsigned long last_blink_time;
	u8 last_blink_rate;
	u8 allow_blinking;
	u64 led_tpt;
934
935
#endif

936
937
938
939
940
941
942
943
#ifdef CONFIG_IWLWIFI_LEDS
	struct iwl_led led[IWL_LED_TRG_MAX];
#endif

#ifdef CONFIG_IWL3945_LEDS
	struct iwl3945_led led39[IWL_LED_TRG_MAX];
	unsigned int rxtxpackets;
#endif
944
945
946
947
948
	u16 active_rate;
	u16 active_rate_basic;

	u8 assoc_station_added;
	u8 start_calib;
949
950
	struct iwl_sensitivity_data sensitivity_data;
	struct iwl_chain_noise_data chain_noise_data;
951
952
	__le16 sensitivity_tbl[HD_TABLE_SIZE];

953
	struct iwl_ht_info current_ht_config;
954
955
956
957
958
959
960
961
962
963
964
	u8 last_phy_res[100];

	/* Rate scaling data */
	s8 data_retry_limit;
	u8 retry_rate;

	wait_queue_head_t wait_command_queue;

	int activity_timer_active;

	/* Rx and Tx DMA processing queues */
965
	struct iwl_rx_queue rxq;
966
	struct iwl_tx_queue txq[IWL_MAX_NUM_QUEUES];
967
	unsigned long txq_ctx_active_msk;
968
969
970
	struct iwl_dma_ptr  kw;	/* keep warm address */
	struct iwl_dma_ptr  scd_bc_tbls;

971
972
973
974
	u32 scd_base_addr;	/* scheduler sram base address */

	unsigned long status;

975
	int last_rx_rssi;	/* From Rx packet statistics */
976
977
	int last_rx_noise;	/* From beacon statistics */

978
979
980
981
982
983
	/* counts mgmt, ctl, and data packets */
	struct traffic_stats {
		u32 cnt;
		u64 bytes;
	} tx_stats[3], rx_stats[3];

984
	struct iwl_power_mgr power_data;
985

986
	struct iwl_notif_statistics statistics;
987
988
989
990
991
992
993
994
995
996
997
998
999
	unsigned long last_statistics_time;

	/* context information */
	u16 rates_mask;

	u32 power_mode;
	u8 bssid[ETH_ALEN];
	u16 rts_threshold;
	u8 mac_addr[ETH_ALEN];

	/*station table variables */
	spinlock_t sta_lock;
	int num_stations;
1000
	struct iwl_station_entry stations[IWL_STATION_COUNT];
1001
1002
1003
	struct iwl_wep_key wep_keys[WEP_KEYS_MAX];
	u8 default_wep_key;
	u8 key_mapping_key;
1004
	unsigned long ucode_key_table;
1005
1006

	/* Indication if ieee80211_ops->open has been called */
1007
	u8 is_open;
1008
1009
1010
1011
1012
1013
1014
1015

	u8 mac80211_registered;

	/* Rx'd packet timing information */
	u32 last_beacon_time;
	u64 last_tsf;

	/* eeprom */
1016
1017
	u8 *eeprom;
	struct iwl_eeprom_calib_info *calib_info;
1018

1019
	enum nl80211_iftype iw_mode;
1020
1021
1022
1023

	struct sk_buff *ibss_beacon;

	/* Last Rx'd beacon timestamp */
1024
	u64 timestamp;
1025
	u16 beacon_int;
1026
	struct ieee80211_vif *vif;
1027

Winkler, Tomas's avatar
Winkler, Tomas committed
1028
	/*Added for 3945 */
1029
1030
1031
	void *shared_virt;
	dma_addr_t shared_phys;
	/*End*/
Tomas Winkler's avatar
Tomas Winkler committed
1032
	struct iwl_hw_params hw_params;
1033

1034

1035
1036
1037
1038
1039
	/* Current association information needed to configure the
	 * hardware */
	u16 assoc_id;
	u16 assoc_capability;

1040
	struct iwl_qos_info qos_data;
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058

	struct workqueue_struct *workqueue;

	struct work_struct up;
	struct work_struct restart;
	struct work_struct calibrated_work;
	struct work_struct scan_completed;
	struct work_struct rx_replenish;
	struct work_struct rf_kill;
	struct work_struct abort_scan;
	struct work_struct update_link_led;
	struct work_struct auth_work;
	struct work_struct report_work;
	struct work_struct request_scan;
	struct work_struct beacon_update;

	struct tasklet_struct irq_tasklet;

1059
	struct delayed_work set_power_save;
1060
1061
1062
	struct delayed_work init_alive_start;
	struct delayed_work alive_start;
	struct delayed_work scan_check;
1063
1064
1065

	/*For 3945 only*/
	struct delayed_work thermal_periodic;
1066
	struct delayed_work rfkill_poll;
1067

1068
1069
1070
	/* TX Power */
	s8 tx_power_user_lmt;
	s8 tx_power_channel_lmt;
1071
1072


Samuel Ortiz's avatar
Samuel Ortiz committed
1073
#ifdef CONFIG_IWLWIFI_DEBUG
1074
	/* debugging info */
1075
	u32 debug_level;
1076
1077
	u32 framecnt_to_us;
	atomic_t restrict_refcnt;
1078
1079
1080
1081
1082
#ifdef CONFIG_IWLWIFI_DEBUGFS
	/* debugfs */
	struct iwl_debugfs *dbgfs;
#endif /* CONFIG_IWLWIFI_DEBUGFS */
#endif /* CONFIG_IWLWIFI_DEBUG */
1083
1084

	struct work_struct txpower_work;
1085
1086
	u32 disable_sens_cal;
	u32 disable_chain_noise_cal;
1087
	u32 disable_tx_power_cal;
1088
	struct work_struct run_time_calib_work;
1089
	struct timer_list statistics_periodic;
1090
1091
1092
1093
1094
1095
1096
1097
1098

	/*For 3945*/
#define IWL_DEFAULT_TX_POWER 0x0F

	struct iwl3945_notif_statistics statistics_39;

	struct iwl3945_station_entry stations_39[IWL_STATION_COUNT];

	u32 sta_supp_rates;
1099
}; /*iwl_priv */
1100

1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
static inline void iwl_txq_ctx_activate(struct iwl_priv *priv, int txq_id)
{
	set_bit(txq_id, &priv->txq_ctx_active_msk);
}

static inline void iwl_txq_ctx_deactivate(struct iwl_priv *priv, int txq_id)
{
	clear_bit(txq_id, &priv->txq_ctx_active_msk);
}

1111
#ifdef CONFIG_IWLWIFI_DEBUG
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
const char *iwl_get_tx_fail_reason(u32 status);
#else
static inline const char *iwl_get_tx_fail_reason(u32 status) { return ""; }
#endif


static inline struct ieee80211_hdr *iwl_tx_queue_get_hdr(struct iwl_priv *priv,
							 int txq_id, int idx)
{
	if (priv->txq[txq_id].txb[idx].skb[0])
		return (struct ieee80211_hdr *)priv->txq[txq_id].
				txb[idx].skb[0]->data;
	return NULL;
}


1128
static inline int iwl_is_associated(struct iwl_priv *priv)
1129
1130
1131
1132
{
	return (priv->active_rxon.filter_flags & RXON_FILTER_ASSOC_MSK) ? 1 : 0;
}

1133
static inline int is_channel_valid(const struct iwl_channel_info *ch_info)
1134
1135
1136
1137
1138
1139
{
	if (ch_info == NULL)
		return 0;
	return (ch_info->flags & EEPROM_CHANNEL_VALID) ? 1 : 0;
}

1140
static inline int is_channel_radar(const struct iwl_channel_info *ch_info)
1141
1142
1143
1144
{
	return (ch_info->flags & EEPROM_CHANNEL_RADAR) ? 1 : 0;
}

1145
static inline u8 is_channel_a_band(const struct iwl_channel_info *ch_info)
1146
{
1147
	return ch_info->band == IEEE80211_BAND_5GHZ;
1148
1149
}

1150
static inline u8 is_channel_bg_band(const struct iwl_channel_info *ch_info)
1151
{
1152
	return ch_info->band == IEEE80211_BAND_2GHZ;
1153
1154
}

1155
static inline int is_channel_passive(const struct iwl_channel_info *ch)
1156
1157
1158
1159
{
	return (!(ch->flags & EEPROM_CHANNEL_ACTIVE)) ? 1 : 0;
}

1160
static inline int is_channel_ibss(const struct iwl_channel_info *ch)
1161
1162
1163
1164
{
	return ((ch->flags & EEPROM_CHANNEL_IBSS)) ? 1 : 0;
}

1165
#endif				/* __iwl_dev_h__ */