iwl-core.h 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723
  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 - 2011 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 - 2011 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. #ifndef __iwl_core_h__
  63. #define __iwl_core_h__
  64. #include "iwl-dev.h"
  65. /************************
  66. * forward declarations *
  67. ************************/
  68. struct iwl_host_cmd;
  69. struct iwl_cmd;
  70. #define IWLWIFI_VERSION "in-tree:"
  71. #define DRV_COPYRIGHT "Copyright(c) 2003-2011 Intel Corporation"
  72. #define DRV_AUTHOR "<ilw@linux.intel.com>"
  73. #define IWL_PCI_DEVICE(dev, subdev, cfg) \
  74. .vendor = PCI_VENDOR_ID_INTEL, .device = (dev), \
  75. .subvendor = PCI_ANY_ID, .subdevice = (subdev), \
  76. .driver_data = (kernel_ulong_t)&(cfg)
  77. #define TIME_UNIT 1024
  78. #define IWL_SKU_G 0x1
  79. #define IWL_SKU_A 0x2
  80. #define IWL_SKU_N 0x8
  81. #define IWL_CMD(x) case x: return #x
  82. struct iwl_hcmd_ops {
  83. int (*rxon_assoc)(struct iwl_priv *priv, struct iwl_rxon_context *ctx);
  84. int (*commit_rxon)(struct iwl_priv *priv, struct iwl_rxon_context *ctx);
  85. void (*set_rxon_chain)(struct iwl_priv *priv,
  86. struct iwl_rxon_context *ctx);
  87. int (*set_tx_ant)(struct iwl_priv *priv, u8 valid_tx_ant);
  88. void (*send_bt_config)(struct iwl_priv *priv);
  89. int (*set_pan_params)(struct iwl_priv *priv);
  90. };
  91. struct iwl_hcmd_utils_ops {
  92. u16 (*get_hcmd_size)(u8 cmd_id, u16 len);
  93. u16 (*build_addsta_hcmd)(const struct iwl_addsta_cmd *cmd, u8 *data);
  94. void (*gain_computation)(struct iwl_priv *priv,
  95. u32 *average_noise,
  96. u16 min_average_noise_antennat_i,
  97. u32 min_average_noise,
  98. u8 default_chain);
  99. void (*chain_noise_reset)(struct iwl_priv *priv);
  100. void (*tx_cmd_protection)(struct iwl_priv *priv,
  101. struct ieee80211_tx_info *info,
  102. __le16 fc, __le32 *tx_flags);
  103. int (*calc_rssi)(struct iwl_priv *priv,
  104. struct iwl_rx_phy_res *rx_resp);
  105. int (*request_scan)(struct iwl_priv *priv, struct ieee80211_vif *vif);
  106. void (*post_scan)(struct iwl_priv *priv);
  107. };
  108. struct iwl_apm_ops {
  109. int (*init)(struct iwl_priv *priv);
  110. void (*config)(struct iwl_priv *priv);
  111. };
  112. struct iwl_debugfs_ops {
  113. ssize_t (*rx_stats_read)(struct file *file, char __user *user_buf,
  114. size_t count, loff_t *ppos);
  115. ssize_t (*tx_stats_read)(struct file *file, char __user *user_buf,
  116. size_t count, loff_t *ppos);
  117. ssize_t (*general_stats_read)(struct file *file, char __user *user_buf,
  118. size_t count, loff_t *ppos);
  119. ssize_t (*bt_stats_read)(struct file *file, char __user *user_buf,
  120. size_t count, loff_t *ppos);
  121. ssize_t (*reply_tx_error)(struct file *file, char __user *user_buf,
  122. size_t count, loff_t *ppos);
  123. };
  124. struct iwl_temp_ops {
  125. void (*temperature)(struct iwl_priv *priv);
  126. };
  127. struct iwl_tt_ops {
  128. bool (*lower_power_detection)(struct iwl_priv *priv);
  129. u8 (*tt_power_mode)(struct iwl_priv *priv);
  130. bool (*ct_kill_check)(struct iwl_priv *priv);
  131. };
  132. struct iwl_lib_ops {
  133. /* set hw dependent parameters */
  134. int (*set_hw_params)(struct iwl_priv *priv);
  135. /* Handling TX */
  136. void (*txq_update_byte_cnt_tbl)(struct iwl_priv *priv,
  137. struct iwl_tx_queue *txq,
  138. u16 byte_cnt);
  139. void (*txq_inval_byte_cnt_tbl)(struct iwl_priv *priv,
  140. struct iwl_tx_queue *txq);
  141. void (*txq_set_sched)(struct iwl_priv *priv, u32 mask);
  142. int (*txq_attach_buf_to_tfd)(struct iwl_priv *priv,
  143. struct iwl_tx_queue *txq,
  144. dma_addr_t addr,
  145. u16 len, u8 reset, u8 pad);
  146. void (*txq_free_tfd)(struct iwl_priv *priv,
  147. struct iwl_tx_queue *txq);
  148. int (*txq_init)(struct iwl_priv *priv,
  149. struct iwl_tx_queue *txq);
  150. /* setup Rx handler */
  151. void (*rx_handler_setup)(struct iwl_priv *priv);
  152. /* setup deferred work */
  153. void (*setup_deferred_work)(struct iwl_priv *priv);
  154. /* cancel deferred work */
  155. void (*cancel_deferred_work)(struct iwl_priv *priv);
  156. /* check validity of rtc data address */
  157. int (*is_valid_rtc_data_addr)(u32 addr);
  158. int (*dump_nic_event_log)(struct iwl_priv *priv,
  159. bool full_log, char **buf, bool display);
  160. void (*dump_nic_error_log)(struct iwl_priv *priv);
  161. void (*dump_csr)(struct iwl_priv *priv);
  162. int (*dump_fh)(struct iwl_priv *priv, char **buf, bool display);
  163. int (*set_channel_switch)(struct iwl_priv *priv,
  164. struct ieee80211_channel_switch *ch_switch);
  165. /* power management */
  166. struct iwl_apm_ops apm_ops;
  167. /* power */
  168. int (*send_tx_power) (struct iwl_priv *priv);
  169. void (*update_chain_flags)(struct iwl_priv *priv);
  170. /* eeprom operations (as defined in iwl-eeprom.h) */
  171. struct iwl_eeprom_ops eeprom_ops;
  172. /* temperature */
  173. struct iwl_temp_ops temp_ops;
  174. int (*txfifo_flush)(struct iwl_priv *priv, u16 flush_control);
  175. void (*dev_txfifo_flush)(struct iwl_priv *priv, u16 flush_control);
  176. struct iwl_debugfs_ops debugfs_ops;
  177. /* thermal throttling */
  178. struct iwl_tt_ops tt_ops;
  179. };
  180. struct iwl_led_ops {
  181. int (*cmd)(struct iwl_priv *priv, struct iwl_led_cmd *led_cmd);
  182. };
  183. /* NIC specific ops */
  184. struct iwl_nic_ops {
  185. void (*additional_nic_config)(struct iwl_priv *priv);
  186. };
  187. struct iwl_legacy_ops {
  188. void (*post_associate)(struct iwl_priv *priv);
  189. void (*config_ap)(struct iwl_priv *priv);
  190. /* station management */
  191. int (*update_bcast_stations)(struct iwl_priv *priv);
  192. int (*manage_ibss_station)(struct iwl_priv *priv,
  193. struct ieee80211_vif *vif, bool add);
  194. };
  195. struct iwl_ops {
  196. const struct iwl_lib_ops *lib;
  197. const struct iwl_hcmd_ops *hcmd;
  198. const struct iwl_hcmd_utils_ops *utils;
  199. const struct iwl_led_ops *led;
  200. const struct iwl_nic_ops *nic;
  201. const struct iwl_legacy_ops *legacy;
  202. const struct ieee80211_ops *ieee80211_ops;
  203. };
  204. struct iwl_mod_params {
  205. int sw_crypto; /* def: 0 = using hardware encryption */
  206. int num_of_queues; /* def: HW dependent */
  207. int disable_11n; /* def: 0 = 11n capabilities enabled */
  208. int amsdu_size_8K; /* def: 1 = enable 8K amsdu size */
  209. int antenna; /* def: 0 = both antennas (use diversity) */
  210. int restart_fw; /* def: 1 = restart firmware */
  211. bool plcp_check; /* def: true = enable plcp health check */
  212. bool ack_check; /* def: false = disable ack health check */
  213. };
  214. /*
  215. * @max_ll_items: max number of OTP blocks
  216. * @shadow_ram_support: shadow support for OTP memory
  217. * @led_compensation: compensate on the led on/off time per HW according
  218. * to the deviation to achieve the desired led frequency.
  219. * The detail algorithm is described in iwl-led.c
  220. * @chain_noise_num_beacons: number of beacons used to compute chain noise
  221. * @adv_thermal_throttle: support advance thermal throttle
  222. * @support_ct_kill_exit: support ct kill exit condition
  223. * @support_wimax_coexist: support wimax/wifi co-exist
  224. * @plcp_delta_threshold: plcp error rate threshold used to trigger
  225. * radio tuning when there is a high receiving plcp error rate
  226. * @chain_noise_scale: default chain noise scale used for gain computation
  227. * @wd_timeout: TX queues watchdog timeout
  228. * @temperature_kelvin: temperature report by uCode in kelvin
  229. * @max_event_log_size: size of event log buffer size for ucode event logging
  230. * @tx_power_by_driver: tx power calibration performed by driver
  231. * instead of uCode
  232. * @ucode_tracing: support ucode continuous tracing
  233. * @sensitivity_calib_by_driver: driver has the capability to perform
  234. * sensitivity calibration operation
  235. * @chain_noise_calib_by_driver: driver has the capability to perform
  236. * chain noise calibration operation
  237. * @shadow_reg_enable: HW shadhow register bit
  238. */
  239. struct iwl_base_params {
  240. int eeprom_size;
  241. int num_of_queues; /* def: HW dependent */
  242. int num_of_ampdu_queues;/* def: HW dependent */
  243. /* for iwl_apm_init() */
  244. u32 pll_cfg_val;
  245. bool set_l0s;
  246. const u16 max_ll_items;
  247. const bool shadow_ram_support;
  248. u16 led_compensation;
  249. const bool broken_powersave;
  250. int chain_noise_num_beacons;
  251. bool adv_thermal_throttle;
  252. bool support_ct_kill_exit;
  253. const bool support_wimax_coexist;
  254. u8 plcp_delta_threshold;
  255. s32 chain_noise_scale;
  256. unsigned int wd_timeout;
  257. bool temperature_kelvin;
  258. u32 max_event_log_size;
  259. const bool tx_power_by_driver;
  260. const bool ucode_tracing;
  261. const bool sensitivity_calib_by_driver;
  262. const bool chain_noise_calib_by_driver;
  263. const bool shadow_reg_enable;
  264. };
  265. /*
  266. * @advanced_bt_coexist: support advanced bt coexist
  267. * @bt_init_traffic_load: specify initial bt traffic load
  268. * @bt_prio_boost: default bt priority boost value
  269. * @bt_statistics: use BT version of statistics notification
  270. * @agg_time_limit: maximum number of uSec in aggregation
  271. * @ampdu_factor: Maximum A-MPDU length factor
  272. * @ampdu_density: Minimum A-MPDU spacing
  273. * @bt_sco_disable: uCode should not response to BT in SCO/ESCO mode
  274. */
  275. struct iwl_bt_params {
  276. bool advanced_bt_coexist;
  277. u8 bt_init_traffic_load;
  278. u8 bt_prio_boost;
  279. const bool bt_statistics;
  280. u16 agg_time_limit;
  281. u8 ampdu_factor;
  282. u8 ampdu_density;
  283. bool bt_sco_disable;
  284. bool bt_session_2;
  285. };
  286. /*
  287. * @use_rts_for_aggregation: use rts/cts protection for HT traffic
  288. */
  289. struct iwl_ht_params {
  290. const bool ht_greenfield_support; /* if used set to true */
  291. bool use_rts_for_aggregation;
  292. };
  293. /**
  294. * struct iwl_cfg
  295. * @fw_name_pre: Firmware filename prefix. The api version and extension
  296. * (.ucode) will be added to filename before loading from disk. The
  297. * filename is constructed as fw_name_pre<api>.ucode.
  298. * @ucode_api_max: Highest version of uCode API supported by driver.
  299. * @ucode_api_min: Lowest version of uCode API supported by driver.
  300. * @pa_type: used by 6000 series only to identify the type of Power Amplifier
  301. * @need_dc_calib: need to perform init dc calibration
  302. * @need_temp_offset_calib: need to perform temperature offset calibration
  303. * @scan_antennas: available antenna for scan operation
  304. * @led_mode: 0=blinking, 1=On(RF On)/Off(RF Off)
  305. * @adv_pm: advance power management
  306. * @rx_with_siso_diversity: 1x1 device with rx antenna diversity
  307. * @internal_wimax_coex: internal wifi/wimax combo device
  308. * @iq_invert: I/Q inversion
  309. *
  310. * We enable the driver to be backward compatible wrt API version. The
  311. * driver specifies which APIs it supports (with @ucode_api_max being the
  312. * highest and @ucode_api_min the lowest). Firmware will only be loaded if
  313. * it has a supported API version. The firmware's API version will be
  314. * stored in @iwl_priv, enabling the driver to make runtime changes based
  315. * on firmware version used.
  316. *
  317. * For example,
  318. * if (IWL_UCODE_API(priv->ucode_ver) >= 2) {
  319. * Driver interacts with Firmware API version >= 2.
  320. * } else {
  321. * Driver interacts with Firmware API version 1.
  322. * }
  323. *
  324. * The ideal usage of this infrastructure is to treat a new ucode API
  325. * release as a new hardware revision. That is, through utilizing the
  326. * iwl_hcmd_utils_ops etc. we accommodate different command structures
  327. * and flows between hardware versions (4965/5000) as well as their API
  328. * versions.
  329. *
  330. */
  331. struct iwl_cfg {
  332. /* params specific to an individual device within a device family */
  333. const char *name;
  334. const char *fw_name_pre;
  335. const unsigned int ucode_api_max;
  336. const unsigned int ucode_api_min;
  337. u8 valid_tx_ant;
  338. u8 valid_rx_ant;
  339. unsigned int sku;
  340. u16 eeprom_ver;
  341. u16 eeprom_calib_ver;
  342. const struct iwl_ops *ops;
  343. /* module based parameters which can be set from modprobe cmd */
  344. const struct iwl_mod_params *mod_params;
  345. /* params not likely to change within a device family */
  346. struct iwl_base_params *base_params;
  347. /* params likely to change within a device family */
  348. struct iwl_ht_params *ht_params;
  349. struct iwl_bt_params *bt_params;
  350. enum iwl_pa_type pa_type; /* if used set to IWL_PA_SYSTEM */
  351. const bool need_dc_calib; /* if used set to true */
  352. const bool need_temp_offset_calib; /* if used set to true */
  353. u8 scan_rx_antennas[IEEE80211_NUM_BANDS];
  354. enum iwl_led_mode led_mode;
  355. const bool adv_pm;
  356. const bool rx_with_siso_diversity;
  357. const bool internal_wimax_coex;
  358. const bool iq_invert;
  359. };
  360. /***************************
  361. * L i b *
  362. ***************************/
  363. struct ieee80211_hw *iwl_alloc_all(struct iwl_cfg *cfg);
  364. int iwl_mac_conf_tx(struct ieee80211_hw *hw, u16 queue,
  365. const struct ieee80211_tx_queue_params *params);
  366. int iwl_mac_tx_last_beacon(struct ieee80211_hw *hw);
  367. void iwl_set_rxon_hwcrypto(struct iwl_priv *priv, struct iwl_rxon_context *ctx,
  368. int hw_decrypt);
  369. int iwl_check_rxon_cmd(struct iwl_priv *priv, struct iwl_rxon_context *ctx);
  370. int iwl_full_rxon_required(struct iwl_priv *priv, struct iwl_rxon_context *ctx);
  371. int iwl_set_rxon_channel(struct iwl_priv *priv, struct ieee80211_channel *ch,
  372. struct iwl_rxon_context *ctx);
  373. void iwl_set_flags_for_band(struct iwl_priv *priv,
  374. struct iwl_rxon_context *ctx,
  375. enum ieee80211_band band,
  376. struct ieee80211_vif *vif);
  377. u8 iwl_get_single_channel_number(struct iwl_priv *priv,
  378. enum ieee80211_band band);
  379. void iwl_set_rxon_ht(struct iwl_priv *priv, struct iwl_ht_config *ht_conf);
  380. bool iwl_is_ht40_tx_allowed(struct iwl_priv *priv,
  381. struct iwl_rxon_context *ctx,
  382. struct ieee80211_sta_ht_cap *ht_cap);
  383. void iwl_connection_init_rx_config(struct iwl_priv *priv,
  384. struct iwl_rxon_context *ctx);
  385. void iwl_set_rate(struct iwl_priv *priv);
  386. void iwl_irq_handle_error(struct iwl_priv *priv);
  387. int iwl_mac_add_interface(struct ieee80211_hw *hw,
  388. struct ieee80211_vif *vif);
  389. void iwl_mac_remove_interface(struct ieee80211_hw *hw,
  390. struct ieee80211_vif *vif);
  391. int iwl_mac_change_interface(struct ieee80211_hw *hw,
  392. struct ieee80211_vif *vif,
  393. enum nl80211_iftype newtype, bool newp2p);
  394. int iwl_alloc_txq_mem(struct iwl_priv *priv);
  395. void iwl_free_txq_mem(struct iwl_priv *priv);
  396. #ifdef CONFIG_IWLWIFI_DEBUGFS
  397. int iwl_alloc_traffic_mem(struct iwl_priv *priv);
  398. void iwl_free_traffic_mem(struct iwl_priv *priv);
  399. void iwl_reset_traffic_log(struct iwl_priv *priv);
  400. void iwl_dbg_log_tx_data_frame(struct iwl_priv *priv,
  401. u16 length, struct ieee80211_hdr *header);
  402. void iwl_dbg_log_rx_data_frame(struct iwl_priv *priv,
  403. u16 length, struct ieee80211_hdr *header);
  404. const char *get_mgmt_string(int cmd);
  405. const char *get_ctrl_string(int cmd);
  406. void iwl_clear_traffic_stats(struct iwl_priv *priv);
  407. void iwl_update_stats(struct iwl_priv *priv, bool is_tx, __le16 fc,
  408. u16 len);
  409. #else
  410. static inline int iwl_alloc_traffic_mem(struct iwl_priv *priv)
  411. {
  412. return 0;
  413. }
  414. static inline void iwl_free_traffic_mem(struct iwl_priv *priv)
  415. {
  416. }
  417. static inline void iwl_reset_traffic_log(struct iwl_priv *priv)
  418. {
  419. }
  420. static inline void iwl_dbg_log_tx_data_frame(struct iwl_priv *priv,
  421. u16 length, struct ieee80211_hdr *header)
  422. {
  423. }
  424. static inline void iwl_dbg_log_rx_data_frame(struct iwl_priv *priv,
  425. u16 length, struct ieee80211_hdr *header)
  426. {
  427. }
  428. static inline void iwl_update_stats(struct iwl_priv *priv, bool is_tx,
  429. __le16 fc, u16 len)
  430. {
  431. }
  432. #endif
  433. /*****************************************************
  434. * RX
  435. ******************************************************/
  436. void iwl_cmd_queue_free(struct iwl_priv *priv);
  437. void iwl_cmd_queue_unmap(struct iwl_priv *priv);
  438. int iwl_rx_queue_alloc(struct iwl_priv *priv);
  439. void iwl_rx_queue_update_write_ptr(struct iwl_priv *priv,
  440. struct iwl_rx_queue *q);
  441. int iwl_rx_queue_space(const struct iwl_rx_queue *q);
  442. void iwl_tx_cmd_complete(struct iwl_priv *priv, struct iwl_rx_mem_buffer *rxb);
  443. void iwl_chswitch_done(struct iwl_priv *priv, bool is_success);
  444. /* TX helpers */
  445. /*****************************************************
  446. * TX
  447. ******************************************************/
  448. void iwl_txq_update_write_ptr(struct iwl_priv *priv, struct iwl_tx_queue *txq);
  449. int iwl_tx_queue_init(struct iwl_priv *priv, struct iwl_tx_queue *txq,
  450. int slots_num, u32 txq_id);
  451. void iwl_tx_queue_reset(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. void iwl_tx_queue_unmap(struct iwl_priv *priv, int txq_id);
  455. void iwl_setup_watchdog(struct iwl_priv *priv);
  456. /*****************************************************
  457. * TX power
  458. ****************************************************/
  459. int iwl_set_tx_power(struct iwl_priv *priv, s8 tx_power, bool force);
  460. /*******************************************************************************
  461. * Rate
  462. ******************************************************************************/
  463. u8 iwl_rate_get_lowest_plcp(struct iwl_priv *priv,
  464. struct iwl_rxon_context *ctx);
  465. /*******************************************************************************
  466. * Scanning
  467. ******************************************************************************/
  468. void iwl_init_scan_params(struct iwl_priv *priv);
  469. int iwl_scan_cancel(struct iwl_priv *priv);
  470. int iwl_scan_cancel_timeout(struct iwl_priv *priv, unsigned long ms);
  471. void iwl_force_scan_end(struct iwl_priv *priv);
  472. int iwl_mac_hw_scan(struct ieee80211_hw *hw,
  473. struct ieee80211_vif *vif,
  474. struct cfg80211_scan_request *req);
  475. void iwl_internal_short_hw_scan(struct iwl_priv *priv);
  476. int iwl_force_reset(struct iwl_priv *priv, int mode, bool external);
  477. u16 iwl_fill_probe_req(struct iwl_priv *priv, struct ieee80211_mgmt *frame,
  478. const u8 *ta, const u8 *ie, int ie_len, int left);
  479. void iwl_setup_rx_scan_handlers(struct iwl_priv *priv);
  480. u16 iwl_get_active_dwell_time(struct iwl_priv *priv,
  481. enum ieee80211_band band,
  482. u8 n_probes);
  483. u16 iwl_get_passive_dwell_time(struct iwl_priv *priv,
  484. enum ieee80211_band band,
  485. struct ieee80211_vif *vif);
  486. void iwl_setup_scan_deferred_work(struct iwl_priv *priv);
  487. void iwl_cancel_scan_deferred_work(struct iwl_priv *priv);
  488. int __must_check iwl_scan_initiate(struct iwl_priv *priv,
  489. struct ieee80211_vif *vif,
  490. enum iwl_scan_type scan_type,
  491. enum ieee80211_band band);
  492. /* For faster active scanning, scan will move to the next channel if fewer than
  493. * PLCP_QUIET_THRESH packets are heard on this channel within
  494. * ACTIVE_QUIET_TIME after sending probe request. This shortens the dwell
  495. * time if it's a quiet channel (nothing responded to our probe, and there's
  496. * no other traffic).
  497. * Disable "quiet" feature by setting PLCP_QUIET_THRESH to 0. */
  498. #define IWL_ACTIVE_QUIET_TIME cpu_to_le16(10) /* msec */
  499. #define IWL_PLCP_QUIET_THRESH cpu_to_le16(1) /* packets */
  500. #define IWL_SCAN_CHECK_WATCHDOG (HZ * 7)
  501. /*****************************************************
  502. * S e n d i n g H o s t C o m m a n d s *
  503. *****************************************************/
  504. const char *get_cmd_string(u8 cmd);
  505. int __must_check iwl_send_cmd_sync(struct iwl_priv *priv,
  506. struct iwl_host_cmd *cmd);
  507. int iwl_send_cmd(struct iwl_priv *priv, struct iwl_host_cmd *cmd);
  508. int __must_check iwl_send_cmd_pdu(struct iwl_priv *priv, u8 id,
  509. u16 len, const void *data);
  510. int iwl_send_cmd_pdu_async(struct iwl_priv *priv, u8 id, u16 len,
  511. const void *data,
  512. void (*callback)(struct iwl_priv *priv,
  513. struct iwl_device_cmd *cmd,
  514. struct iwl_rx_packet *pkt));
  515. int iwl_enqueue_hcmd(struct iwl_priv *priv, struct iwl_host_cmd *cmd);
  516. /*****************************************************
  517. * PCI *
  518. *****************************************************/
  519. static inline u16 iwl_pcie_link_ctl(struct iwl_priv *priv)
  520. {
  521. int pos;
  522. u16 pci_lnk_ctl;
  523. pos = pci_find_capability(priv->pci_dev, PCI_CAP_ID_EXP);
  524. pci_read_config_word(priv->pci_dev, pos + PCI_EXP_LNKCTL, &pci_lnk_ctl);
  525. return pci_lnk_ctl;
  526. }
  527. void iwl_bg_watchdog(unsigned long data);
  528. u32 iwl_usecs_to_beacons(struct iwl_priv *priv, u32 usec, u32 beacon_interval);
  529. __le32 iwl_add_beacon_time(struct iwl_priv *priv, u32 base,
  530. u32 addon, u32 beacon_interval);
  531. #ifdef CONFIG_PM
  532. int iwl_pci_suspend(struct device *device);
  533. int iwl_pci_resume(struct device *device);
  534. extern const struct dev_pm_ops iwl_pm_ops;
  535. #define IWL_PM_OPS (&iwl_pm_ops)
  536. #else /* !CONFIG_PM */
  537. #define IWL_PM_OPS NULL
  538. #endif /* !CONFIG_PM */
  539. /*****************************************************
  540. * Error Handling Debugging
  541. ******************************************************/
  542. void iwl_dump_nic_error_log(struct iwl_priv *priv);
  543. int iwl_dump_nic_event_log(struct iwl_priv *priv,
  544. bool full_log, char **buf, bool display);
  545. #ifdef CONFIG_IWLWIFI_DEBUG
  546. void iwl_print_rx_config_cmd(struct iwl_priv *priv,
  547. struct iwl_rxon_context *ctx);
  548. #else
  549. static inline void iwl_print_rx_config_cmd(struct iwl_priv *priv,
  550. struct iwl_rxon_context *ctx)
  551. {
  552. }
  553. #endif
  554. void iwl_clear_isr_stats(struct iwl_priv *priv);
  555. /*****************************************************
  556. * GEOS
  557. ******************************************************/
  558. int iwlcore_init_geos(struct iwl_priv *priv);
  559. void iwlcore_free_geos(struct iwl_priv *priv);
  560. /*************** DRIVER STATUS FUNCTIONS *****/
  561. #define STATUS_HCMD_ACTIVE 0 /* host command in progress */
  562. /* 1 is unused (used to be STATUS_HCMD_SYNC_ACTIVE) */
  563. #define STATUS_INT_ENABLED 2
  564. #define STATUS_RF_KILL_HW 3
  565. #define STATUS_CT_KILL 4
  566. #define STATUS_INIT 5
  567. #define STATUS_ALIVE 6
  568. #define STATUS_READY 7
  569. #define STATUS_TEMPERATURE 8
  570. #define STATUS_GEO_CONFIGURED 9
  571. #define STATUS_EXIT_PENDING 10
  572. #define STATUS_STATISTICS 12
  573. #define STATUS_SCANNING 13
  574. #define STATUS_SCAN_ABORTING 14
  575. #define STATUS_SCAN_HW 15
  576. #define STATUS_POWER_PMI 16
  577. #define STATUS_FW_ERROR 17
  578. static inline int iwl_is_ready(struct iwl_priv *priv)
  579. {
  580. /* The adapter is 'ready' if READY and GEO_CONFIGURED bits are
  581. * set but EXIT_PENDING is not */
  582. return test_bit(STATUS_READY, &priv->status) &&
  583. test_bit(STATUS_GEO_CONFIGURED, &priv->status) &&
  584. !test_bit(STATUS_EXIT_PENDING, &priv->status);
  585. }
  586. static inline int iwl_is_alive(struct iwl_priv *priv)
  587. {
  588. return test_bit(STATUS_ALIVE, &priv->status);
  589. }
  590. static inline int iwl_is_init(struct iwl_priv *priv)
  591. {
  592. return test_bit(STATUS_INIT, &priv->status);
  593. }
  594. static inline int iwl_is_rfkill_hw(struct iwl_priv *priv)
  595. {
  596. return test_bit(STATUS_RF_KILL_HW, &priv->status);
  597. }
  598. static inline int iwl_is_rfkill(struct iwl_priv *priv)
  599. {
  600. return iwl_is_rfkill_hw(priv);
  601. }
  602. static inline int iwl_is_ctkill(struct iwl_priv *priv)
  603. {
  604. return test_bit(STATUS_CT_KILL, &priv->status);
  605. }
  606. static inline int iwl_is_ready_rf(struct iwl_priv *priv)
  607. {
  608. if (iwl_is_rfkill(priv))
  609. return 0;
  610. return iwl_is_ready(priv);
  611. }
  612. extern void iwl_send_bt_config(struct iwl_priv *priv);
  613. extern int iwl_send_statistics_request(struct iwl_priv *priv,
  614. u8 flags, bool clear);
  615. void iwl_apm_stop(struct iwl_priv *priv);
  616. int iwl_apm_init(struct iwl_priv *priv);
  617. int iwl_send_rxon_timing(struct iwl_priv *priv, struct iwl_rxon_context *ctx);
  618. static inline int iwl_send_rxon_assoc(struct iwl_priv *priv,
  619. struct iwl_rxon_context *ctx)
  620. {
  621. return priv->cfg->ops->hcmd->rxon_assoc(priv, ctx);
  622. }
  623. static inline int iwlcore_commit_rxon(struct iwl_priv *priv,
  624. struct iwl_rxon_context *ctx)
  625. {
  626. return priv->cfg->ops->hcmd->commit_rxon(priv, ctx);
  627. }
  628. static inline const struct ieee80211_supported_band *iwl_get_hw_mode(
  629. struct iwl_priv *priv, enum ieee80211_band band)
  630. {
  631. return priv->hw->wiphy->bands[band];
  632. }
  633. static inline bool iwl_advanced_bt_coexist(struct iwl_priv *priv)
  634. {
  635. return priv->cfg->bt_params &&
  636. priv->cfg->bt_params->advanced_bt_coexist;
  637. }
  638. static inline bool iwl_bt_statistics(struct iwl_priv *priv)
  639. {
  640. return priv->bt_statistics;
  641. }
  642. extern bool bt_coex_active;
  643. extern bool bt_siso_mode;
  644. void iwlagn_fw_error(struct iwl_priv *priv, bool ondemand);
  645. #endif /* __iwl_core_h__ */