iwl-dev.h 27 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051
  1. /******************************************************************************
  2. *
  3. * Copyright(c) 2003 - 2008 Intel Corporation. All rights reserved.
  4. *
  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.
  8. *
  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
  12. * more details.
  13. *
  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
  17. *
  18. * The full GNU General Public License is included in this distribution in the
  19. * file called LICENSE.
  20. *
  21. * Contact Information:
  22. * Intel Linux Wireless <ilw@linux.intel.com>
  23. * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
  24. *
  25. *****************************************************************************/
  26. /*
  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.
  30. */
  31. #ifndef __iwl_dev_h__
  32. #define __iwl_dev_h__
  33. #include <linux/pci.h> /* for struct pci_device_id */
  34. #include <linux/kernel.h>
  35. #include <net/ieee80211_radiotap.h>
  36. #define DRV_NAME "iwlagn"
  37. #include "iwl-rfkill.h"
  38. #include "iwl-eeprom.h"
  39. #include "iwl-4965-hw.h"
  40. #include "iwl-csr.h"
  41. #include "iwl-prph.h"
  42. #include "iwl-debug.h"
  43. #include "iwl-led.h"
  44. #include "iwl-power.h"
  45. #include "iwl-agn-rs.h"
  46. /* configuration for the iwl4965 */
  47. extern struct iwl_cfg iwl4965_agn_cfg;
  48. extern struct iwl_cfg iwl5300_agn_cfg;
  49. extern struct iwl_cfg iwl5100_agn_cfg;
  50. extern struct iwl_cfg iwl5350_agn_cfg;
  51. extern struct iwl_cfg iwl5100_bg_cfg;
  52. extern struct iwl_cfg iwl5100_abg_cfg;
  53. extern struct iwl_cfg iwl5150_agn_cfg;
  54. /* CT-KILL constants */
  55. #define CT_KILL_THRESHOLD 110 /* in Celsius */
  56. /* Default noise level to report when noise measurement is not available.
  57. * This may be because we're:
  58. * 1) Not associated (4965, no beacon statistics being sent to driver)
  59. * 2) Scanning (noise measurement does not apply to associated channel)
  60. * 3) Receiving CCK (3945 delivers noise info only for OFDM frames)
  61. * Use default noise value of -127 ... this is below the range of measurable
  62. * Rx dBm for either 3945 or 4965, so it can indicate "unmeasurable" to user.
  63. * Also, -127 works better than 0 when averaging frames with/without
  64. * noise info (e.g. averaging might be done in app); measured dBm values are
  65. * always negative ... using a negative value as the default keeps all
  66. * averages within an s8's (used in some apps) range of negative values. */
  67. #define IWL_NOISE_MEAS_NOT_AVAILABLE (-127)
  68. /*
  69. * RTS threshold here is total size [2347] minus 4 FCS bytes
  70. * Per spec:
  71. * a value of 0 means RTS on all data/management packets
  72. * a value > max MSDU size means no RTS
  73. * else RTS for data/management frames where MPDU is larger
  74. * than RTS value.
  75. */
  76. #define DEFAULT_RTS_THRESHOLD 2347U
  77. #define MIN_RTS_THRESHOLD 0U
  78. #define MAX_RTS_THRESHOLD 2347U
  79. #define MAX_MSDU_SIZE 2304U
  80. #define MAX_MPDU_SIZE 2346U
  81. #define DEFAULT_BEACON_INTERVAL 100U
  82. #define DEFAULT_SHORT_RETRY_LIMIT 7U
  83. #define DEFAULT_LONG_RETRY_LIMIT 4U
  84. struct iwl_rx_mem_buffer {
  85. dma_addr_t real_dma_addr;
  86. dma_addr_t aligned_dma_addr;
  87. struct sk_buff *skb;
  88. struct list_head list;
  89. };
  90. /*
  91. * Generic queue structure
  92. *
  93. * Contains common data for Rx and Tx queues
  94. */
  95. struct iwl_queue {
  96. int n_bd; /* number of BDs in this queue */
  97. int write_ptr; /* 1-st empty entry (index) host_w*/
  98. int read_ptr; /* last used entry (index) host_r*/
  99. dma_addr_t dma_addr; /* physical addr for BD's */
  100. int n_window; /* safe queue window */
  101. u32 id;
  102. int low_mark; /* low watermark, resume queue if free
  103. * space more than this */
  104. int high_mark; /* high watermark, stop queue if free
  105. * space less than this */
  106. } __attribute__ ((packed));
  107. /* One for each TFD */
  108. struct iwl_tx_info {
  109. struct sk_buff *skb[IWL_NUM_OF_TBS - 1];
  110. };
  111. /**
  112. * struct iwl_tx_queue - Tx Queue for DMA
  113. * @q: generic Rx/Tx queue descriptor
  114. * @bd: base of circular buffer of TFDs
  115. * @cmd: array of command/Tx buffers
  116. * @dma_addr_cmd: physical address of cmd/tx buffer array
  117. * @txb: array of per-TFD driver data
  118. * @need_update: indicates need to update read/write index
  119. * @sched_retry: indicates queue is high-throughput aggregation (HT AGG) enabled
  120. *
  121. * A Tx queue consists of circular buffer of BDs (a.k.a. TFDs, transmit frame
  122. * descriptors) and required locking structures.
  123. */
  124. struct iwl_tx_queue {
  125. struct iwl_queue q;
  126. struct iwl_tfd *tfds;
  127. struct iwl_cmd *cmd[TFD_TX_CMD_SLOTS];
  128. struct iwl_tx_info *txb;
  129. u8 need_update;
  130. u8 sched_retry;
  131. u8 active;
  132. u8 swq_id;
  133. };
  134. #define IWL_NUM_SCAN_RATES (2)
  135. struct iwl4965_channel_tgd_info {
  136. u8 type;
  137. s8 max_power;
  138. };
  139. struct iwl4965_channel_tgh_info {
  140. s64 last_radar_time;
  141. };
  142. /*
  143. * One for each channel, holds all channel setup data
  144. * Some of the fields (e.g. eeprom and flags/max_power_avg) are redundant
  145. * with one another!
  146. */
  147. struct iwl_channel_info {
  148. struct iwl4965_channel_tgd_info tgd;
  149. struct iwl4965_channel_tgh_info tgh;
  150. struct iwl_eeprom_channel eeprom; /* EEPROM regulatory limit */
  151. struct iwl_eeprom_channel fat_eeprom; /* EEPROM regulatory limit for
  152. * FAT channel */
  153. u8 channel; /* channel number */
  154. u8 flags; /* flags copied from EEPROM */
  155. s8 max_power_avg; /* (dBm) regul. eeprom, normal Tx, any rate */
  156. s8 curr_txpow; /* (dBm) regulatory/spectrum/user (not h/w) limit */
  157. s8 min_power; /* always 0 */
  158. s8 scan_power; /* (dBm) regul. eeprom, direct scans, any rate */
  159. u8 group_index; /* 0-4, maps channel to group1/2/3/4/5 */
  160. u8 band_index; /* 0-4, maps channel to band1/2/3/4/5 */
  161. enum ieee80211_band band;
  162. /* FAT channel info */
  163. s8 fat_max_power_avg; /* (dBm) regul. eeprom, normal Tx, any rate */
  164. s8 fat_curr_txpow; /* (dBm) regulatory/spectrum/user (not h/w) */
  165. s8 fat_min_power; /* always 0 */
  166. s8 fat_scan_power; /* (dBm) eeprom, direct scans, any rate */
  167. u8 fat_flags; /* flags copied from EEPROM */
  168. u8 fat_extension_channel; /* HT_IE_EXT_CHANNEL_* */
  169. };
  170. #define IWL_TX_FIFO_AC0 0
  171. #define IWL_TX_FIFO_AC1 1
  172. #define IWL_TX_FIFO_AC2 2
  173. #define IWL_TX_FIFO_AC3 3
  174. #define IWL_TX_FIFO_HCCA_1 5
  175. #define IWL_TX_FIFO_HCCA_2 6
  176. #define IWL_TX_FIFO_NONE 7
  177. /* Minimum number of queues. MAX_NUM is defined in hw specific files */
  178. #define IWL_MIN_NUM_QUEUES 4
  179. /* Power management (not Tx power) structures */
  180. enum iwl_pwr_src {
  181. IWL_PWR_SRC_VMAIN,
  182. IWL_PWR_SRC_VAUX,
  183. };
  184. #define IEEE80211_DATA_LEN 2304
  185. #define IEEE80211_4ADDR_LEN 30
  186. #define IEEE80211_HLEN (IEEE80211_4ADDR_LEN)
  187. #define IEEE80211_FRAME_LEN (IEEE80211_DATA_LEN + IEEE80211_HLEN)
  188. struct iwl_frame {
  189. union {
  190. struct ieee80211_hdr frame;
  191. struct iwl_tx_beacon_cmd beacon;
  192. u8 raw[IEEE80211_FRAME_LEN];
  193. u8 cmd[360];
  194. } u;
  195. struct list_head list;
  196. };
  197. #define SEQ_TO_SN(seq) (((seq) & IEEE80211_SCTL_SEQ) >> 4)
  198. #define SN_TO_SEQ(ssn) (((ssn) << 4) & IEEE80211_SCTL_SEQ)
  199. #define MAX_SN ((IEEE80211_SCTL_SEQ) >> 4)
  200. enum {
  201. /* CMD_SIZE_NORMAL = 0, */
  202. CMD_SIZE_HUGE = (1 << 0),
  203. /* CMD_SYNC = 0, */
  204. CMD_ASYNC = (1 << 1),
  205. /* CMD_NO_SKB = 0, */
  206. CMD_WANT_SKB = (1 << 2),
  207. };
  208. struct iwl_cmd;
  209. struct iwl_priv;
  210. struct iwl_cmd_meta {
  211. struct iwl_cmd_meta *source;
  212. union {
  213. struct sk_buff *skb;
  214. int (*callback)(struct iwl_priv *priv,
  215. struct iwl_cmd *cmd, struct sk_buff *skb);
  216. } __attribute__ ((packed)) u;
  217. /* The CMD_SIZE_HUGE flag bit indicates that the command
  218. * structure is stored at the end of the shared queue memory. */
  219. u32 flags;
  220. DECLARE_PCI_UNMAP_ADDR(mapping)
  221. DECLARE_PCI_UNMAP_LEN(len)
  222. } __attribute__ ((packed));
  223. #define IWL_CMD_MAX_PAYLOAD 320
  224. /**
  225. * struct iwl_cmd
  226. *
  227. * For allocation of the command and tx queues, this establishes the overall
  228. * size of the largest command we send to uCode, except for a scan command
  229. * (which is relatively huge; space is allocated separately).
  230. */
  231. struct iwl_cmd {
  232. struct iwl_cmd_meta meta; /* driver data */
  233. struct iwl_cmd_header hdr; /* uCode API */
  234. union {
  235. u32 flags;
  236. u8 val8;
  237. u16 val16;
  238. u32 val32;
  239. struct iwl_tx_cmd tx;
  240. u8 payload[IWL_CMD_MAX_PAYLOAD];
  241. } __attribute__ ((packed)) cmd;
  242. } __attribute__ ((packed));
  243. struct iwl_host_cmd {
  244. u8 id;
  245. u16 len;
  246. struct iwl_cmd_meta meta;
  247. const void *data;
  248. };
  249. #define TFD_MAX_PAYLOAD_SIZE (sizeof(struct iwl_cmd) - \
  250. sizeof(struct iwl_cmd_meta))
  251. /*
  252. * RX related structures and functions
  253. */
  254. #define RX_FREE_BUFFERS 64
  255. #define RX_LOW_WATERMARK 8
  256. #define SUP_RATE_11A_MAX_NUM_CHANNELS 8
  257. #define SUP_RATE_11B_MAX_NUM_CHANNELS 4
  258. #define SUP_RATE_11G_MAX_NUM_CHANNELS 12
  259. /**
  260. * struct iwl_rx_queue - Rx queue
  261. * @read: Shared index to newest available Rx buffer
  262. * @write: Shared index to oldest written Rx packet
  263. * @free_count: Number of pre-allocated buffers in rx_free
  264. * @rx_free: list of free SKBs for use
  265. * @rx_used: List of Rx buffers with no SKB
  266. * @need_update: flag to indicate we need to update read/write index
  267. *
  268. * NOTE: rx_free and rx_used are used as a FIFO for iwl_rx_mem_buffers
  269. */
  270. struct iwl_rx_queue {
  271. __le32 *bd;
  272. dma_addr_t dma_addr;
  273. struct iwl_rx_mem_buffer pool[RX_QUEUE_SIZE + RX_FREE_BUFFERS];
  274. struct iwl_rx_mem_buffer *queue[RX_QUEUE_SIZE];
  275. u32 read;
  276. u32 write;
  277. u32 free_count;
  278. struct list_head rx_free;
  279. struct list_head rx_used;
  280. int need_update;
  281. struct iwl_rb_status *rb_stts;
  282. dma_addr_t rb_stts_dma;
  283. spinlock_t lock;
  284. };
  285. #define IWL_SUPPORTED_RATES_IE_LEN 8
  286. #define MAX_TID_COUNT 9
  287. #define IWL_INVALID_RATE 0xFF
  288. #define IWL_INVALID_VALUE -1
  289. /**
  290. * struct iwl_ht_agg -- aggregation status while waiting for block-ack
  291. * @txq_id: Tx queue used for Tx attempt
  292. * @frame_count: # frames attempted by Tx command
  293. * @wait_for_ba: Expect block-ack before next Tx reply
  294. * @start_idx: Index of 1st Transmit Frame Descriptor (TFD) in Tx window
  295. * @bitmap0: Low order bitmap, one bit for each frame pending ACK in Tx window
  296. * @bitmap1: High order, one bit for each frame pending ACK in Tx window
  297. * @rate_n_flags: Rate at which Tx was attempted
  298. *
  299. * If REPLY_TX indicates that aggregation was attempted, driver must wait
  300. * for block ack (REPLY_COMPRESSED_BA). This struct stores tx reply info
  301. * until block ack arrives.
  302. */
  303. struct iwl_ht_agg {
  304. u16 txq_id;
  305. u16 frame_count;
  306. u16 wait_for_ba;
  307. u16 start_idx;
  308. u64 bitmap;
  309. u32 rate_n_flags;
  310. #define IWL_AGG_OFF 0
  311. #define IWL_AGG_ON 1
  312. #define IWL_EMPTYING_HW_QUEUE_ADDBA 2
  313. #define IWL_EMPTYING_HW_QUEUE_DELBA 3
  314. u8 state;
  315. };
  316. struct iwl_tid_data {
  317. u16 seq_number;
  318. u16 tfds_in_queue;
  319. struct iwl_ht_agg agg;
  320. };
  321. struct iwl_hw_key {
  322. enum ieee80211_key_alg alg;
  323. int keylen;
  324. u8 keyidx;
  325. u8 key[32];
  326. };
  327. union iwl4965_ht_rate_supp {
  328. u16 rates;
  329. struct {
  330. u8 siso_rate;
  331. u8 mimo_rate;
  332. };
  333. };
  334. #define CFG_HT_RX_AMPDU_FACTOR_DEF (0x3)
  335. #define CFG_HT_MPDU_DENSITY_2USEC (0x5)
  336. #define CFG_HT_MPDU_DENSITY_DEF CFG_HT_MPDU_DENSITY_2USEC
  337. struct iwl_ht_info {
  338. /* self configuration data */
  339. u8 is_ht;
  340. u8 supported_chan_width;
  341. u8 sm_ps;
  342. u8 is_green_field;
  343. u8 sgf; /* HT_SHORT_GI_* short guard interval */
  344. u8 max_amsdu_size;
  345. u8 ampdu_factor;
  346. u8 mpdu_density;
  347. struct ieee80211_mcs_info mcs;
  348. /* BSS related data */
  349. u8 extension_chan_offset;
  350. u8 tx_chan_width;
  351. u8 ht_protection;
  352. u8 non_GF_STA_present;
  353. };
  354. union iwl_qos_capabity {
  355. struct {
  356. u8 edca_count:4; /* bit 0-3 */
  357. u8 q_ack:1; /* bit 4 */
  358. u8 queue_request:1; /* bit 5 */
  359. u8 txop_request:1; /* bit 6 */
  360. u8 reserved:1; /* bit 7 */
  361. } q_AP;
  362. struct {
  363. u8 acvo_APSD:1; /* bit 0 */
  364. u8 acvi_APSD:1; /* bit 1 */
  365. u8 ac_bk_APSD:1; /* bit 2 */
  366. u8 ac_be_APSD:1; /* bit 3 */
  367. u8 q_ack:1; /* bit 4 */
  368. u8 max_len:2; /* bit 5-6 */
  369. u8 more_data_ack:1; /* bit 7 */
  370. } q_STA;
  371. u8 val;
  372. };
  373. /* QoS structures */
  374. struct iwl_qos_info {
  375. int qos_active;
  376. union iwl_qos_capabity qos_cap;
  377. struct iwl_qosparam_cmd def_qos_parm;
  378. };
  379. #define STA_PS_STATUS_WAKE 0
  380. #define STA_PS_STATUS_SLEEP 1
  381. struct iwl_station_entry {
  382. struct iwl_addsta_cmd sta;
  383. struct iwl_tid_data tid[MAX_TID_COUNT];
  384. u8 used;
  385. u8 ps_status;
  386. struct iwl_hw_key keyinfo;
  387. };
  388. /* one for each uCode image (inst/data, boot/init/runtime) */
  389. struct fw_desc {
  390. void *v_addr; /* access by driver */
  391. dma_addr_t p_addr; /* access by card's busmaster DMA */
  392. u32 len; /* bytes */
  393. };
  394. /* uCode file layout */
  395. struct iwl_ucode {
  396. __le32 ver; /* major/minor/API/serial */
  397. __le32 inst_size; /* bytes of runtime instructions */
  398. __le32 data_size; /* bytes of runtime data */
  399. __le32 init_size; /* bytes of initialization instructions */
  400. __le32 init_data_size; /* bytes of initialization data */
  401. __le32 boot_size; /* bytes of bootstrap instructions */
  402. u8 data[0]; /* data in same order as "size" elements */
  403. };
  404. struct iwl4965_ibss_seq {
  405. u8 mac[ETH_ALEN];
  406. u16 seq_num;
  407. u16 frag_num;
  408. unsigned long packet_time;
  409. struct list_head list;
  410. };
  411. struct iwl_sensitivity_ranges {
  412. u16 min_nrg_cck;
  413. u16 max_nrg_cck;
  414. u16 nrg_th_cck;
  415. u16 nrg_th_ofdm;
  416. u16 auto_corr_min_ofdm;
  417. u16 auto_corr_min_ofdm_mrc;
  418. u16 auto_corr_min_ofdm_x1;
  419. u16 auto_corr_min_ofdm_mrc_x1;
  420. u16 auto_corr_max_ofdm;
  421. u16 auto_corr_max_ofdm_mrc;
  422. u16 auto_corr_max_ofdm_x1;
  423. u16 auto_corr_max_ofdm_mrc_x1;
  424. u16 auto_corr_max_cck;
  425. u16 auto_corr_max_cck_mrc;
  426. u16 auto_corr_min_cck;
  427. u16 auto_corr_min_cck_mrc;
  428. };
  429. #define KELVIN_TO_CELSIUS(x) ((x)-273)
  430. #define CELSIUS_TO_KELVIN(x) ((x)+273)
  431. /**
  432. * struct iwl_hw_params
  433. * @max_txq_num: Max # Tx queues supported
  434. * @dma_chnl_num: Number of Tx DMA/FIFO channels
  435. * @scd_bc_tbls_size: size of scheduler byte count tables
  436. * @tx/rx_chains_num: Number of TX/RX chains
  437. * @valid_tx/rx_ant: usable antennas
  438. * @max_rxq_size: Max # Rx frames in Rx queue (must be power-of-2)
  439. * @max_rxq_log: Log-base-2 of max_rxq_size
  440. * @rx_buf_size: Rx buffer size
  441. * @max_stations:
  442. * @bcast_sta_id:
  443. * @fat_channel: is 40MHz width possible in band 2.4
  444. * BIT(IEEE80211_BAND_5GHZ) BIT(IEEE80211_BAND_5GHZ)
  445. * @sw_crypto: 0 for hw, 1 for sw
  446. * @max_xxx_size: for ucode uses
  447. * @ct_kill_threshold: temperature threshold
  448. * @calib_init_cfg: setup initial calibrations for the hw
  449. * @struct iwl_sensitivity_ranges: range of sensitivity values
  450. */
  451. struct iwl_hw_params {
  452. u8 max_txq_num;
  453. u8 dma_chnl_num;
  454. u16 scd_bc_tbls_size;
  455. u8 tx_chains_num;
  456. u8 rx_chains_num;
  457. u8 valid_tx_ant;
  458. u8 valid_rx_ant;
  459. u16 max_rxq_size;
  460. u16 max_rxq_log;
  461. u32 rx_buf_size;
  462. u32 max_pkt_size;
  463. u8 max_stations;
  464. u8 bcast_sta_id;
  465. u8 fat_channel;
  466. u8 sw_crypto;
  467. u32 max_inst_size;
  468. u32 max_data_size;
  469. u32 max_bsm_size;
  470. u32 ct_kill_threshold; /* value in hw-dependent units */
  471. u32 calib_init_cfg;
  472. const struct iwl_sensitivity_ranges *sens;
  473. };
  474. /******************************************************************************
  475. *
  476. * Functions implemented in core module which are forward declared here
  477. * for use by iwl-[4-5].c
  478. *
  479. * NOTE: The implementation of these functions are not hardware specific
  480. * which is why they are in the core module files.
  481. *
  482. * Naming convention --
  483. * iwl_ <-- Is part of iwlwifi
  484. * iwlXXXX_ <-- Hardware specific (implemented in iwl-XXXX.c for XXXX)
  485. * iwl4965_bg_ <-- Called from work queue context
  486. * iwl4965_mac_ <-- mac80211 callback
  487. *
  488. ****************************************************************************/
  489. extern void iwl_update_chain_flags(struct iwl_priv *priv);
  490. extern int iwl_set_pwr_src(struct iwl_priv *priv, enum iwl_pwr_src src);
  491. extern const u8 iwl_bcast_addr[ETH_ALEN];
  492. extern int iwl_rxq_stop(struct iwl_priv *priv);
  493. extern void iwl_txq_ctx_stop(struct iwl_priv *priv);
  494. extern int iwl_queue_space(const struct iwl_queue *q);
  495. static inline int iwl_queue_used(const struct iwl_queue *q, int i)
  496. {
  497. return q->write_ptr > q->read_ptr ?
  498. (i >= q->read_ptr && i < q->write_ptr) :
  499. !(i < q->read_ptr && i >= q->write_ptr);
  500. }
  501. static inline u8 get_cmd_index(struct iwl_queue *q, u32 index, int is_huge)
  502. {
  503. /* This is for scan command, the big buffer at end of command array */
  504. if (is_huge)
  505. return q->n_window; /* must be power of 2 */
  506. /* Otherwise, use normal size buffers */
  507. return index & (q->n_window - 1);
  508. }
  509. struct iwl_dma_ptr {
  510. dma_addr_t dma;
  511. void *addr;
  512. size_t size;
  513. };
  514. #define HT_SHORT_GI_20MHZ (1 << 0)
  515. #define HT_SHORT_GI_40MHZ (1 << 1)
  516. #define IWL_CHANNEL_WIDTH_20MHZ 0
  517. #define IWL_CHANNEL_WIDTH_40MHZ 1
  518. #define IWL_OPERATION_MODE_AUTO 0
  519. #define IWL_OPERATION_MODE_HT_ONLY 1
  520. #define IWL_OPERATION_MODE_MIXED 2
  521. #define IWL_OPERATION_MODE_20MHZ 3
  522. #define IWL_TX_CRC_SIZE 4
  523. #define IWL_TX_DELIMITER_SIZE 4
  524. #define TX_POWER_IWL_ILLEGAL_VOLTAGE -10000
  525. /* Sensitivity and chain noise calibration */
  526. #define INITIALIZATION_VALUE 0xFFFF
  527. #define CAL_NUM_OF_BEACONS 20
  528. #define MAXIMUM_ALLOWED_PATHLOSS 15
  529. #define CHAIN_NOISE_MAX_DELTA_GAIN_CODE 3
  530. #define MAX_FA_OFDM 50
  531. #define MIN_FA_OFDM 5
  532. #define MAX_FA_CCK 50
  533. #define MIN_FA_CCK 5
  534. #define AUTO_CORR_STEP_OFDM 1
  535. #define AUTO_CORR_STEP_CCK 3
  536. #define AUTO_CORR_MAX_TH_CCK 160
  537. #define NRG_DIFF 2
  538. #define NRG_STEP_CCK 2
  539. #define NRG_MARGIN 8
  540. #define MAX_NUMBER_CCK_NO_FA 100
  541. #define AUTO_CORR_CCK_MIN_VAL_DEF (125)
  542. #define CHAIN_A 0
  543. #define CHAIN_B 1
  544. #define CHAIN_C 2
  545. #define CHAIN_NOISE_DELTA_GAIN_INIT_VAL 4
  546. #define ALL_BAND_FILTER 0xFF00
  547. #define IN_BAND_FILTER 0xFF
  548. #define MIN_AVERAGE_NOISE_MAX_VALUE 0xFFFFFFFF
  549. #define NRG_NUM_PREV_STAT_L 20
  550. #define NUM_RX_CHAINS 3
  551. enum iwl4965_false_alarm_state {
  552. IWL_FA_TOO_MANY = 0,
  553. IWL_FA_TOO_FEW = 1,
  554. IWL_FA_GOOD_RANGE = 2,
  555. };
  556. enum iwl4965_chain_noise_state {
  557. IWL_CHAIN_NOISE_ALIVE = 0, /* must be 0 */
  558. IWL_CHAIN_NOISE_ACCUMULATE,
  559. IWL_CHAIN_NOISE_CALIBRATED,
  560. IWL_CHAIN_NOISE_DONE,
  561. };
  562. enum iwl4965_calib_enabled_state {
  563. IWL_CALIB_DISABLED = 0, /* must be 0 */
  564. IWL_CALIB_ENABLED = 1,
  565. };
  566. /*
  567. * enum iwl_calib
  568. * defines the order in which results of initial calibrations
  569. * should be sent to the runtime uCode
  570. */
  571. enum iwl_calib {
  572. IWL_CALIB_XTAL,
  573. IWL_CALIB_DC,
  574. IWL_CALIB_LO,
  575. IWL_CALIB_TX_IQ,
  576. IWL_CALIB_TX_IQ_PERD,
  577. IWL_CALIB_BASE_BAND,
  578. IWL_CALIB_MAX
  579. };
  580. /* Opaque calibration results */
  581. struct iwl_calib_result {
  582. void *buf;
  583. size_t buf_len;
  584. };
  585. enum ucode_type {
  586. UCODE_NONE = 0,
  587. UCODE_INIT,
  588. UCODE_RT
  589. };
  590. /* Sensitivity calib data */
  591. struct iwl_sensitivity_data {
  592. u32 auto_corr_ofdm;
  593. u32 auto_corr_ofdm_mrc;
  594. u32 auto_corr_ofdm_x1;
  595. u32 auto_corr_ofdm_mrc_x1;
  596. u32 auto_corr_cck;
  597. u32 auto_corr_cck_mrc;
  598. u32 last_bad_plcp_cnt_ofdm;
  599. u32 last_fa_cnt_ofdm;
  600. u32 last_bad_plcp_cnt_cck;
  601. u32 last_fa_cnt_cck;
  602. u32 nrg_curr_state;
  603. u32 nrg_prev_state;
  604. u32 nrg_value[10];
  605. u8 nrg_silence_rssi[NRG_NUM_PREV_STAT_L];
  606. u32 nrg_silence_ref;
  607. u32 nrg_energy_idx;
  608. u32 nrg_silence_idx;
  609. u32 nrg_th_cck;
  610. s32 nrg_auto_corr_silence_diff;
  611. u32 num_in_cck_no_fa;
  612. u32 nrg_th_ofdm;
  613. };
  614. /* Chain noise (differential Rx gain) calib data */
  615. struct iwl_chain_noise_data {
  616. u32 active_chains;
  617. u32 chain_noise_a;
  618. u32 chain_noise_b;
  619. u32 chain_noise_c;
  620. u32 chain_signal_a;
  621. u32 chain_signal_b;
  622. u32 chain_signal_c;
  623. u16 beacon_count;
  624. u8 disconn_array[NUM_RX_CHAINS];
  625. u8 delta_gain_code[NUM_RX_CHAINS];
  626. u8 radio_write;
  627. u8 state;
  628. };
  629. #define EEPROM_SEM_TIMEOUT 10 /* milliseconds */
  630. #define EEPROM_SEM_RETRY_LIMIT 1000 /* number of attempts (not time) */
  631. enum {
  632. MEASUREMENT_READY = (1 << 0),
  633. MEASUREMENT_ACTIVE = (1 << 1),
  634. };
  635. #define IWL_MAX_NUM_QUEUES 20 /* FIXME: do dynamic allocation */
  636. struct iwl_priv {
  637. /* ieee device used by generic ieee processing code */
  638. struct ieee80211_hw *hw;
  639. struct ieee80211_channel *ieee_channels;
  640. struct ieee80211_rate *ieee_rates;
  641. struct iwl_cfg *cfg;
  642. /* temporary frame storage list */
  643. struct list_head free_frames;
  644. int frames_count;
  645. enum ieee80211_band band;
  646. int alloc_rxb_skb;
  647. void (*rx_handlers[REPLY_MAX])(struct iwl_priv *priv,
  648. struct iwl_rx_mem_buffer *rxb);
  649. struct ieee80211_supported_band bands[IEEE80211_NUM_BANDS];
  650. #ifdef CONFIG_IWLAGN_SPECTRUM_MEASUREMENT
  651. /* spectrum measurement report caching */
  652. struct iwl_spectrum_notification measure_report;
  653. u8 measurement_status;
  654. #endif
  655. /* ucode beacon time */
  656. u32 ucode_beacon_time;
  657. /* we allocate array of iwl4965_channel_info for NIC's valid channels.
  658. * Access via channel # using indirect index array */
  659. struct iwl_channel_info *channel_info; /* channel info array */
  660. u8 channel_count; /* # of channels */
  661. /* thermal calibration */
  662. s32 temperature; /* degrees Kelvin */
  663. s32 last_temperature;
  664. /* init calibration results */
  665. struct iwl_calib_result calib_results[IWL_CALIB_MAX];
  666. /* Scan related variables */
  667. unsigned long last_scan_jiffies;
  668. unsigned long next_scan_jiffies;
  669. unsigned long scan_start;
  670. unsigned long scan_pass_start;
  671. unsigned long scan_start_tsf;
  672. struct iwl_scan_cmd *scan;
  673. int scan_bands;
  674. int one_direct_scan;
  675. u8 direct_ssid_len;
  676. u8 direct_ssid[IW_ESSID_MAX_SIZE];
  677. u8 scan_tx_ant[IEEE80211_NUM_BANDS];
  678. u8 mgmt_tx_ant;
  679. /* spinlock */
  680. spinlock_t lock; /* protect general shared data */
  681. spinlock_t hcmd_lock; /* protect hcmd */
  682. struct mutex mutex;
  683. /* basic pci-network driver stuff */
  684. struct pci_dev *pci_dev;
  685. /* pci hardware address support */
  686. void __iomem *hw_base;
  687. u32 hw_rev;
  688. u32 hw_wa_rev;
  689. u8 rev_id;
  690. /* uCode images, save to reload in case of failure */
  691. u32 ucode_ver; /* version of ucode, copy of
  692. iwl_ucode.ver */
  693. struct fw_desc ucode_code; /* runtime inst */
  694. struct fw_desc ucode_data; /* runtime data original */
  695. struct fw_desc ucode_data_backup; /* runtime data save/restore */
  696. struct fw_desc ucode_init; /* initialization inst */
  697. struct fw_desc ucode_init_data; /* initialization data */
  698. struct fw_desc ucode_boot; /* bootstrap inst */
  699. enum ucode_type ucode_type;
  700. u8 ucode_write_complete; /* the image write is complete */
  701. struct iwl_rxon_time_cmd rxon_timing;
  702. /* We declare this const so it can only be
  703. * changed via explicit cast within the
  704. * routines that actually update the physical
  705. * hardware */
  706. const struct iwl_rxon_cmd active_rxon;
  707. struct iwl_rxon_cmd staging_rxon;
  708. int error_recovering;
  709. struct iwl_rxon_cmd recovery_rxon;
  710. /* 1st responses from initialize and runtime uCode images.
  711. * 4965's initialize alive response contains some calibration data. */
  712. struct iwl_init_alive_resp card_alive_init;
  713. struct iwl_alive_resp card_alive;
  714. #ifdef CONFIG_IWLWIFI_RFKILL
  715. struct rfkill *rfkill;
  716. #endif
  717. #ifdef CONFIG_IWLWIFI_LEDS
  718. struct iwl_led led[IWL_LED_TRG_MAX];
  719. unsigned long last_blink_time;
  720. u8 last_blink_rate;
  721. u8 allow_blinking;
  722. u64 led_tpt;
  723. #endif
  724. u16 active_rate;
  725. u16 active_rate_basic;
  726. u8 assoc_station_added;
  727. u8 start_calib;
  728. struct iwl_sensitivity_data sensitivity_data;
  729. struct iwl_chain_noise_data chain_noise_data;
  730. __le16 sensitivity_tbl[HD_TABLE_SIZE];
  731. struct iwl_ht_info current_ht_config;
  732. u8 last_phy_res[100];
  733. /* Rate scaling data */
  734. s8 data_retry_limit;
  735. u8 retry_rate;
  736. wait_queue_head_t wait_command_queue;
  737. int activity_timer_active;
  738. /* Rx and Tx DMA processing queues */
  739. struct iwl_rx_queue rxq;
  740. struct iwl_tx_queue txq[IWL_MAX_NUM_QUEUES];
  741. unsigned long txq_ctx_active_msk;
  742. struct iwl_dma_ptr kw; /* keep warm address */
  743. struct iwl_dma_ptr scd_bc_tbls;
  744. u32 scd_base_addr; /* scheduler sram base address */
  745. unsigned long status;
  746. int last_rx_rssi; /* From Rx packet statistics */
  747. int last_rx_noise; /* From beacon statistics */
  748. /* counts mgmt, ctl, and data packets */
  749. struct traffic_stats {
  750. u32 cnt;
  751. u64 bytes;
  752. } tx_stats[3], rx_stats[3];
  753. struct iwl_power_mgr power_data;
  754. struct iwl_notif_statistics statistics;
  755. unsigned long last_statistics_time;
  756. /* context information */
  757. u16 rates_mask;
  758. u32 power_mode;
  759. u32 antenna;
  760. u8 bssid[ETH_ALEN];
  761. u16 rts_threshold;
  762. u8 mac_addr[ETH_ALEN];
  763. /*station table variables */
  764. spinlock_t sta_lock;
  765. int num_stations;
  766. struct iwl_station_entry stations[IWL_STATION_COUNT];
  767. struct iwl_wep_key wep_keys[WEP_KEYS_MAX];
  768. u8 default_wep_key;
  769. u8 key_mapping_key;
  770. unsigned long ucode_key_table;
  771. /* Indication if ieee80211_ops->open has been called */
  772. u8 is_open;
  773. u8 mac80211_registered;
  774. /* Rx'd packet timing information */
  775. u32 last_beacon_time;
  776. u64 last_tsf;
  777. /* eeprom */
  778. u8 *eeprom;
  779. struct iwl_eeprom_calib_info *calib_info;
  780. enum nl80211_iftype iw_mode;
  781. struct sk_buff *ibss_beacon;
  782. /* Last Rx'd beacon timestamp */
  783. u64 timestamp;
  784. u16 beacon_int;
  785. struct ieee80211_vif *vif;
  786. struct iwl_hw_params hw_params;
  787. /* Current association information needed to configure the
  788. * hardware */
  789. u16 assoc_id;
  790. u16 assoc_capability;
  791. struct iwl_qos_info qos_data;
  792. struct workqueue_struct *workqueue;
  793. struct work_struct up;
  794. struct work_struct restart;
  795. struct work_struct calibrated_work;
  796. struct work_struct scan_completed;
  797. struct work_struct rx_replenish;
  798. struct work_struct rf_kill;
  799. struct work_struct abort_scan;
  800. struct work_struct update_link_led;
  801. struct work_struct auth_work;
  802. struct work_struct report_work;
  803. struct work_struct request_scan;
  804. struct work_struct beacon_update;
  805. struct tasklet_struct irq_tasklet;
  806. struct delayed_work set_power_save;
  807. struct delayed_work init_alive_start;
  808. struct delayed_work alive_start;
  809. struct delayed_work scan_check;
  810. /* TX Power */
  811. s8 tx_power_user_lmt;
  812. s8 tx_power_channel_lmt;
  813. #ifdef CONFIG_IWLWIFI_DEBUG
  814. /* debugging info */
  815. u32 debug_level;
  816. u32 framecnt_to_us;
  817. atomic_t restrict_refcnt;
  818. #ifdef CONFIG_IWLWIFI_DEBUGFS
  819. /* debugfs */
  820. struct iwl_debugfs *dbgfs;
  821. #endif /* CONFIG_IWLWIFI_DEBUGFS */
  822. #endif /* CONFIG_IWLWIFI_DEBUG */
  823. struct work_struct txpower_work;
  824. u32 disable_sens_cal;
  825. u32 disable_chain_noise_cal;
  826. u32 disable_tx_power_cal;
  827. struct work_struct run_time_calib_work;
  828. struct timer_list statistics_periodic;
  829. }; /*iwl_priv */
  830. static inline void iwl_txq_ctx_activate(struct iwl_priv *priv, int txq_id)
  831. {
  832. set_bit(txq_id, &priv->txq_ctx_active_msk);
  833. }
  834. static inline void iwl_txq_ctx_deactivate(struct iwl_priv *priv, int txq_id)
  835. {
  836. clear_bit(txq_id, &priv->txq_ctx_active_msk);
  837. }
  838. #ifdef CONFIG_IWLWIFI_DEBUG
  839. const char *iwl_get_tx_fail_reason(u32 status);
  840. #else
  841. static inline const char *iwl_get_tx_fail_reason(u32 status) { return ""; }
  842. #endif
  843. static inline struct ieee80211_hdr *iwl_tx_queue_get_hdr(struct iwl_priv *priv,
  844. int txq_id, int idx)
  845. {
  846. if (priv->txq[txq_id].txb[idx].skb[0])
  847. return (struct ieee80211_hdr *)priv->txq[txq_id].
  848. txb[idx].skb[0]->data;
  849. return NULL;
  850. }
  851. static inline int iwl_is_associated(struct iwl_priv *priv)
  852. {
  853. return (priv->active_rxon.filter_flags & RXON_FILTER_ASSOC_MSK) ? 1 : 0;
  854. }
  855. static inline int is_channel_valid(const struct iwl_channel_info *ch_info)
  856. {
  857. if (ch_info == NULL)
  858. return 0;
  859. return (ch_info->flags & EEPROM_CHANNEL_VALID) ? 1 : 0;
  860. }
  861. static inline int is_channel_radar(const struct iwl_channel_info *ch_info)
  862. {
  863. return (ch_info->flags & EEPROM_CHANNEL_RADAR) ? 1 : 0;
  864. }
  865. static inline u8 is_channel_a_band(const struct iwl_channel_info *ch_info)
  866. {
  867. return ch_info->band == IEEE80211_BAND_5GHZ;
  868. }
  869. static inline u8 is_channel_bg_band(const struct iwl_channel_info *ch_info)
  870. {
  871. return ch_info->band == IEEE80211_BAND_2GHZ;
  872. }
  873. static inline int is_channel_passive(const struct iwl_channel_info *ch)
  874. {
  875. return (!(ch->flags & EEPROM_CHANNEL_ACTIVE)) ? 1 : 0;
  876. }
  877. static inline int is_channel_ibss(const struct iwl_channel_info *ch)
  878. {
  879. return ((ch->flags & EEPROM_CHANNEL_IBSS)) ? 1 : 0;
  880. }
  881. #endif /* __iwl_dev_h__ */