iwlwifi: on-screen event log dump
[pandora-kernel.git] / drivers / net / wireless / iwlwifi / iwl-core.h
1 /******************************************************************************
2  *
3  * This file is provided under a dual BSD/GPLv2 license.  When using or
4  * redistributing this file, you may do so under either license.
5  *
6  * GPL LICENSE SUMMARY
7  *
8  * Copyright(c) 2008 - 2009 Intel Corporation. All rights reserved.
9  *
10  * This program is free software; you can redistribute it and/or modify
11  * it under the terms of version 2 of the GNU General Public License as
12  * published by the Free Software Foundation.
13  *
14  * This program is distributed in the hope that it will be useful, but
15  * WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
17  * General Public License for more details.
18  *
19  * You should have received a copy of the GNU General Public License
20  * along with this program; if not, write to the Free Software
21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110,
22  * USA
23  *
24  * The full GNU General Public License is included in this distribution
25  * in the file called LICENSE.GPL.
26  *
27  * Contact Information:
28  *  Intel Linux Wireless <ilw@linux.intel.com>
29  * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
30  *
31  * BSD LICENSE
32  *
33  * Copyright(c) 2005 - 2009 Intel Corporation. All rights reserved.
34  * All rights reserved.
35  *
36  * Redistribution and use in source and binary forms, with or without
37  * modification, are permitted provided that the following conditions
38  * are met:
39  *
40  *  * Redistributions of source code must retain the above copyright
41  *    notice, this list of conditions and the following disclaimer.
42  *  * Redistributions in binary form must reproduce the above copyright
43  *    notice, this list of conditions and the following disclaimer in
44  *    the documentation and/or other materials provided with the
45  *    distribution.
46  *  * Neither the name Intel Corporation nor the names of its
47  *    contributors may be used to endorse or promote products derived
48  *    from this software without specific prior written permission.
49  *
50  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
51  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
52  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
53  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
54  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
55  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
56  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
57  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
58  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
59  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
60  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
61  *****************************************************************************/
62
63 #ifndef __iwl_core_h__
64 #define __iwl_core_h__
65
66 #include <linux/utsrelease.h>
67
68 /************************
69  * forward declarations *
70  ************************/
71 struct iwl_host_cmd;
72 struct iwl_cmd;
73
74
75 #define IWLWIFI_VERSION UTS_RELEASE "-k"
76 #define DRV_COPYRIGHT   "Copyright(c) 2003-2009 Intel Corporation"
77 #define DRV_AUTHOR     "<ilw@linux.intel.com>"
78
79 #define IWL_PCI_DEVICE(dev, subdev, cfg) \
80         .vendor = PCI_VENDOR_ID_INTEL,  .device = (dev), \
81         .subvendor = PCI_ANY_ID, .subdevice = (subdev), \
82         .driver_data = (kernel_ulong_t)&(cfg)
83
84 #define IWL_SKU_G       0x1
85 #define IWL_SKU_A       0x2
86 #define IWL_SKU_N       0x8
87
88 #define IWL_CMD(x) case x: return #x
89
90 struct iwl_hcmd_ops {
91         int (*rxon_assoc)(struct iwl_priv *priv);
92         int (*commit_rxon)(struct iwl_priv *priv);
93         void (*set_rxon_chain)(struct iwl_priv *priv);
94         int (*set_tx_ant)(struct iwl_priv *priv, u8 valid_tx_ant);
95 };
96
97 struct iwl_hcmd_utils_ops {
98         u16 (*get_hcmd_size)(u8 cmd_id, u16 len);
99         u16 (*build_addsta_hcmd)(const struct iwl_addsta_cmd *cmd, u8 *data);
100         void (*gain_computation)(struct iwl_priv *priv,
101                         u32 *average_noise,
102                         u16 min_average_noise_antennat_i,
103                         u32 min_average_noise,
104                         u8 default_chain);
105         void (*chain_noise_reset)(struct iwl_priv *priv);
106         void (*rts_tx_cmd_flag)(struct ieee80211_tx_info *info,
107                         __le32 *tx_flags);
108         int  (*calc_rssi)(struct iwl_priv *priv,
109                           struct iwl_rx_phy_res *rx_resp);
110 };
111
112 struct iwl_apm_ops {
113         int (*init)(struct iwl_priv *priv);
114         void (*stop)(struct iwl_priv *priv);
115         void (*config)(struct iwl_priv *priv);
116         int (*set_pwr_src)(struct iwl_priv *priv, enum iwl_pwr_src src);
117 };
118
119 struct iwl_temp_ops {
120         void (*temperature)(struct iwl_priv *priv);
121         void (*set_ct_kill)(struct iwl_priv *priv);
122 };
123
124 struct iwl_ucode_ops {
125         u32 (*get_header_size)(u32);
126         u32 (*get_build)(const struct iwl_ucode_header *, u32);
127         u32 (*get_inst_size)(const struct iwl_ucode_header *, u32);
128         u32 (*get_data_size)(const struct iwl_ucode_header *, u32);
129         u32 (*get_init_size)(const struct iwl_ucode_header *, u32);
130         u32 (*get_init_data_size)(const struct iwl_ucode_header *, u32);
131         u32 (*get_boot_size)(const struct iwl_ucode_header *, u32);
132         u8 * (*get_data)(const struct iwl_ucode_header *, u32);
133 };
134
135 struct iwl_lib_ops {
136         /* set hw dependent parameters */
137         int (*set_hw_params)(struct iwl_priv *priv);
138         /* Handling TX */
139         void (*txq_update_byte_cnt_tbl)(struct iwl_priv *priv,
140                                         struct iwl_tx_queue *txq,
141                                         u16 byte_cnt);
142         void (*txq_inval_byte_cnt_tbl)(struct iwl_priv *priv,
143                                        struct iwl_tx_queue *txq);
144         void (*txq_set_sched)(struct iwl_priv *priv, u32 mask);
145         int (*txq_attach_buf_to_tfd)(struct iwl_priv *priv,
146                                      struct iwl_tx_queue *txq,
147                                      dma_addr_t addr,
148                                      u16 len, u8 reset, u8 pad);
149         void (*txq_free_tfd)(struct iwl_priv *priv,
150                              struct iwl_tx_queue *txq);
151         int (*txq_init)(struct iwl_priv *priv,
152                         struct iwl_tx_queue *txq);
153         /* aggregations */
154         int (*txq_agg_enable)(struct iwl_priv *priv, int txq_id, int tx_fifo,
155                               int sta_id, int tid, u16 ssn_idx);
156         int (*txq_agg_disable)(struct iwl_priv *priv, u16 txq_id, u16 ssn_idx,
157                                u8 tx_fifo);
158         /* setup Rx handler */
159         void (*rx_handler_setup)(struct iwl_priv *priv);
160         /* setup deferred work */
161         void (*setup_deferred_work)(struct iwl_priv *priv);
162         /* cancel deferred work */
163         void (*cancel_deferred_work)(struct iwl_priv *priv);
164         /* alive notification after init uCode load */
165         void (*init_alive_start)(struct iwl_priv *priv);
166         /* alive notification */
167         int (*alive_notify)(struct iwl_priv *priv);
168         /* check validity of rtc data address */
169         int (*is_valid_rtc_data_addr)(u32 addr);
170         /* 1st ucode load */
171         int (*load_ucode)(struct iwl_priv *priv);
172         int (*dump_nic_event_log)(struct iwl_priv *priv,
173                                   bool full_log, char **buf, bool display);
174         void (*dump_nic_error_log)(struct iwl_priv *priv);
175         void (*dump_csr)(struct iwl_priv *priv);
176         int (*set_channel_switch)(struct iwl_priv *priv, u16 channel);
177         /* power management */
178         struct iwl_apm_ops apm_ops;
179
180         /* power */
181         int (*send_tx_power) (struct iwl_priv *priv);
182         void (*update_chain_flags)(struct iwl_priv *priv);
183         void (*post_associate) (struct iwl_priv *priv);
184         void (*config_ap) (struct iwl_priv *priv);
185         irqreturn_t (*isr) (int irq, void *data);
186
187         /* eeprom operations (as defined in iwl-eeprom.h) */
188         struct iwl_eeprom_ops eeprom_ops;
189
190         /* temperature */
191         struct iwl_temp_ops temp_ops;
192 };
193
194 struct iwl_led_ops {
195         int (*cmd)(struct iwl_priv *priv, struct iwl_led_cmd *led_cmd);
196         int (*on)(struct iwl_priv *priv);
197         int (*off)(struct iwl_priv *priv);
198 };
199
200 struct iwl_ops {
201         const struct iwl_ucode_ops *ucode;
202         const struct iwl_lib_ops *lib;
203         const struct iwl_hcmd_ops *hcmd;
204         const struct iwl_hcmd_utils_ops *utils;
205         const struct iwl_led_ops *led;
206 };
207
208 struct iwl_mod_params {
209         int sw_crypto;          /* def: 0 = using hardware encryption */
210         int disable_hw_scan;    /* def: 0 = use h/w scan */
211         int num_of_queues;      /* def: HW dependent */
212         int disable_11n;        /* def: 0 = 11n capabilities enabled */
213         int amsdu_size_8K;      /* def: 1 = enable 8K amsdu size */
214         int antenna;            /* def: 0 = both antennas (use diversity) */
215         int restart_fw;         /* def: 1 = restart firmware */
216 };
217
218 /**
219  * struct iwl_cfg
220  * @fw_name_pre: Firmware filename prefix. The api version and extension
221  *      (.ucode) will be added to filename before loading from disk. The
222  *      filename is constructed as fw_name_pre<api>.ucode.
223  * @ucode_api_max: Highest version of uCode API supported by driver.
224  * @ucode_api_min: Lowest version of uCode API supported by driver.
225  * @pa_type: used by 6000 series only to identify the type of Power Amplifier
226  * @max_ll_items: max number of OTP blocks
227  * @shadow_ram_support: shadow support for OTP memory
228  * @led_compensation: compensate on the led on/off time per HW according
229  *      to the deviation to achieve the desired led frequency.
230  *      The detail algorithm is described in iwl-led.c
231  * @use_rts_for_ht: use rts/cts protection for HT traffic
232  * @chain_noise_num_beacons: number of beacons used to compute chain noise
233  * @adv_thermal_throttle: support advance thermal throttle
234  * @support_ct_kill_exit: support ct kill exit condition
235  * @sm_ps_mode: spatial multiplexing power save mode
236  * @support_wimax_coexist: support wimax/wifi co-exist
237  *
238  * We enable the driver to be backward compatible wrt API version. The
239  * driver specifies which APIs it supports (with @ucode_api_max being the
240  * highest and @ucode_api_min the lowest). Firmware will only be loaded if
241  * it has a supported API version. The firmware's API version will be
242  * stored in @iwl_priv, enabling the driver to make runtime changes based
243  * on firmware version used.
244  *
245  * For example,
246  * if (IWL_UCODE_API(priv->ucode_ver) >= 2) {
247  *      Driver interacts with Firmware API version >= 2.
248  * } else {
249  *      Driver interacts with Firmware API version 1.
250  * }
251  *
252  * The ideal usage of this infrastructure is to treat a new ucode API
253  * release as a new hardware revision. That is, through utilizing the
254  * iwl_hcmd_utils_ops etc. we accommodate different command structures
255  * and flows between hardware versions (4965/5000) as well as their API
256  * versions.
257  *
258  */
259 struct iwl_cfg {
260         const char *name;
261         const char *fw_name_pre;
262         const unsigned int ucode_api_max;
263         const unsigned int ucode_api_min;
264         unsigned int sku;
265         int eeprom_size;
266         u16  eeprom_ver;
267         u16  eeprom_calib_ver;
268         int num_of_queues;      /* def: HW dependent */
269         int num_of_ampdu_queues;/* def: HW dependent */
270         const struct iwl_ops *ops;
271         const struct iwl_mod_params *mod_params;
272         u8   valid_tx_ant;
273         u8   valid_rx_ant;
274
275         /* for iwl_apm_init() */
276         u32 pll_cfg_val;
277         bool set_l0s;
278         bool use_bsm;
279
280         bool use_isr_legacy;
281         enum iwl_pa_type pa_type;
282         const u16 max_ll_items;
283         const bool shadow_ram_support;
284         const bool ht_greenfield_support;
285         u16 led_compensation;
286         const bool broken_powersave;
287         bool use_rts_for_ht;
288         int chain_noise_num_beacons;
289         const bool supports_idle;
290         bool adv_thermal_throttle;
291         bool support_ct_kill_exit;
292         u8 sm_ps_mode;
293         const bool support_wimax_coexist;
294 };
295
296 /***************************
297  *   L i b                 *
298  ***************************/
299
300 struct ieee80211_hw *iwl_alloc_all(struct iwl_cfg *cfg,
301                 struct ieee80211_ops *hw_ops);
302 void iwl_hw_detect(struct iwl_priv *priv);
303 void iwl_reset_qos(struct iwl_priv *priv);
304 void iwl_activate_qos(struct iwl_priv *priv, u8 force);
305 int iwl_mac_conf_tx(struct ieee80211_hw *hw, u16 queue,
306                     const struct ieee80211_tx_queue_params *params);
307 void iwl_set_rxon_hwcrypto(struct iwl_priv *priv, int hw_decrypt);
308 int iwl_check_rxon_cmd(struct iwl_priv *priv);
309 int iwl_full_rxon_required(struct iwl_priv *priv);
310 void iwl_set_rxon_chain(struct iwl_priv *priv);
311 int iwl_set_rxon_channel(struct iwl_priv *priv, struct ieee80211_channel *ch);
312 void iwl_set_rxon_ht(struct iwl_priv *priv, struct iwl_ht_config *ht_conf);
313 u8 iwl_is_ht40_tx_allowed(struct iwl_priv *priv,
314                          struct ieee80211_sta_ht_cap *sta_ht_inf);
315 void iwl_set_flags_for_band(struct iwl_priv *priv, enum ieee80211_band band);
316 void iwl_connection_init_rx_config(struct iwl_priv *priv, int mode);
317 int iwl_set_decrypted_flag(struct iwl_priv *priv,
318                            struct ieee80211_hdr *hdr,
319                            u32 decrypt_res,
320                            struct ieee80211_rx_status *stats);
321 void iwl_irq_handle_error(struct iwl_priv *priv);
322 void iwl_configure_filter(struct ieee80211_hw *hw,
323                           unsigned int changed_flags,
324                           unsigned int *total_flags, u64 multicast);
325 int iwl_hw_nic_init(struct iwl_priv *priv);
326 int iwl_set_hw_params(struct iwl_priv *priv);
327 bool iwl_is_monitor_mode(struct iwl_priv *priv);
328 void iwl_post_associate(struct iwl_priv *priv);
329 void iwl_bss_info_changed(struct ieee80211_hw *hw,
330                                      struct ieee80211_vif *vif,
331                                      struct ieee80211_bss_conf *bss_conf,
332                                      u32 changes);
333 int iwl_mac_beacon_update(struct ieee80211_hw *hw, struct sk_buff *skb);
334 int iwl_commit_rxon(struct iwl_priv *priv);
335 int iwl_set_mode(struct iwl_priv *priv, int mode);
336 int iwl_mac_add_interface(struct ieee80211_hw *hw,
337                                  struct ieee80211_if_init_conf *conf);
338 void iwl_mac_remove_interface(struct ieee80211_hw *hw,
339                                  struct ieee80211_if_init_conf *conf);
340 int iwl_mac_config(struct ieee80211_hw *hw, u32 changed);
341 void iwl_config_ap(struct iwl_priv *priv);
342 int iwl_mac_get_tx_stats(struct ieee80211_hw *hw,
343                          struct ieee80211_tx_queue_stats *stats);
344 void iwl_mac_reset_tsf(struct ieee80211_hw *hw);
345 int iwl_alloc_txq_mem(struct iwl_priv *priv);
346 void iwl_free_txq_mem(struct iwl_priv *priv);
347 void iwlcore_rts_tx_cmd_flag(struct ieee80211_tx_info *info,
348                                 __le32 *tx_flags);
349 int iwl_send_wimax_coex(struct iwl_priv *priv);
350 #ifdef CONFIG_IWLWIFI_DEBUGFS
351 int iwl_alloc_traffic_mem(struct iwl_priv *priv);
352 void iwl_free_traffic_mem(struct iwl_priv *priv);
353 void iwl_reset_traffic_log(struct iwl_priv *priv);
354 void iwl_dbg_log_tx_data_frame(struct iwl_priv *priv,
355                                 u16 length, struct ieee80211_hdr *header);
356 void iwl_dbg_log_rx_data_frame(struct iwl_priv *priv,
357                                 u16 length, struct ieee80211_hdr *header);
358 const char *get_mgmt_string(int cmd);
359 const char *get_ctrl_string(int cmd);
360 void iwl_clear_traffic_stats(struct iwl_priv *priv);
361 void iwl_update_stats(struct iwl_priv *priv, bool is_tx, __le16 fc,
362                       u16 len);
363 #else
364 static inline int iwl_alloc_traffic_mem(struct iwl_priv *priv)
365 {
366         return 0;
367 }
368 static inline void iwl_free_traffic_mem(struct iwl_priv *priv)
369 {
370 }
371 static inline void iwl_reset_traffic_log(struct iwl_priv *priv)
372 {
373 }
374 static inline void iwl_dbg_log_tx_data_frame(struct iwl_priv *priv,
375                       u16 length, struct ieee80211_hdr *header)
376 {
377 }
378 static inline void iwl_dbg_log_rx_data_frame(struct iwl_priv *priv,
379                       u16 length, struct ieee80211_hdr *header)
380 {
381 }
382 static inline void iwl_update_stats(struct iwl_priv *priv, bool is_tx,
383                                     __le16 fc, u16 len)
384 {
385         struct traffic_stats    *stats;
386
387         if (is_tx)
388                 stats = &priv->tx_stats;
389         else
390                 stats = &priv->rx_stats;
391
392         if (ieee80211_is_data(fc)) {
393                 /* data */
394                 stats->data_bytes += len;
395         }
396         iwl_leds_background(priv);
397 }
398 #endif
399 /*****************************************************
400  * RX handlers.
401  * **************************************************/
402 void iwl_rx_pm_sleep_notif(struct iwl_priv *priv,
403                            struct iwl_rx_mem_buffer *rxb);
404 void iwl_rx_pm_debug_statistics_notif(struct iwl_priv *priv,
405                                       struct iwl_rx_mem_buffer *rxb);
406 void iwl_rx_reply_error(struct iwl_priv *priv,
407                         struct iwl_rx_mem_buffer *rxb);
408
409 /*****************************************************
410 * RX
411 ******************************************************/
412 void iwl_rx_queue_free(struct iwl_priv *priv, struct iwl_rx_queue *rxq);
413 void iwl_cmd_queue_free(struct iwl_priv *priv);
414 int iwl_rx_queue_alloc(struct iwl_priv *priv);
415 void iwl_rx_handle(struct iwl_priv *priv);
416 int iwl_rx_queue_update_write_ptr(struct iwl_priv *priv,
417                                   struct iwl_rx_queue *q);
418 void iwl_rx_queue_reset(struct iwl_priv *priv, struct iwl_rx_queue *rxq);
419 void iwl_rx_replenish(struct iwl_priv *priv);
420 void iwl_rx_replenish_now(struct iwl_priv *priv);
421 int iwl_rx_init(struct iwl_priv *priv, struct iwl_rx_queue *rxq);
422 int iwl_rx_queue_restock(struct iwl_priv *priv);
423 int iwl_rx_queue_space(const struct iwl_rx_queue *q);
424 void iwl_rx_allocate(struct iwl_priv *priv, gfp_t priority);
425 void iwl_tx_cmd_complete(struct iwl_priv *priv, struct iwl_rx_mem_buffer *rxb);
426 int iwl_tx_queue_reclaim(struct iwl_priv *priv, int txq_id, int index);
427 /* Handlers */
428 void iwl_rx_missed_beacon_notif(struct iwl_priv *priv,
429                                struct iwl_rx_mem_buffer *rxb);
430 void iwl_rx_statistics(struct iwl_priv *priv,
431                               struct iwl_rx_mem_buffer *rxb);
432 void iwl_reply_statistics(struct iwl_priv *priv,
433                           struct iwl_rx_mem_buffer *rxb);
434 void iwl_rx_csa(struct iwl_priv *priv, struct iwl_rx_mem_buffer *rxb);
435
436 /* TX helpers */
437
438 /*****************************************************
439 * TX
440 ******************************************************/
441 int iwl_txq_ctx_reset(struct iwl_priv *priv);
442 void iwl_hw_txq_free_tfd(struct iwl_priv *priv, struct iwl_tx_queue *txq);
443 int iwl_hw_txq_attach_buf_to_tfd(struct iwl_priv *priv,
444                                  struct iwl_tx_queue *txq,
445                                  dma_addr_t addr, u16 len, u8 reset, u8 pad);
446 int iwl_tx_skb(struct iwl_priv *priv, struct sk_buff *skb);
447 void iwl_hw_txq_ctx_free(struct iwl_priv *priv);
448 int iwl_hw_tx_queue_init(struct iwl_priv *priv,
449                          struct iwl_tx_queue *txq);
450 int iwl_txq_update_write_ptr(struct iwl_priv *priv, struct iwl_tx_queue *txq);
451 int iwl_tx_queue_init(struct iwl_priv *priv, struct iwl_tx_queue *txq,
452                       int slots_num, u32 txq_id);
453 void iwl_tx_queue_free(struct iwl_priv *priv, int txq_id);
454 int iwl_tx_agg_start(struct iwl_priv *priv, const u8 *ra, u16 tid, u16 *ssn);
455 int iwl_tx_agg_stop(struct iwl_priv *priv , const u8 *ra, u16 tid);
456 int iwl_txq_check_empty(struct iwl_priv *priv, int sta_id, u8 tid, int txq_id);
457 /*****************************************************
458  * TX power
459  ****************************************************/
460 int iwl_set_tx_power(struct iwl_priv *priv, s8 tx_power, bool force);
461
462 /*******************************************************************************
463  * Rate
464  ******************************************************************************/
465
466 void iwl_hwrate_to_tx_control(struct iwl_priv *priv, u32 rate_n_flags,
467                               struct ieee80211_tx_info *info);
468 int iwl_hwrate_to_plcp_idx(u32 rate_n_flags);
469 int iwl_hwrate_to_mac80211_idx(u32 rate_n_flags, enum ieee80211_band band);
470
471 u8 iwl_rate_get_lowest_plcp(struct iwl_priv *priv);
472
473 u8 iwl_toggle_tx_ant(struct iwl_priv *priv, u8 ant_idx);
474
475 static inline u32 iwl_ant_idx_to_flags(u8 ant_idx)
476 {
477         return BIT(ant_idx) << RATE_MCS_ANT_POS;
478 }
479
480 static inline u8 iwl_hw_get_rate(__le32 rate_n_flags)
481 {
482         return le32_to_cpu(rate_n_flags) & 0xFF;
483 }
484 static inline u32 iwl_hw_get_rate_n_flags(__le32 rate_n_flags)
485 {
486         return le32_to_cpu(rate_n_flags) & 0x1FFFF;
487 }
488 static inline __le32 iwl_hw_set_rate_n_flags(u8 rate, u32 flags)
489 {
490         return cpu_to_le32(flags|(u32)rate);
491 }
492
493 /*******************************************************************************
494  * Scanning
495  ******************************************************************************/
496 void iwl_init_scan_params(struct iwl_priv *priv);
497 int iwl_scan_cancel(struct iwl_priv *priv);
498 int iwl_scan_cancel_timeout(struct iwl_priv *priv, unsigned long ms);
499 int iwl_mac_hw_scan(struct ieee80211_hw *hw, struct cfg80211_scan_request *req);
500 u16 iwl_fill_probe_req(struct iwl_priv *priv, struct ieee80211_mgmt *frame,
501                        const u8 *ie, int ie_len, int left);
502 void iwl_setup_rx_scan_handlers(struct iwl_priv *priv);
503 u16 iwl_get_active_dwell_time(struct iwl_priv *priv,
504                               enum ieee80211_band band,
505                               u8 n_probes);
506 u16 iwl_get_passive_dwell_time(struct iwl_priv *priv,
507                                enum ieee80211_band band);
508 void iwl_bg_scan_check(struct work_struct *data);
509 void iwl_bg_abort_scan(struct work_struct *work);
510 void iwl_bg_scan_completed(struct work_struct *work);
511 void iwl_setup_scan_deferred_work(struct iwl_priv *priv);
512
513 /* For faster active scanning, scan will move to the next channel if fewer than
514  * PLCP_QUIET_THRESH packets are heard on this channel within
515  * ACTIVE_QUIET_TIME after sending probe request.  This shortens the dwell
516  * time if it's a quiet channel (nothing responded to our probe, and there's
517  * no other traffic).
518  * Disable "quiet" feature by setting PLCP_QUIET_THRESH to 0. */
519 #define IWL_ACTIVE_QUIET_TIME       cpu_to_le16(10)  /* msec */
520 #define IWL_PLCP_QUIET_THRESH       cpu_to_le16(1)  /* packets */
521
522
523 /*******************************************************************************
524  * Calibrations - implemented in iwl-calib.c
525  ******************************************************************************/
526 int iwl_send_calib_results(struct iwl_priv *priv);
527 int iwl_calib_set(struct iwl_calib_result *res, const u8 *buf, int len);
528 void iwl_calib_free_results(struct iwl_priv *priv);
529
530 /*******************************************************************************
531  * Spectrum Measureemtns in  iwl-spectrum.c
532  ******************************************************************************/
533 #ifdef CONFIG_IWLWIFI_SPECTRUM_MEASUREMENT
534 void iwl_setup_spectrum_handlers(struct iwl_priv *priv);
535 #else
536 static inline void iwl_setup_spectrum_handlers(struct iwl_priv *priv) {}
537 #endif
538 /*****************************************************
539  *   S e n d i n g     H o s t     C o m m a n d s   *
540  *****************************************************/
541
542 const char *get_cmd_string(u8 cmd);
543 int __must_check iwl_send_cmd_sync(struct iwl_priv *priv,
544                                    struct iwl_host_cmd *cmd);
545 int iwl_send_cmd(struct iwl_priv *priv, struct iwl_host_cmd *cmd);
546 int __must_check iwl_send_cmd_pdu(struct iwl_priv *priv, u8 id,
547                                   u16 len, const void *data);
548 int iwl_send_cmd_pdu_async(struct iwl_priv *priv, u8 id, u16 len,
549                            const void *data,
550                            void (*callback)(struct iwl_priv *priv,
551                                             struct iwl_device_cmd *cmd,
552                                             struct iwl_rx_packet *pkt));
553
554 int iwl_enqueue_hcmd(struct iwl_priv *priv, struct iwl_host_cmd *cmd);
555
556 int iwl_send_card_state(struct iwl_priv *priv, u32 flags,
557                         u8 meta_flag);
558
559 /*****************************************************
560  * PCI                                               *
561  *****************************************************/
562 irqreturn_t iwl_isr_legacy(int irq, void *data);
563 int iwl_reset_ict(struct iwl_priv *priv);
564 void iwl_disable_ict(struct iwl_priv *priv);
565 int iwl_alloc_isr_ict(struct iwl_priv *priv);
566 void iwl_free_isr_ict(struct iwl_priv *priv);
567 irqreturn_t iwl_isr_ict(int irq, void *data);
568
569 static inline u16 iwl_pcie_link_ctl(struct iwl_priv *priv)
570 {
571         int pos;
572         u16 pci_lnk_ctl;
573         pos = pci_find_capability(priv->pci_dev, PCI_CAP_ID_EXP);
574         pci_read_config_word(priv->pci_dev, pos + PCI_EXP_LNKCTL, &pci_lnk_ctl);
575         return pci_lnk_ctl;
576 }
577 #ifdef CONFIG_PM
578 int iwl_pci_suspend(struct pci_dev *pdev, pm_message_t state);
579 int iwl_pci_resume(struct pci_dev *pdev);
580 #endif /* CONFIG_PM */
581
582 /*****************************************************
583 *  Error Handling Debugging
584 ******************************************************/
585 void iwl_dump_nic_error_log(struct iwl_priv *priv);
586 int iwl_dump_nic_event_log(struct iwl_priv *priv,
587                            bool full_log, char **buf, bool display);
588 void iwl_dump_csr(struct iwl_priv *priv);
589 #ifdef CONFIG_IWLWIFI_DEBUG
590 void iwl_print_rx_config_cmd(struct iwl_priv *priv);
591 #else
592 static inline void iwl_print_rx_config_cmd(struct iwl_priv *priv)
593 {
594 }
595 #endif
596
597 void iwl_clear_isr_stats(struct iwl_priv *priv);
598
599 /*****************************************************
600 *  GEOS
601 ******************************************************/
602 int iwlcore_init_geos(struct iwl_priv *priv);
603 void iwlcore_free_geos(struct iwl_priv *priv);
604
605 /*************** DRIVER STATUS FUNCTIONS   *****/
606
607 #define STATUS_HCMD_ACTIVE      0       /* host command in progress */
608 #define STATUS_HCMD_SYNC_ACTIVE 1       /* sync host command in progress */
609 #define STATUS_INT_ENABLED      2
610 #define STATUS_RF_KILL_HW       3
611 #define STATUS_CT_KILL          4
612 #define STATUS_INIT             5
613 #define STATUS_ALIVE            6
614 #define STATUS_READY            7
615 #define STATUS_TEMPERATURE      8
616 #define STATUS_GEO_CONFIGURED   9
617 #define STATUS_EXIT_PENDING     10
618 #define STATUS_STATISTICS       12
619 #define STATUS_SCANNING         13
620 #define STATUS_SCAN_ABORTING    14
621 #define STATUS_SCAN_HW          15
622 #define STATUS_POWER_PMI        16
623 #define STATUS_FW_ERROR         17
624 #define STATUS_MODE_PENDING     18
625
626
627 static inline int iwl_is_ready(struct iwl_priv *priv)
628 {
629         /* The adapter is 'ready' if READY and GEO_CONFIGURED bits are
630          * set but EXIT_PENDING is not */
631         return test_bit(STATUS_READY, &priv->status) &&
632                test_bit(STATUS_GEO_CONFIGURED, &priv->status) &&
633                !test_bit(STATUS_EXIT_PENDING, &priv->status);
634 }
635
636 static inline int iwl_is_alive(struct iwl_priv *priv)
637 {
638         return test_bit(STATUS_ALIVE, &priv->status);
639 }
640
641 static inline int iwl_is_init(struct iwl_priv *priv)
642 {
643         return test_bit(STATUS_INIT, &priv->status);
644 }
645
646 static inline int iwl_is_rfkill_hw(struct iwl_priv *priv)
647 {
648         return test_bit(STATUS_RF_KILL_HW, &priv->status);
649 }
650
651 static inline int iwl_is_rfkill(struct iwl_priv *priv)
652 {
653         return iwl_is_rfkill_hw(priv);
654 }
655
656 static inline int iwl_is_ctkill(struct iwl_priv *priv)
657 {
658         return test_bit(STATUS_CT_KILL, &priv->status);
659 }
660
661 static inline int iwl_is_ready_rf(struct iwl_priv *priv)
662 {
663
664         if (iwl_is_rfkill(priv))
665                 return 0;
666
667         return iwl_is_ready(priv);
668 }
669
670 extern void iwl_rf_kill_ct_config(struct iwl_priv *priv);
671 extern int iwl_send_bt_config(struct iwl_priv *priv);
672 extern int iwl_send_statistics_request(struct iwl_priv *priv,
673                                        u8 flags, bool clear);
674 extern int iwl_verify_ucode(struct iwl_priv *priv);
675 extern int iwl_send_lq_cmd(struct iwl_priv *priv,
676                 struct iwl_link_quality_cmd *lq, u8 flags);
677 extern void iwl_rx_reply_rx(struct iwl_priv *priv,
678                 struct iwl_rx_mem_buffer *rxb);
679 extern void iwl_rx_reply_rx_phy(struct iwl_priv *priv,
680                                     struct iwl_rx_mem_buffer *rxb);
681 void iwl_rx_reply_compressed_ba(struct iwl_priv *priv,
682                                            struct iwl_rx_mem_buffer *rxb);
683 void iwl_apm_stop(struct iwl_priv *priv);
684 int iwl_apm_stop_master(struct iwl_priv *priv);
685 int iwl_apm_init(struct iwl_priv *priv);
686
687 void iwl_setup_rxon_timing(struct iwl_priv *priv);
688 static inline int iwl_send_rxon_assoc(struct iwl_priv *priv)
689 {
690         return priv->cfg->ops->hcmd->rxon_assoc(priv);
691 }
692 static inline int iwlcore_commit_rxon(struct iwl_priv *priv)
693 {
694         return priv->cfg->ops->hcmd->commit_rxon(priv);
695 }
696 static inline void iwlcore_config_ap(struct iwl_priv *priv)
697 {
698         priv->cfg->ops->lib->config_ap(priv);
699 }
700 static inline const struct ieee80211_supported_band *iwl_get_hw_mode(
701                         struct iwl_priv *priv, enum ieee80211_band band)
702 {
703         return priv->hw->wiphy->bands[band];
704 }
705 #endif /* __iwl_core_h__ */