iwl-core.h 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709
  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 - 2010 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 - 2010 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. /************************
  65. * forward declarations *
  66. ************************/
  67. struct iwl_host_cmd;
  68. struct iwl_cmd;
  69. #define IWLWIFI_VERSION "in-tree:"
  70. #define DRV_COPYRIGHT "Copyright(c) 2003-2010 Intel Corporation"
  71. #define DRV_AUTHOR "<ilw@linux.intel.com>"
  72. #define IWL_PCI_DEVICE(dev, subdev, cfg) \
  73. .vendor = PCI_VENDOR_ID_INTEL, .device = (dev), \
  74. .subvendor = PCI_ANY_ID, .subdevice = (subdev), \
  75. .driver_data = (kernel_ulong_t)&(cfg)
  76. #define IWL_SKU_G 0x1
  77. #define IWL_SKU_A 0x2
  78. #define IWL_SKU_N 0x8
  79. #define IWL_CMD(x) case x: return #x
  80. struct iwl_hcmd_ops {
  81. int (*rxon_assoc)(struct iwl_priv *priv);
  82. int (*commit_rxon)(struct iwl_priv *priv);
  83. void (*set_rxon_chain)(struct iwl_priv *priv);
  84. int (*set_tx_ant)(struct iwl_priv *priv, u8 valid_tx_ant);
  85. void (*send_bt_config)(struct iwl_priv *priv);
  86. };
  87. struct iwl_hcmd_utils_ops {
  88. u16 (*get_hcmd_size)(u8 cmd_id, u16 len);
  89. u16 (*build_addsta_hcmd)(const struct iwl_addsta_cmd *cmd, u8 *data);
  90. void (*gain_computation)(struct iwl_priv *priv,
  91. u32 *average_noise,
  92. u16 min_average_noise_antennat_i,
  93. u32 min_average_noise,
  94. u8 default_chain);
  95. void (*chain_noise_reset)(struct iwl_priv *priv);
  96. void (*rts_tx_cmd_flag)(struct ieee80211_tx_info *info,
  97. __le32 *tx_flags);
  98. int (*calc_rssi)(struct iwl_priv *priv,
  99. struct iwl_rx_phy_res *rx_resp);
  100. void (*request_scan)(struct iwl_priv *priv);
  101. };
  102. struct iwl_apm_ops {
  103. int (*init)(struct iwl_priv *priv);
  104. void (*stop)(struct iwl_priv *priv);
  105. void (*config)(struct iwl_priv *priv);
  106. int (*set_pwr_src)(struct iwl_priv *priv, enum iwl_pwr_src src);
  107. };
  108. struct iwl_debugfs_ops {
  109. ssize_t (*rx_stats_read)(struct file *file, char __user *user_buf,
  110. size_t count, loff_t *ppos);
  111. ssize_t (*tx_stats_read)(struct file *file, char __user *user_buf,
  112. size_t count, loff_t *ppos);
  113. ssize_t (*general_stats_read)(struct file *file, char __user *user_buf,
  114. size_t count, loff_t *ppos);
  115. };
  116. struct iwl_temp_ops {
  117. void (*temperature)(struct iwl_priv *priv);
  118. void (*set_ct_kill)(struct iwl_priv *priv);
  119. void (*set_calib_version)(struct iwl_priv *priv);
  120. };
  121. struct iwl_ucode_ops {
  122. u32 (*get_header_size)(u32);
  123. u32 (*get_build)(const struct iwl_ucode_header *, u32);
  124. u32 (*get_inst_size)(const struct iwl_ucode_header *, u32);
  125. u32 (*get_data_size)(const struct iwl_ucode_header *, u32);
  126. u32 (*get_init_size)(const struct iwl_ucode_header *, u32);
  127. u32 (*get_init_data_size)(const struct iwl_ucode_header *, u32);
  128. u32 (*get_boot_size)(const struct iwl_ucode_header *, u32);
  129. u8 * (*get_data)(const struct iwl_ucode_header *, u32);
  130. };
  131. struct iwl_lib_ops {
  132. /* set hw dependent parameters */
  133. int (*set_hw_params)(struct iwl_priv *priv);
  134. /* Handling TX */
  135. void (*txq_update_byte_cnt_tbl)(struct iwl_priv *priv,
  136. struct iwl_tx_queue *txq,
  137. u16 byte_cnt);
  138. void (*txq_inval_byte_cnt_tbl)(struct iwl_priv *priv,
  139. struct iwl_tx_queue *txq);
  140. void (*txq_set_sched)(struct iwl_priv *priv, u32 mask);
  141. int (*txq_attach_buf_to_tfd)(struct iwl_priv *priv,
  142. struct iwl_tx_queue *txq,
  143. dma_addr_t addr,
  144. u16 len, u8 reset, u8 pad);
  145. void (*txq_free_tfd)(struct iwl_priv *priv,
  146. struct iwl_tx_queue *txq);
  147. int (*txq_init)(struct iwl_priv *priv,
  148. struct iwl_tx_queue *txq);
  149. /* aggregations */
  150. int (*txq_agg_enable)(struct iwl_priv *priv, int txq_id, int tx_fifo,
  151. int sta_id, int tid, u16 ssn_idx);
  152. int (*txq_agg_disable)(struct iwl_priv *priv, u16 txq_id, u16 ssn_idx,
  153. u8 tx_fifo);
  154. /* setup Rx handler */
  155. void (*rx_handler_setup)(struct iwl_priv *priv);
  156. /* setup deferred work */
  157. void (*setup_deferred_work)(struct iwl_priv *priv);
  158. /* cancel deferred work */
  159. void (*cancel_deferred_work)(struct iwl_priv *priv);
  160. /* alive notification after init uCode load */
  161. void (*init_alive_start)(struct iwl_priv *priv);
  162. /* alive notification */
  163. int (*alive_notify)(struct iwl_priv *priv);
  164. /* check validity of rtc data address */
  165. int (*is_valid_rtc_data_addr)(u32 addr);
  166. /* 1st ucode load */
  167. int (*load_ucode)(struct iwl_priv *priv);
  168. int (*dump_nic_event_log)(struct iwl_priv *priv,
  169. bool full_log, char **buf, bool display);
  170. void (*dump_nic_error_log)(struct iwl_priv *priv);
  171. void (*dump_csr)(struct iwl_priv *priv);
  172. int (*dump_fh)(struct iwl_priv *priv, char **buf, bool display);
  173. int (*set_channel_switch)(struct iwl_priv *priv, u16 channel);
  174. /* power management */
  175. struct iwl_apm_ops apm_ops;
  176. /* power */
  177. int (*send_tx_power) (struct iwl_priv *priv);
  178. void (*update_chain_flags)(struct iwl_priv *priv);
  179. void (*post_associate) (struct iwl_priv *priv);
  180. void (*config_ap) (struct iwl_priv *priv);
  181. irqreturn_t (*isr) (int irq, void *data);
  182. /* eeprom operations (as defined in iwl-eeprom.h) */
  183. struct iwl_eeprom_ops eeprom_ops;
  184. /* temperature */
  185. struct iwl_temp_ops temp_ops;
  186. /* station management */
  187. void (*add_bcast_station)(struct iwl_priv *priv);
  188. /* recover from tx queue stall */
  189. void (*recover_from_tx_stall)(unsigned long data);
  190. /* check for plcp health */
  191. bool (*check_plcp_health)(struct iwl_priv *priv,
  192. struct iwl_rx_packet *pkt);
  193. /* check for ack health */
  194. bool (*check_ack_health)(struct iwl_priv *priv,
  195. struct iwl_rx_packet *pkt);
  196. struct iwl_debugfs_ops debugfs_ops;
  197. };
  198. struct iwl_led_ops {
  199. int (*cmd)(struct iwl_priv *priv, struct iwl_led_cmd *led_cmd);
  200. int (*on)(struct iwl_priv *priv);
  201. int (*off)(struct iwl_priv *priv);
  202. };
  203. struct iwl_ops {
  204. const struct iwl_ucode_ops *ucode;
  205. const struct iwl_lib_ops *lib;
  206. const struct iwl_hcmd_ops *hcmd;
  207. const struct iwl_hcmd_utils_ops *utils;
  208. const struct iwl_led_ops *led;
  209. };
  210. struct iwl_mod_params {
  211. int sw_crypto; /* def: 0 = using hardware encryption */
  212. int disable_hw_scan; /* def: 0 = use h/w scan */
  213. int num_of_queues; /* def: HW dependent */
  214. int disable_11n; /* def: 0 = 11n capabilities enabled */
  215. int amsdu_size_8K; /* def: 1 = enable 8K amsdu size */
  216. int antenna; /* def: 0 = both antennas (use diversity) */
  217. int restart_fw; /* def: 1 = restart firmware */
  218. };
  219. /**
  220. * struct iwl_cfg
  221. * @fw_name_pre: Firmware filename prefix. The api version and extension
  222. * (.ucode) will be added to filename before loading from disk. The
  223. * filename is constructed as fw_name_pre<api>.ucode.
  224. * @ucode_api_max: Highest version of uCode API supported by driver.
  225. * @ucode_api_min: Lowest version of uCode API supported by driver.
  226. * @pa_type: used by 6000 series only to identify the type of Power Amplifier
  227. * @max_ll_items: max number of OTP blocks
  228. * @shadow_ram_support: shadow support for OTP memory
  229. * @led_compensation: compensate on the led on/off time per HW according
  230. * to the deviation to achieve the desired led frequency.
  231. * The detail algorithm is described in iwl-led.c
  232. * @use_rts_for_ht: use rts/cts protection for HT traffic
  233. * @chain_noise_num_beacons: number of beacons used to compute chain noise
  234. * @adv_thermal_throttle: support advance thermal throttle
  235. * @support_ct_kill_exit: support ct kill exit condition
  236. * @support_wimax_coexist: support wimax/wifi co-exist
  237. * @plcp_delta_threshold: plcp error rate threshold used to trigger
  238. * radio tuning when there is a high receiving plcp error rate
  239. *
  240. * We enable the driver to be backward compatible wrt API version. The
  241. * driver specifies which APIs it supports (with @ucode_api_max being the
  242. * highest and @ucode_api_min the lowest). Firmware will only be loaded if
  243. * it has a supported API version. The firmware's API version will be
  244. * stored in @iwl_priv, enabling the driver to make runtime changes based
  245. * on firmware version used.
  246. *
  247. * For example,
  248. * if (IWL_UCODE_API(priv->ucode_ver) >= 2) {
  249. * Driver interacts with Firmware API version >= 2.
  250. * } else {
  251. * Driver interacts with Firmware API version 1.
  252. * }
  253. *
  254. * The ideal usage of this infrastructure is to treat a new ucode API
  255. * release as a new hardware revision. That is, through utilizing the
  256. * iwl_hcmd_utils_ops etc. we accommodate different command structures
  257. * and flows between hardware versions (4965/5000) as well as their API
  258. * versions.
  259. *
  260. */
  261. struct iwl_cfg {
  262. const char *name;
  263. const char *fw_name_pre;
  264. const unsigned int ucode_api_max;
  265. const unsigned int ucode_api_min;
  266. unsigned int sku;
  267. int eeprom_size;
  268. u16 eeprom_ver;
  269. u16 eeprom_calib_ver;
  270. int num_of_queues; /* def: HW dependent */
  271. int num_of_ampdu_queues;/* def: HW dependent */
  272. const struct iwl_ops *ops;
  273. const struct iwl_mod_params *mod_params;
  274. u8 valid_tx_ant;
  275. u8 valid_rx_ant;
  276. /* for iwl_apm_init() */
  277. u32 pll_cfg_val;
  278. bool set_l0s;
  279. bool use_bsm;
  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. const bool support_wimax_coexist;
  293. u8 plcp_delta_threshold;
  294. s32 chain_noise_scale;
  295. /* timer period for monitor the driver queues */
  296. u32 monitor_recover_period;
  297. bool temperature_kelvin;
  298. u32 max_event_log_size;
  299. u8 scan_antennas[IEEE80211_NUM_BANDS];
  300. };
  301. /***************************
  302. * L i b *
  303. ***************************/
  304. struct ieee80211_hw *iwl_alloc_all(struct iwl_cfg *cfg,
  305. struct ieee80211_ops *hw_ops);
  306. void iwl_hw_detect(struct iwl_priv *priv);
  307. void iwl_activate_qos(struct iwl_priv *priv);
  308. int iwl_mac_conf_tx(struct ieee80211_hw *hw, u16 queue,
  309. const struct ieee80211_tx_queue_params *params);
  310. void iwl_set_rxon_hwcrypto(struct iwl_priv *priv, int hw_decrypt);
  311. int iwl_check_rxon_cmd(struct iwl_priv *priv);
  312. int iwl_full_rxon_required(struct iwl_priv *priv);
  313. void iwl_set_rxon_chain(struct iwl_priv *priv);
  314. int iwl_set_rxon_channel(struct iwl_priv *priv, struct ieee80211_channel *ch);
  315. void iwl_set_rxon_ht(struct iwl_priv *priv, struct iwl_ht_config *ht_conf);
  316. u8 iwl_is_ht40_tx_allowed(struct iwl_priv *priv,
  317. struct ieee80211_sta_ht_cap *sta_ht_inf);
  318. void iwl_set_flags_for_band(struct iwl_priv *priv, enum ieee80211_band band);
  319. void iwl_connection_init_rx_config(struct iwl_priv *priv, int mode);
  320. int iwl_set_decrypted_flag(struct iwl_priv *priv,
  321. struct ieee80211_hdr *hdr,
  322. u32 decrypt_res,
  323. struct ieee80211_rx_status *stats);
  324. void iwl_irq_handle_error(struct iwl_priv *priv);
  325. void iwl_configure_filter(struct ieee80211_hw *hw,
  326. unsigned int changed_flags,
  327. unsigned int *total_flags, u64 multicast);
  328. int iwl_set_hw_params(struct iwl_priv *priv);
  329. void iwl_post_associate(struct iwl_priv *priv);
  330. void iwl_bss_info_changed(struct ieee80211_hw *hw,
  331. struct ieee80211_vif *vif,
  332. struct ieee80211_bss_conf *bss_conf,
  333. u32 changes);
  334. int iwl_mac_beacon_update(struct ieee80211_hw *hw, struct sk_buff *skb);
  335. int iwl_commit_rxon(struct iwl_priv *priv);
  336. int iwl_mac_add_interface(struct ieee80211_hw *hw,
  337. struct ieee80211_vif *vif);
  338. void iwl_mac_remove_interface(struct ieee80211_hw *hw,
  339. struct ieee80211_vif *vif);
  340. int iwl_mac_config(struct ieee80211_hw *hw, u32 changed);
  341. void iwl_config_ap(struct iwl_priv *priv);
  342. void iwl_mac_reset_tsf(struct ieee80211_hw *hw);
  343. int iwl_alloc_txq_mem(struct iwl_priv *priv);
  344. void iwl_free_txq_mem(struct iwl_priv *priv);
  345. void iwlcore_rts_tx_cmd_flag(struct ieee80211_tx_info *info,
  346. __le32 *tx_flags);
  347. int iwl_send_wimax_coex(struct iwl_priv *priv);
  348. #ifdef CONFIG_IWLWIFI_DEBUGFS
  349. int iwl_alloc_traffic_mem(struct iwl_priv *priv);
  350. void iwl_free_traffic_mem(struct iwl_priv *priv);
  351. void iwl_reset_traffic_log(struct iwl_priv *priv);
  352. void iwl_dbg_log_tx_data_frame(struct iwl_priv *priv,
  353. u16 length, struct ieee80211_hdr *header);
  354. void iwl_dbg_log_rx_data_frame(struct iwl_priv *priv,
  355. u16 length, struct ieee80211_hdr *header);
  356. const char *get_mgmt_string(int cmd);
  357. const char *get_ctrl_string(int cmd);
  358. void iwl_clear_traffic_stats(struct iwl_priv *priv);
  359. void iwl_update_stats(struct iwl_priv *priv, bool is_tx, __le16 fc,
  360. u16 len);
  361. #else
  362. static inline int iwl_alloc_traffic_mem(struct iwl_priv *priv)
  363. {
  364. return 0;
  365. }
  366. static inline void iwl_free_traffic_mem(struct iwl_priv *priv)
  367. {
  368. }
  369. static inline void iwl_reset_traffic_log(struct iwl_priv *priv)
  370. {
  371. }
  372. static inline void iwl_dbg_log_tx_data_frame(struct iwl_priv *priv,
  373. u16 length, struct ieee80211_hdr *header)
  374. {
  375. }
  376. static inline void iwl_dbg_log_rx_data_frame(struct iwl_priv *priv,
  377. u16 length, struct ieee80211_hdr *header)
  378. {
  379. }
  380. static inline void iwl_update_stats(struct iwl_priv *priv, bool is_tx,
  381. __le16 fc, u16 len)
  382. {
  383. struct traffic_stats *stats;
  384. if (is_tx)
  385. stats = &priv->tx_stats;
  386. else
  387. stats = &priv->rx_stats;
  388. if (ieee80211_is_data(fc)) {
  389. /* data */
  390. stats->data_bytes += len;
  391. }
  392. iwl_leds_background(priv);
  393. }
  394. #endif
  395. /*****************************************************
  396. * RX handlers.
  397. * **************************************************/
  398. void iwl_rx_pm_sleep_notif(struct iwl_priv *priv,
  399. struct iwl_rx_mem_buffer *rxb);
  400. void iwl_rx_pm_debug_statistics_notif(struct iwl_priv *priv,
  401. struct iwl_rx_mem_buffer *rxb);
  402. void iwl_rx_reply_error(struct iwl_priv *priv,
  403. struct iwl_rx_mem_buffer *rxb);
  404. /*****************************************************
  405. * RX
  406. ******************************************************/
  407. void iwl_cmd_queue_free(struct iwl_priv *priv);
  408. int iwl_rx_queue_alloc(struct iwl_priv *priv);
  409. void iwl_rx_handle(struct iwl_priv *priv);
  410. void iwl_rx_queue_update_write_ptr(struct iwl_priv *priv,
  411. struct iwl_rx_queue *q);
  412. int iwl_rx_queue_space(const struct iwl_rx_queue *q);
  413. void iwl_tx_cmd_complete(struct iwl_priv *priv, struct iwl_rx_mem_buffer *rxb);
  414. /* Handlers */
  415. void iwl_rx_missed_beacon_notif(struct iwl_priv *priv,
  416. struct iwl_rx_mem_buffer *rxb);
  417. void iwl_rx_spectrum_measure_notif(struct iwl_priv *priv,
  418. struct iwl_rx_mem_buffer *rxb);
  419. bool iwl_good_plcp_health(struct iwl_priv *priv,
  420. struct iwl_rx_packet *pkt);
  421. bool iwl_good_ack_health(struct iwl_priv *priv,
  422. struct iwl_rx_packet *pkt);
  423. void iwl_rx_statistics(struct iwl_priv *priv,
  424. struct iwl_rx_mem_buffer *rxb);
  425. void iwl_reply_statistics(struct iwl_priv *priv,
  426. struct iwl_rx_mem_buffer *rxb);
  427. void iwl_rx_csa(struct iwl_priv *priv, struct iwl_rx_mem_buffer *rxb);
  428. /* TX helpers */
  429. /*****************************************************
  430. * TX
  431. ******************************************************/
  432. void iwl_hw_txq_free_tfd(struct iwl_priv *priv, struct iwl_tx_queue *txq);
  433. int iwl_hw_txq_attach_buf_to_tfd(struct iwl_priv *priv,
  434. struct iwl_tx_queue *txq,
  435. dma_addr_t addr, u16 len, u8 reset, u8 pad);
  436. int iwl_hw_tx_queue_init(struct iwl_priv *priv,
  437. struct iwl_tx_queue *txq);
  438. void iwl_free_tfds_in_queue(struct iwl_priv *priv,
  439. int sta_id, int tid, int freed);
  440. void iwl_txq_update_write_ptr(struct iwl_priv *priv, struct iwl_tx_queue *txq);
  441. int iwl_tx_queue_init(struct iwl_priv *priv, struct iwl_tx_queue *txq,
  442. int slots_num, u32 txq_id);
  443. void iwl_tx_queue_reset(struct iwl_priv *priv, struct iwl_tx_queue *txq,
  444. int slots_num, u32 txq_id);
  445. void iwl_tx_queue_free(struct iwl_priv *priv, int txq_id);
  446. /*****************************************************
  447. * TX power
  448. ****************************************************/
  449. int iwl_set_tx_power(struct iwl_priv *priv, s8 tx_power, bool force);
  450. /*******************************************************************************
  451. * Rate
  452. ******************************************************************************/
  453. int iwl_hwrate_to_plcp_idx(u32 rate_n_flags);
  454. u8 iwl_rate_get_lowest_plcp(struct iwl_priv *priv);
  455. u8 iwl_toggle_tx_ant(struct iwl_priv *priv, u8 ant_idx);
  456. static inline u32 iwl_ant_idx_to_flags(u8 ant_idx)
  457. {
  458. return BIT(ant_idx) << RATE_MCS_ANT_POS;
  459. }
  460. static inline u8 iwl_hw_get_rate(__le32 rate_n_flags)
  461. {
  462. return le32_to_cpu(rate_n_flags) & 0xFF;
  463. }
  464. static inline u32 iwl_hw_get_rate_n_flags(__le32 rate_n_flags)
  465. {
  466. return le32_to_cpu(rate_n_flags) & 0x1FFFF;
  467. }
  468. static inline __le32 iwl_hw_set_rate_n_flags(u8 rate, u32 flags)
  469. {
  470. return cpu_to_le32(flags|(u32)rate);
  471. }
  472. /*******************************************************************************
  473. * Scanning
  474. ******************************************************************************/
  475. void iwl_init_scan_params(struct iwl_priv *priv);
  476. int iwl_scan_cancel(struct iwl_priv *priv);
  477. int iwl_scan_cancel_timeout(struct iwl_priv *priv, unsigned long ms);
  478. int iwl_mac_hw_scan(struct ieee80211_hw *hw,
  479. struct ieee80211_vif *vif,
  480. struct cfg80211_scan_request *req);
  481. void iwl_internal_short_hw_scan(struct iwl_priv *priv);
  482. int iwl_force_reset(struct iwl_priv *priv, int mode);
  483. u16 iwl_fill_probe_req(struct iwl_priv *priv, struct ieee80211_mgmt *frame,
  484. const u8 *ie, int ie_len, int left);
  485. void iwl_setup_rx_scan_handlers(struct iwl_priv *priv);
  486. u16 iwl_get_active_dwell_time(struct iwl_priv *priv,
  487. enum ieee80211_band band,
  488. u8 n_probes);
  489. u16 iwl_get_passive_dwell_time(struct iwl_priv *priv,
  490. enum ieee80211_band band);
  491. void iwl_bg_scan_check(struct work_struct *data);
  492. void iwl_bg_abort_scan(struct work_struct *work);
  493. void iwl_bg_scan_completed(struct work_struct *work);
  494. void iwl_setup_scan_deferred_work(struct iwl_priv *priv);
  495. /* For faster active scanning, scan will move to the next channel if fewer than
  496. * PLCP_QUIET_THRESH packets are heard on this channel within
  497. * ACTIVE_QUIET_TIME after sending probe request. This shortens the dwell
  498. * time if it's a quiet channel (nothing responded to our probe, and there's
  499. * no other traffic).
  500. * Disable "quiet" feature by setting PLCP_QUIET_THRESH to 0. */
  501. #define IWL_ACTIVE_QUIET_TIME cpu_to_le16(10) /* msec */
  502. #define IWL_PLCP_QUIET_THRESH cpu_to_le16(1) /* packets */
  503. #define IWL_SCAN_CHECK_WATCHDOG (HZ * 7)
  504. /*******************************************************************************
  505. * Calibrations - implemented in iwl-calib.c
  506. ******************************************************************************/
  507. int iwl_send_calib_results(struct iwl_priv *priv);
  508. int iwl_calib_set(struct iwl_calib_result *res, const u8 *buf, int len);
  509. void iwl_calib_free_results(struct iwl_priv *priv);
  510. /*****************************************************
  511. * S e n d i n g H o s t C o m m a n d s *
  512. *****************************************************/
  513. const char *get_cmd_string(u8 cmd);
  514. int __must_check iwl_send_cmd_sync(struct iwl_priv *priv,
  515. struct iwl_host_cmd *cmd);
  516. int iwl_send_cmd(struct iwl_priv *priv, struct iwl_host_cmd *cmd);
  517. int __must_check iwl_send_cmd_pdu(struct iwl_priv *priv, u8 id,
  518. u16 len, const void *data);
  519. int iwl_send_cmd_pdu_async(struct iwl_priv *priv, u8 id, u16 len,
  520. const void *data,
  521. void (*callback)(struct iwl_priv *priv,
  522. struct iwl_device_cmd *cmd,
  523. struct iwl_rx_packet *pkt));
  524. int iwl_enqueue_hcmd(struct iwl_priv *priv, struct iwl_host_cmd *cmd);
  525. int iwl_send_card_state(struct iwl_priv *priv, u32 flags,
  526. u8 meta_flag);
  527. /*****************************************************
  528. * PCI *
  529. *****************************************************/
  530. irqreturn_t iwl_isr_legacy(int irq, void *data);
  531. static inline u16 iwl_pcie_link_ctl(struct iwl_priv *priv)
  532. {
  533. int pos;
  534. u16 pci_lnk_ctl;
  535. pos = pci_find_capability(priv->pci_dev, PCI_CAP_ID_EXP);
  536. pci_read_config_word(priv->pci_dev, pos + PCI_EXP_LNKCTL, &pci_lnk_ctl);
  537. return pci_lnk_ctl;
  538. }
  539. void iwl_bg_monitor_recover(unsigned long data);
  540. #ifdef CONFIG_PM
  541. int iwl_pci_suspend(struct pci_dev *pdev, pm_message_t state);
  542. int iwl_pci_resume(struct pci_dev *pdev);
  543. #endif /* CONFIG_PM */
  544. /*****************************************************
  545. * Error Handling Debugging
  546. ******************************************************/
  547. void iwl_dump_nic_error_log(struct iwl_priv *priv);
  548. int iwl_dump_nic_event_log(struct iwl_priv *priv,
  549. bool full_log, char **buf, bool display);
  550. void iwl_dump_csr(struct iwl_priv *priv);
  551. int iwl_dump_fh(struct iwl_priv *priv, char **buf, bool display);
  552. #ifdef CONFIG_IWLWIFI_DEBUG
  553. void iwl_print_rx_config_cmd(struct iwl_priv *priv);
  554. #else
  555. static inline void iwl_print_rx_config_cmd(struct iwl_priv *priv)
  556. {
  557. }
  558. #endif
  559. void iwl_clear_isr_stats(struct iwl_priv *priv);
  560. /*****************************************************
  561. * GEOS
  562. ******************************************************/
  563. int iwlcore_init_geos(struct iwl_priv *priv);
  564. void iwlcore_free_geos(struct iwl_priv *priv);
  565. /*************** DRIVER STATUS FUNCTIONS *****/
  566. #define STATUS_HCMD_ACTIVE 0 /* host command in progress */
  567. /* 1 is unused (used to be STATUS_HCMD_SYNC_ACTIVE) */
  568. #define STATUS_INT_ENABLED 2
  569. #define STATUS_RF_KILL_HW 3
  570. #define STATUS_CT_KILL 4
  571. #define STATUS_INIT 5
  572. #define STATUS_ALIVE 6
  573. #define STATUS_READY 7
  574. #define STATUS_TEMPERATURE 8
  575. #define STATUS_GEO_CONFIGURED 9
  576. #define STATUS_EXIT_PENDING 10
  577. #define STATUS_STATISTICS 12
  578. #define STATUS_SCANNING 13
  579. #define STATUS_SCAN_ABORTING 14
  580. #define STATUS_SCAN_HW 15
  581. #define STATUS_POWER_PMI 16
  582. #define STATUS_FW_ERROR 17
  583. static inline int iwl_is_ready(struct iwl_priv *priv)
  584. {
  585. /* The adapter is 'ready' if READY and GEO_CONFIGURED bits are
  586. * set but EXIT_PENDING is not */
  587. return test_bit(STATUS_READY, &priv->status) &&
  588. test_bit(STATUS_GEO_CONFIGURED, &priv->status) &&
  589. !test_bit(STATUS_EXIT_PENDING, &priv->status);
  590. }
  591. static inline int iwl_is_alive(struct iwl_priv *priv)
  592. {
  593. return test_bit(STATUS_ALIVE, &priv->status);
  594. }
  595. static inline int iwl_is_init(struct iwl_priv *priv)
  596. {
  597. return test_bit(STATUS_INIT, &priv->status);
  598. }
  599. static inline int iwl_is_rfkill_hw(struct iwl_priv *priv)
  600. {
  601. return test_bit(STATUS_RF_KILL_HW, &priv->status);
  602. }
  603. static inline int iwl_is_rfkill(struct iwl_priv *priv)
  604. {
  605. return iwl_is_rfkill_hw(priv);
  606. }
  607. static inline int iwl_is_ctkill(struct iwl_priv *priv)
  608. {
  609. return test_bit(STATUS_CT_KILL, &priv->status);
  610. }
  611. static inline int iwl_is_ready_rf(struct iwl_priv *priv)
  612. {
  613. if (iwl_is_rfkill(priv))
  614. return 0;
  615. return iwl_is_ready(priv);
  616. }
  617. extern void iwl_rf_kill_ct_config(struct iwl_priv *priv);
  618. extern void iwl_send_bt_config(struct iwl_priv *priv);
  619. extern int iwl_send_statistics_request(struct iwl_priv *priv,
  620. u8 flags, bool clear);
  621. extern int iwl_verify_ucode(struct iwl_priv *priv);
  622. extern int iwl_send_lq_cmd(struct iwl_priv *priv,
  623. struct iwl_link_quality_cmd *lq, u8 flags, bool init);
  624. void iwl_apm_stop(struct iwl_priv *priv);
  625. int iwl_apm_init(struct iwl_priv *priv);
  626. void iwl_setup_rxon_timing(struct iwl_priv *priv);
  627. static inline int iwl_send_rxon_assoc(struct iwl_priv *priv)
  628. {
  629. return priv->cfg->ops->hcmd->rxon_assoc(priv);
  630. }
  631. static inline int iwlcore_commit_rxon(struct iwl_priv *priv)
  632. {
  633. return priv->cfg->ops->hcmd->commit_rxon(priv);
  634. }
  635. static inline void iwlcore_config_ap(struct iwl_priv *priv)
  636. {
  637. priv->cfg->ops->lib->config_ap(priv);
  638. }
  639. static inline const struct ieee80211_supported_band *iwl_get_hw_mode(
  640. struct iwl_priv *priv, enum ieee80211_band band)
  641. {
  642. return priv->hw->wiphy->bands[band];
  643. }
  644. #endif /* __iwl_core_h__ */