iwl-core.h 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712
  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. const bool tx_power_by_driver;
  300. const bool ucode_tracing;
  301. u8 scan_antennas[IEEE80211_NUM_BANDS];
  302. };
  303. /***************************
  304. * L i b *
  305. ***************************/
  306. struct ieee80211_hw *iwl_alloc_all(struct iwl_cfg *cfg,
  307. struct ieee80211_ops *hw_ops);
  308. void iwl_hw_detect(struct iwl_priv *priv);
  309. void iwl_activate_qos(struct iwl_priv *priv);
  310. int iwl_mac_conf_tx(struct ieee80211_hw *hw, u16 queue,
  311. const struct ieee80211_tx_queue_params *params);
  312. void iwl_set_rxon_hwcrypto(struct iwl_priv *priv, int hw_decrypt);
  313. int iwl_check_rxon_cmd(struct iwl_priv *priv);
  314. int iwl_full_rxon_required(struct iwl_priv *priv);
  315. void iwl_set_rxon_chain(struct iwl_priv *priv);
  316. int iwl_set_rxon_channel(struct iwl_priv *priv, struct ieee80211_channel *ch);
  317. void iwl_set_rxon_ht(struct iwl_priv *priv, struct iwl_ht_config *ht_conf);
  318. u8 iwl_is_ht40_tx_allowed(struct iwl_priv *priv,
  319. struct ieee80211_sta_ht_cap *sta_ht_inf);
  320. void iwl_set_flags_for_band(struct iwl_priv *priv, enum ieee80211_band band);
  321. void iwl_connection_init_rx_config(struct iwl_priv *priv, int mode);
  322. int iwl_set_decrypted_flag(struct iwl_priv *priv,
  323. struct ieee80211_hdr *hdr,
  324. u32 decrypt_res,
  325. struct ieee80211_rx_status *stats);
  326. void iwl_irq_handle_error(struct iwl_priv *priv);
  327. void iwl_configure_filter(struct ieee80211_hw *hw,
  328. unsigned int changed_flags,
  329. unsigned int *total_flags, u64 multicast);
  330. int iwl_set_hw_params(struct iwl_priv *priv);
  331. void iwl_post_associate(struct iwl_priv *priv);
  332. void iwl_bss_info_changed(struct ieee80211_hw *hw,
  333. struct ieee80211_vif *vif,
  334. struct ieee80211_bss_conf *bss_conf,
  335. u32 changes);
  336. int iwl_mac_beacon_update(struct ieee80211_hw *hw, struct sk_buff *skb);
  337. int iwl_commit_rxon(struct iwl_priv *priv);
  338. int iwl_mac_add_interface(struct ieee80211_hw *hw,
  339. struct ieee80211_vif *vif);
  340. void iwl_mac_remove_interface(struct ieee80211_hw *hw,
  341. struct ieee80211_vif *vif);
  342. int iwl_mac_config(struct ieee80211_hw *hw, u32 changed);
  343. void iwl_config_ap(struct iwl_priv *priv);
  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. if (is_tx)
  387. stats = &priv->tx_stats;
  388. else
  389. stats = &priv->rx_stats;
  390. if (ieee80211_is_data(fc)) {
  391. /* data */
  392. stats->data_bytes += len;
  393. }
  394. iwl_leds_background(priv);
  395. }
  396. #endif
  397. /*****************************************************
  398. * RX handlers.
  399. * **************************************************/
  400. void iwl_rx_pm_sleep_notif(struct iwl_priv *priv,
  401. struct iwl_rx_mem_buffer *rxb);
  402. void iwl_rx_pm_debug_statistics_notif(struct iwl_priv *priv,
  403. struct iwl_rx_mem_buffer *rxb);
  404. void iwl_rx_reply_error(struct iwl_priv *priv,
  405. struct iwl_rx_mem_buffer *rxb);
  406. /*****************************************************
  407. * RX
  408. ******************************************************/
  409. void iwl_cmd_queue_free(struct iwl_priv *priv);
  410. int iwl_rx_queue_alloc(struct iwl_priv *priv);
  411. void iwl_rx_handle(struct iwl_priv *priv);
  412. void iwl_rx_queue_update_write_ptr(struct iwl_priv *priv,
  413. struct iwl_rx_queue *q);
  414. int iwl_rx_queue_space(const struct iwl_rx_queue *q);
  415. void iwl_tx_cmd_complete(struct iwl_priv *priv, struct iwl_rx_mem_buffer *rxb);
  416. /* Handlers */
  417. void iwl_rx_missed_beacon_notif(struct iwl_priv *priv,
  418. struct iwl_rx_mem_buffer *rxb);
  419. void iwl_rx_spectrum_measure_notif(struct iwl_priv *priv,
  420. struct iwl_rx_mem_buffer *rxb);
  421. bool iwl_good_plcp_health(struct iwl_priv *priv,
  422. struct iwl_rx_packet *pkt);
  423. bool iwl_good_ack_health(struct iwl_priv *priv,
  424. struct iwl_rx_packet *pkt);
  425. void iwl_rx_statistics(struct iwl_priv *priv,
  426. struct iwl_rx_mem_buffer *rxb);
  427. void iwl_reply_statistics(struct iwl_priv *priv,
  428. struct iwl_rx_mem_buffer *rxb);
  429. void iwl_rx_csa(struct iwl_priv *priv, struct iwl_rx_mem_buffer *rxb);
  430. /* TX helpers */
  431. /*****************************************************
  432. * TX
  433. ******************************************************/
  434. void iwl_hw_txq_free_tfd(struct iwl_priv *priv, struct iwl_tx_queue *txq);
  435. int iwl_hw_txq_attach_buf_to_tfd(struct iwl_priv *priv,
  436. struct iwl_tx_queue *txq,
  437. dma_addr_t addr, u16 len, u8 reset, u8 pad);
  438. int iwl_hw_tx_queue_init(struct iwl_priv *priv,
  439. struct iwl_tx_queue *txq);
  440. void iwl_free_tfds_in_queue(struct iwl_priv *priv,
  441. int sta_id, int tid, int freed);
  442. void iwl_txq_update_write_ptr(struct iwl_priv *priv, struct iwl_tx_queue *txq);
  443. int iwl_tx_queue_init(struct iwl_priv *priv, struct iwl_tx_queue *txq,
  444. int slots_num, u32 txq_id);
  445. void iwl_tx_queue_reset(struct iwl_priv *priv, struct iwl_tx_queue *txq,
  446. int slots_num, u32 txq_id);
  447. void iwl_tx_queue_free(struct iwl_priv *priv, int txq_id);
  448. /*****************************************************
  449. * TX power
  450. ****************************************************/
  451. int iwl_set_tx_power(struct iwl_priv *priv, s8 tx_power, bool force);
  452. /*******************************************************************************
  453. * Rate
  454. ******************************************************************************/
  455. int iwl_hwrate_to_plcp_idx(u32 rate_n_flags);
  456. u8 iwl_rate_get_lowest_plcp(struct iwl_priv *priv);
  457. u8 iwl_toggle_tx_ant(struct iwl_priv *priv, u8 ant_idx);
  458. static inline u32 iwl_ant_idx_to_flags(u8 ant_idx)
  459. {
  460. return BIT(ant_idx) << RATE_MCS_ANT_POS;
  461. }
  462. static inline u8 iwl_hw_get_rate(__le32 rate_n_flags)
  463. {
  464. return le32_to_cpu(rate_n_flags) & 0xFF;
  465. }
  466. static inline u32 iwl_hw_get_rate_n_flags(__le32 rate_n_flags)
  467. {
  468. return le32_to_cpu(rate_n_flags) & 0x1FFFF;
  469. }
  470. static inline __le32 iwl_hw_set_rate_n_flags(u8 rate, u32 flags)
  471. {
  472. return cpu_to_le32(flags|(u32)rate);
  473. }
  474. /*******************************************************************************
  475. * Scanning
  476. ******************************************************************************/
  477. void iwl_init_scan_params(struct iwl_priv *priv);
  478. int iwl_scan_cancel(struct iwl_priv *priv);
  479. int iwl_scan_cancel_timeout(struct iwl_priv *priv, unsigned long ms);
  480. int iwl_mac_hw_scan(struct ieee80211_hw *hw,
  481. struct ieee80211_vif *vif,
  482. struct cfg80211_scan_request *req);
  483. void iwl_bg_start_internal_scan(struct work_struct *work);
  484. void iwl_internal_short_hw_scan(struct iwl_priv *priv);
  485. int iwl_force_reset(struct iwl_priv *priv, int mode);
  486. u16 iwl_fill_probe_req(struct iwl_priv *priv, struct ieee80211_mgmt *frame,
  487. const u8 *ie, int ie_len, int left);
  488. void iwl_setup_rx_scan_handlers(struct iwl_priv *priv);
  489. u16 iwl_get_active_dwell_time(struct iwl_priv *priv,
  490. enum ieee80211_band band,
  491. u8 n_probes);
  492. u16 iwl_get_passive_dwell_time(struct iwl_priv *priv,
  493. enum ieee80211_band band);
  494. void iwl_bg_scan_check(struct work_struct *data);
  495. void iwl_bg_abort_scan(struct work_struct *work);
  496. void iwl_bg_scan_completed(struct work_struct *work);
  497. void iwl_setup_scan_deferred_work(struct iwl_priv *priv);
  498. /* For faster active scanning, scan will move to the next channel if fewer than
  499. * PLCP_QUIET_THRESH packets are heard on this channel within
  500. * ACTIVE_QUIET_TIME after sending probe request. This shortens the dwell
  501. * time if it's a quiet channel (nothing responded to our probe, and there's
  502. * no other traffic).
  503. * Disable "quiet" feature by setting PLCP_QUIET_THRESH to 0. */
  504. #define IWL_ACTIVE_QUIET_TIME cpu_to_le16(10) /* msec */
  505. #define IWL_PLCP_QUIET_THRESH cpu_to_le16(1) /* packets */
  506. #define IWL_SCAN_CHECK_WATCHDOG (HZ * 7)
  507. /*******************************************************************************
  508. * Calibrations - implemented in iwl-calib.c
  509. ******************************************************************************/
  510. int iwl_send_calib_results(struct iwl_priv *priv);
  511. int iwl_calib_set(struct iwl_calib_result *res, const u8 *buf, int len);
  512. void iwl_calib_free_results(struct iwl_priv *priv);
  513. /*****************************************************
  514. * S e n d i n g H o s t C o m m a n d s *
  515. *****************************************************/
  516. const char *get_cmd_string(u8 cmd);
  517. int __must_check iwl_send_cmd_sync(struct iwl_priv *priv,
  518. struct iwl_host_cmd *cmd);
  519. int iwl_send_cmd(struct iwl_priv *priv, struct iwl_host_cmd *cmd);
  520. int __must_check iwl_send_cmd_pdu(struct iwl_priv *priv, u8 id,
  521. u16 len, const void *data);
  522. int iwl_send_cmd_pdu_async(struct iwl_priv *priv, u8 id, u16 len,
  523. const void *data,
  524. void (*callback)(struct iwl_priv *priv,
  525. struct iwl_device_cmd *cmd,
  526. struct iwl_rx_packet *pkt));
  527. int iwl_enqueue_hcmd(struct iwl_priv *priv, struct iwl_host_cmd *cmd);
  528. int iwl_send_card_state(struct iwl_priv *priv, u32 flags,
  529. u8 meta_flag);
  530. /*****************************************************
  531. * PCI *
  532. *****************************************************/
  533. irqreturn_t iwl_isr_legacy(int irq, void *data);
  534. static inline u16 iwl_pcie_link_ctl(struct iwl_priv *priv)
  535. {
  536. int pos;
  537. u16 pci_lnk_ctl;
  538. pos = pci_find_capability(priv->pci_dev, PCI_CAP_ID_EXP);
  539. pci_read_config_word(priv->pci_dev, pos + PCI_EXP_LNKCTL, &pci_lnk_ctl);
  540. return pci_lnk_ctl;
  541. }
  542. void iwl_bg_monitor_recover(unsigned long data);
  543. #ifdef CONFIG_PM
  544. int iwl_pci_suspend(struct pci_dev *pdev, pm_message_t state);
  545. int iwl_pci_resume(struct pci_dev *pdev);
  546. #endif /* CONFIG_PM */
  547. /*****************************************************
  548. * Error Handling Debugging
  549. ******************************************************/
  550. void iwl_dump_nic_error_log(struct iwl_priv *priv);
  551. int iwl_dump_nic_event_log(struct iwl_priv *priv,
  552. bool full_log, char **buf, bool display);
  553. void iwl_dump_csr(struct iwl_priv *priv);
  554. int iwl_dump_fh(struct iwl_priv *priv, char **buf, bool display);
  555. #ifdef CONFIG_IWLWIFI_DEBUG
  556. void iwl_print_rx_config_cmd(struct iwl_priv *priv);
  557. #else
  558. static inline void iwl_print_rx_config_cmd(struct iwl_priv *priv)
  559. {
  560. }
  561. #endif
  562. void iwl_clear_isr_stats(struct iwl_priv *priv);
  563. /*****************************************************
  564. * GEOS
  565. ******************************************************/
  566. int iwlcore_init_geos(struct iwl_priv *priv);
  567. void iwlcore_free_geos(struct iwl_priv *priv);
  568. /*************** DRIVER STATUS FUNCTIONS *****/
  569. #define STATUS_HCMD_ACTIVE 0 /* host command in progress */
  570. /* 1 is unused (used to be STATUS_HCMD_SYNC_ACTIVE) */
  571. #define STATUS_INT_ENABLED 2
  572. #define STATUS_RF_KILL_HW 3
  573. #define STATUS_CT_KILL 4
  574. #define STATUS_INIT 5
  575. #define STATUS_ALIVE 6
  576. #define STATUS_READY 7
  577. #define STATUS_TEMPERATURE 8
  578. #define STATUS_GEO_CONFIGURED 9
  579. #define STATUS_EXIT_PENDING 10
  580. #define STATUS_STATISTICS 12
  581. #define STATUS_SCANNING 13
  582. #define STATUS_SCAN_ABORTING 14
  583. #define STATUS_SCAN_HW 15
  584. #define STATUS_POWER_PMI 16
  585. #define STATUS_FW_ERROR 17
  586. static inline int iwl_is_ready(struct iwl_priv *priv)
  587. {
  588. /* The adapter is 'ready' if READY and GEO_CONFIGURED bits are
  589. * set but EXIT_PENDING is not */
  590. return test_bit(STATUS_READY, &priv->status) &&
  591. test_bit(STATUS_GEO_CONFIGURED, &priv->status) &&
  592. !test_bit(STATUS_EXIT_PENDING, &priv->status);
  593. }
  594. static inline int iwl_is_alive(struct iwl_priv *priv)
  595. {
  596. return test_bit(STATUS_ALIVE, &priv->status);
  597. }
  598. static inline int iwl_is_init(struct iwl_priv *priv)
  599. {
  600. return test_bit(STATUS_INIT, &priv->status);
  601. }
  602. static inline int iwl_is_rfkill_hw(struct iwl_priv *priv)
  603. {
  604. return test_bit(STATUS_RF_KILL_HW, &priv->status);
  605. }
  606. static inline int iwl_is_rfkill(struct iwl_priv *priv)
  607. {
  608. return iwl_is_rfkill_hw(priv);
  609. }
  610. static inline int iwl_is_ctkill(struct iwl_priv *priv)
  611. {
  612. return test_bit(STATUS_CT_KILL, &priv->status);
  613. }
  614. static inline int iwl_is_ready_rf(struct iwl_priv *priv)
  615. {
  616. if (iwl_is_rfkill(priv))
  617. return 0;
  618. return iwl_is_ready(priv);
  619. }
  620. extern void iwl_rf_kill_ct_config(struct iwl_priv *priv);
  621. extern void iwl_send_bt_config(struct iwl_priv *priv);
  622. extern int iwl_send_statistics_request(struct iwl_priv *priv,
  623. u8 flags, bool clear);
  624. extern int iwl_verify_ucode(struct iwl_priv *priv);
  625. extern int iwl_send_lq_cmd(struct iwl_priv *priv,
  626. struct iwl_link_quality_cmd *lq, u8 flags, bool init);
  627. void iwl_apm_stop(struct iwl_priv *priv);
  628. int iwl_apm_init(struct iwl_priv *priv);
  629. void iwl_setup_rxon_timing(struct iwl_priv *priv);
  630. static inline int iwl_send_rxon_assoc(struct iwl_priv *priv)
  631. {
  632. return priv->cfg->ops->hcmd->rxon_assoc(priv);
  633. }
  634. static inline int iwlcore_commit_rxon(struct iwl_priv *priv)
  635. {
  636. return priv->cfg->ops->hcmd->commit_rxon(priv);
  637. }
  638. static inline void iwlcore_config_ap(struct iwl_priv *priv)
  639. {
  640. priv->cfg->ops->lib->config_ap(priv);
  641. }
  642. static inline const struct ieee80211_supported_band *iwl_get_hw_mode(
  643. struct iwl_priv *priv, enum ieee80211_band band)
  644. {
  645. return priv->hw->wiphy->bands[band];
  646. }
  647. #endif /* __iwl_core_h__ */